عمل الإصدارات التلقائية

إصدارات جيثب التلقائية

يعمل هذا الإجراء على تبسيط عملية إصدار GitHub عن طريق تحميل الأصول تلقائيًا وإنشاء سجلات التغيير والتعامل مع الإصدارات المسبقة وما إلى ذلك.

محتويات

1. أمثلة الاستخدام
2. المعلمات المدعومة
3. مشغلات الحدث
4. الإصدار
5. كيفية الحصول على المساعدة
6. رخصة

ملاحظة : مستودع marvinpinto/action-automatic-releases هو مرآة تم إنشاؤها تلقائيًا لـ marvinpinto/actions monorepo الذي يحتوي على هذا الإجراء وغيره. يرجى تقديم القضايا وسحب الطلبات هناك.

أمثلة الاستخدام

قم بإنشاء إصدار مسبق تلقائيًا عندما تصل التغييرات إلى الإصدار الرئيسي

سيتم تفعيل سير العمل هذا بمجرد وصول التغييرات إلى master . بعد تنفيذ خطوات إنشاء مشروعك واختباره:

1. سيتم إنشاء (أو استبدال) علامة git تسمى latest .
2. أنشئ سجل تغيير من جميع الالتزامات بين هذه العلامة وأحدث علامة latest .
3. أنشئ إصدارًا جديدًا مرتبطًا latest علامة (إزالة أي إصدارات سابقة مرتبطة).
4. قم بتحديث هذا الإصدار الجديد بالعنوان المحدد (على سبيل المثال، Development Build ).
5. قم بتحميل LICENSE.txt وأي ملفات jar كأصول إصدار.
6. ضع علامة على هذا الإصدار pre-release .

يمكنك رؤية مثال عملي لسير العمل هذا على marvinpinto/actions.

---
name : " pre-release "

on :
  push :
    branches :
      - " master "

jobs :
  pre-release :
    name : " Pre Release "
    runs-on : " ubuntu-latest "

    steps :
      # ...
      - name : " Build & test "
        run : |
          echo "done!"

      - uses : " marvinpinto/action-automatic-releases@latest "
        with :
          repo_token : " ${{ secrets.GITHUB_TOKEN }} "
          automatic_release_tag : " latest "
          prerelease : true
          title : " Development Build "
          files : |
            LICENSE.txt
            *.jar

قم بإنشاء إصدار GitHub جديد عندما يتم دفع العلامات إلى المستودع

كما هو الحال في المثال السابق، سيتم تفعيل سير العمل هذا بمجرد دفع العلامات الجديدة إلى GitHub. بعد بناء مشروعك واختباره:

1. قم بإنشاء سجل التغيير من جميع الالتزامات بين هذه والعلامة ذات المظهر النصفي السابقة.
2. أنشئ إصدارًا جديدًا واربطه بهذه العلامة.
3. قم بتحميل LICENSE.txt وأي ملفات jar كأصول إصدار.

مرة أخرى، يوجد مثال على ذلك في marvinpinto/actions.

---
name : " tagged-release "

on :
  push :
    tags :
      - " v* "

jobs :
  tagged-release :
    name : " Tagged Release "
    runs-on : " ubuntu-latest "

    steps :
      # ...
      - name : " Build & test "
        run : |
          echo "done!"

      - uses : " marvinpinto/action-automatic-releases@latest "
        with :
          repo_token : " ${{ secrets.GITHUB_TOKEN }} "
          prerelease : false
          files : |
            LICENSE.txt
            *.jar 

المعلمات المدعومة

المعلمة	وصف	تقصير
repo_token **	رمز إجراء GitHub، على سبيل المثال "${{ secrets.GITHUB_TOKEN }}" .	null
draft	هل تريد وضع علامة على هذا الإصدار كمسودة؟	false
prerelease	هل تريد وضع علامة على هذا الإصدار كإصدار مسبق؟	true
automatic_release_tag	اسم العلامة المراد استخدامه للإصدارات التلقائية، على سبيل المثال، latest .	null
title	عنوان الإصدار؛ الإعدادات الافتراضية لاسم العلامة إذا لم يتم تحديد أي منها.	اسم العلامة
files	الملفات المطلوب تحميلها كجزء من أصول الإصدار.	null

النواتج

يمكن الوصول إلى قيم الإخراج التالية عبر ${{ steps..outputs. }} :

اسم	وصف	يكتب
automatic_releases_tag	علامة الإصدار التي تمت معالجة هذا الإجراء للتو	خيط
upload_url	عنوان URL لتحميل أصول إضافية إلى الإصدار	خيط

ملحوظات:

• المعلمات المشار إليها بـ ** مطلوبة.
• تدعم معلمة files أنماط الكرة الأرضية متعددة الأسطر، راجع أمثلة المستودع.

مشغلات الحدث

يتيح لك إطار عمل GitHub Actions تشغيل هذه الإجراءات (وغيرها) في العديد من مجموعات الأحداث. على سبيل المثال، يمكنك إنشاء إصدارات مسبقة محددة لعلامات الإصدار المرشحة (على سبيل المثال *-rc* )، وإنشاء إصدارات عند وصول التغييرات إلى الصفحة الرئيسية (المثال أعلاه)، والإصدارات الليلية، وغير ذلك الكثير. اقرأ بناء جملة سير العمل لإجراءات GitHub للحصول على أفكار وأمثلة متقدمة.

الإصدار

يؤدي كل التزام يصل إلى البرنامج الرئيسي لهذا المشروع إلى تشغيل إنشاء تلقائي بالإضافة إلى إصدار موسوم يسمى latest . إذا كنت لا ترغب في العيش على حافة النزيف، فيمكنك استخدام إصدار مستقر بدلاً من ذلك. انظر الإصدارات للإصدارات المتاحة.

"" style=";text-align:right;direction:rtl">

- uses : " marvinpinto/action-automatic-releases@ " 

كيفية الحصول على المساعدة

يحتوي الملف التمهيدي الرئيسي لهذا المشروع على مجموعة من المعلومات المتعلقة بتصحيح الأخطاء ومشكلات الإرسال. إذا كنت لا تزال عالقًا، فحاول الاتصال بي على قاعدة المفاتيح وسأبذل قصارى جهدي لمساعدتك.

رخصة

تم إصدار الكود المصدري لهذا المشروع بموجب ترخيص MIT. هذا المشروع غير مرتبط بـ GitHub.