安装含不同命名OpenSSL依赖的两个Pods时的冲突问题求助

问题背景 #

我们有两个Pods：Openpath和CGModule，二者各自带有依赖项。CGModule依赖openssl.xcframework，Openpath依赖OpenSSL-Universal（内含OpenSSL.xcframework）——这两个框架本质是同一库，仅命名大小写不同。

执行pod install时触发报错：

target has frameworks with conflicting names: openssl.xcframework

尝试过两种方案但均未解决问题：

• 直接将CGModule.xcframework加入应用项目，仅通过Podfile安装Openpath：pod install和构建能成功完成，但运行时系统只会加载一个OpenSSL框架，且CGModule需导入openssl、Openpath需导入OpenSSL，导致应用启动时因导入不匹配崩溃。
• 将两个Pods分别放入子项目：构建后仍仅加载一个OpenSSL框架，冲突问题未得到解决。

推测原因：OpenSSL早期版本将xcframework命名为openssl.xcframework，后续新版本改为OpenSSL.xcframework，命名不一致导致CocoaPods识别为两个不同框架，从而触发冲突；若命名一致则会自动使用新版本，两个Pods均可正常依赖。

可行解决方案 #

方案1：统一框架名称（推荐） #

找到CGModule依赖的openssl.xcframework，将其重命名为OpenSSL.xcframework，同时修改CGModule的Podspec文件中对应依赖的名称，确保和Openpath依赖的框架名称完全一致。操作步骤：

1. 定位到CGModule依赖的openssl.xcframework所在的本地路径
2. 重命名框架文件夹为OpenSSL.xcframework
3. 编辑CGModule的Podspec，将依赖项中的openssl.xcframework替换为OpenSSL.xcframework
4. 重新执行pod install

方案2：用Podfile的post_install钩子自动修正 #

在项目的Podfile中添加以下脚本，自动在安装后修改冲突框架的名称和相关配置：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    next unless target.name == 'CGModule'
    
    # 找到CGModule依赖的openssl.xcframework引用
    framework_file = target.frameworks_build_phase.files.find { |file| file.path.include?('openssl.xcframework') }
    next unless framework_file
    
    # 替换框架名称
    framework_file.path = framework_file.path.gsub('openssl.xcframework', 'OpenSSL.xcframework')
    
    # 更新框架搜索路径
    target.build_configurations.each do |config|
      if config.build_settings['FRAMEWORK_SEARCH_PATHS']
        config.build_settings['FRAMEWORK_SEARCH_PATHS'] = config.build_settings['FRAMEWORK_SEARCH_PATHS'].map do |path|
          path.gsub('openssl.xcframework', 'OpenSSL.xcframework')
        end
      end
    end
  end
end

添加完成后执行pod install，脚本会自动统一框架名称，消除冲突。

方案3：替换CGModule的依赖源 #

如果CGModule允许替换依赖，可以直接在Podfile中指定其使用OpenSSL-Universal替代原有的openssl.xcframework：

pod 'CGModule', :podspec => './path/to/CGModule.podspec', :replace_dependency => 'openssl' => 'OpenSSL-Universal'

注意：使用此方案前需确认OpenSSL-Universal的版本兼容CGModule的功能需求。

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