مرجع سريع

ورقة غش التعيين الدلالي للإصدارات (SemVer)

دليل مرجعي سريع للتعيين الدلالي للإصدارات (SemVer): زيادات MAJOR و MINOR و PATCH، وسوم ما قبل الإصدار، وبيانات البناء ونطاقات مديري الحزم.

· تاريخ النشر

يحدد التعيين الدلالي للإصدارات (SemVer) مواصفة قياسية لتعيين وزيادة أرقام إصدارات البرمجيات: MAJOR.MINOR.PATCH.

المكونات الثلاثة

$$\text{Version} = \text{MAJOR}.\text{MINOR}.\text{PATCH}$$

  1. MAJOR (1.0.0 -> 2.0.0): تغييرات جذرية غير متوافقة مع الإصدارات السابقة في واجهة برمجة التطبيقات (API).
  2. MINOR (1.0.0 -> 1.1.0): ميزات جديدة متوافقة مع الإصدارات السابقة.
  3. PATCH (1.0.0 -> 1.0.1): إصلاحات أخطاء متوافقة مع الإصدارات السابقة.

ما قبل الإصدار وبيانات البناء

1.0.0-alpha
1.0.0-alpha.1
1.0.0-beta.2
1.0.0-rc.1
1.0.0+20261108   # بيانات البناء (+يتم تجاهلها في تحديد أسبقية الإصدار)

ترتيب الأسبقية: 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0.


محددات نطاقات مديري الحزم

النطاق الإصدارات المشمولة الوصف
1.2.3 1.2.3 تطابق دقيق للإصدار
>1.2.3 1.2.4, 2.0.0, ... أكبر من
>=1.2.0 <1.3.0 1.2.0 up to 1.2.9 نطاق محدد
~1.2.3 >=1.2.3 <1.3.0 قريب بشكل معقول (يسمح بإصدارات patch فقط)
^1.2.3 >=1.2.3 <2.0.0 متوافق (يسمح بإصدارات minor و patch)
^0.2.3 >=0.2.3 <0.3.0 في الإصدارات 0.x.x، يُعتبر إصدار minor تغييراً جذرياً كاسراً
* Any version مطابقة عامة غير مقيدة

المراجع

موضوعات ذات صلة