Swift Package Manager：如何仅为iOS条件性链接GoogleMobileAds？

核心问题原因 #

仅在Build Phases的Link Binary With Libraries里设置平台过滤没用——Swift Package的依赖是全局关联目标的，Xcode在解析依赖阶段就会为tvOS目标尝试查找GoogleMobileAds的适配版本，而该库本身不支持tvOS，因此报错。

具体解决步骤 #

1. 切断tvOS目标与GoogleMobileAds的Package依赖关联

   • 打开Xcode项目导航栏，选中你的项目根节点，切换到Package Dependencies标签页
   • 找到GoogleMobileAds依赖项，点击右侧的...按钮选择Add to Targets
   • 只勾选你的iOS目标，取消勾选tvOS目标。这样Swift Package只会为iOS目标下载、编译该库，tvOS构建流程完全不会触碰到这个依赖。

2. 清理构建缓存并重启Xcode

   • 按住Option键，点击Xcode顶部菜单栏的Product，选择Clean Build Folder
   • 手动删除项目对应的Derived Data目录：~/Library/Developer/Xcode/DerivedData/下匹配你项目名称的文件夹
   • 重启Xcode后再尝试构建tvOS目标

3. 确认代码层面的条件隔离正确
   所有涉及GoogleMobileAds的代码必须用iOS平台条件包裹，避免canImport判断（防止依赖残留导致误判）：

   #if os(iOS)
   import GoogleMobileAds
   #endif
   
   // 调用库的逻辑也要包裹
   #if os(iOS)
   func initializeAds() {
       GADMobileAds.sharedInstance().start(completionHandler: nil)
   }
   #endif
   

4. 检查tvOS目标的Build Settings

   • 选中tvOS目标，进入Build Settings标签页
   • 搜索Other Linker Flags，确保没有硬编码的GoogleMobileAds相关链接标记
   • 搜索Framework Search Paths，移除任何指向GoogleMobileAds xcframework的路径（如果存在）

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