À partir du 27 mars 2025, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main pour créer et contribuer à AOSP. Pour en savoir plus, consultez la section Modifications apportées à AOSP.

Cette page a été traduite par l'API Cloud Translation.

ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

Sous-classes indirectes connues

BaseEmulatorPreparer, BaseTargetPreparer, BuildInfoRecorder, CreateAvdPreparer, CreateUserPreparer, DeviceBuildInfoBootStrapper, DeviceBuildInfoInjector, DeviceCleaner, DeviceFlashPreparer, DeviceImageZipFlashingTargetPreparer, DeviceSetup, DeviceUpdateTargetPreparer, FastbootUpdateBootstrapPreparer, FoldableModePreparer, GkiDeviceFlashPreparer, et 15 autres.

BaseEmulatorPreparer	Préparateur commun pour le lancement d'un émulateur local.
BaseTargetPreparer	Classe d'implémentation de base pour `ITargetPreparer`, qui permet de contrôler si l'objet est désactivé ou non.
BuildInfoRecorder	`ITargetPreparer` qui écrit les métadonnées d'informations de compilation dans un fichier spécifié.
CreateAvdPreparer
CreateUserPreparer	Préparateur de cible pour créer un utilisateur et le nettoyer à la fin.
DeviceBuildInfoBootStrapper	Un `ITargetPreparer` qui remplace les champs d'informations de compilation par des attributs lus à partir de l'appareil Cette option est utile pour tester des appareils avec des builds générés à partir d'une source externe (par exemple,
DeviceBuildInfoInjector	Un `ITargetPreparer` qui insère des métadonnées `DeviceBuildDescriptor` dans `IBuildInfo`.
DeviceCleaner	Effectue un redémarrage ou un formatage en tant qu'action de nettoyage après le test, et éteint éventuellement l'écran.
DeviceFlashPreparer	`ITargetPreparer` qui flashe une image sur du matériel Android physique.
DeviceImageZipFlashingTargetPreparer	Un préparateur de cible qui flashe l'appareil avec des images fournies via un format spécifique.
DeviceSetup	`ITargetPreparer` qui configure un appareil pour les tests en fonction des `Option` fournies.
DeviceUpdateTargetPreparer	`ITargetPreparer` abstrait qui gère les étapes courantes de mise à jour des appareils avec un fichier d'image d'appareil à partir d'une source externe (par opposition à un service de compilation).
FastbootUpdateBootstrapPreparer	Un `ITargetPreparer` qui met en scène des fichiers spécifiés (chargeur de démarrage, radio, fichier ZIP de l'image de l'appareil) dans `IDeviceBuildInfo` pour flasher les appareils avec `FastbootDeviceFlasher`, puis injecte des attributs d'appareil post-démarrage dans les informations de compilation à des fins de création de rapports sur les résultats.
FoldableModePreparer	Préparateur cible pouvant modifier l'état pliable d'un appareil.
GkiDeviceFlashPreparer	Un préparateur de cible qui flashe l'appareil avec l'image générique du kernel Android.
GsiDeviceFlashPreparer	Un préparateur de cible qui flashe l'appareil avec une image système générique Android.
ITargetCleaner	Cette interface est obsolète. tearDown a été déplacé vers l'interface ITargetPreparer de base.
InstallApexModuleTargetPreparer
KillExistingEmulatorPreparer	`ITargetPreparer` qui arrête un émulateur en cours d'exécution.
LocalEmulatorLaunch	Un TargetPreparer qui lance un émulateur localement à partir d'un environnement de compilation Android.
LocalEmulatorSnapshot	Un TargetPreparer destiné à générer un instantané d'émulateur propre à partir d'un environnement de compilation/développement Android
ModuleOemTargetPreparer
RecoveryLogPreparer	Un préparateur de cible utilisé pour collecter les journaux avant la récupération.
RunCommandTargetPreparer
RunOnSecondaryUserTargetPreparer	`ITargetPreparer` qui crée un utilisateur secondaire lors de la configuration et indique que les tests doivent être exécutés avec cet utilisateur.
RunOnSystemUserTargetPreparer	`ITargetPreparer` qui indique que les tests doivent être exécutés sur l'utilisateur (plutôt que sur l'utilisateur actuel).
RunOnWorkProfileTargetPreparer	Un `ITargetPreparer` qui crée un profil professionnel lors de la configuration et indique que les tests doivent être exécutés avec cet utilisateur.
StubTargetPreparer	Implémentation vide d'un `ITargetPreparer`.
SuiteApkInstaller	Installe les APK spécifiés pour la configuration de la suite: à partir de la variable $ANDROID_TARGET_OUT_TESTCASES ou du ROOT_DIR dans les informations de compilation.
TestAppInstallSetup	`ITargetPreparer` qui installe une ou plusieurs applications à partir d'un dossier `IDeviceBuildInfo.getTestsDir()` sur l'appareil.

Prépare l'environnement de test pour l'exécution du test.

(par exemple, installe des logiciels, ajuste les paramètres d'environnement pour les tests, lance des cibles, etc.)

Notez que plusieurs ITargetPreparer peuvent être spécifiés dans une configuration. Il est recommandé que chaque ITargetPreparer documente clairement son environnement attendu avant et après la configuration. Par exemple, un ITargetPreparer qui configure un appareil pour les tests doit être exécuté après l'ITargetPreparer qui installe le logiciel.

Résumé

Méthodes publiques
`default void`	`setUp(ITestDevice device, IBuildInfo buildInfo)` Cette méthode est obsolète. Utilisez plutôt `setUp(com.android.tradefed.invoker.TestInformation)`.
`default void`	`setUp(TestInformation testInformation)` Configurez la cible pour les tests.
`default void`	`tearDown(TestInformation testInformation, Throwable e)` Effectuez le nettoyage/démontage de la cible après les tests.
`default void`	`tearDown(ITestDevice device, IBuildInfo buildInfo, Throwable e)` Cette méthode est obsolète. Utilisez plutôt `tearDown(com.android.tradefed.invoker.TestInformation, Throwable)`.

Méthodes publiques

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

Cette méthode est obsolète.
Utilisez plutôt setUp(com.android.tradefed.invoker.TestInformation).

Configurez la cible pour les tests.

Paramètres
`device`	`ITestDevice`: `ITestDevice` à préparer.
`buildInfo`	`IBuildInfo`: données sur la compilation en cours de test.

Génère
`TargetSetupError`	si une erreur fatale s'est produite lors de la configuration de l'environnement
`BuildError`	Si une erreur liée à BuildInfo se produit
`DeviceNotAvailableException`	si l'appareil ne répond plus

setUp

public void setUp (TestInformation testInformation)

Configurez la cible pour les tests.

Paramètres
`testInformation`	`TestInformation`: `TestInformation` de l'appel.

Génère
`TargetSetupError`	si une erreur fatale s'est produite lors de la configuration de l'environnement
`BuildError`	Si une erreur se produit en raison de la préparation de la compilation
`DeviceNotAvailableException`	si l'appareil ne répond plus

tearDown

public void tearDown (TestInformation testInformation, 
                Throwable e)

Effectuez le nettoyage/démontage de la cible après les tests.

Paramètres
`testInformation`	`TestInformation`: `TestInformation` de l'appel.
`e`	`Throwable`: si l'appel s'est terminé par une exception, il s'agit de l'exception interceptée au niveau de l'appel. Sinon, la valeur sera `null`.

Génère
`DeviceNotAvailableException`	si l'appareil ne répond plus

tearDown

public void tearDown (ITestDevice device, 
                IBuildInfo buildInfo, 
                Throwable e)

Cette méthode est obsolète.
Utilisez plutôt tearDown(com.android.tradefed.invoker.TestInformation, Throwable).

Effectuez le nettoyage/démontage de la cible après les tests.

Paramètres
`device`	`ITestDevice`: `ITestDevice` à préparer.
`buildInfo`	`IBuildInfo`: données sur la compilation en cours de test.
`e`	`Throwable`: si l'appel s'est terminé par une exception, il s'agit de l'exception interceptée au niveau de l'appel. Sinon, la valeur sera `null`.

Génère
`DeviceNotAvailableException`	si l'appareil ne répond plus