概括:
在 Android 项目里,“用哪个 JDK 编译代码”其实分成两层:
-
运行 Gradle / AGP 的 JDK(构建工具本身用的 JDK)
-
编译你源码时的 Java 语言等级 / 字节码版本(source/targetCompatibility)
这两者相关但不完全等同,下面分开说明它们是如何“设置和决定”的。
一、构建时使用的 JDK 是怎么决定的?
这是指:Gradle + Android Gradle Plugin 在构建时实际启动的那个 JDK。
决定顺序大致是下面这样(越靠上优先级越高):
-
Gradle Toolchains(推荐方式,Gradle 6.7+) 在
build.gradle(通常是项目根目录的build.gradle或build.gradle.kts)里显式指定:java { toolchain { languageVersion = JavaLanguageVersion.of(17) // 举例:使用 JDK 17 } }
-
Gradle 会自动寻找 / 下载相应版本的 JDK 用于构建。
-
一旦配置了 toolchain,它优先级最高。
gradle.properties中的org.gradle.java.home
在项目或用户级的 gradle.properties 里设置,例如:
org.gradle.java.home=/path/to/jdk-17
-
会强制 Gradle 使用该路径下的 JDK。
-
优先级高于环境变量
JAVA_HOME。
- Android Studio 中的 Gradle JDK 设置
在 IDE 中配置(不同版本菜单略有差异,大致路径):
-
File→Settings→Build, Execution, Deployment→Build Tools→Gradle -
Gradle JDK一项里选择一个 JDK(通常是 IDE 自带的 Embedded JDK 或本地安装的 JDK)。 这里的配置只影响:从 Android Studio 点“Run / Build”时使用的 JDK。 用命令行**./gradlew**构建时不受此项影响。
- 环境变量
JAVA_HOME
当没有配置 toolchain、org.gradle.java.home、IDE Gradle JDK 时,Gradle 会退回到环境变量:
export JAVA_HOME=/path/to/jdk-17
./gradlew启动时会使用JAVA_HOME指向的 JDK。
我的设备系统环境变量跟AS上配置的JDK路径是一致的,也推荐配置一致,这样便于排查问题。
总结这一层:
构建使用的 JDK 由:Gradle Toolchain > org.gradle.java.home > IDE Gradle JDK > JAVA_HOME > 系统默认 java 决定。
你可以通过命令行查看当前 Gradle 实际用的 JDK:
./gradlew -version
输出:
------------------------------------------------------------
Gradle 7.5
------------------------------------------------------------
Build time: 2022-07-14 12:48:15 UTC
Revision: c7db7b958189ad2b0c1472b6fe663e6d654a5103
Kotlin: 1.6.21
Groovy: 3.0.10
Ant: Apache Ant(TM) version 1.10.11 compiled on July 10 2021
JVM: 17.0.10 (JetBrains s.r.o. 17.0.10+0--11572160)
OS: Windows 11 10.0 amd64
二、编译 Java 源码的语言级别 / 字节码版本是怎么设置的?
即:你写的 .java 文件支持到 Java 几(语法)、编译成什么版本的字节码(target)。 在 Android 项目里,主要由 android 块里的 compileOptions 控制:
android {
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
}
-
sourceCompatibility:源码语法允许到哪一版 Java,例如 1.8、11、17。 -
targetCompatibility:输出字节码的版本(虚拟机兼容性)。
注意几点:
-
这里设置的“Java 版本”必须受当前 Android Gradle Plugin(AGP)支持。
-
不同 AGP 版本支持的最大 Java 语言版本不同,比如某些旧版只支持到 Java 8,稍新的支持到 11,再新的支持到 17。
-
如果设置了 AGP 不支持的版本,会在同步/编译时报错。
-
-
这里设置的语言级别不等于构建 JDK 必须同版本
-
比如,你可以用 JDK 17 运行 Gradle,但是
sourceCompatibility/targetCompatibility依然设置为1.8。 -
真正决定“你的 App 代码能用哪些 Java 语法”的,是这个
compileOptions设置,而不是构建时 JDK 版本。
-
-
Kotlin 代码的 JVM 目标版本单独设置:
groovy kotlinOptions { jvmTarget = "1.8" // 或 "11"、"17" }
三、Android 上 Java 版本、JDK、运行环境的关系(简化理解)
对于 Android 项目来说,可以这样理解三层含义:
-
Gradle / AGP 运行的 JDK
-
只影响“构建工具”本身能不能跑起来、是否兼容。
-
由 Toolchain / org.gradle.java.home / Gradle JDK / JAVA_HOME 决定。
-
与手机上的 Java 环境无关。
-
-
源码的 Java 语法 & 字节码版本
-
由
compileOptions和kotlinOptions.jvmTarget决定。 -
必须在 AGP 支持范围内。
-
Android 通过 desugar 等机制帮你在旧设备上支持较新的语法特性。
-
-
设备上的 Android 运行时(ART/Dalvik)
-
不是真正的标准 HotSpot JVM,而是 Android 自己的运行时。
-
你不用手动“在手机上装 JDK”,构建好的 dex / apk 会直接在 ART 上跑。
-
四、实践中常见的设置方案
典型现代项目(示例):
groovy
// 根 build.gradle(.kts)
java {
toolchain {
languageVersion = JavaLanguageVersion.of(17)
}
}
android {
compileOptions {
sourceCompatibility JavaVersion.VERSION_11
targetCompatibility JavaVersion.VERSION_11
}
}
kotlinOptions {
jvmTarget = "11"
}
-
Gradle、AGP 使用 JDK 17 构建。
-
项目代码使用 Java 11 语法,编译成 Java 11 字节码。
-
前提是:AGP 版本已经支持 Java 11。