Nomi in codice, tag e numeri di build

Le versioni di sviluppo di Android sono organizzate in famiglie, con nomi in codice alfabetici ispirati a prelibatezze. Questa pagina fornisce informazioni sui nomi in codice della piattaforma, sulle versioni, sui livelli API e sui rilasci NDK , con una spiegazione delle definizioni degli ID build ad essi associati.

Tieni presente che potresti aver bisogno di ulteriori dettagli sulla versione del nome in codice, a seconda del tuo caso d'uso. Ad esempio, potresti aver bisogno del nome in codice del dispositivo Android e delle combinazioni di tasti per l'avvio in modalità flashboot o dei sorgenti e dei file binari del kernel per compilare manualmente un kernel. Questi sono riassunti nella sezione Riferimenti e risorse del nome in codice per i casi d'uso , con collegamenti per individuare le informazioni necessarie per questi argomenti:

• L'avvio in modalità flashboot richiede combinazioni di tasti per i dispositivi con i corrispondenti nomi in codice del dispositivo Android.
• I kernel che devono essere compilati manualmente richiedono nomi in codice e posizioni corrispondenti per ottenere sorgenti e file binari del kernel.
• Le build che generano più repository Git richiedono accoppiamenti di nome in codice del dispositivo per ottenere una corretta configurazione della directory di origine per scaricare fonti e strumenti di compilazione.

Nomi in codice della piattaforma, versioni, livelli API e rilasci NDK

Questa tabella elenca i nomi in codice, i numeri di versione corrispondenti e i livelli API associati.

Crea definizioni ID

In Android 8.0.0 (Oreo) e versioni successive, le singole build sono identificate con il formato ID build PVBB.YYMMDD.bbb[.Cn] , dove:

• P rappresenta la prima lettera del nome in codice della versione della piattaforma, ad esempio O è Oreo.
• V rappresenta una verticale supportata. Per convenzione, P rappresenta il ramo della piattaforma primaria.
• BB è un codice alfanumerico che consente a Google di identificare l'esatto ramo di codice da cui è stata creata la build.
• YYMMDD identifica la data in cui la versione è diramata o sincronizzata con il ramo di sviluppo. Non è sempre la data esatta in cui è stata creata una build poiché è normale che variazioni minori aggiunte a una build esistente riutilizzino lo stesso codice data della build esistente.
• bbb identifica le singole versioni relative allo stesso codice data, in sequenza a partire da 001 .
• Cn è un valore alfanumerico facoltativo che identifica un hotfix su una build PVBB.YYMMDD.bbb esistente, a partire da A1 .

Le versioni precedenti di Android utilizzano un codice ID build diverso e più breve (ad esempio, FRF85B ) dove:

• La prima lettera è il nome in codice della famiglia di rilascio, ad esempio F è Froyo.
• La seconda lettera è un codice ramo che consente a Google di identificare l'esatto ramo di codice da cui è stata creata la build. Per convenzione, R è il ramo di rilascio primario.
• La terza lettera e i due numeri successivi sono un codice data. La lettera conta i quarti ( A è Q1 2009, F è Q2 2010 e così via). I due numeri contano i giorni all'interno del trimestre ( F85 è il 24 giugno 2010). Il codice della data non è sempre la data esatta in cui è stata creata una build poiché è normale che variazioni minori aggiunte a una build esistente riutilizzino lo stesso codice della data della build esistente.
• L'ultima lettera identifica le singole versioni relative allo stesso codice data, iniziando in sequenza con A (che è implicita e solitamente omessa per brevità).

Tag e build del codice sorgente

A partire da Donut, l'elenco esatto di tag e build è nella tabella seguente. L' ID build fornisce informazioni come la versione della piattaforma, il ramo del codice e la data in cui la versione è stata ramificata o sincronizzata con il ramo di sviluppo.

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.