如何创建含内部框架的Cocoa Touch Framework？导入遇问题求助

我来帮你拆解这两个问题，先从根源说起，再解答你的疑问，最后给你具体的排查步骤：

核心问题的本质 #

你遇到的第一个运行错误dyld: Library not loaded: Reason: image not found，核心原因是你的框架依赖了通过CocoaPods安装的第三方库，但你只移动了自己的test.framework，没把这些依赖的库一起带到目标项目里。CocoaPods默认会把第三方依赖编译成动态库，这些库并没有被合并到你的test.framework中，所以运行时系统找不到这些缺失的依赖。

而第二个项目无法访问框架内部代码，大概率是框架的符号暴露设置或者头文件配置有问题，和你是否移动文件的操作无关。

你的两个疑问解答 #

1. 能否仅通过移动test.framework文件来连接框架？

分两种情况：

• 如果你的框架是静态框架，且没有任何外部依赖（没用CocoaPods装第三方库），直接移动.framework文件是完全可行的；
• 但你的框架用了CocoaPods引入依赖，且默认是动态依赖的话，只移动test.framework肯定不行——因为依赖的动态库不在目标项目里，运行时会找不到。

2. 若必须采用上述方式，理论上是否可行？之前的操作是否有误？

理论上可行，但你遗漏了最关键的一步：必须把框架依赖的所有第三方库也一起复制到目标项目中并正确配置。你的操作只移动了自己的框架，没处理依赖，这是核心错误。

另外第二个项目无法访问内部代码，不是移动操作的问题，而是框架本身的配置问题（比如头文件没公开、符号被隐藏）。

具体排查与解决步骤 #

针对第一个项目的dyld错误解决 #

1. 确认依赖库的位置
   打开你的框架项目，找到Pods目录下的所有依赖库（比如AFNetworking.framework这类），把这些.framework文件也复制到目标项目中。
2. 配置目标项目的依赖
   在目标项目的Build Phases中：
   • 把复制过来的依赖库添加到Link Binary With Libraries；
   • 同时添加到Embed Frameworks（确保Code Sign On Copy勾选）。
3. 检查框架的依赖路径
   用终端命令查看你的test.framework的依赖路径：

   otool -L /path/to/test.framework/test
   

   如果输出里的依赖库路径是绝对路径（比如指向你原框架项目的路径），需要修改为@rpath开头的路径。你可以用install_name_tool命令修改：

   install_name_tool -change 原依赖路径 @rpath/依赖库名称.framework/依赖库名称 /path/to/test.framework/test
   

   同时确保目标项目的Build Settings中Runpath Search Paths包含@executable_path/Frameworks和@loader_path/Frameworks。

针对第二个项目无法访问内部代码的解决 #

1. 检查Public头文件配置
   打开你的框架项目，进入Build Phases → Headers：
   • 把你需要对外暴露的类/方法的头文件从Project或Private组拖到Public组；
   • 确保头文件里的类和方法是公开的（比如@interface MyClass : NSObject，没有@private限制，方法声明在头文件里）。
2. 调整符号隐藏设置
   在框架项目的Build Settings中：
   • 把Symbols Hidden by Default设为NO（动态框架下，这个设置会隐藏未公开的符号，导致外部看不到）；
   • 把Strip Debug Symbols During Copy设为NO，避免符号被剥离。
3. 确认导入方式
   在目标项目中导入框架时，要使用框架的模块导入方式：

   #import <test/MyPublicClass.h>
   

   而不是直接导入头文件路径。

更可靠的替代方案（推荐） #

手动移动.framework很容易踩坑，推荐两种更稳定的方式：

• 做成CocoaPods私有库：把你的框架打包成私有Pod，目标项目直接通过Podfile引入，CocoaPods会自动处理所有依赖和配置；
• 添加为子项目：在目标项目中直接添加框架项目作为子项目，通过Target Dependencies关联，再把框架添加到Embed Frameworks，这样编译时会自动同步依赖和配置。

内容的提问来源于stack exchange，提问作者Yume