Nomi in codice, tag e numeri di build

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

Tieni presente che potresti aver bisogno di ulteriori dettagli sulla versione del nome in codice, a seconda del caso d'uso. Ad esempio, potrebbero essere necessari il nome in codice del dispositivo Android e le combinazioni di tasti per l'avvio in modalità flashboot oppure i sorgenti e i file binari del kernel per creare un kernel manualmente. Questi sono riepilogati nella sezione Riferimenti sui nomi in codice e risorse 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 creati manualmente richiedono nomi in codice e posizioni corrispondenti per ottenere i sorgenti e i file binari del kernel.
• Le build che generano più repository Git richiedono accoppiamenti dei nomi in codice del dispositivo per ottenere una corretta configurazione della directory di origine per scaricare fonti e creare strumenti.

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

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

Creare definizioni ID

In Android 8.0.0 (Oreo) e versioni successive, le singole build vengono 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 principale della piattaforma.
• BB è un codice alfanumerico che consente a Google di identificare l'esatto ramo di codice da cui è stata realizzata la build.
• AAMMGG identifica la data in cui la versione viene diramata o sincronizzata con il ramo di sviluppo. Non è sempre la data esatta in cui è stata realizzata 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, iniziando in sequenza con 001 .
• Cn è un valore alfanumerico facoltativo che identifica un hotfix su una build PVBB.YYMMDD.bbb esistente, a partire da A1 .

Le versioni Android precedenti 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 di 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 principale.
• La terza lettera e i due numeri successivi rappresentano un codice data. La lettera conta i trimestri ( A è il primo trimestre del 2009, F è il secondo trimestre del 2010 e così via). I due numeri contano i giorni all'interno del trimestre ( F85 è il 24 giugno 2010). Il codice data non è sempre la data esatta in cui è stata realizzata una build poiché è normale che variazioni minori aggiunte a una build esistente riutilizzino lo stesso codice 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 quali il rilascio della piattaforma, il ramo del codice e la data da cui il rilascio è stato diramato o sincronizzato con il ramo di sviluppo.

I rami Froyo, Gingerbread, ICS-MR0, ICS-MR1, JB-Dev, JB-MR1-Dev, JB-MR1.1-Dev, JB-MR2-Dev e Kitkat-Dev rappresentano rami di sviluppo che non esattamente non esattamente non esattamente non esattamente che non non sono esattamente rami che non esattamente non esattamente non esattamente che non non sono esattamente rami che non esattamente non esattamente non esattamente che non non sono esattamente rami di sviluppo che non esattamente non esattamente non esattamente non esattamente Abbina le configurazioni testate da Google. Pertanto, queste filiali potrebbero contenere una varietà di cambiamenti oltre alle versioni ufficiali etichettate e potrebbero non essere così accuratamente testate.

Per distinguere tra le versioni, è possibile ottenere un elenco di modifiche associate a ciascun progetto emettendo il seguente comando e passandolo i due tag di filiale:

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

Per esempio:

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

Per inviare l'output a un file di testo:

  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

Moduli GPL a nido d'ape

Per Honeycomb, l'intero codice sorgente della piattaforma non è disponibile. Tuttavia, le parti di nido d'ape in licenza ai sensi del GPL e LGPL sono disponibili nei seguenti tag.

Nessun manifesto contiene esattamente questi moduli, ma alcuni manifesti consentono di costruire quei componenti. I seguenti comandi funzionano per 3.0_r1.1:

repo init -b main -m base-for-3.0-gpl.xml
repo sync
repo forall -c git checkout android-3.0_r1.1

Per utilizzare un'altra versione, modificare il parametro git checkout e (se necessario) il parametro -m in repo init . Il comando git checkout emette un errore per eventuali progetti non GPL in cui non riesce a trovare il tag.

Riferimenti e risorse in codice per casi d'uso

Le risorse per il tipo di informazioni di nome in codice necessarie per supportare i casi d'uso di configurazione specifici sono elencate di seguito:

• Se ti stai avviando in modalità Fastboot (da un dispositivo che è in fase di avvio a freddo), sono necessarie le combinazioni di chiavi che corrispondono al dispositivo Android che stai utilizzando. Per un elenco di dispositivi con i loro corrispondenti codeni del dispositivo Android (ad esempio, Nexus 5x è in codice Bullhead e utilizza una combinazione di chiavi specifica), consultare l'avvio in modalità di avvio rapido per ottenere le combinazioni di chiavi necessarie.
• Se la tua build richiede fonti di più repository GIT, utilizzare l'approccio repo per scaricare fonti e strumenti di costruzione; Ciò garantisce una corretta configurazione della directory di origine. Per ottenere nomi BRANCH per i kernel necessari, consultare le fonti di download e costruire strumenti per un elenco di accoppiamenti di nomi di code dispositivo (come Pixel 5-Redfin), referenziati ai loro percorsi binari nell'albero Aosp e nei corrispondenti rami repo .

Le versioni di sviluppo di Android sono organizzate in famiglie, con cani alfabetici che sono ispirati a gustose prelibatezze. Questa pagina fornisce informazioni sui codeni della piattaforma, le versioni, i livelli di API e le versioni NDK , con una spiegazione delle definizioni di ID build ad essi associate.

Si noti che potresti richiedere ulteriori dettagli sulla versione in codice in codice, a seconda del caso d'uso. Ad esempio, potrebbe essere necessario il nome in codice Android dispositivo e le combinazioni di chiavi per l'avvio in modalità Flashboot, o fonti di kernel e binari per costruire un kernel manualmente. Questi sono riassunti in base ai riferimenti e alle risorse del codice per i casi d'uso , con collegamenti per individuare le informazioni necessarie per questi argomenti:

• L'avvio in modalità Flashboot richiede combinazioni di chiavi per i dispositivi con i corrispondenti insegne di dispositivi Android.
• I kernel che devono essere costruiti richiedono manualmente nomi di codice e posizioni corrispondenti per ottenere fonti e binari del kernel.
• Build che sorgente più repository GIT richiedono accoppiamenti di nome in codice dispositivo per ottenere una configurazione della directory di origine corretta per scaricare fonti e creare strumenti.

CONSIGLI PARTRAFICATO, versioni, livelli API e versioni NDK

Questa tabella elenca i codenames, i loro numeri di versione corrispondenti e i livelli API associati.

Build ID Definizioni

In Android 8.0.0 (Oreo) e superiori, le singole build sono identificate con il formato ID build PvBB.yymmdd.bbb [.cn] , dove:

• P rappresenta la prima lettera del codice del rilascio della piattaforma, ad esempio, è 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 la filiale esatta del codice da cui è stata effettuata la build.
• YyMMDD identifica la data in cui il rilascio è ramificato o sincronizzato con il ramo di sviluppo. Non è sempre la data esatta in cui è stata fatta una build in quanto è comune per le variazioni minori aggiunte a una build esistente per riutilizzare lo stesso codice della data della build esistente.
• BBB identifica le singole versioni relative allo stesso codice della data, a partire in sequenza con 001 .
• CN è un alfanumerico opzionale che identifica un hotfix sopra una build PvBB.yymmdd.bbb esistente, a partire da A1 .

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

• La prima lettera è il nome in codice della famiglia di rilascio, ad esempio F è Froyo.
• La seconda lettera è un codice di filiale che consente a Google di identificare la filiale del codice esatta da cui è stata effettuata la build. Per convenzione, R è il ramo di rilascio primario.
• La terza lettera e i seguenti due numeri sono un codice della data. Le lettere contano i quarti ( A sono il primo trimestre 2009, F è il secondo trimestre 2010 e così via). I due numeri contano i giorni entro il trimestre ( F85 è il 24 giugno 2010). Il codice della data non è sempre la data esatta in cui è stata effettuata una build in quanto è comune per le variazioni minori aggiunte a una build esistente per riutilizzare lo stesso codice della data della build esistente.
• L'ultima lettera identifica le singole versioni relative allo stesso codice della data, a partire in sequenza con A (che è implicito e di solito omesso per la brevità).

Tag e build di codice sorgente

A partire dalla ciambella, l'elenco esatto di tag e build è nella tabella seguente. L' ID build fornisce informazioni come il rilascio della piattaforma, il ramo di codice e la data in cui il rilascio è stato ramificato o sincronizzato con il ramo di sviluppo.