الأسماء الرمزية والعلامات وأرقام البناء

يتم تنظيم إصدارات تطوير Android ضمن عائلات، بأسماء رمزية أبجدية مستوحاة من المأكولات اللذيذة. توفر هذه الصفحة معلومات حول الأسماء الرمزية للنظام الأساسي والإصدارات ومستويات واجهة برمجة التطبيقات (API) وإصدارات NDK ، مع شرح لتعريفات معرف البناء المرتبطة بها.

لاحظ أنك قد تحتاج إلى تفاصيل إضافية لإصدار الاسم الرمزي، اعتمادًا على حالة الاستخدام الخاصة بك. على سبيل المثال، قد تحتاج إلى الاسم الرمزي لجهاز Android ومجموعات المفاتيح للتشغيل في وضع flashboot، أو مصادر kernel والثنائيات لإنشاء kernel يدويًا. تم تلخيصها ضمن قسم مراجع وموارد الاسم الرمزي لحالات الاستخدام ، مع روابط تتيح لك تحديد المعلومات التي تحتاجها لهذه المواضيع:

• يتطلب التشغيل في وضع flashboot مجموعات مفاتيح للأجهزة التي لها الأسماء الرمزية المقابلة لها على أجهزة Android.
• تتطلب النواة التي يجب إنشاؤها يدويًا أسماء التعليمات البرمجية والمواقع المقابلة للحصول على مصادر النواة والثنائيات.
• تتطلب إنشاءات مستودعات Git المتعددة المصدر إقران اسم رمز الجهاز للحصول على إعداد دليل المصدر الصحيح لتنزيل المصادر وإنشاء الأدوات.

الأسماء الرمزية للنظام الأساسي والإصدارات ومستويات واجهة برمجة التطبيقات (API) وإصدارات NDK

يسرد هذا الجدول الأسماء الرمزية وأرقام الإصدارات المقابلة لها ومستويات واجهة برمجة التطبيقات المرتبطة بها.

بناء تعريفات الهوية

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

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

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

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

علامات التعليمات البرمجية المصدر والبنيات

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

The branches froyo, gingerbread, ics-mr0, ics-mr1, jb-dev, jb-mr1-dev, jb-mr1.1-dev, jb-mr2-dev, and kitkat-dev represent development branches that don't exactly match configurations tested by Google. As such, these branches might contain a variety of changes in addition to the official tagged releases and might not be as thoroughly tested.

To differentiate between releases, you can get a list of changes associated with each project by issuing the following command and passing it the two branch tags:

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

For example:

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

To send the output to a text file:

  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 modules

For Honeycomb, the entire platform source code isn't available. However, the parts of Honeycomb licensed under the GPL and LGPL are available under the following tags.

No manifest contains exactly these modules, but some manifests allow building those components. The following commands work for 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

To use another version, change the git checkout parameter and (if necessary) the -m parameter in repo init . The git checkout command outputs an error for any non-GPL projects where it can't find the tag.

Codename references and resources for use cases

Resources for the type of codenames information that's needed to support specific setup use cases are listed below:

• If you're booting into Fastboot mode (from a device that's undergoing a cold boot), you need the key combinations that correspond to the Android device you're using. For a listing of devices with their corresponding Android Device codenames (for example, Nexus 5x is codenamed Bullhead and uses a specific key combination), see Booting into fast boot mode to obtain the key combinations you need.
• If your build requires sources from multiple Git repositories, use the repo approach to download sources and build tools; this ensures a correct source directory setup. To get BRANCH names for the kernels you require, see Downloading sources and build tools for a list of device-code name pairings (such as Pixel 5 - redfin), cross-referenced to their binary paths in the AOSP tree and corresponding repo branches.