Test VTS avec ramdisk de débogage

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Depuis Android 10, l'image système générique (GSI) utilisée pour exécuter les tests de conformité CTS-on-GSI/VTS est passée de userdebug à user build type afin d'être signée. Il s'agit d'un pour les tests VTS, car il nécessite adb root, mais adb root n'est pas disponible sur un appareil de build d'utilisateur.

Le disque RAM de débogage (ou image de démarrage de débogage) est introduit pour activer adb root sur une appareil de build de l'utilisateur dont le bootloader est déverrouillée. Cela simplifie le flux de test en utilisant le même system.img GSI de compilation utilisateur pour CTS-on-GSI et VTS-on-GSI. Pour la configuration STS, l'utilisation d'un autre system.img OEM pour le débogage utilisateur reste obligatoire.

Le tableau suivant montre les modifications apportées aux images et aux types de compilation pour les tests de conformité dans Android 10.

Présentation

Ces fichiers image supplémentaires sont générés sous le dossier de compilation (${ANDROID_PRODUCT_OUT}):

• boot-debug.img
• vendor_boot-debug.img

Lorsque boot-debug.img est flashé sur la partition boot de l'appareil, la version userdebug du fichier sepolicy du système et un fichier de propriétés supplémentaire, adb_debug.prop, sont chargés. Cela permet à adb root d'utiliser la compilation utilisateur system.img (GSI ou OEM).

Pour les images de kernel génériques (GKI, Generic Kernel Image) utilisant des appareils dotés d'une partition vendor_boot, boot-debug.img ne doit pas être flashé, car la partition boot doit être flashée avec une image GKI certifiée. À la place, vendor_boot-debug.img doit être flashé sur la partition vendor_boot afin de faciliter le débogage du ramdisk.

Conditions préalables à l'utilisation d'un ramdisk de débogage

Le ramdisk de débogage est fourni par l'OEM qui exécute les tests de conformité. Il ne doit pas être signé pour la publication et ne peut être utilisé que si l'appareil est déverrouillé.

Le ramdisk de débogage ne sera pas généré ni utilisé pour mettre à niveau les appareils avec :

• BOARD_BUILD_SYSTEM_ROOT_IMAGE vrai
• skip_initramfs dans la ligne de commande du noyau

Images système génériques Android 12

Aucune instruction supplémentaire n'est requise pour utiliser le ramdisk de débogage avec le GSI Android 12.

Depuis le 29/09/2021, il n'est plus nécessaire de mettre à jour les ramdisks de débogage avec repack_bootimg. Images système génériques Android 12 une fois que SGR1.210929.001 (7777720) aura intégré les mises à jour userdebug_plat_sepolicy.cil dans son system.img et ignore userdebug_plat_sepolicy.cil à partir du disque RAM de débogage. Consultez le CL pour plus de détails.

Image système générique Android 11

Lorsque boot-debug.img ou vendor_boot-debug.img est utilisé, le système sepolicy est chargé à partir du fichier userdebug_plat_sepolicy.cil dans le fichier de débogage ramdisk de boot-debug.img ou vendor_boot-debug.img. Pour démarrer des images GSI, veuillez toujours intégrer les modifications de sepolicy à jour de la branche android11-gsi afin de reconstruire votre boot-debug.img ou vendor_boot-debug.img.

Vous pouvez également utiliser l'outil repack_bootimg pour recréer un boot-debug.img ou vendor_boot-debug.img avec la stratégie de sécurité GSI mise à jour.

Reconditionner un ramdisk de débogage

Au lieu d'intégrer les changements de règles pour recréer boot-debug.img, les partenaires Vous pouvez utiliser repack_bootimg pour mettre à jour le fichier de règles GSI dans boot-debug.img. (ou vendor_boot-debug.img si l'appareil utilise GKI).

La procédure est la suivante :

1. Télécharger otatools.zip depuis https://ci.android.com Nous vous recommandons de télécharger l'application à partir des artefacts de compilation de aosp_arm64-userdebug le aosp-main.

2. Configurez l'environnement d'exécution pour repack_bootimg :

   unzip otatools.zip -d otatools
   export PATH="${PWD}/otatools/bin:${PATH}"
   repack_bootimg --help

3. Téléchargez userdebug_plat_sepolicy.cil ou boot-with-debug-ramdisk-${KERNEL_VERSION}.img à partir du build GSI que vous utilisez. Par exemple, si vous utilisez une GSI arm64 à partir de RJR1.211020.001 (7840830), puis téléchargez depuis https://ci.android.com/builds/submitted/7840830/aosp_arm64-user/latest

4. Mettez à jour l'appareil boot-debug.img ou vendor_boot-debug.img avec userdebug_plat_sepolicy.cil:

   repack_bootimg --local --dst_bootimg boot-debug.img \
       --ramdisk_add userdebug_plat_sepolicy.cil:userdebug_plat_sepolicy.cil \
       --ramdisk_add userdebug_plat_sepolicy.cil:first_stage_ramdisk/userdebug_plat_sepolicy.cil
   # If using GKI
   repack_bootimg --local --dst_bootimg vendor_boot-debug.img \
       --ramdisk_add userdebug_plat_sepolicy.cil:userdebug_plat_sepolicy.cil \
       --ramdisk_add userdebug_plat_sepolicy.cil:first_stage_ramdisk/userdebug_plat_sepolicy.cil

   Avec boot-with-debug-ramdisk-${KERNEL_VERSION}.img:

   repack_bootimg --src_bootimg boot-with-debug-ramdisk-5.4.img \
       --dst_bootimg boot-debug.img \
       --ramdisk_add first_stage_ramdisk/userdebug_plat_sepolicy.cil:userdebug_plat_sepolicy.cil \
       --ramdisk_add first_stage_ramdisk/userdebug_plat_sepolicy.cil:first_stage_ramdisk/userdebug_plat_sepolicy.cil
   # If using GKI
   repack_bootimg --src_bootimg boot-with-debug-ramdisk-5.4.img \
       --dst_bootimg vendor_boot-debug.img \
       --ramdisk_add first_stage_ramdisk/userdebug_plat_sepolicy.cil:userdebug_plat_sepolicy.cil \
       --ramdisk_add first_stage_ramdisk/userdebug_plat_sepolicy.cil:first_stage_ramdisk/userdebug_plat_sepolicy.cil

   Les arguments de --ramdisk_add peuvent être ajustés en fonction des configurations de l'appareil. Consultez la section suivante pour en savoir plus explicative.

Chemin d'accès de la règle de débogage userdebug

repack_bootimg ci-dessus copie le fichier userdebug_plat_sepolicy.cil du ramdisk de --src_bootimg vers le ramdisk de --dst_bootimg. Toutefois, le chemin d'accès dans un ramdisk de débogage peut être différent selon les versions d'Android. Dans Android 10 et 11, le chemin d'accès est first_stage_ramdisk/userdebug_plat_sepolicy.cil pour les appareils avec androidboot.force_normal_boot=1 dans la ligne de commande du noyau. Sinon, le chemin d'accès est userdebug_plat_sepolicy.cil.

Exécutez la commande suivante pour vérifier si androidboot.force_normal_boot figure dans la ligne de commande du noyau :

adb root
adb shell cat /proc/cmdline | grep force_normal_boot

À partir d'Android 12, le chemin d'accès dans un fichier de débogage ramdisk est toujours userdebug_plat_sepolicy.cil, quelle que soit l'existence de androidboot.force_normal_boot=1 dans la ligne de commande du noyau. Le tableau suivant présente les chemins d'accès dans un ramdisk de débogage dans différentes versions d'Android.

Vous pouvez spécifier --ramdisk_add pour copier des fichiers à partir et vers différents chemins d'accès à l'aide d'une liste de paires src_path:dst_path. Par exemple, la commande suivante copie fichier first_stage_ramdisk/userdebug_plat_sepolicy.cil d'un boot-with-debug-ramdisk-5.4.img Android 11 vers first_stage_ramdisk/userdebug_plat_sepolicy.cil dans un vendor_boot-debug.img Android 11.

repack_bootimg \
    --src_bootimg boot-with-debug-ramdisk-5.4.img \
    --dst_bootimg vendor_boot-debug.img \
    --ramdisk_add first_stage_ramdisk/userdebug_plat_sepolicy.cil:first_stage_ramdisk/userdebug_plat_sepolicy.cil

Si aucun androidboot.force_normal_boot=1 n'est défini dans la ligne de commande du kernel, la commande doit être ajustée comme indiqué ci-dessous pour remplacer le chemin de destination par userdebug_plat_sepolicy.cil.

repack_bootimg \
    --src_bootimg boot-with-debug-ramdisk-5.4.img \
    --dst_bootimg vendor_boot-debug.img \
    --ramdisk_add first_stage_ramdisk/userdebug_plat_sepolicy.cil:userdebug_plat_sepolicy.cil

Ajouter un pied de page AVB

Si l'image transmise à --dst_bootimg est configurée en tant que Enchaînement AVB un pied de page AVB doit être ajouté après l'exécution de repack_bootimg .

Par exemple, avant d'exécuter repack_bootimg, exécutez la commande suivante pour : vérifier si un vendor_boot-debug.img a un pied de page AVB enchaîné.

avbtool info_image --image vendor_boot-debug.img

S'il comporte à l'origine un pied de page AVB enchaîné, un pied de page AVB doit être ajouté après l'exécution de la commande repack_bootimg. En utilisant n'importe quelle clé de test vendor_boot-debug.img fonctionne, car le disque RAM de débogage ne peut être utilisé que lorsqu'un l'appareil est déverrouillé, ce qui permet d'obtenir des images signées sans autorisation par une clé sur le boot ou vendor_boot.

avbtool add_hash_footer --partition_name vendor_boot \
    --partition_size 100663296 \
    --algorithm SHA256_RSA4096 \
    --key otatools/external/avb/test/data/testkey_rsa4096.pem \
    --image vendor_boot-debug.img