actes

Actions GitHub pour les builds Gradle

Ce référentiel contient un ensemble d'actions GitHub utiles pour créer des projets Gradle sur GitHub.

L'action setup-gradle

L'action setup-gradle peut être utilisée pour configurer Gradle pour une exécution optimale sur n'importe quelle plate-forme prise en charge par GitHub Actions.

Cela remplace le précédent gradle/gradle-build-action , qui délègue désormais à cette implémentation.

La méthode recommandée pour exécuter n'importe quelle version de Gradle consiste à utiliser Gradle Wrapper, et les exemples supposent que Gradle Wrapper a été configuré pour le projet. Consultez cet exemple si votre projet n'utilise pas Gradle Wrapper.

Exemple d'utilisation

 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

Consultez la documentation complète des actions pour des scénarios d’utilisation plus avancés.

L'action dependency-submission

Génère et soumet un graphique de dépendances pour un projet Gradle, permettant à GitHub d'alerter sur les vulnérabilités signalées dans les dépendances de votre projet.

Le flux de travail suivant générera un graphique de dépendances pour un projet Gradle et le soumettra immédiatement au référentiel via l'API de soumission de dépendances. Pour la plupart des projets, cette configuration par défaut devrait suffire.

Ajoutez-le simplement en tant que nouveau fichier de workflow à votre référentiel (par exemple .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

Consultez la documentation complète des actions pour des scénarios d’utilisation plus avancés.

L'action wrapper-validation

L'action wrapper-validation valide les sommes de contrôle de tous les fichiers JAR Gradle Wrapper présents dans le référentiel et échoue si des fichiers JAR Gradle Wrapper inconnus sont trouvés.

L'action doit être exécutée à la racine du référentiel, car elle recherchera de manière récursive tous les fichiers nommés gradle-wrapper.jar .

À partir de la v4, l'action setup-gradle effectuera la validation du wrapper à chaque exécution. Si vous utilisez setup-gradle dans vos flux de travail, il est peu probable que vous ayez besoin d'utiliser l'action wrapper-validation .

Exemple de flux de travail

 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

Consultez la documentation complète des actions pour des scénarios d’utilisation plus avancés.