Android构建失败报错无法安装应用，已尝试多种缓存操作仍未解决

问题详情 #

构建报错：Failed to install the app. Make sure you have the Android development environment set up
已尝试无效操作：

• 重置缓存文件
• Android Studio中执行Invalidate Caches / Restart
• 清除Android Studio数据
• 重置Bundler缓存

排查解决步骤 #

• 校验Android SDK环境
  1. 打开Android Studio的Settings > Appearance & Behavior > System Settings > Android SDK，确认已安装对应版本的SDK Platform、SDK Build-Tools（建议选稳定版）、Android SDK Command-line Tools（最新版）。
  2. 检查系统环境变量：
     • 确认ANDROID_HOME（或ANDROID_SDK_ROOT）指向SDK安装目录（例：Windows为C:\Users\<用户名>\AppData\Local\Android\Sdk，Mac为~/Library/Android/sdk）
     • 将$ANDROID_HOME/platform-tools和$ANDROID_HOME/tools添加到系统PATH变量中
• 检查设备连接状态
  1. 执行命令 adb devices，确认设备显示为device状态（模拟器需正常启动，真机需开启USB调试并授权）。
  2. 若设备未识别，重启adb服务：执行adb kill-server，再运行adb start-server
• 核对项目Gradle配置
  1. 查看项目根目录build.gradle，确保compileSdkVersion、targetSdkVersion与已安装的SDK版本一致。
  2. 检查gradle/wrapper/gradle-wrapper.properties中的distributionUrl，若gradle版本过旧，替换为稳定版地址（例：https\://services.gradle.org/distributions/gradle-7.5-bin.zip）
• 清理并重新构建
  1. 终端执行 ./gradlew clean（Mac/Linux）或 gradlew clean（Windows）清理构建缓存
  2. 执行 ./gradlew assembleDebug（Mac/Linux）或 gradlew assembleDebug（Windows）手动构建，查看详细报错日志
• 检查设备存储空间
  确保测试设备（真机/模拟器）剩余存储空间充足，避免因空间不足导致安装失败

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