رقم إلى أربعة أرقام صحيحة مفصولة بنقاط لتحديد إصدار هذه الإضافة. تنطبق قاعدتان على الأعداد الصحيحة:
- يجب أن تتراوح الأعداد الصحيحة بين 0 و65535، بشكل شامل.
- لا يمكن أن تبدأ الأعداد الصحيحة غير الصفرية بـ 0. على سبيل المثال، الرقم 032 غير صالح لأنه يبدأ بصفر.
- ويجب ألا تكون جميعها صفرًا. على سبيل المثال، 0 و0.0.0.0 غير صالحين بينما 0.1.0.0 صالح.
في ما يلي بعض الأمثلة على الإصدارات الصالحة:
"version": "1"
"version": "1.0"
"version": "2.10.2"
"version": "3.1.2.4567"
إذا كانت الإضافة المنشورة تحتوي على سلسلة إصدار أحدث من الإضافة المثبّتة، سيتم تعديل الإضافة تلقائيًا.
تبدأ المقارنة بالأعداد الصحيحة أقصى اليسار. بعد ذلك، إذا كانت هذه الأعداد الصحيحة متساوية، تتم مقارنة الأعداد الصحيحة الموجودة على اليمين، وهكذا. على سبيل المثال، الإصدار 1.2.0 أحدث من 1.1.9.9999.
العدد الصحيح المفقود يساوي صفرًا. على سبيل المثال، الإصدار 1.1.9.9999 أحدث من 1.1 و1.1.9.9999 أقدم من 1.2.
اسم الإصدار
بالإضافة إلى الحقل "version"
الذي يُستخدم لأغراض التحديث، يمكن ضبط "version_name"
على سلسلة إصدار وصفية وسيتم استخدامه لأغراض العرض في حال توفّره.
في ما يلي بعض الأمثلة على أسماء الإصدارات:
"version_name": "1.0 beta"
"version_name": "build rc2"
"version_name": "3.1.2.4567"
في حالة عدم وجود version_name، سيتم استخدام حقل الإصدار لأغراض العرض أيضًا.