Ionic Cordova Build Android报Unknown argument: platform错误如何解决

这个报错和Cordova Android平台本身的安装状态无关，核心是构建时的参数解析不兼容：

• 高版本Ionic CLI（v7及以上）调用Angular的ng子进程执行构建任务时，会默认向构建命令传入--platform参数
• 如果本地项目依赖的@ionic/angular-toolkit版本低于6.0.0、Angular构建链（@angular-devkit/build-angular）版本低于13，内置的参数解析逻辑无法识别--platform参数，就会直接抛出Error: Unknown Argument: Platform错误
• Ionic主进程捕获到ng子进程执行异常退出后，就会连带抛出[Error] An Error Occurred While Running Subprocess NG的提示

其他低概率触发场景：

• 执行构建命令时未处于项目根目录，CLI读取到错误配置，参数透传逻辑错乱
• 本地node_modules依赖安装损坏，参数解析脚本运行异常

• 第一步：对齐版本依赖
  先执行以下命令确认当前环境版本：
  ionic --version
npm list @ionic/angular-toolkit @angular-devkit/build-angular
  二选一调整版本即可：
  1. 保留高版本Ionic CLI：将本地项目的@ionic/angular-toolkit升级到6.0.0及以上版本，同时保证@angular-devkit/build-angular大版本和项目使用的Angular版本一致
  2. 不升级本地Angular依赖：将全局Ionic CLI降级到6.x版本，执行命令npm install -g @ionic/cli@6
• 第二步：清理重装依赖
  版本调整完成后，删除项目根目录下的node_modules文件夹和package-lock.json文件，重新执行npm install安装干净依赖，避免旧版本残留文件干扰构建逻辑
• 第三步：确认执行路径
  运行构建命令前，确认终端当前路径为项目根目录（目录下可直接看到ionic.config.json、angular.json、package.json三个核心配置文件），不要在src、platforms等子目录下执行构建命令
• 第四步：校验构建链路
  先单独执行ng build确认Angular原生构建流程可正常运行，再执行Cordova构建命令。如果仍有参数识别问题，可在构建命令中添加--明确分割Ionic接收参数和透传给ng的参数，临时绕过解析问题，示例命令：
  ionic cordova build android -- --configuration=production

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