CocoaPods依赖冲突：Alamofire5.0.4与MyFramework依赖4.9.0如何共存编译

原生CocoaPods默认会对同一Pod的依赖版本做全局对齐，直接声明两个版本的同一Pod会直接触发版本冲突报错，要实现双版本共存核心是做编译符号隔离，以下是两个可落地的无业务代码改动方案：

方案一：预编译MyFramework为内嵌Alamofire 4.9.0的xcframework（推荐） #

• 操作步骤：
  1. 拉取MyFramework 2.0.0的源码，保留其原有~>4.9.0的Alamofire依赖声明，不改动任何MyFramework业务代码
  2. 编译MyFramework为xcframework时，将Alamofire 4.9.0源码与MyFramework源码合并编译，配置编译参数隐藏所有Alamofire相关的对外符号：可通过编译配置加OTHER_LDFLAGS = -unexported_symbols_list，将所有Alamofire符号加入隐藏列表，仅暴露MyFramework自身的公开API
  3. 修改MyFramework的podspec配置，删除原有Alamofire依赖声明，新增vendored_frameworks指向刚才打包完成的、内嵌了Alamofire 4.9.0的xcframework
  4. 主工程Podfile保持原有配置不变：

  pod 'Alamofire', '5.0.4'
  pod 'MyFramework', '2.0.0'
  

• 效果：主工程代码直接链接独立的Alamofire 5.0.4；MyFramework内部使用的是自身二进制内嵌的、符号对外隐藏的Alamofire 4.9.0，两者无符号冲突，无需改动任何业务代码。

方案二：按Target隔离依赖编译 #

适合MyFramework作为独立组件Target集成在主工程的场景，操作步骤：

• 1. 修改Podfile配置，将两个版本的Alamofire分别绑定到独立的Target，避免全局版本冲突：

  # 主App Target，仅依赖Alamofire 5.0.4
  target 'MainApp' do
    use_frameworks! => :static
    pod 'Alamofire', '5.0.4'
  end
  
  # MyFramework专属Target，仅依赖Alamofire 4.9.0
  target 'MyFramework' do
    use_frameworks! => :static
    pod 'Alamofire', '~> 4.9.0'
    pod 'MyFramework', '2.0.0'
  end
  

• 2. 新增post_install钩子，强制隐藏MyFramework侧Alamofire 4.9.0的对外符号，避免和主工程侧的Alamofire 5.0.4冲突：

  post_install do |installer|
    installer.pods_project.targets.each do |target|
      # 仅处理Alamofire 4.9.0版本的Target
      if target.name == 'Alamofire' && target.version.to_s.start_with?('4.')
        target.build_configurations.each do |config|
          # 配置符号隐藏列表，将所有Alamofire 4.x的符号设为不对外导出
          config.build_settings['OTHER_LDFLAGS'] ||= '$(inherited) -unexported_symbols_list ${PODS_TARGET_SRCROOT}/alamofire_4_unexported_symbols'
        end
      end
    end
  end
  

注：alamofire_4_unexported_symbols为自定义的符号隐藏列表文件，可通过导出Alamofire 4.9.0的所有符号生成，仅需保留不对外暴露的Alamofire符号即可。

• 效果：主App Target编译时仅链接Alamofire 5.0.4，MyFramework Target编译时使用独立的Alamofire 4.9.0，通过符号隐藏避免两者冲突，全程无需改动业务代码。

注意：上述方案为临时过渡方案，待MyFramework完成Alamofire 5.x适配后，可直接移除符号隔离配置，全局统一使用Alamofire 5.0.4即可。

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