Membangun kernel Pixel

Panduan ini memberikan petunjuk langkah demi langkah tentang cara mendownload, mengompilasi, dan mem-flash kernel Pixel kustom untuk pengembangan. Berkat GKI, kini Anda dapat mengupdate kernel secara terpisah dari build platform Android. Langkah-langkah ini hanya berlaku untuk perangkat Pixel 6 dan yang lebih baru. Hal ini karena Pixel 5 dan perangkat sebelumnya memerlukan update modul kernel di partisi vendor, yang bergantung pada build platform Android untuk perangkat tersebut. Tabel cabang kernel Pixel yang didukung GKI menyertakan cabang manifes repositori kernel untuk setiap perangkat Pixel yang didukung GKI. Lihat bagian Kernel Pixel Lama untuk Pixel 5 dan cabang manifes kernel yang lebih lama.

Cabang kernel Pixel yang didukung GKI

Selain kernel yang didukung pabrik, perangkat Pixel 6 dan 6 Pro hanya didukung untuk tujuan pengembangan GKI di cabang kernel Android Common yang disertakan dalam tabel Kombinasi Platform Android dan Kernel Pixel 6/6 Pro yang Didukung. Karena perbedaan UAPI vendor antara HAL platform Android dan driver kernel Pixel, tabel ini menyediakan kombinasi build yang didukung.

Kombinasi kernel dan platform Android Pixel 6/6 Pro yang didukung

Siapkan perangkat Pixel Anda

Diagram alir berikut menjelaskan proses untuk mengupdate kernel di perangkat Pixel 6 dan yang lebih baru:

Mem-flash perangkat menggunakan flash.android.com

1. Buka flash.android.com
2. Pilih build Android berdasarkan kombinasi Platform Android dan Kernel yang didukung.
3. Pilih opsi berikut:
   • Hapus Total Perangkat
   • Mem-flash Semua Partisi secara Paksa
   • Nonaktifkan Verifikasi
4. Tekan tombol Instal build untuk melakukan flash perangkat.

Mendownload dan mengompilasi kernel

Menyinkronkan repositori kernel

Jalankan perintah berikut untuk mendownload kode sumber kernel. Lihat tabel Kombinasi Platform Android dan Kernel Pixel 6/6 Pro yang Didukung untuk Pixel KERNEL_MANIFEST_BRANCH.

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

repo sync -c --no-tags

Mengupdate ramdisk vendor

Perbarui file vendor_ramdisk-DEVICE.img di repositori kernel agar cocok dengan build platform Android yang di-flash di perangkat. Ada beberapa opsi yang dapat Anda ikuti.

Opsi 1) Ekstrak image ramdisk vendor dari setelan pabrik Pixel.

1. Download setelan pabrik yang didukung untuk perangkat Anda dari https://developers.google.com/android/images.

2. Ekstrak vendor_boot.img:

   • Perintah berikut menggunakan Pixel 6 Pro AP1A.240505.004 sebagai contohnya. Ganti nama file zip dengan nama file image factory yang Anda download.

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

     cd raven-ap1a.240505.004
   

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

3. Ekstrak vendor_boot.img untuk mendapatkan ramdisk vendor.

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

4. Salin file vendor-ramdisk-by-name/ramdisk_ yang diekstrak ke repositori kernel Pixel.

   Perangkat	DEVICE_RAMDISK_PATH
   Pixel 6 (oriole) Pixel 6 Pro (raven)	prebuilts/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
   

Opsi 2) Salin vendor_ramdisk dari repositori platform Android yang di-build secara lokal.

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

Mengompilasi kernel (Kleaf)

Di Android 13, skrip build.sh diganti dengan sistem build kernel baru yang disebut Kleaf. Untuk perangkat yang menggunakan android13-5.15 dan yang lebih baru, kernel harus di-build menggunakan Kleaf.

Untuk Pixel 6 dan 6 Pro dengan kernel android14 dan yang lebih baru, jalankan perintah build Kleaf:

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

Untuk Pixel 6 dan 6 Pro dengan kernel android13-5.15, jalankan perintah build Kleaf:

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

Untuk semua kernel Pixel lainnya, jalankan skrip build_DEVICE.sh yang ditemukan di KERNEL_REPO_ROOT. Pada sebagian besar kasus, DEVICE harus berupa nama kode yang cocok dengan nama kode yang digunakan di kolom Jalur biner dalam hierarki AOSP dari tabel Cabang kernel Pixel yang didukung GKI. Nama ini dapat berupa nama kode satu perangkat, seperti "akita" (Pixel 8a), atau nama kode yang mewakili sekelompok perangkat terkait yang menggunakan kernel yang sama, seperti "caimito" yang berarti Pixel 9 (tokay), Pixel 9 Pro (caiman), dan Pixel 9 Pro XL (komodo). Untuk rilis android14 dan yang lebih lama, gunakan build_slider.sh untuk Pixel 6 dan Pixel 6 Pro, serta build_cloudripper.sh untuk Pixel 7 dan Pixel 7 Pro.

Misalnya, untuk mem-build kernel Pixel 6 di cabang android-gs-raviole-5.10-android14, Anda harus menjalankan perintah:

build_slider.sh

Secara default, skrip build_DEVICE.sh menggunakan kernel GKI bawaan untuk mempercepat proses build. Jika Anda ingin mengubah kernel inti, tetapkan variabel lingkungan BUILD_AOSP_KERNEL=1 untuk mem-build kernel dari sumber lokal.

Untuk mengetahui detail selengkapnya tentang sistem build kernel dan cara menyesuaikan build, lihat Kleaf - Building Android Kernels with Bazel.

Mem-flash image kernel

Catatan: Jika belum menonaktifkan verifikasi, Anda harus melakukannya sebelum mem-flash kernel kustom. Berikut adalah perintah untuk melakukannya:

fastboot oem disable-verification

PERINGATAN: Jika mem-flash kernel kustom di atas build platform, Anda mungkin perlu menghapus total perangkat jika ada downgrade level patch keamanan (SPL) yang terkait dengan kernel baru. Proses ini akan menghapus semua data pribadi Anda. Pastikan untuk mencadangkan data Anda sebelum menghapus total.

fastboot -w

Untuk mem-flash image kernel, jalankan perintah fastboot flash untuk setiap partisi kernel yang tercantum untuk perangkat Anda. Untuk partisi dinamis, Anda harus memulai ulang ke mode fastbootd sebelum melakukan flash.

Berikut adalah perintah flash untuk Pixel 6 di 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

Image kernel dapat ditemukan di DIST_DIR.

Catatan: Jika Anda memiliki dongle serial dan ingin mengaktifkan log serial, perintahnya adalah:

fastboot oem uart enable
fastboot oem uart config 3000000

Contoh perintah untuk terhubung dari host:

screen -fn /dev/ttyUSB* 3000000

Memulihkan image pabrik

Untuk memulihkan perangkat kembali ke setelan pabrik, Anda dapat menggunakan flash.android.com.

Kernel Pixel lama

Sebagai referensi, tabel cabang kernel Pixel lama menyediakan cabang repositori kernel untuk perangkat Pixel 5 dan yang lebih lama. Ini adalah perangkat yang didukung non-GKI.

Cabang kernel Pixel lama