Mac环境下Ionic构建Android模拟器时Gradle PATH配置问题

我之前也碰到过类似的困惑，给你整理几个关键步骤来搞定这个问题：

1. 别加整个项目目录，只加核心工具路径 #

你不需要把Android Studio的项目目录加到PATH里，而是要把几个Android开发必需的工具路径加进去，这些才是Cordova/Ionic真正需要的：

• Android SDK Platform Tools：默认路径是 ~/Library/Android/sdk/platform-tools，包含adb等关键工具
• Android SDK Tools（旧版SDK需要，新版可选择性添加）：~/Library/Android/sdk/tools
• Android Studio自带的Gradle：路径在Android Studio安装目录下，比如 /Applications/Android Studio.app/Contents/gradle/gradle-7.5/bin（把7.5换成你Android Studio实际用的Gradle版本，可在Android Studio偏好设置的Build, Execution, Deployment > Gradle里查看）

把这些路径添加到你的shell配置文件里（比如~/.zshrc或~/.bash_profile），示例代码：

# 配置Android相关工具路径
export PATH="$PATH:~/Library/Android/sdk/platform-tools"
export PATH="$PATH:~/Library/Android/sdk/tools"
# 配置Android Studio自带的Gradle
export PATH="$PATH:/Applications/Android Studio.app/Contents/gradle/gradle-7.5/bin"

添加后执行source ~/.zshrc（对应你的配置文件）让改动立即生效。

2. 告诉Cordova用Android Studio的Gradle，不用单独下载 #

设置GRADLE_HOME环境变量指向Android Studio自带的Gradle目录，这样Cordova就会直接用这个版本，不用自己下载：

export GRADLE_HOME="/Applications/Android Studio.app/Contents/gradle/gradle-7.5"

同样把这行加到你的shell配置文件里，source生效。

3. 确保ANDROID_HOME变量正确设置 #

这是很多人容易忽略的点，Cordova需要这个变量来定位Android SDK：

export ANDROID_HOME="~/Library/Android/sdk"

把这行也加入到shell配置文件中。

4. 解释“报错但显示[OK]”的奇怪现象 #

这种情况一般是构建过程中出现了非致命的警告或小错误（比如模拟器启动超时、某个资源文件的小问题），但核心的APK部署流程还是完成了。你可以执行ionic cordova emulate android --verbose查看详细日志，定位具体的问题点——比如是不是模拟器没有提前启动，或者adb连接有小故障，这些都不会影响最终的APK部署，但会抛出错误提示。

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