A partire dal 27 marzo 2025, ti consigliamo di utilizzare android-latest-release anziché aosp-main per compilare e contribuire ad AOSP. Per ulteriori informazioni, vedi Modifiche ad AOSP.

Questa pagina è stata tradotta dall'API Cloud Translation.

Test VTS con ramdisk di debug

A partire da Android 10, l'immagine di sistema generica (GSI) utilizzata per eseguire i test di conformità CTS-on-GSI/VTS è cambiata dal tipo di build userdebug a user per essere firmata per il rilascio. Si tratta di un problema per i test VTS perché VTS richiede l'esecuzione di adb root, ma adb root non è disponibile su un dispositivo di build utente.

Il ramdisk di debug (o l'immagine di avvio di debug) viene introdotto per abilitare adb root su un dispositivo di build utente il cui bootloader è sbloccato. In questo modo, il flusso di test viene semplificato utilizzando la stessa build utente GSI system.img per CTS-on-GSI e VTS-on-GSI. Per la configurazione di STS, è ancora necessario utilizzare un altro OEM system.img userdebug.

La tabella seguente mostra le modifiche al tipo di immagine e di build per i test di conformità in Android 10.

Suite di test	Testa con	Build	Debug ramdisk	adb root?	Modifica della variante di compilazione di Android 9 -> 10
CTS	Sistema dell'OEM	utente	N	N	Nessuna influenza
CTS-on-GSI	GSI	utente	N	N	userdebug -> user GSI release firmata
STS	Sistema dell'OEM	userdebug	N	Y	Novità di Q
VTS	GSI	utente	Y	Y	userdebug -> user GSI release firmata

Panoramica

Questi file immagine aggiuntivi vengono generati nella cartella di build (${ANDROID_PRODUCT_OUT}):

boot-debug.img
vendor_boot-debug.img

Quando boot-debug.img viene installato nella partizione boot del dispositivo, vengono caricati la versione userdebug del file sepolicy di sistema e un file di proprietà aggiuntivo, adb_debug.prop. In questo modo adb root con la build utente system.img (GSI o OEM).

Per Generic Kernel Image (GKI) che utilizzano dispositivi con una partizione vendor_boot, boot-debug.img non deve essere flashato, in quanto la partizione boot deve essere flashata con un'immagine GKI certificata. Invece, vendor_boot-debug.img deve essere flashato nella partizione vendor_boot per facilitare il debug di ramdisk.

Prerequisiti per l'utilizzo di un ramdisk di debug

Il ramdisk di debug viene fornito dall'OEM che esegue i test di conformità. Non deve essere firmato per la release e può essere utilizzato solo se il dispositivo è sbloccato.

Il ramdisk di debug non verrà generato o utilizzato per l'upgrade dei dispositivi con:

BOARD_BUILD_SYSTEM_ROOT_IMAGE true
skip_initramfs nella riga di comando del kernel

GSI Android 12

Non sono necessarie istruzioni aggiuntive per utilizzare debug ramdisk con GSI Android 12.

A partire dal 29/09/2021, i ramdisk di debug non richiedono più l'aggiornamento con lo strumento repack_bootimg. La build GSI di Android 12 successiva a SGR1.210929.001 (7777720) incorpora il file userdebug_plat_sepolicy.cil aggiornato in system.img e ignora userdebug_plat_sepolicy.cil dal ramdisk di debug. Per maggiori dettagli, consulta le CL.

GSI Android 11

Quando viene utilizzato boot-debug.img o vendor_boot-debug.img, il sistema sepolicy viene caricato dal file userdebug_plat_sepolicy.cil nel ramdisk di debug di boot-debug.img o vendor_boot-debug.img. Per avviare le immagini GSI, incorpora sempre le modifiche sepolicy aggiornate dal ramo android11-gsi per ricompilare boot-debug.img o vendor_boot-debug.img.

In alternativa, lo strumento repack_bootimg potrebbe essere utilizzato per ricompilare un'immagine boot-debug.img o vendor_boot-debug.img con sepolicy GSI aggiornata.

Ricompilare un ramdisk di debug

Invece di incorporare le modifiche a sepolicy per ricompilare boot-debug.img, i partner possono utilizzare repack_bootimg per aggiornare il file sepolicy GSI in boot-debug.img (o vendor_boot-debug.img se il dispositivo utilizza GKI).

I passaggi sono i seguenti:

Scarica otatools.zip da https://ci.android.com. Ti consigliamo di scaricare gli artefatti di build di aosp_cf_arm64_only_phone-userdebug nel ramo aosp-android-latest-release.

Configura l'ambiente di esecuzione per repack_bootimg:

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

Scarica userdebug_plat_sepolicy.cil o boot-with-debug-ramdisk-${KERNEL_VERSION}.img dalla build GSI che stai utilizzando. Ad esempio, se utilizzi una GSI arm64 di RJR1.211020.001 (7840830), scaricala da https://ci.android.com/builds/submitted/7840830/aosp_arm64-user/latest.

Importante :il ${KERNEL_VERSION} non è pertinente in questo caso. Puoi utilizzare uno qualsiasi dei boot-with-debug-ramdisk-${KERNEL_VERSION}.img.
Nota:dal 27/09/2021, boot-debug-${KERNEL_VERSION}.img in una build GSI è stato rinominato in boot-with-debug-ramdisk-${KERNEL_VERSION}.img.

Aggiorna il dispositivo boot-debug.img o vendor_boot-debug.img con 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

Con 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

Gli argomenti di --ramdisk_add possono essere modificati in base alle configurazioni del dispositivo. Per una spiegazione dettagliata, consulta la sezione successiva.

Percorso di userdebug sepolicy

Il comando repack_bootimg precedente copia il file userdebug_plat_sepolicy.cil dal ramdisk di --src_bootimg al ramdisk di --dst_bootimg. Tuttavia, il percorso all'interno di un ramdisk di debug potrebbe essere diverso in versioni diverse di Android. In Android 10 e 11, il percorso è first_stage_ramdisk/userdebug_plat_sepolicy.cil per i dispositivi con androidboot.force_normal_boot=1 nella riga di comando del kernel. In caso contrario, il percorso è userdebug_plat_sepolicy.cil.

Esegui questo comando per verificare se è presente androidboot.force_normal_boot nella riga di comando del kernel:

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

A partire da Android 12, il percorso all'interno di un ramdisk di debug è sempre userdebug_plat_sepolicy.cil, indipendentemente dall'esistenza di androidboot.force_normal_boot=1 nella riga di comando del kernel. La seguente tabella mostra i percorsi all'interno di un ramdisk di debug in diverse versioni di Android.

Immagine di debug	Android 10	Android 11	Android 12
GKI boot-with-debug-ramdisk-${KERNEL_VERSION}.img	N/D	`first_stage_ramdisk/userdebug_plat_sepolicy.cil`	`userdebug_plat_sepolicy.cil`
boot-debug.img specifico per il dispositivo	Dipende da force_normal_boot	Dipende da force_normal_boot	`userdebug_plat_sepolicy.cil`
vendor_boot-debug.img specifico per il dispositivo	N/D	Dipende da force_normal_boot	`userdebug_plat_sepolicy.cil`

Puoi specificare --ramdisk_add per copiare file da e verso percorsi diversi con un elenco di coppie src_path:dst_path. Ad esempio, il seguente comando copia il file first_stage_ramdisk/userdebug_plat_sepolicy.cil da un boot-with-debug-ramdisk-5.4.img Android 11 a first_stage_ramdisk/userdebug_plat_sepolicy.cil all'interno di 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

Se nella riga di comando del kernel non è presente androidboot.force_normal_boot=1, il comando deve essere modificato come indicato di seguito per cambiare il percorso di destinazione in 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

Aggiungere un piè di pagina AVB

Se l'immagine passata a --dst_bootimg è configurata come partizione AVB-chained, è necessario aggiungere un piè di pagina AVB dopo aver eseguito il comando repack_bootimg.

Ad esempio, prima di eseguire repack_bootimg, esegui il seguente comando per verificare se un vendor_boot-debug.img ha un piè di pagina AVB concatenato.

avbtool info_image --image vendor_boot-debug.img

Se originariamente ha un piè di pagina AVB concatenato, è necessario aggiungere un piè di pagina AVB dopo l'esecuzione del comando repack_bootimg. L'utilizzo di qualsiasi chiave di test per firmare vendor_boot-debug.img funziona perché il ramdisk di debug può essere utilizzato solo quando un dispositivo è sbloccato, il che consente immagini firmate con chiavi non di rilascio sulla partizione boot o 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