如何强制使用PhoneGap cli-8.0.0并兼容Android与iOS？

我来帮你解决这个问题——强制PhoneGap Build使用cli-8.0.0同时兼容iOS和Android，之前的iOS构建失败大概率是配置细节没处理到位，下面是具体的步骤和注意事项：

1. 正确指定cli-8.0.0版本 #

首先，你需要在项目根目录的config.xml中明确声明要使用的PhoneGap CLI版本，放在<widget>根节点下即可：

<preference name="phonegap-version" value="cli-8.0.0" />

PhoneGap Build会优先使用这个配置，而不是默认的cli-6.5.0。如果之前你添加过这个配置但出问题，大概率是搭配了其他不兼容的设置，继续往下看。

2. 修复iOS构建失败的核心问题 #

cli-8.0.0对应的iOS平台版本是4.5.5，这个版本对iOS的最低系统版本和插件兼容性有要求，你需要做这些调整：

• 设置iOS部署目标：cli-8.0.0要求iOS最低版本为9.0，必须在config.xml中添加：

  <preference name="deployment-target" value="9.0" />
  

  之前如果没加这个，iOS构建会因为系统版本不匹配失败。
• 更新兼容的插件：旧版本的插件可能不支持cordova-ios@4.5.5，你需要检查所有<plugin>标签，把版本更新到支持cli-8.0.0的版本。比如：
  • 相机插件：cordova-plugin-camera@4.0.3（兼容cordova-ios 4.x）
  • 状态栏插件：cordova-plugin-statusbar@2.4.3
    如果插件没有指定版本，PhoneGap Build会拉取最新版，但有些最新版可能要求更高的cli版本，所以最好手动指定兼容cli-8.0.0的版本。
• 移除废弃配置：如果你的config.xml里还有旧的<gap:plugin>标签（PhoneGap旧语法），全部替换为标准的<plugin>标签；同时移除任何针对cli-6.x的特殊偏好设置，比如旧的iOS权限配置。

3. 确保Android构建兼容 #

cli-8.0.0对应的Android平台版本是7.0.0，针对Android的调整相对简单：

• 设置Android SDK版本：在config.xml中添加：

  <preference name="android-minSdkVersion" value="19" /> <!-- 对应Android 4.4，覆盖默认的16 -->
  <preference name="android-targetSdkVersion" value="26" /> <!-- cli-8.0.0默认的Android 8.0 -->
  

  这个范围可以覆盖绝大多数主流Android设备，同时符合平台要求。
• 插件兼容性检查：同样确保Android相关插件支持cordova-android@7.0.0，比如cordova-plugin-file@6.0.1这类稳定版本。如果遇到gradle相关的错误，可以尝试添加cordova-plugin-androidx-adapter插件（不过cli-8.0.0还没强制要求AndroidX，除非你的插件依赖）。

4. 测试构建的正确流程 #

• 先删除PhoneGap Build控制台中旧的构建记录，清理缓存；
• 重新打包你的源码为zip包（确保config.xml在根目录，不要嵌套）；
• 先单独构建iOS，查看控制台的错误日志——如果是插件报错，就更新对应插件版本；如果是权限问题，就在config.xml中补充对应的<platform name="ios">下的权限配置；
• iOS构建成功后，再构建Android，同样根据日志调整配置。

为什么之前配置会导致iOS构建损坏？ #

大概率是两个原因：一是没有设置deployment-target为9.0，导致cordova-ios@4.5.5无法编译；二是使用了不兼容的旧插件版本，插件内部的代码和新的iOS平台API冲突。按照上面的步骤调整后，应该可以解决问题。

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