GKI 1.0: tests de compatibilité

Cette page explique comment obtenir des images de démarrage avec des artefacts de compilation du noyau pour les tests de compatibilité.

Obtenir des images de démarrage

Dans AOSP, vous pouvez obtenir des images de démarrage prédéfinies sur ci.android.com. Les images de démarrage sont contenues dans l'archive aosp_arm64-img-*.zip de la cible de compilation aosp_arm64, comme suit:

Les images de démarrage signées et non signées sont disponibles avec les options de compression du noyau suivantes:

  • boot-5.4.img est un noyau non compressé.
  • boot-5.4-gz est un kernel compressé gzip.
  • boot-5.4-lz4 est un noyau compressé LZ4.

À des fins de développement, vous pouvez utiliser des précompilés de kernel et des images de démarrage GKI qui exportent tous les symboles du kernel (les symboles sont untrimmed). Les précompilés de kernel non élagués sont générés dans la cible kernel_debug_aarch64 pour un build de kernel particulier sur ci.android.com. Les images de démarrage GKI non élaguées sont générées dans les builds userdebug, ainsi que les images de démarrage GKI élaguées normales. Leurs noms de fichier se terminent par -allsyms.img.

Obtenir les artefacts de compilation du noyau

Lorsque vous déboguez des problèmes dans un fichier boot.img GKI, il est utile de disposer également des artefacts de compilation associés au noyau dans ce fichier. Par exemple, vous pouvez utiliser le vmlinux non tronqué pour le débogage et le fichier manifeste pour reproduire la compilation du kernel GKI en local. Pour obtenir des artefacts de compilation:

  1. Recherchez le numéro de compilation du kernel précompilé utilisé pour créer le boot.img GKI. Le numéro de build s'affiche à la fin de la version du kernel, précédé des lettres ab. L'exemple suivant affiche le numéro de build en gras:

    [ 0.000000] Linux version 5.4.49-00947-g9d21bcd4897b-ab6638796

    Vous pouvez également déterminer le numéro de build du noyau à l'aide de grep pour trouver une image de démarrage contenant un noyau non compressé:

    grep -a "Linux version " boot-5.4.img

  2. Ouvrez la version précompilée du kernel à l'aide du numéro de compilation dans l'URL suivante : https://ci.android.com/builds/submitted/<number>/kernel_aarch64/latest

    Par exemple, en utilisant le numéro de build de l'étape 1, l'URL est la suivante : https://ci.android.com/builds/submitted/6638796/kernel_aarch64/latest

    Lorsque vous utilisez une version non coupée, remplacez kernel_aarch64 dans le lien par kernel_debug_aarch64.