Flutter无法部署至Android设备问题求助

环境信息 #

• Flutter 3.19.6（最新稳定版）
• Android Studio Jellyfish 2023.3.1（最新版）
• Gradle版本：7.6.3
• Java JDK：19（此前使用过22和21，Flutter/Gradle提示支持Java 19）

报错历程 #

1. 最初报错：
   
2. 更新SDK构建工具后，出现新报错：
   
   
   

解决方案 #

1. 修正Java版本（核心问题） #

Gradle 7.6.3官方仅支持Java 8、11、17，JDK19不在兼容列表内，这是导致构建失败的关键：

• 安装Java 17（推荐OpenJDK 17）
• 在Android Studio中切换JDK：
  1. 打开File > Project Structure（快捷键Ctrl+Alt+Shift+S）
  2. 进入SDK Location，在JDK location选择JDK17的安装路径
  3. 修改项目根目录下的gradle.properties，添加：

     org.gradle.java.home=/你的JDK17安装路径
     

2. 同步SDK与Gradle配置 #

• 打开Android Studio的SDK Manager：
  • 确认SDK Platforms中安装了与项目compileSdkVersion一致的Android版本
  • 确认SDK Tools中Android SDK Build-Tools的版本和项目build.gradle中指定的buildToolsVersion完全匹配
• 检查项目android/build.gradle：
  确保compileSdkVersion、targetSdkVersion、buildToolsVersion均为已安装的有效版本
• 检查android/gradle/wrapper/gradle-wrapper.properties：
  确认distributionUrl指向正确的Gradle 7.6.3包：

  distributionUrl=https\://services.gradle.org/distributions/gradle-7.6.3-bin.zip
  

3. 清理缓存并重建 #

执行以下命令彻底清理项目缓存：

flutter clean
cd android && ./gradlew clean
cd .. && flutter pub get

重启Android Studio后，重新尝试部署到设备。

4. 验证设备连接 #

• 确保Android设备已开启USB调试和USB安装权限
• 执行flutter devices命令，确认设备被正确识别；若未识别，安装对应设备的USB驱动

内容的提问来源于stack exchange，提问作者Wakeel Furqan Ahmed