Ionic构建Android应用时ANDROID_SDK_ROOT未定义及Gradle缺失问题求助

第一阶段：修复ANDROID_SDK_ROOT未识别的问题 #

从你最初的错误日志来看，终端无法读取ANDROID_SDK_ROOT和ANDROID_HOME变量，即便你认为环境变量配置正确，可能存在以下几个原因及解决办法：

• 环境变量未生效：修改系统环境变量后，必须重启VSCode或打开新的终端窗口，旧终端不会加载新的环境变量。你可以在新终端中输入echo %ANDROID_SDK_ROOT%，验证变量是否能正确输出。
• SDK路径配置错误：ANDROID_SDK_ROOT需要指向Android SDK的根目录（比如C:\Program Files (x86)\Android\android-sdk），而非里面的tools子文件夹。从你后续更新的日志能看到，之前你把路径设成了tools，这会导致Cordova无法识别完整的SDK结构。
• PATH未包含必要的SDK目录：确保系统PATH里添加了以下关键路径：
  • %ANDROID_SDK_ROOT%\platform-tools（包含adb等核心工具）
  • %ANDROID_SDK_ROOT%\tools
  • %ANDROID_SDK_ROOT%\build-tools\[你的build-tools版本号]（比如30.0.3，可在SDK目录下查看已安装的版本）

第二阶段：解决Gradle未找到的问题 #

修复SDK路径后出现了Gradle相关错误，结合你提到“已安装Android Studio但从未运行过”，这是核心问题：

• 首次启动Android Studio完成初始化：Android Studio第一次启动时，会自动下载并配置必要组件，包括Gradle、Android SDK缺失的依赖等。你需要打开Android Studio，按照引导完成初始化（可能需要等待一段时间下载文件），这一步能让Cordova自动识别到Android Studio内置的Gradle。
• 验证Gradle可用性：初始化完成后，打开新终端输入gradle -v，如果能输出版本信息，说明Gradle已被正确识别。
• 手动配置Gradle（若自动识别失败）：
  1. 查看项目中platforms/android/gradle/wrapper/gradle-wrapper.properties文件里的distributionUrl，确认所需的Gradle版本。
  2. 下载对应版本的Gradle，解压到本地目录（比如C:\Gradle）。
  3. 添加系统环境变量GRADLE_HOME指向该解压目录，再把%GRADLE_HOME%\bin添加到PATH中。
  4. 重启终端，再次运行ionic cordova build android --verbose。

最后验证 #

完成以上步骤后，重新运行ionic cordova build android，应该能正常完成编译。如果仍有问题，可以检查Java环境变量（确保JAVA_HOME指向JDK根目录，且%JAVA_HOME%\bin在PATH中）。

内容的提问来源于stack exchange，提问作者Cristian Garcia Blasco