À partir de 2026, pour nous aligner sur notre modèle de développement stable et garantir la stabilité de la plate-forme pour l'écosystème, nous publierons le code source sur AOSP au deuxième et au quatrième trimestre. Pour créer et contribuer dans AOSP, utilisez android-latest-release. La branche de fichier manifeste android-latest-release fera toujours référence à la version la plus récente envoyée à AOSP. Pour en savoir plus, consultez Modifications apportées à AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

GkiDeviceFlashPreparer

public class GkiDeviceFlashPreparer
extends BaseTargetPreparer implements ILabPreparer

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

Préparateur cible qui flashe l'appareil avec une image générique du noyau commun Android. Pour en savoir plus, veuillez consulter https://source.android.com/devices/architecture/kernel/android-common.

Résumé

Constructeurs publics
`GkiDeviceFlashPreparer()`

Méthodes publiques
`void`	`setUp(TestInformation testInfo)` Configurez la cible pour les tests.
`void`	`validateGkiBootImg(ITestDevice device, IBuildInfo buildInfo)` La validation de l'image de démarrage GKI est attendue.

Méthodes protégées
`void`	`addHashFooter(ITestDevice device, IBuildInfo buildInfo, File tmpDir)` La validation de l'image de démarrage GKI est attendue.
`void`	`buildGkiSystemDlkmImg(ITestDevice device, IBuildInfo buildInfo, File tmpDir)` Créez l'image GKI system_dlkm si l'archive system_dlkm est fournie.
`File`	`extractSystemDlkmTarGzip(File systemDlkmArchive)` Extrait le fichier gzip tar system_dlkm dans le dossier system_dlkm_staging.
`void`	`flattenSystemDlkm(ITestDevice device, File systemDlkmStagingDir)` Aplatissez le répertoire de préproduction system_dlkm afin que tous les modules du noyau se trouvent directement sous /lib/modules.
`String[]`	`getDeviceKernelVersion(ITestDevice device)` Obtenez la version du noyau de l'appareil avant le flashage.
`IHostOptions`	`getHostOptions()` Obtenez une référence à `IHostOptions`.
`String[]`	`getKernelVersionFromImage(File image)` Extrait la version du noyau à partir des fichiers image boot/vendor_boot/system_dlkm/vendor_dlkm.
`File`	`getRequestedFile(ITestDevice device, String requestedFileName, File sourceFile, File tmpDir)` Obtenez le fichier demandé à partir du fichier source (ZIP ou dossier) en fonction du nom du fichier demandé.
`IRunUtil`	`getRunUtil()` Obtenez l'instance `IRunUtil` à utiliser.
`String[]`	`parseKernelVersion(String source, String kernelVersionString)`
`void`	`validateGkiBootImg(ITestDevice device, IBuildInfo buildInfo, File tmpDir)` La validation de l'image de démarrage GKI est attendue.
`void`	`validateKernelCompatibility(String imageName, String[] imageVersion, String[] bootVersion, ITestDevice device)`
`void`	`validateKernelVersion(ITestDevice device, IBuildInfo buildInfo, File tmpDir)` Validez que les versions du noyau dans les images sont celles attendues.

Constructeurs publics

GkiDeviceFlashPreparer

public GkiDeviceFlashPreparer ()

Méthodes publiques

setUp

public void setUp (TestInformation testInfo)

Configurez la cible pour les tests.

Paramètres
`testInfo`	`TestInformation` : `TestInformation` de l'invocation.

Génère
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

validateGkiBootImg

public void validateGkiBootImg (ITestDevice device, 
                IBuildInfo buildInfo)

La validation de l'image de démarrage GKI est attendue. (Obsolète. Veuillez appeler avec tmpDir fourni)

Paramètres
`device`	`ITestDevice` : `ITestDevice`
`buildInfo`	`IBuildInfo` : `IBuildInfo`, informations sur la compilation

Génère
`TargetSetupError`	s'il n'y a pas de fichier boot.img GKI valide.

Méthodes protégées

addHashFooter

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

La validation de l'image de démarrage GKI est attendue. Génère une exception s'il n'y a pas de boot.img valide.

Paramètres
`device`	`ITestDevice` : `ITestDevice`
`buildInfo`	`IBuildInfo` : `IBuildInfo`, informations sur la compilation
`tmpDir`	`File` : répertoire temporaire `File`

Génère
`TargetSetupError`	s'il n'y a pas de fichier boot.img GKI valide.
`DeviceNotAvailableException`

buildGkiSystemDlkmImg

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

Créez l'image GKI system_dlkm si l'archive system_dlkm est fournie.

Paramètres
`device`	`ITestDevice` : `ITestDevice`
`buildInfo`	`IBuildInfo` : `IBuildInfo`, informations sur la compilation
`tmpDir`	`File` : répertoire temporaire `File`

Génère
`TargetSetupError`	s'il y a une erreur lors de la création du fichier image.

extractSystemDlkmTarGzip

protected File extractSystemDlkmTarGzip (File systemDlkmArchive)

Extrait le fichier gzip tar system_dlkm dans le dossier system_dlkm_staging. Cette fonction est un wrapper autour de ERROR(/TarUtil.extractTarGzipToTemp) afin de simuler la décompression pour les tests unitaires.

Paramètres
`systemDlkmArchive`	`File` : fichier tar gzip system_dlkm contenant les modules GKI.

Renvoie
`File`	Fichier contenant le contenu gzip tar de system_dlkm.

Génère
	java.io.IOException
`IOException`

flattenSystemDlkm

protected void flattenSystemDlkm (ITestDevice device, 
                File systemDlkmStagingDir)

Aplatissez le répertoire de préproduction system_dlkm afin que tous les modules du noyau se trouvent directement sous /lib/modules. Cela est nécessaire pour correspondre à la mise en page attendue du fichier system_dlkm pour les builds de plate-forme.

Paramètres
`device`	`ITestDevice` : `ITestDevice`
`systemDlkmStagingDir`	`File` : répertoire de préproduction system_dlkm `File`

Génère
`IOException`	ou TargetSetupError en cas d'erreur lors de l'aplatissement de system_dlkm.
`TargetSetupError`

getDeviceKernelVersion

protected String[] getDeviceKernelVersion (ITestDevice device)

Obtenez la version du noyau de l'appareil avant le flashage.

Paramètres
`device`	`ITestDevice` : `ITestDevice` à partir duquel obtenir la version du noyau.

Renvoie
`String[]`	Un `ERROR(/String[])` contenant les informations de version de noyau analysées : [kernelVersion, patchLevel, pageSize]. Renvoie la valeur "null" si la chaîne de version ne peut pas être analysée.2

Génère
`DeviceNotAvailableException`

getHostOptions

protected IHostOptions getHostOptions ()

Obtenez une référence à IHostOptions.

Renvoie
`IHostOptions`	le `IHostOptions` à utiliser

getKernelVersionFromImage

protected String[] getKernelVersionFromImage (File image)

Extrait la version du noyau à partir des fichiers image boot/vendor_boot/system_dlkm/vendor_dlkm. Cette méthode lit le fichier image boot/vendor_boot/system_dlkm/vendor_dlkm et recherche un modèle spécifique dans les chaînes de version du noyau Android. Il analyse ensuite la chaîne trouvée pour extraire la version du noyau dans un format standardisé.

Paramètres
`image`	`File` : `File` du fichier image de démarrage (par exemple, boot.img).

Renvoie
`String[]`	Un `ERROR(/String[])` contenant les informations de version de noyau analysées : [kernelVersion, patchLevel, pageSize]. Renvoie la valeur "null" si la chaîne de version ne peut pas être analysée.

getRequestedFile

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

Obtenez le fichier demandé à partir du fichier source (ZIP ou dossier) en fonction du nom du fichier demandé.

Le fichier source fourni peut être un fichier ZIP. La méthode décompressera le fichier dans un répertoire temporaire et trouvera le fichier demandé à partir du nom de fichier fourni.

Le fichier source fourni peut être un dossier. La méthode trouvera le fichier demandé en fonction du nom de fichier fourni.

Paramètres
`device`	`ITestDevice` : `ITestDevice`
`requestedFileName`	`String` : chaîne du nom de fichier demandé.
`sourceFile`	`File` : fichier source
`tmpDir`	`File`

Renvoie
`File`	le fichier spécifié par le nom de fichier demandé.

Génère
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

getRunUtil

protected IRunUtil getRunUtil ()

Obtenez l'instance IRunUtil à utiliser.

Renvoie
`IRunUtil`	le `IRunUtil` à utiliser

parseKernelVersion

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

Paramètres
`source`	`String`
`kernelVersionString`	`String`

Renvoie
`String[]`

validateGkiBootImg

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

La validation de l'image de démarrage GKI est attendue. Génère une exception s'il n'y a pas de boot.img valide.

Paramètres
`device`	`ITestDevice` : `ITestDevice`
`buildInfo`	`IBuildInfo` : `IBuildInfo`, informations sur la compilation
`tmpDir`	`File` : répertoire temporaire `File`

Génère
`TargetSetupError`	s'il n'y a pas de fichier boot.img GKI valide.

validateKernelCompatibility

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

Paramètres
`imageName`	`String`
`imageVersion`	`String`
`bootVersion`	`String`
`device`	`ITestDevice`

Génère
`TargetSetupError`

validateKernelVersion

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

Validez que les versions du noyau dans les images sont celles attendues. Génère une exception si la valeur n'est pas valide.

Paramètres
`device`	`ITestDevice` : `ITestDevice`
`buildInfo`	`IBuildInfo` : `IBuildInfo`, informations sur la compilation
`tmpDir`	`File` : répertoire temporaire `File`

Génère
`TargetSetupError`	s'il n'y a pas de fichier boot.img GKI valide.
`DeviceNotAvailableException`