在构建后重命名 iOS 框架

问题描述

我从修改后的开源 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 目录并为 .frameworkx86_64 架构。)

  2. 打开 arm64 并将 Info.plistBundle name 更改为 Executable file。您还需要更新 MyNewFramework

  3. 打开 bundle id。将 Modules/module.modulemap 的用法更改为 MyFramework

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

  2. #import <MyNewFramework/Something.h>目录#import <MyFramework/中的文件改为Headers

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

  4. 导航到 MyFramework 目录后,运行命令:MyNewFramework。它应该回应如下内容:MyFramework.framework 作为选项之一。复制此路径。

  5. 使用从第 6 步复制的命令,将 otool -l MyNewFramework | grep rpath 的实例替换为 name @rpath/MyFramework.framework/MyFramework 运行以下命令:(如果与您复制的不同,则更改 MyFramework

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

  2. 将整个框架的名称从 otool -l MyNewFramework 重命名为 MyNewFramework

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

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

  5. 为确保没有任何挂起的引用,请删除派生数据 (MyFramework.xcframework)。确保拆除您的依赖项并将它们与重命名的依赖项重新集成。 (对于 cocoapods,这涉及使用新框架名称更新 Podfile 或 podspec,然后运行 ​​MyNewFramework.xcframework。)

哇!什么工作!去给自己修理一杯好喝的东西。

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