ما هو الإصدار الدلالي
معيار ترقيم الإصدارات MAJOR.MINOR.PATCH
الإصدار الدلالي (SemVer) — معيار ترقيم إصدارات البرامج بتنسيق MAJOR.MINOR.PATCH، حيث لكل جزء معنى محدد.
هيكل الإصدار
- MAJOR (1.x.x) — تغييرات API غير متوافقة
- MINOR (x.1.x) — وظائف جديدة مع التوافق العكسي
- PATCH (x.x.1) — إصلاحات أخطاء متوافقة مع الإصدارات السابقة
- ما قبل الإصدار — 1.0.0-alpha، 1.0.0-beta.1
- بيانات البناء الوصفية — 1.0.0+build.123
القواعد
- الإصدار الأولي — 0.1.0
- أول إصدار مستقر — 1.0.0
- عند زيادة MAJOR — إعادة تعيين MINOR وPATCH
- عند زيادة MINOR — إعادة تعيين PATCH
- تُقارن الإصدارات من اليسار إلى اليمين
أمثلة على التغييرات
- MAJOR: إزالة وظيفة، تغيير توقيع الطريقة
- MINOR: إضافة نقطة نهاية جديدة، معامل اختياري جديد
- PATCH: إصلاح خطأ، تحسين الأداء
الأدوات
- npm — يستخدم SemVer للحزم
- Composer — مدير حزم PHP
- Maven — تبعيات Java
- semantic-release — أتمتة الإصدارات
- commitizen — التزامات منظمة
الفوائد
- القابلية للتنبؤ — توقعات واضحة من التحديثات
- الأتمتة — تحديد الإصدار التلقائي
- التوثيق — سجل التغييرات من الالتزامات
- التوافق — تحديثات آمنة للتبعيات