Codinomes, tags e números de build

As versões de desenvolvimento do Android são organizadas em famílias com codinomes ordenados alfabeticamente e inspirados em doces. Esta página fornece informações sobre codinomes, versões, níveis de API e versões do NDK da plataforma, com uma explicação das definições de ID dos builds associados.

Talvez você precise de mais detalhes do codinome da versão, dependendo do seu caso de uso. Por exemplo, você pode precisar de combinações de teclas e do codinome do dispositivo Android para inicializar no modo flashboot, ou origens e binários do kernel para criar um manualmente. Há um resumo desses elementos na seção Referências e recursos de codinome para casos de uso, com links para localizar as informações necessária destes tópicos:

• A inicialização no modo flashboot exige combinações de teclas com os codinomes correspondentes do dispositivo Android.
• Os kernels que precisam ser criados manualmente exigem a combinação de codinomes e locais para acessar origens e binários do kernel.
• Os builds que combinam vários repositórios Git exigem pares de codinomes do dispositivo para receber uma configuração correta do diretório de origem e fazer o download das origens e das ferramentas de build.

Codinomes, versões, níveis de API e versões do NDK da plataforma

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

Definições do ID do build

No Android 8.0.0 (Oreo) e em versões mais recentes, os builds individuais são identificados pelo formato PVBB.AAMMDD.bbb[.Cn] do ID do build, em que:

• P representa a primeira letra do codinome da versão da plataforma (por exemplo, O é Oreo);
• V representa uma ramificação vertical compatível. Por convenção, P representa a ramificação principal da plataforma.
• BB representa um código alfanumérico que permite ao Google identificar a ramificação de código exata em que o build foi criado.
• AAMMDD identifica a data da ramificação ou sincronização da versão com a ramificação de desenvolvimento. Essa nem sempre é a data exata em que um build foi criado, já que é comum que pequenas variações adicionadas a um build existente reutilizem o mesmo código de data desse build;
• bbb identifica versões individuais relacionadas ao mesmo código de data, iniciando sequencialmente com 001.
• Cn é um alfanumérico opcional, que identifica um hotfix feito sobre um build PVBB.AAMMDD.bbb, começando com A1.

As versões mais antigas do Android usam um ID de build diferente e mais curto (por exemplo, FRF85B), em que:

• A primeira letra é o codinome da família da versão (por exemplo, F refere-se a Froyo);
• A segunda letra é um código de ramificação que mostra ao Google a ramificação de código exata em que o build foi criado. Por convenção, R é a ramificação principal de versão.
• A terceira letra e os dois dígitos seguintes são um código de data. A letra indica a contagem de trimestres (A é o 1º trimestre de 2009, F é o 2º trimestre de 2010 etc.). Os dois números indicam a contagem dos dias dentro do trimestre (F85 se refere a 24 de junho de 2010). O código de data nem sempre é a data exata em que um build foi criado, já que é comum que pequenas variações adicionadas a um build reutilizem o mesmo código de data dele.
• A última letra identifica versões individuais relacionadas ao mesmo código de data, iniciando sequencialmente com A, o que é implícito e geralmente omitido para simplificar.

Builds e tags de código-fonte

A tabela a seguir apresenta a lista exata de tags e builds, a partir do Android Donut. O ID do build oferece informações como a versão da plataforma, a ramificação do código e a data em que a versão foi ramificada ou sincronizada com a ramificação de desenvolvimento.

As ramificações froyo, gingerbread, ics-mr0, ics-mr1, jb-dev, jb-mr1-dev, jb-mr1.1-dev, jb-mr2-dev e kitkat-dev representam ramificações de desenvolvimento que não correspondem exatamente às configurações testadas pelo Google. Assim, essas ramificações podem conter uma variedade de alterações, além das versões oficiais marcadas, e podem não ter sido completamente testadas.

Para diferenciar as versões, você pode acessar uma lista das mudanças associadas ao projeto executando o comando abaixo e transmitindo as duas tags de ramificação:

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

Exemplo:

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

Para enviar o resultado para um arquivo de texto:

  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

Módulos GPL do Honeycomb

Para o Honeycomb, todo o código-fonte da plataforma está indisponível. No entanto, as partes do Honeycomb licenciadas pela GPL e LGPL estão disponíveis nas seguintes tags:

Nenhum manifesto contém exatamente esses módulos, mas alguns permitem a criação desses componentes. Os seguintes comandos funcionam para 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

Para usar outra versão, altere o parâmetro git checkout e (se necessário) o parâmetro -m em repo init. O comando git checkout resulta em um erro para os projetos não GPL em que não é possível encontrar a tag.

Referências e recursos de codinome para casos de uso

Veja abaixo os recursos do tipo de informação de codinomes necessários para oferecer suporte a casos de uso de configuração específicos:

• Se você estiver inicializando no modo fastboot (Fastboot mode) em um dispositivo que está inicializando a frio, use as combinações de teclas que correspondem ao dispositivo Android que você está usando. Para uma lista com os codinomes dos dispositivos Android, por exemplo, o Nexus 5x é chamado de Bullhead e usa uma combinação de teclas específica, consulte Como inicializar no modo fastboot e veja as combinações de teclas necessárias.
• Caso seu build exija origens de vários repositórios Git, use a abordagem repo para fazer o download delas e das ferramentas de build. Isso vai garantir a configuração correta do diretório de origem. Para acessar nomes de BRANCH para os kernels necessários, consulte Como fazer o download de origens e ferramentas de criação para ver uma lista de pares de dispositivos e codinomes (como Pixel 5 - redfin) com referência cruzada aos caminhos binários na árvore AOSP e às ramificações repo correspondentes.