A partire dal 2026, per allinearci al nostro modello di sviluppo trunk stabile e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per compilare e contribuire ad AOSP, utilizza android-latest-release. Il branch del manifest android-latest-release farà sempre riferimento alla release più recente pubblicata su AOSP. Per saperne di più, consulta la sezione Modifiche ad AOSP.

Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

GkiDeviceFlashPreparer

public class GkiDeviceFlashPreparer
extends BaseTargetPreparer implements ILabPreparer

java.lang.Object
↳	com.android.tradefed.targetprep.BaseTargetPreparer
	↳	com.android.tradefed.targetprep.GkiDeviceFlashPreparer

Un preparatore di destinazione che esegue il flash del dispositivo con l'immagine generica del kernel comune di Android. Per informazioni dettagliate, visita la pagina https://source.android.com/devices/architecture/kernel/android-common.

Riepilogo

Costruttori pubblici
`GkiDeviceFlashPreparer()`

Metodi pubblici
`void`	`setUp(TestInformation testInfo)` Esegui la configurazione del target per il test.
`void`	`validateGkiBootImg(ITestDevice device, IBuildInfo buildInfo)` Verifica che l'immagine di avvio GKI sia quella prevista.

Metodi protetti
`void`	`addHashFooter(ITestDevice device, IBuildInfo buildInfo, File tmpDir)` Verifica che l'immagine di avvio GKI sia quella prevista.
`void`	`buildGkiSystemDlkmImg(ITestDevice device, IBuildInfo buildInfo, File tmpDir)` Crea l'immagine GKI system_dlkm se viene fornito l'archivio system_dlkm.
`File`	`extractSystemDlkmTarGzip(File systemDlkmArchive)` Estrae il file tar gzip system_dlkm nella cartella di staging system_dlkm.
`void`	`flattenSystemDlkm(ITestDevice device, File systemDlkmStagingDir)` Appiattisci la directory di staging system_dlkm in modo che tutti i moduli del kernel si trovino direttamente in /lib/modules.
`String[]`	`getDeviceKernelVersion(ITestDevice device)` Ottieni la versione kernel del dispositivo prima di eseguire il flashing.
`IHostOptions`	`getHostOptions()` Ottieni un riferimento a `IHostOptions`
`String[]`	`getKernelVersionFromImage(File image)` Estrae la versione kernel dai file immagine boot/vendor_boot/system_dlkm/vendor_dlkm.
`File`	`getRequestedFile(ITestDevice device, String requestedFileName, File sourceFile, File tmpDir)` Recupera il file richiesto dal file di origine (zip o cartella) in base al nome del file richiesto.
`IRunUtil`	`getRunUtil()` Ottieni l'istanza `IRunUtil` da utilizzare.
`String[]`	`parseKernelVersion(String source, String kernelVersionString)`
`void`	`validateGkiBootImg(ITestDevice device, IBuildInfo buildInfo, File tmpDir)` Verifica che l'immagine di avvio GKI sia quella prevista.
`void`	`validateKernelCompatibility(String imageName, String[] imageVersion, String[] bootVersion, ITestDevice device)`
`void`	`validateKernelVersion(ITestDevice device, IBuildInfo buildInfo, File tmpDir)` Verifica che le versioni del kernel nelle immagini siano quelle previste.

Costruttori pubblici

GkiDeviceFlashPreparer

public GkiDeviceFlashPreparer ()

Metodi pubblici

setUp

public void setUp (TestInformation testInfo)

Esegui la configurazione del target per il test.

Parametri
`testInfo`	`TestInformation`: il `TestInformation` della chiamata.

Genera
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

validateGkiBootImg

public void validateGkiBootImg (ITestDevice device, 
                IBuildInfo buildInfo)

Verifica che l'immagine di avvio GKI sia quella prevista. (Obsoleto. Chiama con tmpDir fornito)

Parametri
`device`	`ITestDevice`: il `ITestDevice`
`buildInfo`	`IBuildInfo`: le `IBuildInfo` le informazioni sulla build

Genera
`TargetSetupError`	se non è presente un boot.img GKI valido

Metodi protetti

addHashFooter

protected void addHashFooter (ITestDevice device, 
                IBuildInfo buildInfo, 
                File tmpDir)

Verifica che l'immagine di avvio GKI sia quella prevista. Genera un'eccezione se non è presente alcun boot.img valido.

Parametri
`device`	`ITestDevice`: il `ITestDevice`
`buildInfo`	`IBuildInfo`: le `IBuildInfo` le informazioni sulla build
`tmpDir`	`File`: la directory temporanea `File`

Genera
`TargetSetupError`	se non è presente un boot.img GKI valido
`DeviceNotAvailableException`

buildGkiSystemDlkmImg

protected void buildGkiSystemDlkmImg (ITestDevice device, 
                IBuildInfo buildInfo, 
                File tmpDir)

Crea l'immagine GKI system_dlkm se viene fornito l'archivio system_dlkm.

Parametri
`device`	`ITestDevice`: il `ITestDevice`
`buildInfo`	`IBuildInfo`: le `IBuildInfo` le informazioni sulla build
`tmpDir`	`File`: la directory temporanea `File`

Genera
`TargetSetupError`	se si verifica un errore durante la creazione del file immagine.

extractSystemDlkmTarGzip

protected File extractSystemDlkmTarGzip (File systemDlkmArchive)

Estrae il file tar gzip system_dlkm nella cartella di staging system_dlkm. Questa funzione è un wrapper intorno a ERROR(/TarUtil.extractTarGzipToTemp) per simulare l'estrazione per i test delle unità.

Parametri
`systemDlkmArchive`	`File`: il file tar gzip system_dlkm contenente i moduli GKI.

Resi
`File`	File contenente i contenuti di system_dlkm tar gzip.

Genera
	java.io.IOException
`IOException`

flattenSystemDlkm

protected void flattenSystemDlkm (ITestDevice device, 
                File systemDlkmStagingDir)

Appiattisci la directory di staging system_dlkm in modo che tutti i moduli del kernel si trovino direttamente in /lib/modules. Ciò è necessario per corrispondere al layout previsto del file system_dlkm per le build della piattaforma.

Parametri
`device`	`ITestDevice`: il `ITestDevice`
`systemDlkmStagingDir`	`File`: the system_dlkm staging directory `File`

Genera
`IOException`	o TargetSetupError se si verifica un errore durante l'appiattimento di system_dlkm.
`TargetSetupError`

getDeviceKernelVersion

protected String[] getDeviceKernelVersion (ITestDevice device)

Ottieni la versione kernel del dispositivo prima di eseguire il flashing.

Parametri
`device`	`ITestDevice`: il `ITestDevice` da cui ottenere la versione kernel.

Resi
`String[]`	Un `ERROR(/String[])` contenente le informazioni sulla versione kernel analizzate: [kernelVersion, patchLevel, pageSize]. Restituisce null se non è possibile analizzare la stringa della versione.2

Genera
`DeviceNotAvailableException`

getHostOptions

protected IHostOptions getHostOptions ()

Ottieni un riferimento a IHostOptions

Resi
`IHostOptions`	`IHostOptions` da utilizzare

getKernelVersionFromImage

protected String[] getKernelVersionFromImage (File image)

Estrae la versione kernel dai file immagine boot/vendor_boot/system_dlkm/vendor_dlkm. Questo metodo legge il file immagine boot/vendor_boot/system_dlkm/vendor_dlkm e cerca un pattern specifico nelle stringhe della versione kernel Android. Quindi analizza la stringa trovata per estrarre la versione kernel in un formato standardizzato.

Parametri
`image`	`File`: Il `File` al file immagine di avvio (ad es. boot.img).

Resi
`String[]`	Un `ERROR(/String[])` contenente le informazioni sulla versione kernel analizzate: [kernelVersion, patchLevel, pageSize]. Restituisce null se la stringa della versione non può essere analizzata.

getRequestedFile

protected File getRequestedFile (ITestDevice device, 
                String requestedFileName, 
                File sourceFile, 
                File tmpDir)

Recupera il file richiesto dal file di origine (zip o cartella) in base al nome del file richiesto.

Il file sorgente fornito può essere un file ZIP. Il metodo lo decomprimerà nella directory temporanea e troverà il file richiesto in base al nome fornito.

Il file sorgente fornito può essere una cartella di file. Il metodo troverà il file richiesto in base al nome file fornito.

Parametri
`device`	`ITestDevice`: il `ITestDevice`
`requestedFileName`	`String`: la stringa del nome file richiesto
`sourceFile`	`File`: il file sorgente
`tmpDir`	`File`

Resi
`File`	il file specificato dal nome del file richiesto

Genera
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

getRunUtil

protected IRunUtil getRunUtil ()

Ottieni l'istanza IRunUtil da utilizzare.

Resi
`IRunUtil`	`IRunUtil` da utilizzare

parseKernelVersion

protected String[] parseKernelVersion (String source, 
                String kernelVersionString)

Parametri
`source`	`String`
`kernelVersionString`	`String`

Resi
`String[]`

validateGkiBootImg

protected void validateGkiBootImg (ITestDevice device, 
                IBuildInfo buildInfo, 
                File tmpDir)

Verifica che l'immagine di avvio GKI sia quella prevista. Genera un'eccezione se non è presente alcun boot.img valido.

Parametri
`device`	`ITestDevice`: il `ITestDevice`
`buildInfo`	`IBuildInfo`: le `IBuildInfo` le informazioni sulla build
`tmpDir`	`File`: la directory temporanea `File`

Genera
`TargetSetupError`	se non è presente un boot.img GKI valido

validateKernelCompatibility

protected void validateKernelCompatibility (String imageName, 
                String[] imageVersion, 
                String[] bootVersion, 
                ITestDevice device)

Parametri
`imageName`	`String`
`imageVersion`	`String`
`bootVersion`	`String`
`device`	`ITestDevice`

Genera
`TargetSetupError`

validateKernelVersion

protected void validateKernelVersion (ITestDevice device, 
                IBuildInfo buildInfo, 
                File tmpDir)

Verifica che le versioni del kernel nelle immagini siano quelle previste. Genera un'eccezione se non è valido.

Parametri
`device`	`ITestDevice`: il `ITestDevice`
`buildInfo`	`IBuildInfo`: le `IBuildInfo` le informazioni sulla build
`tmpDir`	`File`: la directory temporanea `File`

Genera
`TargetSetupError`	se non è presente un boot.img GKI valido
`DeviceNotAvailableException`