Pixel-Kernel erstellen

Dieser Leitfaden enthält eine detaillierte Anleitung zum Herunterladen, Kompilieren und Flashen eines benutzerdefinierten Pixel-Kernels für die Entwicklung. Dank GKI ist es jetzt möglich, den Kernel unabhängig vom Android-Plattform-Build zu aktualisieren. Diese Schritte gelten nur für Google Pixel 6 und höher. Das liegt daran, dass auf Google Pixel 5 und älteren Geräten die Kernelmodule in der Partition vendor aktualisiert werden müssen. Das hängt vom Android-Plattform-Build für diese Geräte ab. Die Tabelle Von GKI unterstützte Pixel-Kernelzweige enthält den Manifest-Zweig des Kernel-Repositorys für jedes von GKI unterstützte Pixel-Gerät. Weitere Informationen zu Pixel 5 und älteren Kernel-Manifest-Zweigen finden Sie im Abschnitt Legacy-Pixel-Kernel.

Von GKI unterstützte Pixel-Kernel-Branches

Zusätzlich zu den von der Fertigung unterstützten Kerneln werden Google Pixel 6 und Google Pixel 6 Pro für die GKI-Entwicklung nur auf den Android Common-Kernel-Ästen unterstützt, die in der Tabelle Unterstützte Android-Plattform- und Kernelkombinationen für Google Pixel 6/6 Pro aufgeführt sind. Aufgrund von Anbieter-UAPI-Unterschieden zwischen den HALs der Android-Plattform und den Pixel-Kernel-Treibern sind in der Tabelle die unterstützten Build-Kombinationen aufgeführt.

Unterstützte Kombinationen aus Android-Plattform und -Kernel auf Pixel 6/6 Pro

Pixel-Gerät vorbereiten

Das folgende Flussdiagramm beschreibt den Ablauf zum Aktualisieren des Kernels auf Google Pixel 6 und höher:

Gerät über flash.android.com flashen

1. Rufen Sie flash.android.com auf.
2. Wählen Sie den Android-Build basierend auf den unterstützten Kombinationen von Android-Plattform und Kernel aus.
3. Wählen Sie die folgenden Optionen aus:
   • Gerätedaten löschen
   • Flash für alle Partitionen erzwingen
   • Überprüfung deaktivieren
4. Drücken Sie die Schaltfläche Build installieren, um das Gerät zu flashen.

Kernel herunterladen und kompilieren

Kernel-Repository synchronisieren

Führen Sie die folgenden Befehle aus, um den Kernel-Quellcode herunterzuladen. Weitere Informationen finden Sie in der Tabelle Unterstützte Android-Plattform- und Kernel-Kombinationen für Pixel 6/6 Pro für Pixel KERNEL_MANIFEST_BRANCH.

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

repo sync -c --no-tags

Anbieter-RAMdisk aktualisieren

Aktualisieren Sie die Datei vendor_ramdisk-DEVICE.img im Kernel-Repository, damit sie mit dem Android-Plattform-Build übereinstimmt, der auf das Gerät geflasht wird. Dafür gibt es mehrere Möglichkeiten.

Option 1: Extrahieren Sie das Ramdisk-Image des Anbieters aus dem Pixel-Factory Image.

1. Laden Sie das unterstützte Werksimage für Ihr Gerät unter https://developers.google.com/android/images herunter.

2. Extrahieren Sie die vendor_boot.img:

   • In den folgenden Befehlen wird Pixel 6 Pro AP1A.240505.004 als Beispiel verwendet. Ersetzen Sie den Namen der ZIP-Datei durch den Dateinamen des Factory-Images, das Sie heruntergeladen haben.

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

     cd raven-ap1a.240505.004
   

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

3. Entpacken Sie die vendor_boot.img, um das RAM-Disk des Anbieters zu erhalten.

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

4. Kopieren Sie die extrahierte vendor-ramdisk-by-name/ramdisk_-Datei in das Pixel-Kernel-Repository.

   Gerät	DEVICE_RAMDISK_PATH
   Pixel 6 (Oriole) Pixel 6 Pro (Rabe)	vorkonfigurierte/boot-artifacts/ramdisks/vendor_ramdisk-oriole.img
   Pixel 6a (bluejay)	private/devices/google/bluejay/vendor_ramdisk-bluejay.img

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

Option 2: vendor_ramdisk aus einem lokal erstellten Android-Plattform-Repository kopieren

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

Kompilieren Sie den Kernel (Kleaf)

In Android 13 wurde das build.sh-Script durch ein neues Kernel-Buildsystem namens Kleaf ersetzt. Bei Geräten mit android13-5.15 und höher sollte der Kernel mit Kleaf erstellt werden.

Führen Sie für Pixel 6 und 6 Pro mit android14 und höher den Build-Befehl von Kleaf aus:

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

Führen Sie für Pixel 6 und 6 Pro mit android13-5.15-Kerneln den Kleaf-Build-Befehl aus:

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

Führen Sie für alle anderen Pixel-Kernel das Skript build_DEVICE.sh unter KERNEL_REPO_ROOT aus. In den meisten Fällen muss DEVICE der Codename sein, der mit dem Codenamen in der Spalte Binary path in AOSP tree (Binärpfad im AOSP-Baum) der Tabelle GKI-unterstützte Pixel-Kernelzweige übereinstimmt. Das kann der Codename eines Geräts sein, z. B. „akita“ (Google Pixel 8a), oder der Codename einer Gruppe ähnlicher Geräte, die denselben Kernel verwenden, z. B. „caimito“, was für Google Pixel 9 (tokay), Google Pixel 9 Pro (caiman) und Google Pixel 9 Pro XL (komodo) steht. Verwenden Sie für android14 und ältere Versionen build_slider.sh für Google Pixel 6 und Google Pixel 6 Pro und build_cloudripper.sh für Google Pixel 7 und Google Pixel 7 Pro.

Wenn Sie beispielsweise den Kernel für Google Pixel 6 im Branch android-gs-raviole-5.10-android14 erstellen möchten, führen Sie den Befehl aus:

build_slider.sh

Standardmäßig verwenden die build_DEVICE.sh-Scripts den vorgefertigten GKI-Kernel, um den Build-Prozess zu beschleunigen. Wenn Sie den Kernkernel ändern möchten, legen Sie die Umgebungsvariable BUILD_AOSP_KERNEL=1 fest, um den Kernel stattdessen aus den lokalen Quellen zu erstellen.

Weitere Informationen zum Kernel-Buildsystem und zum Anpassen des Builds finden Sie unter Kleaf – Android-Kernel mit Bazel erstellen.

Kernel-Images blinken

Hinweis: Wenn Sie die Überprüfung nicht deaktiviert haben, müssen Sie dies tun, bevor Sie den benutzerdefinierten Kernel flashen. Dazu verwenden Sie den folgenden Befehl:

fastboot oem disable-verification

WARNUNG: Wenn Sie einen benutzerdefinierten Kernel auf einen Plattform-Build flashen, müssen Sie Ihr Gerät möglicherweise löschen, wenn mit dem neuen Kernel ein Downgrade der Sicherheitspatch-Ebene (Security Patch Level, SPL) verbunden ist. Dabei werden alle deine persönlichen Daten gelöscht. Sichern Sie unbedingt Ihre Daten, bevor Sie sie löschen.

fastboot -w

Führen Sie zum Flashen der Kernel-Images den Befehl fastboot flash für jede Kernel-Partition aus, die auf Ihrem Gerät aufgeführt ist. Bei dynamischen Partitionen müssen Sie vor dem Flashen im fastbootd-Modus neu starten.

Hier sind die Befehle zum Flashen von Pixel 6 mit 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

Die Kernel-Images finden Sie im DIST_DIR.

Hinweis: Wenn Sie einen seriellen Dongle haben und serielle Logs aktivieren möchten, lautet der Befehl:

fastboot oem uart enable
fastboot oem uart config 3000000

Beispielbefehl zum Herstellen einer Verbindung vom Host:

screen -fn /dev/ttyUSB* 3000000

Factory Images wiederherstellen

Wenn Sie Ihr Gerät auf die Factory Images zurücksetzen möchten, können Sie flash.android.com verwenden.

Alte Pixel-Kernel

In der Tabelle Alte Kernel-Branches für Google Pixel finden Sie die Kernel-Repository-Branches für Google Pixel 5 und ältere Geräte. Diese Geräte werden nicht von GKI unterstützt.

Alte Pixel-Kernelzweige