Gradle 与 CI/CD 集成：Jenkins/GitHub Actions 自动化构建配置

将 Gradle 与 CI/CD 工具（如 Jenkins 或 GitHub Actions）集成，可以实现自动化构建、测试、打包和部署，极大提升开发效率。以下是具体的配置方案：

一、Gradle 项目基础配置

首先确保 Gradle 项目本身支持自动化执行，关键配置如下：

build.gradle 核心任务

定义构建、测试、打包等任务，确保可通过命令行执行：

groovy 复制代码

// 示例：Java 项目
plugins {
    id 'java'
    id 'maven-publish' // 如需发布到仓库
}

group = 'com.example'
version = '1.0.0'

repositories {
    mavenCentral()
}

dependencies {
    testImplementation 'junit:junit:4.13.2'
}

// 打包任务（如生成 JAR）
jar {
    manifest {
        attributes 'Main-Class': 'com.example.Main'
    }
}

// 自定义任务：构建+测试+打包
task buildAndPackage(type: GradleBuild) {
    tasks = ['clean', 'test', 'jar']
}

添加可执行权限

确保项目中的 gradlew（Gradle wrapper）有执行权限：
bash 复制代码
```
chmod +x gradlew
```
提交 gradlew、gradlew.bat 和 gradle/wrapper/ 目录到版本控制，避免依赖系统安装的 Gradle。

二、与 Jenkins 集成

Jenkins 是常用的 CI/CD 工具，通过 Pipeline 实现 Gradle 自动化流程：

1. 前提条件

Jenkins 已安装 Gradle Plugin （可选，也可直接用 gradlew）。
项目代码托管在 Git 仓库（如 GitHub、GitLab）。

2. Pipeline 配置（`Jenkinsfile`）

在项目根目录创建 Jenkinsfile，定义流水线步骤：

groovy 复制代码

pipeline {
    agent any // 可指定特定节点

    stages {
        stage('拉取代码') {
            steps {
                git url: 'https://github.com/your/repo.git', branch: 'main'
            }
        }

        stage('构建与测试') {
            steps {
                // 使用 gradlew 执行任务（无需系统安装 Gradle）
                sh './gradlew clean test' // Linux/macOS
                // bat 'gradlew.bat clean test' // Windows
            }
            post {
                // 归档测试报告
                always {
                    junit 'build/test-results/test/**/*.xml'
                }
            }
        }

        stage('打包') {
            steps {
                sh './gradlew jar'
            }
            post {
                // 归档构建产物
                success {
                    archiveArtifacts artifacts: 'build/libs/*.jar', fingerprint: true
                }
            }
        }

        stage('部署') { // 可选：部署到服务器/仓库
            steps {
                sh './gradlew publish' // 如需发布到 Maven 仓库
                // 或通过 SSH 部署到服务器
                // sshPublisher(publishers: [sshPublisherDesc(...)])
            }
        }
    }
}

3. Jenkins 配置步骤

新建"流水线"项目，选择"从 SCM 加载 Jenkinsfile"。
配置 Git 仓库地址和分支，Jenkins 会自动检测 Jenkinsfile 并执行流程。

三、与 GitHub Actions 集成

GitHub Actions 是 GitHub 内置的 CI/CD 工具，配置更轻量（通过 .github/workflows 目录）。

1. 工作流配置文件

在项目根目录创建 .github/workflows/gradle-ci.yml：

yaml 复制代码

name: Gradle CI/CD

on:
  push:
    branches: [ main, develop ] # 推送时触发
  pull_request:
    branches: [ main ] # PR 时触发

jobs:
  build:
    runs-on: ubuntu-latest # 可选：windows-latest, macos-latest

    steps:
      - name: 拉取代码
        uses: actions/checkout@v4

      - name: 设置 JDK 17
        uses: actions/setup-java@v4
        with:
          java-version: '17'
          distribution: 'temurin'
          cache: gradle # 缓存 Gradle 依赖，加速构建

      - name: 授予 gradlew 执行权限
        run: chmod +x ./gradlew

      - name: 构建与测试
        run: ./gradlew clean test

      - name: 打包
        run: ./gradlew jar

      - name: 上传构建产物
        uses: actions/upload-artifact@v4
        with:
          name: gradle-build
          path: build/libs/*.jar

      - name: 部署（可选）
        if: github.ref == 'refs/heads/main' # 仅 main 分支触发部署
        run: ./gradlew publish
        env:
          # 传递仓库凭证（如 Nexus/GitHub Packages）
          MAVEN_USERNAME: ${{ secrets.MAVEN_USERNAME }}
          MAVEN_PASSWORD: ${{ secrets.MAVEN_PASSWORD }}

2. 关键配置说明

触发条件 ：通过 on 定义触发场景（推送、PR 等）。
缓存优化 ：cache: gradle 缓存依赖，减少重复下载。
安全凭证：敏感信息（如账号密码）通过 GitHub Secrets 存储，避免硬编码。
多环境支持 ：可通过 runs-on 指定不同操作系统（Linux/Windows/macOS）。

四、通用最佳实践

依赖缓存 ：在 CI/CD 中缓存 ~/.gradle/caches 目录，加速构建（Jenkins 可通过插件，GitHub Actions 已集成）。
并行任务 ：对多模块项目，使用 ./gradlew build --parallel 并行执行任务。
测试报告：归档测试结果（如 JUnit 报告），便于问题排查。
条件执行 ：通过分支名（如 main/develop）或标签（tags: v*）触发不同流程（如生产部署仅在 main 分支）。
版本管理 ：结合 gradle-release-plugin 实现自动版本号递增和标签创建。