Android开发 与 JDK版本

0 阅读1分钟

概括:

在 Android 项目里,“用哪个 JDK 编译代码”其实分成两层:

  1. 运行 Gradle / AGP 的 JDK(构建工具本身用的 JDK)

  2. 编译你源码时的 Java 语言等级 / 字节码版本(source/targetCompatibility)

这两者相关但不完全等同,下面分开说明它们是如何“设置和决定”的。

一、构建时使用的 JDK 是怎么决定的?

这是指:Gradle + Android Gradle Plugin 在构建时实际启动的那个 JDK。

决定顺序大致是下面这样(越靠上优先级越高):

  1. Gradle Toolchains(推荐方式,Gradle 6.7+) 在 build.gradle(通常是项目根目录的 build.gradle 或 build.gradle.kts)里显式指定:

    java { toolchain { languageVersion = JavaLanguageVersion.of(17) // 举例:使用 JDK 17 } }

  • Gradle 会自动寻找 / 下载相应版本的 JDK 用于构建。

  • 一旦配置了 toolchain,它优先级最高。

  1. gradle.properties 中的 org.gradle.java.home

在项目或用户级的 gradle.properties 里设置,例如:

org.gradle.java.home=/path/to/jdk-17
  • 会强制 Gradle 使用该路径下的 JDK。

  • 优先级高于环境变量 JAVA_HOME。

  1. 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** 构建时不受此项影响。

  1. 环境变量 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:输出字节码的版本(虚拟机兼容性)。

注意几点:

  1. 这里设置的“Java 版本”必须受当前 Android Gradle Plugin(AGP)支持。

    1. 不同 AGP 版本支持的最大 Java 语言版本不同,比如某些旧版只支持到 Java 8,稍新的支持到 11,再新的支持到 17。

    2. 如果设置了 AGP 不支持的版本,会在同步/编译时报错。

  2. 这里设置的语言级别不等于构建 JDK 必须同版本

    1. 比如,你可以用 JDK 17 运行 Gradle,但是 sourceCompatibility/targetCompatibility 依然设置为 1.8。

    2. 真正决定“你的 App 代码能用哪些 Java 语法”的,是这个 compileOptions 设置,而不是构建时 JDK 版本。

  3. Kotlin 代码的 JVM 目标版本单独设置:

    groovy kotlinOptions { jvmTarget = "1.8" // 或 "11"、"17" }

三、Android 上 Java 版本、JDK、运行环境的关系(简化理解)

对于 Android 项目来说,可以这样理解三层含义:

  1. Gradle / AGP 运行的 JDK

    1. 只影响“构建工具”本身能不能跑起来、是否兼容。

    2. 由 Toolchain / org.gradle.java.home / Gradle JDK / JAVA_HOME 决定。

    3. 与手机上的 Java 环境无关。

  2. 源码的 Java 语法 & 字节码版本

    1. 由 compileOptions 和 kotlinOptions.jvmTarget 决定。

    2. 必须在 AGP 支持范围内。

    3. Android 通过 desugar 等机制帮你在旧设备上支持较新的语法特性。

  3. 设备上的 Android 运行时(ART/Dalvik)

    1. 不是真正的标准 HotSpot JVM,而是 Android 自己的运行时。

    2. 你不用手动“在手机上装 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。