Codinomes, tags e números de compilação

Os lançamentos de desenvolvimento do Android são organizados em famílias, com codinomes alfabéticos inspirados em guloseimas saborosas. Esta página fornece informações sobre codinomes de plataforma, versões, níveis de API e versões do NDK , com uma explicação das definições de ID de compilação associadas a eles.

Observe que você pode precisar de detalhes adicionais da versão do codinome, dependendo do seu caso de uso. Por exemplo, você pode precisar do nome de código do dispositivo Android e combinações de teclas para inicializar no modo flashboot ou fontes e binários do kernel para criar um kernel manualmente. Eles estão resumidos na seção Referências de codinome e recursos para casos de uso , com links para você localizar as informações necessárias para esses tópicos:

• A inicialização no modo flashboot requer combinações de teclas para dispositivos com seus codinomes de dispositivo Android correspondentes.
• Kernels que devem ser construídos manualmente requerem nomes de código e locais correspondentes para obter fontes e binários do kernel.
• Compilações que originam vários repositórios Git requerem emparelhamentos de nome de código de dispositivo para obter uma configuração de diretório de origem correta para baixar fontes e ferramentas de compilação.

Codinomes de plataforma, versões, níveis de API e lançamentos do NDK

Esta tabela lista codinomes, seus números de versão correspondentes e níveis de API associados.

Definições de ID de compilação

No Android 8.0.0 (Oreo) e superior, as compilações individuais são identificadas com o formato de ID de compilação PVBB.YYMMDD.bbb[.Cn] , em que:

• P representa a primeira letra do codinome do lançamento da plataforma, por exemplo, O é Oreo.
• V representa uma vertical suportada. Por convenção, P representa o ramo primário da plataforma.
• BB é um código alfanumérico que permite ao Google identificar a ramificação exata do código a partir da qual a compilação foi feita.
• YYMMDD identifica a data em que a versão é ramificada ou sincronizada com a ramificação de desenvolvimento. Nem sempre é a data exata em que uma compilação foi feita, pois é comum que pequenas variações adicionadas a uma compilação existente reutilizem o mesmo código de data da compilação existente.
• bbb identifica versões individuais relacionadas ao mesmo código de data, começando sequencialmente com 001 .
• Cn é um alfanumérico opcional que identifica um hotfix sobre uma construção PVBB.YYMMDD.bbb existente, começando em A1 .

Versões mais antigas do Android usam um código de ID de compilação diferente e mais curto (por exemplo, FRF85B ), onde:

• A primeira letra é o codinome da família de lançamento, por exemplo, F é Froyo.
• A segunda letra é um código de ramificação que permite ao Google identificar a ramificação exata do código a partir da qual a compilação foi feita. Por convenção, R é a ramificação de lançamento principal.
• A terceira letra e os dois números seguintes são um código de data. A carta conta trimestres ( A é Q1 2009, F é Q2 2010 e assim por diante). Os dois números contam os dias dentro do trimestre ( F85 é 24 de junho de 2010). O código de data nem sempre é a data exata em que uma compilação foi feita, pois é comum que pequenas variações adicionadas a uma compilação existente reutilizem o mesmo código de data da compilação existente.
• A última letra identifica versões individuais relacionadas ao mesmo código de data, começando sequencialmente com A (que é implícito e geralmente omitido por brevidade).

Tags e compilações de código-fonte

Começando com Donut, a lista exata de tags e builds está na tabela a seguir. O ID de compilação fornece informações como a versão da plataforma, ramificação do código e data em que a versão foi ramificada ou sincronizada com a ramificação de desenvolvimento.

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.