CocoaPods多目标依赖歧义求助：DynamicColor链接器标志冲突问题

问题场景 #

项目包含两个Target：

• 主App Target MyApp，最低支持iOS 13.0
• Widget扩展Target MyAppWidgetExtension，最低支持iOS 14.0
  两者均通过共用的commandPod方法引入DynamicColor库，执行pod install后出现链接器歧义报错：

Multiple targets match implicit dependency for linker flags '-framework DynamicColor'. Consider adding an explicit dependency on the intended target to resolve this ambiguity.
Target'DynamicColor-iOS13.0'（in project 'Pods'）
Target 'DynamicColor-iOS14.0' （in project 'Pods')

原因分析 #

由于两个Target的最低系统版本不同，CocoaPods为DynamicColor生成了两个对应不同iOS版本的Target，链接器无法自动判断使用哪个版本，因此抛出歧义错误。

解决方案 #

方案1：统一依赖库的最低部署版本（推荐） #

修改post_install脚本，默认让所有第三方依赖库的最低部署版本与主Target保持一致（iOS13.0），仅对需要iOS14的本地库单独设置版本：

source 'https://github.com/CocoaPods/Specs.git'

use_frameworks!
inhibit_all_warnings!

def commandPod
  pod 'DynamicColor'
end


target 'MyApp' do
  platform :ios, '13.0'
  commandPod
  pod 'JXPagingView/Paging'
  pod 'JXSegmentedView'
  pod 'LookinServer',             :subspecs => ['Swift'], :configurations => ['Debug']
end

target 'MyAppWidgetExtension' do
  platform :ios, '14.0'
  commandPod
  pod 'AttributedText',         :path => '../AttributedText'
end

touch_ios_14 = ['AttributedText']

post_install do |installer|
  installer.pods_project.targets.each do |target|
    puts "[post_install] target #{target}"
    target.build_configurations.each do |config|
      # 默认依赖库用iOS13.0，仅指定本地库用iOS14.0
      base_deployment_target = '13.0'
      base_deployment_target = '14.0' if touch_ios_14.include?(target.name)
      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = base_deployment_target
      config.build_settings['CODE_SIGN_IDENTITY'] = ''
    end
  end
end

这种方式下CocoaPods只会生成一个DynamicColor Target，从根源避免版本歧义。

方案2：为每个Target显式指定依赖关联（适合必须保留不同部署版本的场景） #

如果业务要求DynamicColor在Widget Target中必须使用iOS14版本，可修改Podfile为每个Target单独声明依赖，并显式指定链接关系：

source 'https://github.com/CocoaPods/Specs.git'

use_frameworks!
inhibit_all_warnings!

# 主App依赖集合
def mainAppPods
  pod 'DynamicColor'
  pod 'JXPagingView/Paging'
  pod 'JXSegmentedView'
  pod 'LookinServer', :subspecs => ['Swift'], :configurations => ['Debug']
end

# Widget依赖集合
def widgetPods
  pod 'DynamicColor'
  pod 'AttributedText', :path => '../AttributedText'
end

target 'MyApp' do
  platform :ios, '13.0'
  mainAppPods
end

target 'MyAppWidgetExtension' do
  platform :ios, '14.0'
  widgetPods
  # 显式指定该Target链接对应版本的DynamicColor
  pod 'DynamicColor', :link_with => 'MyAppWidgetExtension'
end

touch_ios_14 = ['AttributedText']

post_install do |installer|
  installer.pods_project.targets.each do |target|
    puts "[post_install] target #{target}"
    target.build_configurations.each do |config|
      if touch_ios_14.include?(target.name)
        config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '14.0'
      else
        # 区分DynamicColor的不同版本Target，分别设置部署版本
        if target.name.include?('DynamicColor-iOS14')
          config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '14.0'
        else
          config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '13.0'
        end
      end
      config.build_settings['CODE_SIGN_IDENTITY'] = ''
    end
  end
end

此方案会增加配置维护成本，仅在特殊场景下使用。

方案3：让Widget Target继承主Target的依赖配置 #

如果Widget Target的依赖与主Target高度重合，可通过inherit! :complete让它继承主Target的依赖配置，避免重复声明：

source 'https://github.com/CocoaPods/Specs.git'

use_frameworks!
inhibit_all_warnings!

target 'MyApp' do
  platform :ios, '13.0'
  pod 'DynamicColor'
  pod 'JXPagingView/Paging'
  pod 'JXSegmentedView'
  pod 'LookinServer', :subspecs => ['Swift'], :configurations => ['Debug']

  target 'MyAppWidgetExtension' do
    platform :ios, '14.0'
    inherit! :complete
    pod 'AttributedText', :path => '../AttributedText'
  end
end

touch_ios_14 = ['AttributedText']

post_install do |installer|
  installer.pods_project.targets.each do |target|
    puts "[post_install] target #{target}"
    target.build_configurations.each do |config|
      base_deployment_target = '13.0'
      base_deployment_target = '14.0' if touch_ios_14.include?(target.name)
      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = base_deployment_target
      config.build_settings['CODE_SIGN_IDENTITY'] = ''
    end
  end
end

继承配置后，CocoaPods会为共用依赖生成单一Target，自动解决链接歧义。

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