在构建 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
这需要更新框架的所有名称:
打开 MyFramework.framework
目录(如果使用 XCFramework,这将需要打开 .xcframework
目录并为 .framework
重复这些步骤 x86_64
和 arm64
架构。)
打开Info.plist
并将Bundle name
和Executable file
更改为MyNewFramework
。您还需要更新 bundle id
打开 Modules/module.modulemap
。将 MyFramework
的用途更改为 MyNewFramework
:
framework module MyNewFramework {
umbrella header "MyNewFramework.h"
export *
module * { export * }
}
打开 Headers
目录,对于其中的每个头文件,您需要更改所有其他本地头文件的导入:#import <MyFramework/Something.h>
- > #import <MyNewFramework/Something.h>
(我建议对 #import <MyFramework/
进行全局查找和替换)。
把Headers
目录下的文件MyFramework.h
改成MyNewFramework.h
将在框架目录中找到的可执行文件的名称从 MyFramework
更改为 MyNewFramework
导航到 MyFramework.framework
目录后,运行 命令:otool -l MyNewFramework | grep rpath
。它应该回显如下内容:name @rpath/MyFramework.framework/MyFramework
作为选项之一。复制此路径。
使用从第 6 步复制的命令,将 MyFramework
的实例替换为 MyNewFramework
运行 此命令:(更改 @rpath/MyNewFramework.framework/MyNewFramework
如果不同来自你复制的内容)
install_name_tool -id @rpath/MyNewFramework.framework/MyNewFramework MyNewFramework
通过再次 运行ning otool -l MyNewFramework
确认重命名 rpath 成功并检查路径是否已更新为 MyNewFramework
.
将整个框架的名称从MyFramework.framework
重命名为MyNewFramework.framework
如果使用 XCFramework,请在体系结构外部导航到直接在 .xcframework
目录中找到的 Info.plist
。在 Item 0
和 Item 1
中的 AvailableLibraries
下,将 LibraryPath
从 MyFramework.framework
更改为 MyNewFramework.framework
。
如果使用 XCFramework,不要忘记将最外层目录的名称从 MyFramework.xcframework
重命名为 MyNewFramework.xcframework
。
为确保没有任何挂起的引用,请删除派生数据 (rm -rf ~/Library/Developer/Xcode/DerivedData/
)。确保拆除您的依赖项并将它们与重命名的依赖项重新集成。 (对于 cocoapods,这涉及使用新框架名称更新 Podfile 或 podspec,然后 运行ning pod deintegrate && pod install
。)
哇!多么好的工作!去给自己弄杯好东西。
注意:验证这不会在构建和导出您的应用程序时导致任何问题。如果是这样,请考虑禁用 Bitcode(如果这对您来说是可行的选择)。
我已经从修改后的开源 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
这需要更新框架的所有名称:
打开
MyFramework.framework
目录(如果使用 XCFramework,这将需要打开.xcframework
目录并为.framework
重复这些步骤x86_64
和arm64
架构。)打开
Info.plist
并将Bundle name
和Executable file
更改为MyNewFramework
。您还需要更新bundle id
打开
Modules/module.modulemap
。将MyFramework
的用途更改为MyNewFramework
:
framework module MyNewFramework {
umbrella header "MyNewFramework.h"
export *
module * { export * }
}
打开
Headers
目录,对于其中的每个头文件,您需要更改所有其他本地头文件的导入:#import <MyFramework/Something.h>
- >#import <MyNewFramework/Something.h>
(我建议对#import <MyFramework/
进行全局查找和替换)。把
Headers
目录下的文件MyFramework.h
改成MyNewFramework.h
将在框架目录中找到的可执行文件的名称从
MyFramework
更改为MyNewFramework
导航到
MyFramework.framework
目录后,运行 命令:otool -l MyNewFramework | grep rpath
。它应该回显如下内容:name @rpath/MyFramework.framework/MyFramework
作为选项之一。复制此路径。使用从第 6 步复制的命令,将
MyFramework
的实例替换为MyNewFramework
运行 此命令:(更改@rpath/MyNewFramework.framework/MyNewFramework
如果不同来自你复制的内容)
install_name_tool -id @rpath/MyNewFramework.framework/MyNewFramework MyNewFramework
通过再次 运行ning
otool -l MyNewFramework
确认重命名 rpath 成功并检查路径是否已更新为MyNewFramework
.将整个框架的名称从
MyFramework.framework
重命名为MyNewFramework.framework
如果使用 XCFramework,请在体系结构外部导航到直接在
.xcframework
目录中找到的Info.plist
。在Item 0
和Item 1
中的AvailableLibraries
下,将LibraryPath
从MyFramework.framework
更改为MyNewFramework.framework
。如果使用 XCFramework,不要忘记将最外层目录的名称从
MyFramework.xcframework
重命名为MyNewFramework.xcframework
。为确保没有任何挂起的引用,请删除派生数据 (
rm -rf ~/Library/Developer/Xcode/DerivedData/
)。确保拆除您的依赖项并将它们与重命名的依赖项重新集成。 (对于 cocoapods,这涉及使用新框架名称更新 Podfile 或 podspec,然后 运行ningpod deintegrate && pod install
。)
哇!多么好的工作!去给自己弄杯好东西。
注意:验证这不会在构建和导出您的应用程序时导致任何问题。如果是这样,请考虑禁用 Bitcode(如果这对您来说是可行的选择)。