仅用命令行工具开发Android时SDK路径配置无效问题求助

核心问题排查与修复 #

1. 修复路径缺失根目录的问题 #

你的环境变量和local.properties中的路径都缺少根目录/，导致系统无法识别为有效绝对路径：

• 修改~/.bash_profile中的配置：

  export ANDROID_HOME=/Users/folder1/Android
  export PATH=$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/cmdline-tools/latest/bin
  export ANDROID_SDK_ROOT=/Users/folder1/Android
  

  注意：将原配置中的$ANDROID_HOME/tools替换为$ANDROID_HOME/cmdline-tools/latest/bin——新版命令行工具的sdkmanager位置已变更。

• 修改local.properties中的路径：

  sdk.dir=/Users/folder1/Android
  

2. 调整cmdline-tools目录结构 #

Android命令行工具要求必须放在cmdline-tools/latest目录下，否则Gradle无法正确识别SDK工具链：

1. 在Android/cmdline-tools目录下创建latest子文件夹
2. 将cmdline-tools下的所有文件（如bin、lib等）移动到latest目录中
   最终目录结构应为：

Android:
/build-tools
/cmdline-tools
  /latest
    /bin
    /lib
/licences
/platform-tools
/platforms

3. 确保环境变量生效 #

• 若使用Mac默认的Zsh终端，需将环境变量配置同步到~/.zshrc，或在~/.zshrc末尾添加：

  source ~/.bash_profile
  

• 执行命令使配置立即生效：

  source ~/.bash_profile
  # 若用Zsh则执行
  source ~/.zshrc
  

• 验证配置：执行echo $ANDROID_HOME，输出应为/Users/folder1/Android；执行sdkmanager --list，若能正常列出SDK组件则说明配置正确。

4. 核对项目Gradle配置 #

检查项目根目录或app模块下的build.gradle文件，确保版本与已安装的SDK匹配：

android {
    compileSdkVersion 35
    buildToolsVersion "35.0.0" // 确保已安装对应版本的build-tools
    // ...其他配置
}

5. 清理缓存并重新构建 #

执行以下命令清理构建缓存后重新尝试：

./gradlew clean
./gradlew build --warning-mode all

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