React Native安卓应用启动失败：项目':app'中找不到'installDebug'任务

一、启动应用的解决步骤 #

1. 安装指定版本的Android SDK Build-Tools 30.0.2 #

• 打开Android Studio，进入设置面板（Windows/Linux：File > Settings；Mac：Android Studio > Settings）
• 导航到Appearance & Behavior > System Settings > Android SDK
• 在SDK Platforms标签页，勾选Show Package Details，找到Android 11 (API 30)并展开，勾选SDK Platform
• 切换到SDK Tools标签页，同样勾选Show Package Details，找到Android SDK Build-Tools，勾选30.0.2版本，点击Apply完成安装

2. 确认环境变量配置 #

• 确保ANDROID_HOME环境变量指向你的SDK安装目录：
  • Windows：C:\Users\<你的用户名>\AppData\Local\Android\Sdk
  • Mac/Linux：~/Library/Android/sdk
• 将$ANDROID_HOME/platform-tools和$ANDROID_HOME/tools添加到系统PATH中

3. 检查项目Gradle配置 #

• 进入项目的android目录，打开根目录下的build.gradle文件，确认：

  buildToolsVersion = "30.0.2"
  compileSdkVersion = 30
  

• 打开app模块下的build.gradle文件，确认：

  android {
      compileSdkVersion 30
      buildToolsVersion "30.0.2"
  
      defaultConfig {
          targetSdkVersion 30
          // 其他配置...
      }
  }
  

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

• 进入android目录，执行清理命令：
  • Mac/Linux：./gradlew clean
  • Windows：gradlew clean
• 回到项目根目录，重新执行yarn android

5. 兼容Gradle版本（可选） #

• 检查android/gradle/wrapper/gradle-wrapper.properties中的distributionUrl，确保Gradle版本与你的React Native版本兼容（旧RN版本通常对应Gradle 6.x或7.x）
• 若版本不匹配，修改distributionUrl后执行cd android && ./gradlew wrapper（或Windows对应命令）更新Gradle包装器

二、Gradle学习资源推荐 #

• Gradle官方用户指南：覆盖基础概念、任务配置、依赖管理等核心内容，从入门到进阶系统学习Gradle
• Android官方构建文档：聚焦Android项目的Gradle配置，包括构建变体、签名、依赖优化等，完全匹配RN裸项目的Android构建场景
• 《Gradle实战》书籍：深入讲解Gradle核心原理、自定义任务、插件开发，适合想彻底理解构建流程的开发者
• React Native官方Android构建文档：针对RN裸项目的Android构建流程和配置细节，快速对接现有项目需求

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