使用CocoaPods的静态框架无法在主App中编译的问题排查

问题根源 #

你的静态框架WWAlertTesterFramework依赖AlertController这个Pod，但默认情况下，静态框架编译时不会将依赖的Pod代码打包进自身，仅保留模块引用。这就导致：

• 主App未引入AlertController时，编译阶段找不到对应模块，抛出Cannot load underlying module for 'AlertController'错误；
• 主App引入该Pod后，框架和主App各自包含一份AlertController的实现代码，链接时触发重复符号报错。

解决方案 #

核心思路是让静态框架编译时将依赖的Pod代码静态合并到框架内部，主App仅需引入框架即可，无需再单独引入Pod。

1. 配置框架的Pod依赖打包规则

如果你的框架通过Podfile管理依赖，修改WWAlertTesterFramework目录下的Podfile：

target 'WWAlertTesterFramework' do
  # 指定静态链接方式，让Pod代码合并到框架中
  use_frameworks! :linkage => :static
  pod 'AlertController'
end

如果你的框架使用podspec管理（更规范的组件化方式），在WWAlertTesterFramework.podspec中添加：

# 声明为静态框架
s.static_framework = true
# 添加依赖
s.dependency 'AlertController'

2. 重新编译框架

进入框架目录执行：

pod install

之后重新编译WWAlertTesterFramework工程，此时编译出的静态框架已经包含了AlertController的所有代码。

3. 主App仅引入框架

将编译好的WWAlertTesterFramework添加到主App项目中，无需在主App的Podfile中引入AlertController。此时编译主App，既不会出现模块找不到的错误，也不会有重复符号问题——因为所有依赖代码都已经打包在框架里，主App只链接这一份实现。

补充说明 #

静态框架和动态框架的依赖处理逻辑不同：动态框架可以依赖其他动态框架，运行时加载；但静态框架如果要对外隐藏依赖，必须将依赖的静态代码合并到自身，否则主App需要手动引入所有依赖，就会引发你遇到的问题。

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