إصدار Oleafly

لإصدارات Oleafly مرحلتان مقصودتان. يبني وسم الإصدار مسودة ويتحقق منها. ثم ينشر مشرف المسودة نفسها بتشغيل منفصل لسير عمل النشر.

الدفع إلى main يشغّل CI لكنه لا ينشئ إصدارًا.

ابنِ المسودة

ابدأ من فرع main محدَّث وCI خضراء.

git switch main
git pull --ff-only
./scripts/bump-version.sh 0.3.6
git commit -am "chore: release v0.3.6"
git push origin main
git tag v0.3.6
git push origin v0.3.6

يشغّل الوسم .github/workflows/release.yml. ويبني هذه الأهداف:

الهدف	المثبّتات
macOS Apple Silicon	.dmg
Windows x64	.msi و-setup.exe
Linux x64	.AppImage و.deb
Linux ARM64	.AppImage و.deb

يجلب كل هدف أدواته المرافقة للمجمّع المقيّدة إصدارها ويتحقق منها. ثم يدمج سير العمل شظايا المحدِّث الأربعة كلها في latest.json واحد. ولا تُعدّ المسودة جاهزة إلا عند وجود كل مثبّت مطلوب وكل مدخل محدِّث.

راجع المسودة

افتح المسودة في صفحة GitHub Releases (يفتح في علامة تبويب جديدة). تحقق من ملاحظات الإصدار وأسماء المثبّتات والمجاميع الاختبارية والتواقيع وlatest.json. لا تنشر مسودة ناقصة.

انشر

افتح Actions → Release → Run workflow. أدخل الوسم نفسه وحدد Publish the release.

يعيد تشغيل النشر فحوص البناء والآثار. ويشغّل أيضًا اختبارات عقد حية مقابل Anthropic وGoogle باستخدام نسخة الإصدار المرشحة. ويرفض العمل النهائي النشر ما لم تكن كل منصة مدعومة وموجز المحدِّث الكامل موجودين.

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

أرقام الإصدارات

يتبع Oleafly ترقيم الإصدارات الدلالي:

• تصحيحي (Patch)، مثل الانتقال من 0.3.5 إلى 0.3.6، للإصلاحات المتوافقة.
• إضافي (Minor)، مثل الانتقال من 0.3.5 إلى 0.4.0، للميزات المتوافقة.
• جذري (Major)، مثل الانتقال من 0.3.5 إلى 1.0.0، للتغييرات الكاسرة أو أول إصدار مستقر.

فحوص مهمة

• يجب أن يطابق الوسم package.json وsrc-tauri/tauri.conf.json وsrc-tauri/Cargo.toml وsrc-tauri/Cargo.lock. استخدم scripts/bump-version.sh بدلًا من تحرير كل ملف على حدة.
• تأتي ملاحظات الإصدار من قسم النسخة المطابق في CHANGELOG.md.
• لا تعد استخدام وسم منشور. في حالة مسودة فاشلة، أصلح الفرع وأنشئ نسخة جديدة ما لم يوجد سبب واضح لاستبدال الوسم غير المنشور.
• يستخدم توقيع macOS وتوثيقه أسرار إصدار Apple. ويستخدم Windows Authenticode توقيع Azure Artifact Signing عند تكوين أسراره. وتستخدم توقيعات المحدِّث مفتاح توقيع Tauri المنفصل.

انظر التحديثات التلقائية لسلوك توقيع المحدِّث والتراجع. وتوجد تعليمات التثبيت للمستخدم في التنزيل والتثبيت.