自定义Framework未找到报错,无法添加至FrameWorks文件夹求解决方案
解决自定义Framework“未找到”及无法添加问题的建议
检查Framework本身有效性
- 确认Framework是完整编译产物:需包含真机+模拟器的合并架构,可通过命令
lipo -info 你的Framework路径/Framework名称查看是否有arm64、x86_64等所需架构,单架构会导致特定环境下识别失败。 - 检查签名状态:右键Framework选择“显示包内容”,查看
Info.plist里的CFBundleIdentifier是否和项目签名团队匹配,或通过Xcode的“Signing & Capabilities”面板确认签名配置。
解决无法添加到FrameWorks文件夹的问题
- 拖拽Framework到Xcode的Frameworks目录时,务必勾选**“Copy items if needed”**和对应目标target;若拖拽无反应,可通过Xcode菜单操作:点击项目根目录→选择对应target→进入“General”标签页→在“Frameworks, Libraries, and Embedded Content”区域点击
+号,从本地路径选择Framework添加。 - 检查文件权限:右键Framework文件→选择“显示简介”,确保当前用户有读取&写入权限,权限不足会导致Xcode无法识别添加。
修复“Framework未找到”编译报错
- 配置Framework搜索路径:进入项目target的“Build Settings”→搜索
Framework Search Paths,添加Framework所在的本地路径(建议用$(SRCROOT)拼接,比如$(SRCROOT)/Frameworks),并设置为recursive(递归搜索)。 - 确认Embed方式:在“Frameworks, Libraries, and Embedded Content”里,将Framework的Embed选项设置为
Embed & Sign(开发阶段),Do Not Embed会导致运行时找不到。 - 清理缓存:执行Xcode菜单的
Product → Clean Build Folder(快捷键Cmd+Shift+K),重启Xcode后重新编译。
内容的提问来源于stack exchange,提问作者Steven
相关产品推荐
相关产品推荐

