You need to enable JavaScript to run this app. Xcode 12.5迁移至xcframework时dyld: Library not loaded错误解决
优惠活动
大模型
产品
解决方案
定价
更多

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到Frameworks组
关联target设置

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

设置embed状态


内容的提问来源于stack exchange,提问作者infinity_coding7

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.19 08:36:03