用途:为持续集成与部署配置 Gradle 构建,覆盖 GitHub Actions、GitLab CI、Jenkins、CircleCI,包含缓存、制品管理、测试报告和 Docker 镜像构建。
主要能力:设置自动化构建;配置依赖与构建缓存以加速流水线;生成并发布测试报告;在流水线中构建和推送 Docker 镜像;通过并行执行优化 CI 性能;处理构建制品与代码覆盖率报告。
使用方式:始终使用 Gradle Wrapper(./gradlew build,而非 gradle build),并确保可执行:chmod +x ./gradlew。启用缓存,如 GitHub Actions 使用 gradle/actions/setup-gradle@v4 并配置 cache-encryption-key;GitLab CI 缓存 .gradle/wrapper 与 .gradle/caches。性能优化可加 --parallel、--build-cache、--configuration-cache、--scan,并在 gradle.properties 设置 org.gradle.parallel=true、org.gradle.caching=true、org.gradle.daemon=false。测试报告可用 mikepenz/action-junit-report@v4 或 GitLab artifacts.reports.junit。Docker 镜像可用 Jib:./gradlew jibDockerBuild 或 ./gradlew jib。制品上传用 actions/upload-artifact@v4 或 GitLab artifacts.paths。构建扫描需引入 com.gradle.enterprise 插件并运行 --scan。
适用场景:需要在上述任一 CI 平台搭建自动化构建、加速流水线、发布测试报告或构建推送镜像时。
限制与要求:建议 Gradle Wrapper 8.11+、JDK 17+(推荐 21);需相应 CI 平台与 Docker;凭据需安全存储(如 GRADLE_ENCRYPTION_KEY、DOCKER_USERNAME、DOCKER_PASSWORD)。更完整的各平台示例、命令参考与排错见 references/detailed-guide.md。