Configure a modern Gradle build on GitHub Actions with gradle/actions/setup-gradle
更新说明：本文于 2026-08 重写。原示例使用已废弃的 setup-java v1、手写 actions/cache 缓存、默认分支 master，现已升级为官方推荐方案 gradle/actions/setup-gradle（内置 wrapper 校验与依赖缓存）。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
| name: Java CI with Gradle
on:
push:
branches: [ main ]
pull_request:
branches: [ main ]
jobs:
build:
name: Gradle Automation Build
runs-on: ubuntu-latest
strategy:
matrix:
java: [11, 17, 21]
steps:
- name: Checkout
uses: actions/checkout@v6
- name: Set up JDK
uses: actions/setup-java@v5
with:
distribution: temurin
java-version: ${{ matrix.java }}
- name: Setup Gradle
uses: gradle/actions/setup-gradle@v6 # 内置 wrapper 完整性校验 + Gradle 依赖缓存，无需再手写 actions/cache
- name: Build with Gradle
run: ./gradlew clean build
- name: Upload test results
uses: actions/upload-artifact@v7
with:
name: test-results-${{ matrix.java }}
path: build/reports/tests/
|
为什么这么写
gradle/actions/setup-gradle 取代手写缓存：它会自动校验 Gradle wrapper（防供应链攻击）、缓存 dependencies/configuration cache，并支持依赖分析上报。旧示例里两段 actions/cache@v1 已不需要。- JDK 由
actions/setup-java 提供：显式指定 distribution: temurin（Eclipse Temurin LTS）比依赖 runner 预装的 JDK 更可复现；旧版 v1 基于已废弃的 Node12 运行时，且自动装的是旧版。 - 分支
master → main：GitHub 新仓库默认主分支已是 main。 - 矩阵 JDK 选 LTS：建议
[11, 17, 21]（按你的项目实际最低版本裁剪）；最新 LTS 已是 JDK 25，可加进矩阵或作为推荐基线。想再精简可只跑 21。 - 上传测试报告（可选）：
actions/upload-artifact 便于在构建页查看测试结果。
按需裁剪：若你的项目用 Kotlin/Android，把 build 换成对应 task（如 assemble / lint）即可。