Кодовые имена, теги и номера сборки

Выпуски для разработки Android организованы в семейства с алфавитными кодовыми именами, вдохновленными вкусными угощениями. На этой странице представлена ​​информация о кодовых именах платформ, версиях, уровнях API и выпусках NDK с объяснением связанных с ними определений идентификатора сборки .

Обратите внимание, что вам могут потребоваться дополнительные сведения о версии кодового имени, в зависимости от вашего варианта использования. Например, вам может понадобиться кодовое имя устройства Android и комбинации клавиш для загрузки в режиме flashboot или исходные коды и двоичные файлы ядра для сборки ядра вручную. Они обобщены в разделе « Справочники по кодовым именам и ресурсы для вариантов использования » со ссылками, по которым вы можете найти информацию, необходимую для этих тем:

• Для загрузки в режиме flashboot требуются комбинации клавиш для устройств с соответствующими кодовыми именами устройств Android.
• Ядра, которые должны быть собраны вручную, требуют кодовых имен и соответствующих местоположений для получения исходных кодов ядра и двоичных файлов.
• Для сборок с несколькими репозиториями Git требуются пары кодовых имен устройств, чтобы получить правильную настройку исходного каталога для загрузки исходников и инструментов сборки.

Кодовые названия платформ, версии, уровни API и выпуски NDK.

В этой таблице перечислены кодовые имена, соответствующие им номера версий и соответствующие уровни API.

Определения идентификатора сборки

В Android 8.0.0 (Oreo) и более поздних версиях отдельные сборки идентифицируются с помощью формата идентификатора сборки PVBB.ГГММДД.bbb[.Cn] , где:

• P представляет собой первую букву кодового имени версии платформы, например, O — это Oreo.
• V представляет поддерживаемую вертикаль. По соглашению P представляет основную ветвь платформы.
• BB — это буквенно-цифровой код, который позволяет Google определить точную ветвь кода, из которой была сделана сборка.
• ГГММДД определяет дату, когда выпуск является ответвлением или синхронизируется с ответвлением разработки. Это не всегда точная дата, когда была сделана сборка, так как обычно для незначительных изменений, добавленных к существующей сборке, повторно используется тот же код даты, что и у существующей сборки.
• bbb идентифицирует отдельные версии, относящиеся к одному и тому же коду даты, последовательно начиная с 001 .
• Cn — это необязательный буквенно-цифровой идентификатор, который идентифицирует исправление поверх существующей сборки PVBB.ГГММДД.bbb, начиная с A1 .

В более старых версиях Android используется другой, более короткий идентификатор сборки (например, FRF85B ), где:

• Первая буква — кодовое название семейства релизов, например, F — Froyo.
• Вторая буква — это код ветки, который позволяет Google определить точную ветку кода, из которой была сделана сборка. По соглашению R является основной веткой выпуска.
• Третья буква и следующие за ней две цифры — это код даты. Буква подсчитывает кварталы ( A – первый квартал 2009 года, F – второй квартал 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.