行動

Gradle 建構的 GitHub Actions

此儲存庫包含一組 GitHub Actions，可用於在 GitHub 上建立 Gradle 專案。

setup-gradle操作

setup-gradle操作可用於設定 Gradle，以便在 GitHub Actions 支援的任何平台上實現最佳執行。

這取代了之前的gradle/gradle-build-action ，後者現在委託給此實作。

執行任何 Gradle 建置的建議方法是藉助 Gradle Wrapper，並且範例假設已為專案配置了 Gradle Wrapper。如果您的專案不使用 Gradle Wrapper，請參閱此範例。

用法範例

 name : Build

on :
  push :

jobs :
  build :
    runs-on : ubuntu-latest
    steps :
    - name : Checkout sources
      uses : actions/checkout@v4
    - name : Setup Java
      uses : actions/setup-java@v4
      with :
        distribution : ' temurin '
        java-version : 17
    - name : Setup Gradle
      uses : gradle/actions/setup-gradle@v4
    - name : Build with Gradle
      run : ./gradlew build

有關更進階的使用場景，請參閱完整的操作文件。

dependency-submission動作

產生並提交 Gradle 專案的依賴關係圖，讓 GitHub 就專案依賴關係中報告的漏洞發出警報。

以下工作流程將為 Gradle 專案產生依賴關係圖，並透過依賴關係提交 API 將其立即提交至儲存庫。對於大多數項目，此預設配置應該滿足您的需求。

只需將其作為新的工作流程檔案新增至您的儲存庫（例如.github/workflows/dependency-submission.yml ）。

 name : Dependency Submission

on :
  push :
    branches : [ 'main' ]

permissions :
  contents : write

jobs :
  dependency-submission :
    runs-on : ubuntu-latest
    steps :
    - name : Checkout sources
      uses : actions/checkout@v4
    - name : Setup Java
      uses : actions/setup-java@v4
      with :
        distribution : ' temurin '
        java-version : 17
    - name : Generate and submit dependency graph
      uses : gradle/actions/dependency-submission@v4

有關更進階的使用場景，請參閱完整的操作文件。

wrapper-validation操作

wrapper-validation操作會驗證儲存庫中存在的所有Gradle Wrapper JAR 檔案的校驗和，如果發現任何未知的 Gradle Wrapper JAR 文件，則會失敗。

該操作應該在儲存庫的根目錄中運行，因為它將遞歸搜尋名為gradle-wrapper.jar的任何檔案。

從 v4 開始， setup-gradle操作將對每次執行執行包裝器驗證。如果您在工作流程中使用setup-gradle ，則不太可能需要使用wrapper-validation操作。

工作流程範例

 name : " Validate Gradle Wrapper "

on :
  push :
  pull_request :

jobs :
  validation :
    name : " Validation "
    runs-on : ubuntu-latest
    steps :
      - uses : actions/checkout@v4
      - uses : gradle/actions/wrapper-validation@v4

有關更進階的使用場景，請參閱完整的操作文件。