Tworzenie jąder Pixela

Ten przewodnik zawiera szczegółowe instrukcje pobierania, kompilowania i flashowania niestandardowego jądra Pixela na potrzeby programowania. Dzięki GKI można teraz aktualizować jądro niezależnie od kompilacji platformy Android. Te czynności dotyczą tylko urządzeń Pixel 6 i nowszych. Dzieje się tak, ponieważ na Pixelu 5 i starszych urządzeniach trzeba zaktualizować moduły jądra na partycji vendor, która zależy od wersji platformy Android na tych urządzeniach. Tabela gałęzi jądra Pixela obsługiwanych przez GKI zawiera gałąź pliku manifestu repozytorium jądra dla każdego urządzenia Pixel obsługiwanego przez GKI. W przypadku gałęzi manifestu jądra dla Pixela 5 i starszych należy zapoznać się z sekcją Starsze jądra Pixela.

GKI obsługiwane gałęzie jądra Pixela

Oprócz jąder obsługiwanych fabrycznie urządzenia Pixel 6 i 6 Pro są obsługiwane do celów związanych z rozwojem GKI tylko w odgałęziach jądra Android Common wymienionych w tabeli Obsługiwane kombinacje platformy i jądra Androida na Pixelu 6/6 Pro. Ze względu na różnice w użytkowniku UAPI między interfejsami HAL platformy Android a sterownikami jądra Pixela w tabeli podano obsługiwane kombinacje kompilacji.

Obsługiwane kombinacje platformy Android i jądra na Pixelu 6/6 Pro

Przygotuj urządzenie Pixel

Ten schemat przepływu danych opisuje proces aktualizacji jądra na urządzeniach Pixel 6 i nowszych:

Flashowanie urządzenia za pomocą witryny flash.android.com

1. Otwórz stronę flash.android.com.
2. Wybierz wersję Androida na podstawie obsługiwanych kombinacji platformy i jądra Androida.
3. Wybierz te opcje:
   • Wyczyść pamięć urządzenia
   • Wymuś flashowanie wszystkich partycji
   • Wyłączanie weryfikacji
4. Aby zaflashować urządzenie, naciśnij przycisk Zainstaluj wersję.

Pobieranie i kompilowanie jądra

Synchronizowanie repozytorium jądra

Aby pobrać kod źródłowy jądra, uruchom te polecenia. Zapoznaj się z tabelą Wspierane kombinacje platformy Android i jądra na Pixelu 6/6 Pro, aby dowiedzieć się, jakie wersje Androida i jądra są obsługiwane na urządzeniuKERNEL_MANIFEST_BRANCH.

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

repo sync -c --no-tags

Aktualizowanie pamięci RAM dostawcy

Zaktualizuj plik vendor_ramdisk-DEVICE.img w repozytorium jądra, aby pasował do wersji platformy Android, która jest flashowana na urządzeniu. Masz kilka opcji do wyboru.

Opcja 1. Wyodrębnij obraz dostawcy z obrazu Pixel factory.

1. Pobierz obsługiwany obraz fabryczny dla swojego urządzenia na stronie https://developers.google.com/android/images.

2. Wyodrębnij vendor_boot.img:

   • W podanych niżej poleceniach jako przykład użyto telefonu Pixel 6 Pro AP1A.240505.004. Zastąp nazwę pliku zip nazwą pliku pobranego obrazu fabrycznego.

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

     cd raven-ap1a.240505.004
   

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

3. Rozpakuj plik vendor_boot.img, aby uzyskać dysk RAM dostawcy.

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

4. Skopiuj wyekstrahowany plik vendor-ramdisk-by-name/ramdisk_ do repozytorium jądra Pixela.

   Urządzenie	DEVICE_RAMDISK_PATH
   Pixel 6 (pomarańczowy) Pixel 6 Pro (czarny)	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
   

Opcja 2. Skopiuj vendor_ramdisk z repozytorium platformy Androida utworzonego lokalnie.

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

Kompilowanie jądra (Kleaf)

W Androidzie 13 skrypt build.sh został zastąpiony nowym systemem kompilacji jądra o nazwie Kleaf. W przypadku urządzeń z android13-5.15 lub nowszą wersją jądra należy użyć Kleaf.

W przypadku Pixela 6 i 6 Pro z jądrem android14 lub nowszym uruchom komendę kompilacji Kleaf:

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

W przypadku Pixela 6 i Pixela 6 Pro z jądrem android13-5.15 uruchom komendę kompilowania Kleaf:

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

W przypadku wszystkich innych jąder Pixela uruchom skrypt build_DEVICE.sh, który znajdziesz na stronie KERNEL_REPO_ROOT. W większości przypadków DEVICE musi być nazwą kodu, która jest zgodna z nazwą kodu użytą w kolumnie Ścieżka binarna w drzewie AOSP w tabeli GKI obsługiwane gałęzie jądra Pixela. Może to być nazwa kodowa jednego urządzenia, np. „akita” (Pixel 8a), lub nazwa kodowa, która reprezentuje grupę powiązanych urządzeń z tym samym jądrem, np. „caimito”, co oznacza Pixel 9 (tokay), Pixel 9 Pro (caiman) i Pixel 9 Pro XL (komodo). W przypadku wersji android14 i starszych na Pixelu 6 i Pixelu 6 Pro użyj wartości build_slider.sh, a na Pixelu 7 i Pixelu 7 Pro – wartości build_cloudripper.sh.

Aby na przykład utworzyć jądro dla Pixela 6 na gałęzi android-gs-raviole-5.10-android14, uruchom to polecenie:

build_slider.sh

Domyślnie skrypty build_DEVICE.sh używają wstępnie skompilowanego jądra GKI, aby przyspieszyć proces kompilacji. Jeśli chcesz zmodyfikować jądro jądra, ustaw zmienną środowiskową BUILD_AOSP_KERNEL=1, aby skompilować jądro z źródeł lokalnych.

Więcej informacji o systemie kompilacji jądra i o dostosowywaniu kompilacji znajdziesz w artykule Kleaf – kompilowanie jąder Androida za pomocą Bazel.

Flashowanie obrazów jądra

Uwaga: jeśli nie wyłączysz weryfikacji, musisz to zrobić przed zainstalowaniem niestandardowego jądra. Oto polecenie:

fastboot oem disable-verification

OSTRZEŻENIE: jeśli flashujesz niestandardowe jądro na platformie, może być konieczne wyczyszczenie urządzenia, jeśli nowe jądro powoduje obniżenie poziomu poprawek zabezpieczeń (SPL). Ten proces spowoduje usunięcie wszystkich danych osobowych. Przed wyczyszczeniem pamięci utwórz kopię zapasową danych.

fastboot -w

Aby zaflashować obrazy jądra, uruchom polecenie fastboot flash dla każdej partycji jądra wymienionej dla Twojego urządzenia. W przypadku partycji dynamicznych przed zapisaniem danych musisz ponownie uruchomić urządzenie w trybie fastbootd.

Oto polecenia flashowania na Pixelu 6 w wersji 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

Obrazy jądra znajdziesz w DIST_DIR.

Uwaga: jeśli masz klucz USB i chcesz włączyć dzienniki szeregowe, wykonaj to polecenie:

fastboot oem uart enable
fastboot oem uart config 3000000

Przykładowe polecenie do połączenia z hosta:

screen -fn /dev/ttyUSB* 3000000

Przywracanie obrazów fabrycznych

Aby przywrócić urządzenie do ustawień fabrycznych, możesz użyć strony flash.android.com.

Starsze jądra Pixel

W tabeli starsze gałęzie jądra Pixela podano gałęzie repozytorium jądra dla Pixela 5 i starszych urządzeń. Te urządzenia nie obsługują GKI.

Starsze gałęzie jądra Pixel