Ionic开发iOS应用：部署目标设为10.x时构建失败

这问题我之前帮好几个开发者排查过，核心原因很明确：GoogleToolboxForMac（简称GTM）这个库已经不再支持iOS 10及以下版本了。当你把部署目标降到10.x时，Ionic或CocoaPods的构建流程会尝试拉取适配低版本的GTM，但要么找不到对应的兼容版本，要么拉到的版本在链接阶段缺失必要的库文件，最终导致构建失败。

下面是几个经过验证的解决步骤，你可以按顺序尝试：

1. 锁定GTM的兼容版本（CocoaPods方式） #

如果你的项目用CocoaPods管理iOS依赖，直接在项目根目录的Podfile里添加或修改GTM的版本指定：

pod 'GoogleToolboxForMac', '~> 2.2.0'

这个2.2.0版本是GTM最后支持iOS 10的稳定版本。修改后执行：

pod install --repo-update

更新完依赖后再重新构建项目。

2. 彻底清理构建缓存 #

缓存残留是这类问题的常见诱因，咱们把所有相关缓存清一遍：

• 先清理Ionic/Cordova的构建缓存：

  ionic cordova clean ios
  

• 打开Xcode，执行Product -> Clean Build Folder（快捷键Cmd+Shift+K）
• 手动删除Xcode的DerivedData文件夹（彻底清除编译缓存）：

  rm -rf ~/Library/Developer/Xcode/DerivedData
  

3. 检查并调整Ionic插件的依赖 #

很多Ionic插件（比如Google Maps、Firebase相关的插件）会间接依赖GTM。你可以先查看已安装的插件列表：

cordova plugin list

找到依赖GTM的插件后，要么更新到支持iOS 10的版本，要么替换为兼容的插件版本。比如某些旧版的cordova-plugin-firebase会强制拉取高版本GTM，这时可以换成支持iOS 10的分支或版本。

4. 手动添加GTM库（极端情况） #

如果上面的方法都无效，你可以手动引入兼容版本的GTM：

• 下载GTM 2.2.0版本的源码（对应tag的压缩包）
• 解压后，把GoogleToolboxForMac文件夹拖到你的Xcode项目中，勾选「Copy items if needed」，并确保关联到你的app target
• 在Xcode的Build Phases -> Link Binary With Libraries里，确认已经添加了GTM的库文件

额外提醒 #

iOS 10已经是非常老旧的版本了，苹果官方早已停止维护，用户占比也极低。如果不是业务强制要求，建议尽量保持部署目标在11.0及以上，这样能避免很多依赖兼容问题，也能用上更多新特性。

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