Ionic Cordova安卓iOS构建问题：安卓模拟器测试报错

环境信息 #

• Node: v10.24.1
• Ionic: 5.4.16
• Cordova: 9.0.0

已执行操作（无报错） #

1. ionic cordova resources
2. ionic cordova platform add ios@6.1.1
3. ionic cordova platform add android

问题 #

在Android Studio模拟器中测试安卓应用时出现报错，已尝试升降级Node、Ionic、Cordova版本，问题未解决。

可能原因及解决方案 #

1. Android SDK 版本不兼容 #

• 查看项目platforms/android/project.properties文件，确认targetSdkVersion、compileSdkVersion与本地已安装的Android SDK版本匹配。
• 打开Android Studio的SDK Manager，安装对应版本的SDK Platform、Build Tools及必要组件。

2. Gradle 配置或缓存问题 #

• 检查platforms/android/build.gradle中的Gradle版本，确保本地已安装该版本。可在Android Studio的Gradle设置中切换到本地Gradle，避免自动下载失败。
• 清理Gradle缓存：

  cd platforms/android
  # Mac/Linux
  ./gradlew clean
  # Windows
  gradlew clean
  

  清理后重新执行ionic cordova build android。

3. 模拟器配置问题 #

• 确认模拟器的Android系统版本不低于项目minSdkVersion（在project.properties中查看）。
• 尝试创建新的模拟器实例，排除旧模拟器损坏的可能。

4. Cordova Android 平台版本不匹配 #

Cordova 9.0.0与cordova-android 8.x版本兼容性更稳定，尝试指定版本重新安装：

ionic cordova platform remove android
ionic cordova platform add android@8.1.0

5. 环境变量配置错误 #

• 确保ANDROID_SDK_ROOT（或ANDROID_HOME）环境变量指向正确的Android SDK安装路径。
• 确认PATH中包含$ANDROID_SDK_ROOT/platform-tools和$ANDROID_SDK_ROOT/tools（Mac/Linux），或对应Windows路径，保证adb命令可正常执行。

6. 项目依赖或插件冲突 #

• 执行cordova plugin list查看已安装插件，尝试移除近期添加的插件后重新测试。
• 清理项目缓存与依赖：

  rm -rf node_modules package-lock.json platforms plugins
  npm install
  ionic cordova platform add android
  

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