إنشاء الإصدارات وإدارتها

تساعدكم ميزة Releases في GitHub على حزم إصدارات مستقرة من برامجكم وتوفيرها للمستخدمين. ويمكن اعتبارها إعلانًا رسميًا عن إصدار جديد.

وتُعدّ هذه الميزة ضرورية للمشاريع التي تحتاج إلى توزيع ملفات ثنائية مترجمة أو وثائق أو لقطات محددة من الشيفرة المصدرية.

يرتبط كل إصدار في GitHub مباشرةً بـ علامة Git. وتحدد العلامة نقطة معينة في سجل مستودعكم، وعادةً ما تكون رقم إصدار مثل v1.0.0.

• توفر العلامات مرجعًا دائمًا وثابتًا إلى commit.
• وتضيف الإصدارات بيانات وصفية غنية، مثل ملاحظات الإصدار والملفات المرفقة، فوق هذه العلامة.

قبل إنشاء إصدار، تأكدوا من دفع العلامة المطلوبة إلى GitHub!

ملاحظات الإصدار هي أوصاف توضّح ما الجديد أو ما تم تحسينه أو إصلاحه في إصدار محدد. وهي ضرورية لإبلاغ المستخدمين بالتغييرات.

• استخدموا لغة واضحة وموجزة.
• سلّطوا الضوء على الميزات الرئيسية وإصلاحات الأخطاء.
• يدعم التنسيق باستخدام Markdown النص المنسّق.

ملفات الإصدار هي ملفات يمكنكم إرفاقها بإصدار، لتصبح متاحة للتنزيل. وقد تتضمن:

• ملفات ثنائية مترجمة (مثل .exe و.dmg)
• الشيفرة المصدرية المضغوطة (.zip و.tar.gz)
• ملفات الوثائق أو برامج التثبيت

وتوفر كل ما يحتاج إليه المستخدمون لهذا الإصدار المحدد في مكان واحد.

لإنشاء إصدار:

1. انتقلوا إلى مستودعكم على GitHub.
2. انقروا على 'Releases' (توجد غالبًا في الشريط الجانبي الأيمن أو ضمن علامة التبويب 'Code').
3. انقروا على الزر 'Draft a new release'.

يفتح ذلك نموذجًا تحددون فيه تفاصيل الإصدار.

في صفحة إنشاء الإصدار، ستقومون بما يلي:

• اختيار علامة Git موجودة أو إنشاء علامة جديدة.
• توفير عنوان للإصدار (مثل 'Version 1.0.0 - Initial Release').
• كتابة ملاحظات الإصدار التفصيلية.

يمكنكم تحديده بوصفه 'pre-release' (للاختبار) أو نشره مباشرةً.

يمكن لـ GitHub مساعدتكم في إنشاء ملاحظات الإصدار تلقائيًا!

عند النقر على 'Generate release notes'، سيفحص GitHub عمليات commit وطلبات السحب التي دُمجت منذ آخر علامة إصدار، ويقترح ملخصًا. ويمكنكم بعد ذلك تعديل هذا الملخص وتحسينه.

بعد تجهيز ملاحظات الإصدار، يمكنكم رفع الملفات.

ما عليكم سوى سحب الملفات وإفلاتها في المنطقة المحددة، أو النقر للاستعراض. سيرفع GitHub الملفات، وستظهر بوصفها ملفات قابلة للتنزيل في صفحة الإصدار.

تحدث الأخطاء! يمكنكم دائمًا تعديل إصدار أو حذفه.

• في صفحة 'Releases'، ابحثوا عن الإصدار الذي تريدون تعديله.
• انقروا على أيقونة القلم للتعديل، أو على أيقونة سلة المهملات للحذف.

يتيح لكم التعديل تغيير الملاحظات أو العنوان أو الملفات. ويؤدي الحذف إلى إزالة الإصدار من GitHub، لكن علامة Git الأساسية تظل موجودة.

لقد تعلّمتم كيفية إنشاء إصدارات GitHub وإدارتها!

• توفر الإصدارات لقطات رسمية ومحددة الإصدار من مشروعكم.
• وتُبنى على علامات Git، وتتضمن ملاحظات الإصدار وملفات اختيارية.
• يمكنكم إنشاء الإصدارات وتعديلها وحذفها من خلال واجهة GitHub.

وهذا يساعد المستخدمين على العثور بسهولة على إصدارات برامجكم المستقرة وتنزيلها.