Ionic Cordova项目从Android9迁移至Android13遇构建工具缺失错误

1. 确认构建工具的安装状态 #

先通过命令核查已安装的Android构建工具版本：

sdkmanager --list_installed

查看输出的Build Tools板块，确认是否存在30.0.3或更高版本（如33.0.2）。若未安装，执行以下命令补装：

sdkmanager "build-tools;30.0.3"

权限不足时，在命令前添加sudo。

2. 校验环境变量配置 #

确保系统环境变量指向正确的SDK路径：

• 检查ANDROID_SDK_ROOT（或旧版ANDROID_HOME）的设置：

  echo $ANDROID_SDK_ROOT
  

  若未配置，在终端配置文件（~/.bashrc或~/.zshrc）中添加：

  export ANDROID_SDK_ROOT=/home/your-user/Android/Sdk
  export PATH=$PATH:$ANDROID_SDK_ROOT/build-tools:$ANDROID_SDK_ROOT/platform-tools
  

  执行source ~/.bashrc（或对应配置文件）使变更生效。

3. 强制指定Cordova使用的构建工具版本 #

在项目根目录的config.xml中添加配置，明确构建工具和目标SDK版本：

<platform name="android">
    <!-- 指定要求的构建工具版本 -->
    <preference name="android-buildToolsVersion" value="30.0.3" />
    <!-- 对应Android 13的targetSdkVersion -->
    <preference name="android-targetSdkVersion" value="33" />
</platform>

4. 清理并重新添加Android平台 #

旧平台的残留配置可能引发冲突，执行以下步骤重置：

# 移除现有Android平台
ionic cordova platform remove android
# 清理项目缓存
ionic cordova clean
# 重新添加Android 13平台
ionic cordova platform add android@13

5. 检查Gradle全局配置 #

打开~/.gradle/gradle.properties文件，确认是否存在android.sdk.dir配置，若缺失则手动添加：

android.sdk.dir=/home/your-user/Android/Sdk

确保路径与ANDROID_SDK_ROOT完全一致。

6. 修复SDK目录权限 #

若Gradle因权限问题无法读取构建工具，执行以下命令修改SDK目录权限：

sudo chown -R your-user:your-user /home/your-user/Android/Sdk

替换your-user为你的系统用户名。

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