Creare kernel Pixel

Questa guida fornisce istruzioni dettagliate su come scaricare, compilare e eseguire il flash di un kernel Pixel personalizzato per lo sviluppo. Grazie a GKI, ora è possibile aggiornare il kernel indipendentemente dalla build della piattaforma Android. Questi passaggi sono applicabili solo ai dispositivi Pixel 6 e modelli successivi. Questo perché Pixel 5 e i dispositivi precedenti richiedono l'aggiornamento dei moduli del kernel nella partizione vendor, che dipende dalla build della piattaforma Android per questi dispositivi. La tabella Rali del kernel Pixel supportati da GKI include il ramo manifest del repository del kernel per ogni dispositivo Pixel supportato da GKI. Consulta la sezione Kernel Pixel legacy per i rami manifest del kernel di Pixel 5 e versioni precedenti.

Rami del kernel Pixel supportati da GKI

Oltre ai kernel supportati di fabbrica, i dispositivi Pixel 6 e 6 Pro sono supportati per lo sviluppo GKI solo sui rami di kernel Android comuni inclusi nella tabella Combinazioni di kernel e piattaforma Android per Pixel 6/6 Pro supportate. A causa delle differenze tra le UAPI dei fornitori tra gli HAL della piattaforma Android e i driver del kernel di Pixel, la tabella fornisce le combinazioni di build supportate.

Combinazioni di kernel e piattaforma Android supportate per Pixel 6/6 Pro

Prepara il dispositivo Pixel

Il seguente diagramma di flusso descrive la procedura per l'aggiornamento del kernel su Pixel 6 e dispositivi successivi:

Esegui il flashing del dispositivo utilizzando flash.android.com

1. Visita il sito flash.android.com.
2. Scegli la build Android in base alle combinazioni della piattaforma Android e del kernel supportate.
3. Seleziona le seguenti opzioni:
   • Cancella dati dispositivo
   • Forza il flash di tutte le partizioni
   • Disabilita verifica
4. Premi il pulsante Installa build per far lampeggiare il dispositivo.

Scarica e compila il kernel

Sincronizza il repository del kernel

Esegui i seguenti comandi per scaricare il codice sorgente del kernel. Fai riferimento alla tabella Combinazioni supportate per piattaforma Android e kernel Pixel 6/6 Pro per Pixel KERNEL_MANIFEST_BRANCH.

repo init -u https://android.googlesource.com/kernel/manifest -b KERNEL_MANIFEST_BRANCH

repo sync -c --no-tags

Aggiorna il ramdisk del fornitore

Aggiorna il file vendor_ramdisk-DEVICE.img nel repository del kernel in modo che corrisponda alla build della piattaforma Android su cui viene eseguito il flashing del dispositivo. Ecco alcune opzioni che puoi seguire.

Opzione 1) estrai l'immagine ramdisk del fornitore dall'immagine di fabbrica di Pixel.

1. Scarica l'immagine di fabbrica supportata per il tuo dispositivo da https://developers.google.com/android/images.

2. Estrai il vendor_boot.img:

   • I comandi riportati di seguito utilizzano Pixel 6 Pro AP1A.240505.004 come esempio. Sostituisci il nome del file ZIP con il nome del file dell'immagine di fabbrica che hai scaricato.

     unzip raven-ap1a.240505.004-factory-9d783215.zip
   

     cd raven-ap1a.240505.004
   

     unzip image-raven-ap1a.240505.004.zip vendor_boot.img
   

3. Estrai il file vendor_boot.img per ottenere il ramdisk del fornitore.

     KERNEL_REPO_ROOT/tools/mkbootimg/unpack_bootimg.py --boot_img vendor_boot.img \
         --out vendor_boot_out
   

4. Copia il file vendor-ramdisk-by-name/ramdisk_ estratto nel repository del kernel di Pixel.

   Dispositivo	DEVICE_RAMDISK_PATH
   Pixel 6 (oriole) Pixel 6 Pro (corvo)	prebuilts/boot-artifacts/ramdisks/vendor_ramdisk-oriole.img
   Pixel 6a (ghiandaia)	private/devices/google/bluejay/vendor_ramdisk-bluejay.img

     cp vendor_boot_out/vendor-ramdisk-by-name/ramdisk_ \
         KERNEL_REPO_ROOT/DEVICE_RAMDISK_PATH
   

Opzione 2) Copia l'oggetto vendor_ramdisk da un repository della piattaforma Android creato localmente.

cp ANDROID_ROOT/out/target/product/DEVICE/vendor_ramdisk-debug.img \
   KERNEL_REPO_ROOT/DEVICE_RAMDISK_PATH/vendor_ramdisk-DEVICE.img

Compila il kernel (Kleaf)

In Android 13, lo script build.sh è stato sostituito con un nuovo sistema di build del kernel denominato Kleaf. Per i dispositivi che utilizzano android13-5.15 e versioni successive, il kernel deve essere compilato utilizzando Kleaf.

Per Pixel 6 e 6 Pro con kernel android14 e successivi, esegui il comando Kleaf build:

tools/bazel run --config=fast --config=stamp //private/google-modules/soc/gs:slider_dist

Per Pixel 6 e 6 Pro con kernel android13-5.15, esegui il comando di compilazione Kleaf:

tools/bazel run --lto=thin //gs/google-modules/soc-modules:slider_dist

Per tutti gli altri kernel Pixel, esegui lo script build_DEVICE.sh che si trova all'indirizzo KERNEL_REPO_ROOT. Nella maggior parte dei casi, DEVICE deve essere il nome in codice che corrisponde al nome in codice utilizzato nella colonna Percorso binario nell'albero AOSP della tabella Ramo del kernel Pixel supportati da GKI. Può essere il nome in codice di un dispositivo, ad esempio "akita" (Pixel 8a), o un nome in codice che rappresenta un gruppo di dispositivi correlati che condividono un kernel, ad esempio "caimito", che significa Pixel 9 (tokay), Pixel 9 Pro (caiman) e Pixel 9 Pro XL (komodo). Per le release android14 e precedenti, utilizza build_slider.sh per Pixel 6 e Pixel 6 Pro e build_cloudripper.sh per Pixel 7 e Pixel 7 Pro.

Ad esempio, per creare il kernel per Pixel 6 sul ramo android-gs-raviole-5.10-android14, devi eseguire il comando:

build_slider.sh

Per impostazione predefinita, gli script build_DEVICE.sh utilizzano il kernel GKI precompilato per velocizzare il processo di compilazione. Se vuoi modificare il kernel principale, imposta la variabile di ambiente BUILD_AOSP_KERNEL=1 per creare il kernel dalle origini locali.

Per ulteriori dettagli sul sistema di compilazione del kernel e su come personalizzare la compilazione, consulta Kleaf - Building Android Kernels with Bazel.

Esegui il flashing delle immagini kernel

Nota: se non hai disattivato la verifica, devi farlo prima di eseguire il flashing del kernel personalizzato. Ecco il comando da utilizzare:

fastboot oem disable-verification

AVVISO: se stai eseguendo il flashing di un kernel personalizzato su una build della piattaforma, potresti dover cancellare i dati del dispositivo se è presente un downgrade a livello di patch di sicurezza (SPL) associato al nuovo kernel. Questa procedura cancella tutti i tuoi dati personali. Assicurati di eseguire il backup dei dati prima del reset.

fastboot -w

Per eseguire il flashing delle immagini kernel, esegui il comando fastboot flash per ogni partizione del kernel elencata per il tuo dispositivo. Per le partizioni dinamiche, devi riavviare in modalità fastbootd prima di lampeggiare.

Ecco i comandi lampeggianti per Pixel 6 su android-mainline:

fastboot flash boot        out/slider/dist/boot.img
fastboot flash dtbo        out/slider/dist/dtbo.img
fastboot flash vendor_boot out/slider/dist/vendor_boot.img
fastboot reboot fastboot
fastboot flash vendor_dlkm out/slider/dist/vendor_dlkm.img

Le immagini kernel sono disponibili in DIST_DIR.

Nota: se hai una chiavetta seriale e vuoi abilitare i log seriali, il comando è:

fastboot oem uart enable
fastboot oem uart config 3000000

Comando di esempio per la connessione dall'host:

screen -fn /dev/ttyUSB* 3000000

Ripristina le immagini di fabbrica

Per ripristinare le immagini di fabbrica sul dispositivo, puoi utilizzare flash.android.com.

Kernel Pixel precedenti

Come riferimento, la tabella Branch del kernel Pixel legacy fornisce i branch del repository del kernel per Pixel 5 e versioni precedenti. Questi sono dispositivi non supportati da GKI.

Branch del kernel di Pixel precedenti