Processo di rilascio GKI (Generic Kernel Image)

Questa pagina descrive come viene rilasciata la GKI, inclusi i rilasci di emergenza trimestrali e fuori banda. L'obiettivo di questa pagina è fornire agli OEM una linea guida su dove trovare il GKI, nonché sulla procedura per le correzioni di emergenza fuori banda. Gli OEM possono anche utilizzare lo sviluppo GKI per scoprire di più su come collaborare con il team del kernel Android per ottimizzare il kernel GKI per i loro prodotti.

Cadenza di rilascio della GKI

La GKI viene rilasciata con cadenza trimestrale dopo il blocco della KMI.

Mese di uscita a12-5.10 a13-5.10 a13-5.15 a14-5.15 a14-6.1 a15-6.6* a16-6.12* a17-6.18* a18-7.3*
Ottobre
2026
Termine ultimo per il check-in:
16 ott16 ott1° ott1° ott
Precaricamento GKI pronto 31 ott31 ott15 ott15 ott
Nov
2026
Nessuna release questo mese.
Dicembre
2026
Termine ultimo per il check-in:
1° dic1° dic1° dic1° dic
Precaricamento GKI pronto 15 dic15 dic15 dic15 dic
Gennaio
2027
Termine ultimo per il check-in:
16 gen16 gen2 gen2 gen
Precaricamento GKI pronto 31 gen31 gen15 gen15 gen
Feb
2027
Nessuna release questo mese.
Marzo
2027
Termine ultimo per il check-in:
1° mar16 mar16 mar1° mar
Precaricamento GKI pronto 15 mar31 mar31 mar15 mar
Aprile
2027
Termine ultimo per il check-in:
1 apr1 apr
Precaricamento GKI pronto 15 apr15 apr
Maggio
2027
Nessuna release questo mese.
Giugno
2027
Termine ultimo per il check-in:
1° giugno15 giu15 giu1° giugno
Precaricamento GKI pronto 15 giu30 giu30 giu15 giu
Luglio
2027
Termine ultimo per il check-in:
1 lug1 lug1 lug
Precaricamento GKI pronto 15 lug15 lug15 lug
Agosto
2027
Nessuna release questo mese.
Settembre
2027
Termine ultimo per il check-in:
1° set16 set16 set1° set
Precaricamento GKI pronto 15 set30 set30 set15 set
Ottobre
2027
Termine ultimo per il check-in:
1° ott1° ott1° ott
Precaricamento GKI pronto 15 ott15 ott15 ott
Nov
2027
Nessuna release questo mese.
Dicembre
2027
Termine ultimo per il check-in:
1° dic1° dic1° dic1° dic
Precaricamento GKI pronto 15 dic15 dic15 dic15 dic

Validità della build GKI per gli OEM

Gli OEM possono utilizzare un GKI Android rilasciato di recente. Gli OEM possono lanciare build certificate GKI, purché siano conformi ai requisiti del kernel con assistenza a lungo termine (LTS) nel Bollettino sulla sicurezza di Android (ASB).

Release GKI da 16 kB

Il team di rilascio di GKI gestisce le release di GKI da 16 KB utilizzando la stessa cadenza di rilascio trimestrale, gli stessi test di qualificazione e lo stesso processo di respin delle release di GKI da 4 KB:

  • Rami supportati:
    • android15-6.6 (a partire da gennaio 2026)
    • android16-6.12 (a partire da marzo 2026)
    • android17-6.18 (a partire da giugno 2026)
    • android18-7.3 (a partire da luglio 2027)
  • Parità di build e certificazione: i file binari GKI da 16 KB utilizzano lo stesso tag di origine e lo stesso ID build del kernel della release GKI da 4 KB corrispondente. Fino al 2027, la scheda Build di release da 16 kB nelle pagine delle build di release android15-6.6, android16-6.12 e android17-6.18 fornisce file binari di release GKI da 16 kB non certificati. Non è necessario aggiornare i kernel da 4 KB e 16 KB contemporaneamente, anche se ti consigliamo di farlo.
  • Respin on demand: richiedi i respin GKI da 16 kB utilizzando lo stesso modulo e la stessa procedura di richiesta di respin delle build da 4 kB.

Release certificate trimestrali

Le release trimestrali della GKI contengono un boot.img testato che include un certificato inserito da Google per attestare che i file binari sono stati creati da una base di codice sorgente nota.

Ogni trimestre, viene selezionato un candidato per la release trimestrale GKI (non certificato) dopo la data limite di check-in. Dopo aver selezionato il candidato per la release trimestrale, non verranno accettate nuove modifiche nella release di quel mese. Durante il periodo di chiusura, possono essere risolti solo i bug che causano errori dei test. Il candidato per la release viene sottoposto a garanzia di qualità, come descritto nella sezione sulla qualifica GKI, per verificare che i test di conformità vengano superati su una build GSI+GKI con un dispositivo di riferimento e Cuttlefish.

Sequenza temporale della frequenza di rilascio di GKI Figura 1. Sequenza temporale delle release di GKI

Qualifiche GKI

Tipi di build GKI Applicazione delle norme sulla qualità Note
Trimestrale (certificato) Test di Cuttlefish
  • Avvio
  • VTS
  • CTS
Test dell'hardware di riferimento
  • Avvio
  • VTS
  • CTS
Respin (certificati) Test di Cuttlefish
  • Avvio
  • VTS
  • Sottoinsieme di CTS
Test dei dispositivi di riferimento
  • Avvio
  • VTS
  • Basato su una build certificata GKI.
  • La build viene certificata dopo la qualifica.

Dove ottenere gli artefatti di build

Gli OEM possono ottenere gli artefatti per tutte le release da ci.android.com.

Puoi trovare ulteriori informazioni sull'integrazione continua, inclusi i risultati dei test, nella dashboard Integrazione continua di Android.

Domande frequenti

Di seguito sono riportate alcune domande frequenti relative alla procedura di rilascio della GKI.

È possibile creare un nuovo file binario GKI basato su un GKI già rilasciato?

Sì, questa operazione è nota come "respin". Il processo di respin è supportato purché la build GKI rilasciata (su cui è richiesto il respin) sia conforme ai requisiti LTS nel Bollettino sulla sicurezza di Android (ASB).

È possibile riprodurre i file binari GKI?

Sì, ecco un esempio:

GKI 2.0
5.10 kernel prebuilts from build 7364300
https://ci.android.com/builds/submitted/7364300/kernel_aarch64/latest

Per riprodurre l'esempio, scarica manifest_$id.xml ed esegui questo comando:

repo init -u https://android.googlesource.com/kernel/manifest
mv manifest_7364300.xml .repo/manifests
repo init -m manifest_7364300.xml --depth=1
repo sync
# build the GKI images
# You may want to use LTO=thin to build faster for development
BUILD_CONFIG=common/build.config.gki.aarch64 build/build.sh
# (optional) build virtual platform modules
BUILD_CONFIG=common-modules/virtual-device/build.config.virtual_device.aarch64 build/build.sh

Puoi recuperare la copia dell'artefatto GKI da out/.../dist.

Il file binario GKI (inclusa la patch di emergenza) è stato creato sulla base di codice più recente?

No. Le nuove versioni contengono solo le patch che si trovano sopra i kernel certificati trimestrali scelti. Queste nuove versioni contengono tutte le correzioni di bug che bloccano il lancio segnalate fino a un determinato momento dagli OEM che utilizzano la release trimestrale di base corrispondente. Di seguito è riportato un esempio di come si verifica questo tipo di scenario.

  • OEM1 e OEM2 decidono di utilizzare la release binaria GKI di novembre 2021.
  • OEM1 e OEM2 rilevano problemi che richiedono patch per l'assistenza. Queste patch potrebbero essere diverse o uguali.
  • Le nuove versioni basate sul file binario di novembre 2021 contengono correzioni bloccanti per il lancio segnalate sia da OEM1 che da OEM2 durante la finestra di rilascio, ma nient'altro.
  • I problemi menzionati nel secondo punto sono inclusi anche nelle successive release trimestrali di GKI.

La nuova versione di ottobre contiene tutte le patch inviate dagli OEM, ma altre patch degli OEM ci riguardano perché non sono state testate specificamente con i nostri prodotti. È possibile includere solo la nostra patch?

Non è possibile. Un percorso di riprogettazione per i singoli OEM non è scalabile. Invece, il team GKI esamina ogni singola modifica che viene inserita nelle build di respin e testa le modifiche con tutto l'hardware disponibile prima di creare una nuova build. Se il team GKI rileva che il problema è specifico di un OEM, un dispositivo o un modello, può verificare che il codice aggiunto dalla modifica venga eseguito solo sul dispositivo, sul modello o sullo SKU interessato.

Il vantaggio principale delle nuove versioni unificate è che ogni dispositivo che utilizza la stessa base di release trae vantaggio dagli altri, soprattutto se i bug rilevati sono generici e applicabili a tutti gli utenti. I bug del kernel di base rilevati durante i test degli operatori sono un esempio specifico di questo concetto.

Esistono situazioni in cui Google fornisce informazioni specifiche sulle patch degli OEM e sugli scenari dei problemi, in modo che gli OEM possano valutare l'impatto e il rischio dell'implementazione delle patch con i loro prodotti?

Google non aggiungerà mai una modifica a una build di respin finché il team GKI non avrà compreso il problema e raccolto tutti i dettagli. Puoi vederlo nel log delle modifiche (messaggio di commit). Google non rivela il dispositivo specifico interessato, ma gli OEM possono sempre trovare la descrizione del problema e la soluzione nel log delle modifiche.