如何在Android Studio的Flutter项目中降级Java版本并统一环境版本

一、为Android Studio中的Flutter项目降级Java版本 #

1. 全局配置Android Studio使用指定JDK #

Android Studio默认启用捆绑的JetBrains Runtime（JBR），需全局切换到目标旧版JDK：

• 打开Android Studio，进入File > Settings（Windows/Linux）或Android Studio > Settings（Mac）
• 导航到Build, Execution, Deployment > Build Tools > Gradle
• 在Gradle JDK下拉菜单中选择已安装的旧版JDK；若未显示，点击Add JDK手动选择旧版JDK的安装路径
• 确认勾选关联设置，确保全局生效

2. 项目级强制锁定Java版本 #

修改项目gradle配置，确保编译逻辑与目标JDK版本匹配：

• 打开Flutter项目的android/build.gradle文件，更新compileOptions和kotlinOptions：

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8 // 替换为你需要的旧版本，如1.8
        targetCompatibility JavaVersion.VERSION_1_8
    }

    kotlinOptions {
        jvmTarget = '1.8' // 与上面的Java版本保持一致
    }
}

• 打开android/gradle/wrapper/gradle-wrapper.properties，确保Gradle版本与目标JDK兼容（例如Java 8对应Gradle 6.x/7.x）：

distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-all.zip

3. 让Flutter Doctor识别指定JDK #

Flutter依赖系统环境变量读取JDK，需同步配置：

• 确保JAVA_HOME指向目标旧版JDK，并将其bin目录添加到系统PATH最前端
• 重启命令行，执行flutter doctor --verbose，检查输出中的Java版本是否更新

二、确保Android Studio、Flutter及命令行Java版本一致 #

1. 统一系统环境变量 #

• Windows：右键「此电脑」→「属性」→「高级系统设置」→「环境变量」，设置JAVA_HOME为目标JDK路径，添加%JAVA_HOME%\bin到PATH并移至最前
• Mac/Linux：编辑~/.bash_profile或~/.zshrc，添加以下内容：

export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_391.jdk/Contents/Home # 替换为你的JDK路径
export PATH="$JAVA_HOME/bin:$PATH"

• 重启命令行和Android Studio，使环境变量生效

2. 多环境验证 #

• 命令行执行java --version和javac --version，确认版本匹配目标JDK
• Android Studio中进入File > Project Structure > SDK Location，检查JDK Location是否指向目标路径
• 执行flutter doctor --verbose，核对Java binary at:和Java version:与命令行输出一致

3. 可选：使用JDK版本管理工具（推荐） #

若需频繁切换JDK版本，可借助工具简化管理：

• Mac/Linux：通过Homebrew安装jenv：

brew install jenv
echo 'export PATH="$HOME/.jenv/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(jenv init -)"' >> ~/.zshrc
jenv add /Library/Java/JavaVirtualMachines/jdk1.8.0_391.jdk/Contents/Home
jenv global 1.8

• Windows：使用Scoop安装jabba，通过命令快速切换全局/局部JDK版本

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