使用VS Code构建Flutter Android App Bundle遇Java版本兼容问题求解决

问题背景 #

使用VS Code开发Flutter，构建AAB时遇到Gradle插件要求Java 17，但当前使用Java 11的错误，且在Android Studio中找不到指定Gradle JDK的选项。以下是几种可行的解决办法：

1. 修改项目的gradle.properties文件 #

这是无需依赖IDE设置的通用方案：

• 找到Flutter项目根目录下的gradle.properties文件
• 添加或修改以下配置，替换为你的Java 17路径：

org.gradle.java.home=/Applications/Android Studio.app/Contents/jbr/Contents/Home

注：上述路径是Mac系统中Android Studio自带的JBR 17路径，Windows系统通常为C:\Program Files\Android\Android Studio\jbr，也可使用自行下载的JDK 17路径

2. 通过Android Studio SDK Manager安装JDK 17 #

若找不到Gradle JDK设置选项，可先确保安装了Java 17：

• 打开Android Studio，进入Tools → SDK Manager
• 切换到SDK Tools标签，勾选Show Package Details
• 找到OpenJDK 17（或标注为Android Studio默认JDK的选项），勾选后点击Apply完成安装
• 安装后，确保项目级build.gradle中的AGP版本与Gradle版本匹配（AGP 7.0+需搭配Java 17）

3. 设置系统环境变量JAVA_HOME #

Mac/Linux #

• 打开终端，编辑shell配置文件（如~/.zshrc或~/.bash_profile）：

export JAVA_HOME=/path/to/java17
export PATH=$JAVA_HOME/bin:$PATH

• 执行source ~/.zshrc（对应你的shell类型）使配置生效

Windows #

• 打开「系统属性 → 高级 → 环境变量」
• 新建系统变量JAVA_HOME，值为Java 17的安装路径
• 编辑Path变量，添加%JAVA_HOME%\bin

4. 在VS Code中直接指定Gradle JDK #

• 打开VS Code，按下Cmd+Shift+P（Mac）或Ctrl+Shift+P（Windows/Linux）
• 输入并选择Gradle: Configure Gradle JDK
• 在弹出的选项中选择已安装的Java 17版本，或手动指定其安装路径

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