Xcode 12.5迁移至xcframework时dyld: Library not loaded错误解决
环境配置
- MacBook Pro (13-inch, 2017, 双Thunderbolt 3接口)
- 操作系统:Big sur 11.3.1
- Xcode版本:12.5
- Apple Swift版本:5.4 (swiftlang-1205.0.26.9 clang-1205.0.19.55)
- 编译目标:x86_64-apple-darwin20.4.0
问题描述
Xcode 12.4及更早版本中,我们使用适配方案为项目生成framework,这类framework为bundle格式(黄色公文包图标)。同时需要为每个target在Build Phase下手动编写Carthage Copy File脚本,操作繁琐且易出错。
数日前查阅Carthage官方文档时发现官方推荐使用xcframework,从步骤说明来看无需再执行繁琐的copy file步骤,因此决定尝试迁移。
我严格按照官方迁移步骤操作,同时将framework搜索路径从$(PROJECT_DIR)/YOUR_PROJECT/Carthage/Build/iOS修改为$(PROJECT_DIR)/YOUR_PROJECT/Carthage/Build。修改后应用可在模拟器正常运行,但真机运行时直接崩溃,调试控制台报错如下:
dyld: Library not loaded: @rpath/Auth0.framework/Auth0 Referenced from: /private/var/containers/Bundle/Application/9575D8AA-BD35-447B-ACC3-F8545CDB62EE/FIT dev.app/FIT dev Reason: image not found dyld: launch, loading dependent libraries DYLD_LIBRARY_PATH=/usr/lib/system/introspection DYLD_INSERT_LIBRARIES=/Developer/usr/lib/libBacktraceRecording.dylib:/Developer/usr/lib/libMainThreadChecker.dylib:/Developer/Library/PrivateFrameworks/DTDDISupport.framework/libViewDebuggerSupport.dylib
解决方案
最终我找到对应技术文章,文中建议对拖拽到项目中的framework执行embed & sign操作。我在项目General/Frameworks, Libraries and Embedded Content标签页下,将部分framework的Embed状态从Do not embed修改为Embed & Sign,修改后项目可同时在模拟器和真机正常运行,UI测试也无异常。
Carthage官方文档的迁移步骤未提及该操作,也未找到同类问题的相关说明,因此分享完整迁移步骤供参考:
- 严格按照官方迁移步骤操作,若项目有多个target,可将所有xcframework放入文件导航栏的
/Frameworks组下,即可一次性将xcframework关联到所有target。


- 为新增的xcframework设置embed状态,可将framework分为三类处理:
- 绿色标记的第三方库,例如auth0、alamofire ->
Embed and Sign - 橙色标记的自研开发库 ->
Embed and Sign - 其余库(本次场景下为Firebase相关xcframework) ->
Do not embed
- 绿色标记的第三方库,例如auth0、alamofire ->

内容的提问来源于stack exchange,提问作者infinity_coding7
相关产品推荐
相关产品推荐

