Ionic/Cordova 旧项目环境配置：工具链版本与常用命令

2018 年的 Ionic 环境笔记把 Node、JDK、Android SDK、Ant 和多代 CLI 命令放在一起。恢复旧项目时，不能照着“全部装最新版”执行；每个工具各自升级，可能反而让原项目更难构建。

先保存版本和项目配置

记录 package.json、锁文件、config.xml、插件与平台列表，再查看当前入口：

node --version
npm --version
java -version
ionic info
cordova platform ls
cordova plugin ls

Ionic CLI、Cordova CLI 和 cordova-android 是不同组件，JDK 与 Gradle 的兼容还需按平台包版本确认。归档 Android 指南也区分 CLI 与平台版本；不能从旧清单推导所有项目都需要 Ant。Cordova 8.x Android 指南

JAVA_HOME 指向 JDK，SDK 位置和 platform-tools 等路径按实际安装确认，再在新终端查看命令解析结果。路径含空格时应由正确引用和工具支持处理，不能概括成“有空格的 JDK 路径都无效”。

旧 SDK Manager 的 android 命令、手工 CLASSPATH 与 tools.jar 清单，不应当作新 JDK 或当前 Android SDK 的通用安装步骤。

当 CLI 提示 platform 命令已改名时，先看相应帮助：

ionic cordova platform --help

支持这一代子命令的 CLI 使用 ionic cordova platform，而不是拼错的 platfrom。Ionic 命令文档

创建项目的基本结构曾是 ionic start demo blank，tabs 等模板需由对应版本支持；start 和项目名之间必须有空格。不要先创建 demo 目录又在里面无意嵌套一个同名工程。

在依赖和平台版本已锁定、支持这些入口的既有项目中，常见命令为：

ionic cordova build android
ionic cordova emulate android
ionic cordova run android
ionic serve

添加平台、构建和运行可能下载资源、生成文件或向设备安装应用，应在备份与版本控制下进行，不能把命令当只读检查。添加 Android 平台前，应先选择经过验证的 cordova-android 版本，而不是任意解析新版本。

serve 用于浏览器预览，不证明 SQLite、相机或文件等原生插件可用。原生构建成功也不代表真机权限和后端访问正常；网络地址问题可另看设备后端地址笔记。