کد نام ها، برچسب ها، و شماره ساخت

نسخه‌های توسعه اندروید در خانواده‌ها، با کدهای الفبایی که از خوراکی‌های خوشمزه الهام گرفته شده‌اند، سازمان‌دهی شده‌اند. این صفحه اطلاعاتی درباره کدهای پلتفرم، نسخه‌ها، سطوح API و نسخه‌های NDK ارائه می‌کند، همراه با توضیحی درباره تعاریف شناسه ساخت مرتبط با آنها.

توجه داشته باشید که بسته به مورد استفاده شما، ممکن است به جزئیات بیشتر کد-نسخه نیاز داشته باشید. به عنوان مثال، ممکن است برای راه‌اندازی به حالت فلش‌بوت، به نام کد دستگاه اندروید و ترکیب‌های کلیدی یا منابع هسته و باینری‌ها برای ساختن یک هسته به صورت دستی نیاز داشته باشید. این موارد در بخش منابع و مراجع Codename برای موارد استفاده خلاصه شده است، با پیوندهایی برای شما برای یافتن اطلاعات مورد نیاز برای این موضوعات:

• راه‌اندازی در حالت فلش‌بوت به ترکیب کلید برای دستگاه‌هایی با نام کد دستگاه Android مربوطه نیاز دارد.
• هسته هایی که باید به صورت دستی ساخته شوند به نام کد و مکان های مربوطه برای به دست آوردن منابع هسته و باینری ها نیاز دارند.
• سازه‌هایی که چندین مخزن Git را منبع می‌کنند، برای دریافت یک راه‌اندازی دایرکتوری منبع صحیح برای دانلود منابع و ابزارهای ساخت، به جفت نام کد دستگاه نیاز دارند.

کدهای پلتفرم، نسخه ها، سطوح API و نسخه های NDK

این جدول نام‌های رمز، شماره نسخه مربوطه و سطوح API مرتبط را فهرست می‌کند.

ساخت تعاریف شناسه

در Android 8.0.0 (Oreo) و بالاتر، بیلدهای فردی با فرمت Build ID PVBB.YYMMDD.bbb[.Cn] شناسایی می شوند، که در آن:

• P نشان دهنده اولین حرف از نام رمز انتشار پلتفرم است، به عنوان مثال، O Oreo است.
• V یک عمودی پشتیبانی شده را نشان می دهد. طبق قرارداد، P نشان دهنده شاخه اولیه پلت فرم است.
• BB یک کد الفبایی است که به گوگل اجازه می دهد تا شاخه کد دقیقی را که بیلد از آن ساخته شده است شناسایی کند.
• YYMMDD تاریخی را مشخص می کند که نسخه از شاخه توسعه منشعب شده یا با آن همگام شده است. همیشه تاریخ دقیقی نیست که یک بیلد در آن ساخته شده است، زیرا تغییرات جزئی به یک بیلد موجود برای استفاده مجدد از کد تاریخی مشابه با ساخت موجود رایج است.
• bbb نسخه های منفرد مربوط به همان کد تاریخ را شناسایی می کند که به ترتیب با 001 شروع می شود.
• Cn یک اختیاری و الفبایی است که یک Hotfix را در بالای یک بیلد موجود PVBB.YYMMDD.bbb شناسایی می کند که از A1 شروع می شود.

نسخه‌های قدیمی‌تر اندروید از کد شناسه ساخت متفاوت و کوتاه‌تری استفاده می‌کنند (مثلاً FRF85B ) که در آن:

• حرف اول اسم رمز خانواده انتشار است، به عنوان مثال، F Froyo است.
• حرف دوم یک کد شعبه است که به گوگل اجازه می دهد تا شاخه کد دقیقی را که بیلد از آن ساخته شده است شناسایی کند. طبق قرارداد، 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 master -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.