如何解决VS Code/Android Studio USB调试Flutter时Gradle构建报错问题

USB调试开启备用方式 #

• Android Studio操作路径：
  1. 手机端提前开启开发者选项、USB调试权限，连接电脑后选择「文件传输（MTP）」连接模式
  2. 打开顶部菜单栏的设备管理器（Device Manager），切换到「Physical」分类，刷新后选中识别到的真机设备直接运行项目即可
  3. 若无法识别设备，可尝试切换USB连接模式为「图片传输（PTP）」，重新插拔USB线后重试
• VS Code操作路径：
  1. 按下Ctrl+Shift+P唤起命令面板，输入Flutter: Select Device，选中列表里的真机设备后点击运行按钮
  2. 也可直接在终端执行flutter devices查询设备ID，随后执行flutter run -d 你的设备ID直接启动项目

报错修复方案 #

你遇到的编译报错核心原因是Gradle版本与JDK版本不兼容：版本号60对应JDK 16，而当前项目使用的Gradle 6.7最高仅支持JDK 15，版本不匹配触发编译中断，按以下步骤操作即可解决：

• 方案一：升级项目Gradle版本
  打开项目android/gradle/wrapper/gradle-wrapper.properties文件，将distributionUrl参数对应的Gradle版本修改为7.0及以上版本即可，示例配置如下：

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

• 方案二：降低项目使用的JDK版本
  • Android Studio端：打开设置页（File -> Settings -> Build, Execution, Deployment -> Build Tools -> Gradle），将「Gradle JDK」选项修改为1.8、11或15版本，同步项目后重新运行
  • VS Code端：将系统环境变量JAVA_HOME指向15及以下版本的JDK安装路径，重启终端后重新执行运行命令
• 若修改后仍有报错，可先删除Gradle缓存目录C:\Users\Nxshe Medan\.gradle\caches下的对应版本缓存文件，再重新同步项目运行即可。

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