多Target Xcode工作区Common模块引入Pod启动报错的最优解决方法

问题根源 #

当你将some_pod添加到Common模块（Target），而Main Target依赖Common时，CocoaPods默认可能没有正确处理依赖传递：

• 如果Common是动态库：其依赖的some_pod框架需要被嵌入到最终的Main Target中，否则dyld找不到该框架。
• 如果Common是静态库：依赖的some_pod应该被合并到Common中，但Podfile配置错误可能导致搜索路径缺失。

手动添加框架到Main Target能临时解决问题，但不符合CocoaPods的依赖管理逻辑，后续容易出现配置遗漏。

最优解决方式：正确配置Podfile让依赖自动传递 #

1. 调整Podfile配置 #

根据你的项目结构，修改Podfile确保Common的依赖能被Main Target自动识别：

示例Podfile（针对独立Target的场景）

workspace 'MainApp'

# 配置Common Target
target 'Common' do
  platform :ios, '14.0'
  use_frameworks! # 若需静态库，改为 use_frameworks! :linkage => :static

  pod 'some_pod'
end

# 配置Main Target
target 'MainTarget' do
  platform :ios, '14.0'
  use_frameworks!

  # 关联项目中的多个Target，确保CocoaPods识别依赖关系
  project 'MainApp.xcodeproj', 'MainTarget' => :ios, 'Common' => :ios

  # 继承Common的依赖配置（动态库场景用:complete，静态库场景用:search_paths）
  inherit! :complete
end

2. 重新安装Pods #

执行以下命令清理并重新生成Pods配置：

pod deintegrate
pod install

3. 验证配置 #

打开MainApp.xcworkspace，检查Main Target的Frameworks, Libraries and Embedded Content：

• 若Common是动态库：some_pod.framework会被自动添加，状态为Embed & Sign。
• 若Common是静态库：some_pod.framework状态为Do Not Embed（因为已合并到Common中）。

额外检查项 #

如果问题仍存在，可排查以下配置：

• 确认Main Target的LD_RUNPATH_SEARCH_PATHS包含@executable_path/Frameworks和@loader_path/Frameworks（CocoaPods默认会配置，若被手动修改需恢复）。
• 确认Common Target的FRAMEWORK_SEARCH_PATHS包含Pods相关路径（CocoaPods自动生成，无需手动修改）。

内容的提问来源于stack exchange，提问作者Burak Akyalçın