在构建 iOS 框架后重命名它

Renaming an iOS Framework after it's been built

我已经从修改后的开源 C++ 代码构建了一个框架,用于另一个开发 sdk。如果应用程序有另一个也依赖于此框架的 sdk,则它们无法使用此 sdk。我如何重新命名这个框架 它已经构建之后(更改 MyFramework.xcframework -> MyNewFramework.xcframework)。

重命名我能找到的所有参考资料后,我在安装时仍然遇到链接器错误:dyld: Library not loaded: @rpath/MyFramework.framework/MyFramework Referenced from: /private/var/containers/Bundle/Application/[app] Reason: image not found

这需要更新框架的所有名称:

  1. 打开 MyFramework.framework 目录(如果使用 XCFramework,这将需要打开 .xcframework 目录并为 .framework 重复这些步骤 x86_64arm64 架构。)

  2. 打开Info.plist并将Bundle nameExecutable file更改为MyNewFramework。您还需要更新 bundle id

  3. 打开 Modules/module.modulemap。将 MyFramework 的用途更改为 MyNewFramework:

framework module MyNewFramework {
  umbrella header "MyNewFramework.h"

  export *
  module * { export * }
}
  1. 打开 Headers 目录,对于其中的每个头文件,您需要更改所有其他本地头文件的导入:#import <MyFramework/Something.h> - > #import <MyNewFramework/Something.h>(我建议对 #import <MyFramework/ 进行全局查找和替换)。

  2. Headers目录下的文件MyFramework.h改成MyNewFramework.h

  3. 将在框架目录中找到的可执行文件的名称从 MyFramework 更改为 MyNewFramework

  4. 导航到 MyFramework.framework 目录后,运行 命令:otool -l MyNewFramework | grep rpath。它应该回显如下内容:name @rpath/MyFramework.framework/MyFramework 作为选项之一。复制此路径。

  5. 使用从第 6 步复制的命令,将 MyFramework 的实例替换为 MyNewFramework 运行 此命令:(更改 @rpath/MyNewFramework.framework/MyNewFramework 如果不同来自你复制的内容)

install_name_tool -id @rpath/MyNewFramework.framework/MyNewFramework MyNewFramework
  1. 通过再次 运行ning otool -l MyNewFramework 确认重命名 rpath 成功并检查路径是否已更新为 MyNewFramework.

  2. 将整个框架的名称从MyFramework.framework重命名为MyNewFramework.framework

  3. 如果使用 XCFramework,请在体系结构外部导航到直接在 .xcframework 目录中找到的 Info.plist。在 Item 0Item 1 中的 AvailableLibraries 下,将 LibraryPathMyFramework.framework 更改为 MyNewFramework.framework

  4. 如果使用 XCFramework,不要忘记将最外层目录的名称从 MyFramework.xcframework 重命名为 MyNewFramework.xcframework

  5. 为确保没有任何挂起的引用,请删除派生数据 (rm -rf ~/Library/Developer/Xcode/DerivedData/)。确保拆除您的依赖项并将它们与重命名的依赖项重新集成。 (对于 cocoapods,这涉及使用新框架名称更新 Podfile 或 podspec,然后 运行ning pod deintegrate && pod install。)

哇!多么好的工作!去给自己弄杯好东西。

注意:验证这不会在构建和导出您的应用程序时导致任何问题。如果是这样,请考虑禁用 Bitcode(如果这对您来说是可行的选择)。