使用Ionic发布APK时遇ANDROID_HOME、Gradle及ionic命令配置问题

最近在用Ionic开发APP，打包APK的最后几步接连踩坑，折腾了好一阵才解决，这里把遇到的问题和对应的解决方法整理出来：

1. ANDROID_HOME环境变量错误 #

打包时突然提示ANDROID_HOME未设置，这是因为系统找不到Android SDK的路径。解决方法很直接：

• 手动添加系统环境变量：右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
• 新建系统变量，变量名填ANDROID_HOME，变量值填你的Android SDK安装路径（比如C:\Users\你的用户名\AppData\Local\Android\Sdk）
• 再把%ANDROID_HOME%\platform-tools和%ANDROID_HOME%\tools这两个路径添加到系统的Path变量里
• 保存设置后重启命令行，再执行打包命令就可以正常识别SDK了

2. CordovaError：找不到已安装的Gradle版本 #

解决完ANDROID_HOME的问题后，又弹出这个错误，说找不到Gradle来安装包装器。这里有两个靠谱的解决方向：

• 方案一：安装Android Studio
  Android Studio会自动配置Gradle环境，而且后续更新SDK、Gradle都更省心，安装完成后重启命令行，Cordova就能自动识别到Gradle了。
• 方案二：手动配置Gradle路径
  去Gradle官网下载对应版本的压缩包，解压到电脑的某个路径（比如D:\Gradle\gradle-7.6），然后把该路径下的bin文件夹（比如D:\Gradle\gradle-7.6\bin）添加到系统Path变量里，重启命令行后输入gradle -v验证是否生效，生效后再执行打包命令即可。

3. 'ionic' 不是内部或外部命令错误 #

有时候打开新的命令行窗口，输入ionic命令会报这个错，原因是Node.js的全局模块路径没在系统Path里，或者ionic没全局安装：

• 先确认是否全局安装了Ionic CLI，执行命令：npm install -g @ionic/cli
• 然后用npm root -g查看Node.js全局模块的安装路径（一般是C:\Users\你的用户名\AppData\Roaming\npm）
• 把这个路径添加到系统Path变量里，重启命令行后再输入ionic -v，能显示版本号就说明没问题了

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