如何创建依赖Pods的Swift iOS Framework？引入Alamofire后跨工程失效

我之前也碰到过一模一样的问题！当你把集成了Alamofire这类第三方Pods的iOS Framework用到其他项目时，最容易踩的坑就是依赖库没有被正确打包或链接。下面是几个我亲测有效的解决思路，一步步来应该能搞定：

这是最基础的一步，很多问题都出在这。首先确保你的Podfile用了正确的配置来支持Framework集成：

platform :ios, '14.0'
# 如果要做静态Framework，推荐用这个配置，能把依赖打包进你的Framework
use_frameworks! :linkage => :static

target 'YourCustomFramework' do
  pod 'Alamofire', '~> 5.8' # 替换成你需要的版本
end

写完Podfile后，一定要执行pod install，并且用生成的.xcworkspace文件打开你的Framework项目，别再用原来的.xcodeproj了——这是很多人容易忽略的细节！

打开Framework项目的Build Settings，检查这几个关键项：

• Mach-O Type：如果想把Alamofire打包进Framework给其他项目直接用，选Static Library；如果坚持用动态Framework，选Dynamic Library（但后续目标项目也要同步依赖）。
• Other Linker Flags：如果是静态Framework，确保这里有-ObjC（CocoaPods一般会自动加，但可以确认下）。
• Framework Search Paths：应该包含$(PROJECT_DIR)/Pods路径，pod install通常会自动配置，要是没有的话手动加上。

这里给你掰扯清楚两者的区别，方便你选：

• 静态Framework：最省心的方案，能把Alamofire的代码直接打包进你的Framework里。其他项目引入你的Framework后，不需要再单独安装Alamofire，直接就能用。编译的时候，Xcode会把所有静态库合并成一个文件，不会有依赖缺失的问题。
• 动态Framework：如果必须用动态的，那目标项目的Podfile必须也添加相同版本的Alamofire，而且目标项目也要用.xcworkspace打开，确保依赖正确链接。不然运行时会出现dyld: Library not loaded这类找不到Alamofire的错误。

不管是静态还是动态，集成步骤要做对：

1. 把你编译好的YourCustomFramework.framework文件拖到目标项目的Frameworks, Libraries, and Embedded Content列表里。
2. 如果是动态Framework：设置Embed选项为Embed & Sign；如果是静态Framework：设置为Do Not Embed（因为静态库已经合并到目标项目的二进制里了，不需要嵌入）。

• 架构问题：编译Framework时要确保生成的是通用架构（支持真机+模拟器），不然在某类设备上运行会报错。可以用终端命令检查：lipo -info YourCustomFramework.framework/YourCustomFramework，输出里应该包含arm64（真机）和x86_64（模拟器）。
• 运行时符号错误：如果出现Undefined symbol这类错误，大概率是静态Framework的链接配置有问题，检查Other Linker Flags有没有加-ObjC或者-all_load，或者确认Podfile里的use_frameworks! :linkage => :static配置正确。

按照这些步骤走下来，应该就能解决你的问题了！我当时就是一开始用了动态Framework，又没在目标项目里同步依赖，折腾了好久才换成静态的搞定。

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