以下部分描述了 Gradle 与多种集成的兼容性。此处未列出的版本可能工作,也可能不工作。

Java 运行时

Gradle 运行在 Java 虚拟机 (JVM) 上,JVM 通常由 JDK 或 JRE 提供。执行 Gradle 需要 JVM 版本在 17 到 24 之间。尚不支持 JVM 25 及更高版本。

Gradle wrapper、Gradle 客户端、Tooling API 客户端和 TestKit 客户端与 JVM 8 兼容。

JDK 6 及以上版本可用于编译。JVM 8 及以上版本可用于执行测试。

任何完全受支持的 Java 版本都可用于编译或测试。但是,最新的 Java 版本可能仅支持编译或测试,而不支持运行 Gradle。通过工具链实现支持,并适用于所有支持工具链的任务。

请参阅下表,了解特定 Gradle 版本支持的 Java 版本

表 1. Java 兼容性
Java 版本 对工具链的支持 对运行 Gradle 的支持

8

不适用

2.0 到 8.14.*

9

不适用

4.3 到 8.14.*

10

不适用

4.7 到 8.14.*

11

不适用

5.0 到 8.14.*

12

不适用

5.4 到 8.14.*

13

不适用

6.0 到 8.14.*

14

不适用

6.3 到 8.14.*

15

6.7

6.7 到 8.14.*

16

7.0

7.0 到 8.14.*

17

7.3

7.3 及以后

18

7.5

7.5 及以后

19

7.6

7.6 及以后

20

8.1

8.3 及以后

21

8.4

8.5 及以后

22

8.7

8.8 及以后

23

8.10

8.10 及以后

24

8.14

8.14 及以后

25

不适用

不适用

我们只在测试确认它们能正常工作且无任何警告后,才将版本列入上表。然而,由于工具链的支持,Gradle 在此之前通常也能与最新的 Java 版本配合使用。我们鼓励用户尝试并告知我们。

Kotlin

Gradle 经过 Kotlin 2.0.0 到 2.2.0 的测试。Beta 和 RC 版本可能工作,也可能不工作。

表 2. 嵌入式 Kotlin 版本
嵌入式 Kotlin 版本 最低 Gradle 版本 Kotlin 语言版本

1.3.10

5.0

1.3

1.3.11

5.1

1.3

1.3.20

5.2

1.3

1.3.21

5.3

1.3

1.3.31

5.5

1.3

1.3.41

5.6

1.3

1.3.50

6.0

1.3

1.3.61

6.1

1.3

1.3.70

6.3

1.3

1.3.71

6.4

1.3

1.3.72

6.5

1.3

1.4.20

6.8

1.3

1.4.31

7.0

1.4

1.5.21

7.2

1.4

1.5.31

7.3

1.4

1.6.21

7.5

1.4

1.7.10

7.6

1.4

1.8.10

8.0

1.8

1.8.20

8.2

1.8

1.9.0

8.3

1.8

1.9.10

8.4

1.8

1.9.20

8.5

1.8

1.9.22

8.7

1.8

1.9.23

8.9

1.8

1.9.24

8.10

1.8

2.0.20

8.11

1.8

2.0.21

8.12

1.8

2.2.0

9.0

2.2

Groovy

Gradle 经过 Groovy 1.5.8 到 4.0.27 的测试。

用 Groovy 编写的 Gradle 插件必须使用 Groovy 4.x,以兼容 Gradle 和 Groovy DSL 构建脚本。

Android

Gradle 经过 Android Gradle Plugin 8.4 到 8.11 的测试。Alpha 和 beta 版本可能工作,也可能不工作。

目标平台

Gradle 支持一组定义好的目标平台,它们是以下各项的组合

  • 操作系统和版本

  • 架构

  • 文件系统监视兼容性

下表列出了 Gradle 官方支持的平台

表 3. 支持的平台
操作系统 架构

Ubuntu 22

amd64

Windows 10

amd64

macOS 12

amd64

aarch64

Ubuntu 16

amd64

aarch64

Alpine 3.20

amd64

CentOS 9

amd64

目前,所有 Gradle 测试都在平台的默认文件系统上运行,即 Ubuntu、Amazon Linux 和 CentOS 使用 `ext4`,Windows 使用 `NTFS`,macOS 使用 `APFS`。

未列出的平台可能与 Gradle 兼容,但未经过积极测试。