actions

إجراءات GitHub لبناء Gradle

يحتوي هذا المستودع على مجموعة من إجراءات GitHub المفيدة لبناء مشاريع Gradle على GitHub.

إجراء 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 وإرساله على الفور إلى المستودع عبر Dependency Submission 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 .

بدءًا من الإصدار 4، سيقوم إجراء 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

راجع وثائق الإجراء الكاملة للتعرف على سيناريوهات الاستخدام الأكثر تقدمًا.