Compiler des noyaux Pixel

Ce guide fournit des instructions détaillées sur le téléchargement, la compilation et le flashage d'un noyau Pixel personnalisé pour le développement. Grâce à GKI, il est désormais possible de mettre à jour le noyau indépendamment de la compilation de la plate-forme Android. Ces étapes ne s'appliquent qu'aux appareils Pixel 6 et modèles ultérieurs. En effet, les appareils Pixel 5 et les modèles antérieurs nécessitent la mise à jour des modules du noyau sur la partition vendor, qui dépend de la version de la plate-forme Android pour ces appareils. Le tableau Branches du noyau Pixel compatibles avec GKI inclut la branche du fichier manifeste du dépôt du noyau pour chaque appareil Pixel compatible avec GKI. Consultez Anciens noyaux Pixel pour les branches de fichier manifeste du noyau du Pixel 5 et des modèles antérieurs.

Le Pixel 6 et le Pixel 6 Pro sont également compatibles avec le noyau Linux en amont et peuvent démarrer à l'invite de commande de l'appareil avec uniquement les pilotes en amont. Pour en savoir plus, consultez Compiler et flasher le noyau Pixel en amont.

Compiler et flasher les noyaux GKI Pixel

Cette section fournit les étapes à suivre pour synchroniser, compiler et flasher les branches du noyau compatibles avec GKI. Le tableau suivant fournit un mappage des appareils Pixel compatibles et des branches de dépôt du noyau de production correspondantes.

Branches du noyau Pixel compatibles avec GKI

En plus des noyaux compatibles en usine, les appareils Pixel 6 et Pixel 6 Pro sont compatibles à des fins de développement GKI uniquement sur les branches du noyau commun Android incluses dans le tableau Combinaisons de plates-formes et de noyaux Android Pixel 6 et Pixel 6 Pro compatibles. En raison des différences d'UAPI du fournisseur entre les HAL de la plate-forme Android et les pilotes du noyau Pixel, le tableau fournit les combinaisons de compilation compatibles.

Combinaisons de plate-forme et de noyau Android compatibles avec les Pixel 6 et Pixel 6 Pro

Préparer votre appareil Pixel

L'organigramme suivant décrit le processus de mise à jour du noyau sur les appareils Pixel 6 et ultérieurs :

Flasher l'appareil à l'aide de flash.android.com

1. Accédez à flash.android.com.
2. Choisissez la version Android en fonction des combinaisons de plate-forme et de noyau Android compatibles.
   • Pour android-latest-release, sélectionnez "Retour à la version publique", "Canary" ou "Bêta".
3. Sélectionnez les options suivantes :
   • Effacer les données de l'appareil
   • Forcer le flash de toutes les partitions
   • Désactiver la validation
4. Appuyez sur le bouton Installer la compilation pour flasher l'appareil.

Synchroniser le dépôt du noyau

Exécutez les commandes suivantes pour télécharger le code source du noyau. Consultez le tableau Combinaisons de plate-forme et de noyau Android compatibles avec le Pixel 6 et le Pixel 6 Pro pour le Pixel KERNEL_MANIFEST_BRANCH.

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

repo sync -c --no-tags

Mettre à jour le ramdisk du fournisseur

Mettez à jour le fichier vendor_ramdisk-DEVICE.img dans le dépôt du noyau pour qu'il corresponde à la version de plate-forme Android installée sur l'appareil. Il existe plusieurs façons de mettre à jour le fichier vendor_ramdisk-DEVICE.img. Utilisez l'option (1) si vous utilisez Android 15 QPR2 (BP11.241025.006) ou version ultérieure. Sinon, utilisez l'option 2.

• Option 1) Mettre à jour uniquement les bits DTB et DLKM du ramdisk de la partition vendor_boot

  À partir de la version 35.0.2-12583183 de fastboot, vous pouvez flasher directement le DTB et le ramdisk DLKM sur la partition vendor_boot. Mettez à niveau vos outils de plate-forme Android vers la version 36.0.0 ou ultérieure pour utiliser cette option. Pour ce faire, exécutez la commande suivante :

  $ANDROID_HOME/cmdline-tools/latest/bin/sdkmanager "platform-tools"
  

  Suivez les instructions pour flasher le DTB et vendor_boot:dlkm dans Flasher les images du noyau.

• Option 2) Extrayez l'image ramdisk du fournisseur à partir de l'image d'usine Pixel.

  1. Téléchargez l'image d'usine compatible avec votre appareil depuis https://developers.google.com/android/images.

  2. Extrayez le fichier vendor_boot.img :

     Les commandes suivantes utilisent la version AP1A.240505.004 du Pixel 6 Pro comme exemple. Remplacez le nom du fichier ZIP par celui de l'image système d'usine que vous avez téléchargée.

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

       cd raven-ap1a.240505.004
     

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

  3. Décompressez le fichier vendor_boot.img pour obtenir le ramdisk du fournisseur.

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

  4. Copiez le fichier vendor-ramdisk-by-name/ramdisk_ extrait dans le dépôt du noyau Pixel.

     Appareil	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
     

Compiler le noyau

Dans Android 13, le script build.sh a été remplacé par un nouveau système de compilation du noyau appelé Kleaf. Pour les appareils utilisant android13-5.15 ou une version ultérieure, le noyau doit être créé à l'aide de Kleaf.

Pour plus de simplicité, vous pouvez exécuter le script build_DEVICE.sh disponible sur KERNEL_REPO_ROOT. Dans la plupart des cas, DEVICE doit être le nom de code, qui peut être le nom de code d'un appareil, tel que "akita" (Pixel 8a), ou un nom de code qui représente un groupe d'appareils associés qui partagent un noyau, tel que "caimito" qui signifie Pixel 9 (tokay), Pixel 9 Pro (caiman) et Pixel 9 Pro XL (komodo). Pour android14 et les versions antérieures, utilisez build_slider.sh pour le Pixel 6 et le Pixel 6 Pro, et build_cloudripper.sh pour le Pixel 7 et le Pixel 7 Pro.

Par exemple, pour compiler le noyau pour Pixel 6 sur la branche android-gs-raviole-5.10-android14, vous devez exécuter la commande suivante :

build_slider.sh

Par défaut, sur les branches du noyau de production, les scripts build_DEVICE.sh utilisent le noyau GKI précompilé pour accélérer le processus de compilation. Si vous souhaitez modifier le noyau principal, définissez la variable d'environnement BUILD_AOSP_KERNEL=1 pour compiler le noyau à partir des sources locales. Les branches du noyau de développement compilent directement la source du noyau par défaut.

Pour en savoir plus sur le système de compilation du noyau et sur la personnalisation de la compilation, consultez Kleaf : compiler des noyaux Android avec Bazel.

Flasher les images du noyau

Remarque : Si vous n'avez pas désactivé la validation, vous devez le faire avant de flasher le noyau personnalisé. Voici la commande à exécuter :

fastboot oem disable-verification

AVERTISSEMENT : Si vous flashez un noyau personnalisé sur une version de plate-forme, vous devrez peut-être effacer les données de votre appareil en cas de rétrogradation du niveau de correctif de sécurité (SPL) associée au nouveau noyau. Cette opération efface toutes vos données à caractère personnel. Assurez-vous de sauvegarder vos données avant de les effacer.

fastboot -w

Pour flasher les images du noyau, exécutez la commande fastboot flash pour chaque partition du noyau listée pour votre appareil. Pour les partitions dynamiques, vous devez redémarrer en mode fastbootd avant le flashage.

Voici les commandes de flashage pour le Pixel 6 sur android-mainline :

fastboot flash boot        out/slider/dist/boot.img
fastboot flash dtbo        out/slider/dist/dtbo.img
fastboot flash  --dtb out/slider/dist/dtb.img vendor_boot:dlkm out/slider/dist/initramfs.img
fastboot reboot fastboot
fastboot flash vendor_dlkm out/slider/dist/vendor_dlkm.img

Pour le Pixel 6, le Pixel 6 Pro et le Pixel 6a, si vous avez mis à jour vendor_ramdisk dans Mettre à jour le ramdisk du fournisseur, utilisez plutôt la commande suivante pour mettre à jour la partition vendor_boot :

fastboot flash vendor_boot out/slider/dist/vendor_boot.img

Les images du noyau se trouvent dans DIST_DIR.

Remarque : Si vous disposez d'un dongle série et que vous souhaitez activer les journaux série, la commande est la suivante :

fastboot oem uart enable
fastboot oem uart config 3000000

Exemple de commande pour se connecter depuis l'hôte :

screen -fn /dev/ttyUSB* 3000000

Restaurer les images d'usine

Pour restaurer les images d'usine sur votre appareil, vous pouvez utiliser flash.android.com.

Compiler et flasher le noyau Pixel en amont

Étant donné que les Pixel 6 et Pixel 6 Pro sont compatibles avec le noyau Linux en amont, vous pouvez utiliser android-mainline avec uniquement les pilotes en amont pour démarrer une invite shell de l'appareil pour le développement du noyau. Cette section explique comment synchroniser, compiler et flasher un noyau Pixel 6 et Pixel 6 Pro à partir de android-mainline.

Suivez les étapes suivantes pour commencer.

1. Préparez votre appareil en suivant les étapes décrites dans Préparer votre appareil Pixel.
2. Synchronisez la branche du fichier manifeste du noyau common-android-mainline en suivant la procédure décrite dans Synchroniser le dépôt du noyau.

3. La configuration de la cible de compilation Kleaf est définie sous le chemin d'accès KERNEL_REPO_ROOT/devices/google/raviole. Pour compiler la cible de compilation raviole_upstream, exécutez la commande Kleaf :

   tools/bazel run //devices/google/raviole:raviole_upstream_dist
   

4. Comme pour les noyaux de production, désactivez la validation et effacez votre appareil lorsque vous flashez un noyau personnalisé sur les images d'usine Android. Pour en savoir plus, consultez les notes de la section Flasher les images du noyau.

5. En mode fastboot, exécutez les commandes suivantes pour flasher les images du noyau :

   fastboot flash boot        out/raviole_upstream/dist/boot.img
   fastboot flash dtbo        out/raviole_upstream/dist/dtbo.img
   fastboot flash  --dtb out/raviole_upstream/dist/dtb.img \
       vendor_boot:dlkm out/raviole_upstream/dist/initramfs.img
   

6. Pour accéder à l'invite de commande shell d'un appareil, vous pouvez redémarrer en mode Recovery en exécutant la commande suivante :

   fastboot reboot recovery
   

   Ouvrez le shell de l'appareil en exécutant la commande adb shell. L'accès racine peut également être utilisé en exécutant la commande adb root.

Anciens noyaux Pixel

À titre de référence, le tableau Branches du noyau Pixel antérieur fournit les branches du dépôt du noyau pour le Pixel 5 et les appareils plus anciens. Il s'agit d'appareils non compatibles avec GKI.

Anciennes branches du noyau Pixel