الأسماء البرمجية والعلامات وأرقام الإصدار

يتم تنظيم إصدارات تطوير Android في مجموعات، باستخدام أسماء رمزية أبجدية.

علامات الرمز المصدر وعمليات الإنشاء

بدءًا من Donut، يمكنك الاطّلاع على القائمة الدقيقة للعلامات والإصدارات في الجدول التالي. يقدّم رقم تعريف الإصدار معلومات مثل إصدار المنصة وbranch للرمز البرمجي وتاريخ إنشاء branch للإصدار أو تاريخ مزامنته مع branch للتطوير.

تعريفات أرقام تعريف الإصدار

في الإصدار Android 8.0.0 (Oreo) والإصدارات الأحدث، يتم تحديد الإصدارات باستخدام تنسيق رقم تعريف الإصدار PVBB.YYMMDD.bbb[.Cn]، حيث:

• يمثّل P الحرف الأول من الاسم الرمزي لإصدار النظام الأساسي، على سبيل المثال، O هو Oreo. بالنسبة إلى الأسماء الرمزية لنظام التشغيل Android 10 والإصدارات الأحدث، يتم استخدام الحرف المماثل، مثل Q لنظام التشغيل Android 10 وR لنظام التشغيل Android 11.
• يمثّل V فئة متاحة. وفقًا للعرف، يمثّل الرمز P فرع المنصة الأساسي.
• BB هو رمز أبجدي رقمي يسمح لخدمة Google بتحديد فرع الرمز البرمجي الدقيق الذي تم إنشاء الإصدار منه.
• يحدِّد YYYYMMDD تاريخ إنشاء فرع الإصدار أو مزامنته مع فرع التطوير. لا يشير هذا الحقل دائمًا إلى التاريخ الدقيق الذي تم فيه إنشاء الإصدار، لأنّه من الشائع أن تتم إضافة اختلافات طفيفة إلى إصدار حالي لإعادة استخدام رمز التاريخ نفسه الخاص بالإصدار الحالي.
• يحدِّد bbb الإصدارات الفردية المرتبطة برمز التاريخ نفسه، ويُستخدَم 001 بشكل تسلسلي لبدء الإصدارات.
• Cn هو سلسلة أبجدية رقمية اختيارية تحدد تحديثًا سريعًا على ملف PVBB.YYMMDD.bbbتمت برمجته مسبقًا، بدءًا من A1.

يستخدم الإصدار 7.00 من Android والإصدارات الأقدم رقم تعريف إصدار مختلفًا وأقصر (مثل FRF85B) على النحو التالي:

• الحرف الأول هو الاسم الرمزي لمجموعة الإصدارات، على سبيل المثال، F هو Froyo.
• الحرف الثاني هو رمز الفرع الذي يسمح لشركة Google بتحديد فرع التعليمات البرمجية الدقيق الذي تم إنشاء الإصدار منه. وفقًا للعرف، يكون R هو الفرع الأساسي للإصدار.
• الحرف الثالث والرقمَان التاليان هما رمز التاريخ. يُستخدَم الحرف لحساب الأرباع (أ هو الربع الأول من عام 2009، وف هو الربع الثاني من عام 2010، وهكذا). يُستخدَم الرقمان لاحتساب الأيام خلال الربع (F85 هو 24 حزيران (يونيو) 2010). لا يشير رمز التاريخ دائمًا إلى التاريخ الدقيق الذي تم فيه إنشاء الإصدار، لأنّه من الشائع أن تتم إعادة استخدام رمز التاريخ نفسه في الإصدار الحالي عند إضافة اختلافات بسيطة إلى إصدار حالي.
• يحدِّد الحرف الأخير إصدارات فردية مرتبطة برمز التاريخ نفسه، بدءًا من أ بشكل تسلسلي (وهو ضمني ويتم عادةً حذفه للاختصار).

تستخدِم تحديثات الأمان رقمًا تعريفيًا للإصدارات (مثل 7786871) وهي جزء من إصدارات رمز المصدر المستندة إلى مشاريع الإصدارات السابقة . يمكنك تطبيق تحديثات الأمان هذه على إصدارات Android السابقة.

أخيرًا، تمثل الفروع froyo وgingerbread وics-mr0 وics-mr1 وjb-dev وjb-mr1-dev وjb-mr1.1-dev وjb-mr2-dev وkitkat-dev فروع التطوير التي لا تتطابق تمامًا مع الإعدادات التي تختبرها Google. وبناءً على ذلك، قد تحتوي هذه الفروع على مجموعة متنوعة من التغييرات بالإضافة إلى الإصدارات الرسمية المُشار إليها وقد لا يتم اختبارها بدقة.

التفريق بين الإصدارات

للتمييز بين الإصدارات، يمكنك الحصول على قائمة بالتغييرات المرتبطة بكل مشروع من خلال إصدار الأمر التالي وإرساله بعلامتَي الفروع:

repo forall -pc 'git log --no-merges --oneline branch-1..branch-2'

مثلاً:

repo forall -pc 'git log --no-merges --oneline android-4.4.2_r2..android-4.4.2_r1'

لإرسال الإخراج إلى ملف نصي:

  repo forall -pc 'git log --no-merges --oneline android-4.4.2_r2..android-4.4.2_r1' > /tmp/android-4.4.2_r2-android-4.4.2_r1-diff.txt

وحدات Honeycomb GPL

بالنسبة إلى Honeycomb، لا يتوفّر رمز المصدر الكامل للنظام الأساسي. ومع ذلك، فإنّ أجزاء Honeycomb المرخَّصة بموجب GPL وLGPL متاحة ضمن العلامات التالية.

لا يحتوي أي بيان على هذه الوحدات بالضبط، ولكن تسمح بعض البيانات ب إنشاء هذه المكوّنات. تعمل الأوامر التالية مع الإصدار 3.0_r1.1:

repo init -b main -m base-for-3.0-gpl.xml
repo sync
repo forall -c git checkout android-3.0_r1.1

لاستخدام إصدار آخر، غيِّر المَعلمة git checkout و (إذا لزم الأمر) المَعلمة -m في repo init. يعرض الأمر git checkout خطأ لأي مشاريع غير مرخّصة بموجب "الرخصة العامة لبرامج GNU" (GPL) لا يمكنه العثور فيها على العلامة.

الأسماء الرمزية للأجهزة

يسرد الجدول التالي الأسماء الرمزية للأجهزة من Google. يمكنك استخدام هذه الأسماء الرمزية لإنشاء سلاسل استهداف الإنشاء المستخدَمة مع الأمر lunch: