Ionic 2.5升级至Ionic 4后iOS运行报错：cordova.js缺失

1. 确认Capacitor配置与Cordova兼容性 #

• 检查capacitor.config.json，若已移除所有Cordova插件，删除文件中多余的cordova配置字段
• 确保webDir字段指向正确的Angular构建目录，通常为www

2. 清理index.html中的冗余脚本 #

• 移除index.html中手动添加的cordova.js或capacitor.js引入标签，Capacitor会在原生构建时自动注入这类脚本
• 删除旧Ionic/Cordova的初始化代码，比如ionicPlatform.ready()这类旧API调用

3. 彻底清理并重建项目 #

执行以下命令重置项目构建环境：

# 删除缓存与构建产物
rm -rf node_modules dist www
# 重新安装依赖
npm install
# 构建项目
ng build --prod
# 同步Capacitor配置到iOS
npx cap sync ios
# 打开Xcode项目
npx cap open ios

4. 检查Xcode中的Web资源 #

• 在Xcode中进入App > App > www目录，确认所有构建产物已正确同步
• 若www目录内容缺失，先执行npx cap copy ios再同步配置

5. 匹配Capacitor与Ionic 4版本 #

Ionic 4适配Capacitor 1.x版本，若当前版本过高，执行降级操作：

# 安装兼容版本的Capacitor
npm install @capacitor/core@1.x @capacitor/cli@1.x --save
# 重新同步配置
npx cap sync ios

6. 验证Angular构建配置 #

确认angular.json中构建输出路径正确，且生产配置已禁用优化：

"architect": {
  "build": {
    "options": {
      "outputPath": "www",
      ...
    },
    "configurations": {
      "production": {
        "buildOptimizer": false,
        "optimization": false,
        ...
      }
    }
  }
}

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