À 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

AdbStopServerPreparer, AllTestAppsInstallSetup, AoaTargetPreparer, AppSetup, ArtChrootPreparer, BaseEmulatorPreparer, BaseTargetPreparer, BuildInfoRecorder, CheckPairingPreparer, CompanionAllocator, CompanionAwarePreparer, CompanionRunCommandTargetPreparer, CompanionTestAppInstallSetup, CompileBootImageWithSpeedTargetPreparer, CpuThrottlingWaiter et 79 autres.

AdbStopServerPreparer	Le préparateur cible doit arrêter le serveur adb sur l'hôte avant et après l'exécution des tests adb.
AllTestAppsInstallSetup	Un `ITargetPreparer` qui installe toutes les applications d'un dossier `IDeviceBuildInfo.getTestsDir()` sur l'appareil.
AoaTargetPreparer	`ITargetPreparer` qui exécute une série d'actions (clics et balayages, par exemple) à l'aide du protocole Android Open Accessory (AOAv2).
AppSetup	Un `ITargetPreparer` qui installe un APK et ses tests.
ArtChrootPreparer	Créez un répertoire chroot pour les tests ART.
BaseEmulatorPreparer	Préparateur commun pour lancer 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	Un `ITargetPreparer` qui écrit des métadonnées d'informations de compilation dans un fichier spécifié.
CheckPairingPreparer	Un `CompanionAwarePreparer` qui vérifie l'association Bluetooth entre les appareils principal et associé
CompanionAllocator	Classe de base qui gère l'allocation et la libération de l'appareil associé `getCompanionDeviceSelectionOptions()` doit être implémenté pour décrire les critères nécessaires à l'attribution de l'appareil associé.
CompanionAwarePreparer	`ITargetPreparer` qui encapsule la logique d'obtention d'un appareil associé déjà attribué.
CompanionRunCommandTargetPreparer	Un `ITargetPreparer` qui exécute les commandes spécifiées sur l'appareil associé attribué
CompanionTestAppInstallSetup	Un `ITargetPreparer` qui installe une ou plusieurs applications à partir d'un dossier `IDeviceBuildInfo.getTestsDir()` sur un appareil associé attribué.
CompileBootImageWithSpeedTargetPreparer	Recompile le classpath de démarrage et le serveur système avec le filtre de compilation "speed".
CpuThrottlingWaiter	Un `ITargetPreparer` qui attend que la fréquence maximale sur tous les cœurs soit rétablie au niveau le plus élevé disponible
CreateAvdPreparer
CreateUserPreparer	Préparateur cible pour la création et la suppression de l'utilisateur à la fin.
DeviceActionTargetPreparer	`ITargetPreparer` pour effectuer des actions sur l'appareil.
DeviceBuildInfoBootStrapper	Un `ITargetPreparer` qui remplace les champs d'informations sur la compilation par des attributs lus à partir de l'appareil Cela 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 le `IBuildInfo`.
DeviceCleaner	Redémarre ou formate l'appareil comme action de nettoyage après le test, et éteint éventuellement l'écran.
DeviceFlashPreparer	Un `ITargetPreparer` qui flashe une image sur un matériel Android physique.
DeviceImageZipFlashingTargetPreparer	Préparateur de cibles qui flashe l'appareil avec les images de l'appareil fournies dans un format spécifique.
DeviceOwnerTargetPreparer	`ITargetPreparer` qui configure un composant de propriétaire de l'appareil.
DeviceSetup	Un `ITargetPreparer` qui configure un appareil pour les tests en fonction des `Option` fournies.
DeviceStorageFiller	Demandez au préparateur cible de remplir l'espace de stockage afin qu'un certain espace libre soit disponible.
DeviceStringPusher	Préparateur de cible pour écrire une chaîne dans un fichier.
DeviceUpdateTargetPreparer	`ITargetPreparer` abstrait qui gère les étapes courantes de mise à jour des appareils avec un fichier image d'appareil provenant d'une source externe (par opposition à un service de compilation).
DeviceWiper	Un `ITargetPreparer` qui efface les données utilisateur
DisableSELinuxTargetPreparer	Préparateur cible qui désactive SELinux s'il est activé.
DynamicSystemPreparer	Un `ITargetPreparer` qui configure une image système sur une version d'appareil avec la mise à jour dynamique du système.
EraseUserDataPreparer	Un `ITargetPreparer` qui efface les données utilisateur sur l'appareil.
FastbootCommandPreparer	Préparateur cible qui déclenche fastboot et envoie des commandes fastboot.
FastbootUpdateBootstrapPreparer	Un `ITargetPreparer` qui prépare les fichiers spécifiés (bootloader, radio, fichier ZIP de l'image de l'appareil) dans `IDeviceBuildInfo` pour flasher les appareils avec `FastbootDeviceFlasher`, puis injecte les attributs de l'appareil post-boot dans les informations de compilation à des fins de reporting des résultats.
FeatureFlagTargetPreparer	Met à jour DeviceConfig (indicateurs de fonctionnalité ajustés par un service à distance).
FoldableModePreparer	Préparateur de cibles capable de modifier l'état pliable d'un appareil.
FolderSaver	Un `ITargetPreparer` qui extrait les répertoires de l'appareil, les compresse et les enregistre dans le backend de journalisation.
FutilityCommandPreparer	Préparateur pour exécuter les commandes d'inutilité.
GkiDeviceFlashPreparer	Préparateur cible qui flashe l'appareil avec une image générique du noyau commun Android.
GoogleAccountPreparer	Un `ITargetPreparer` permettant de configurer des comptes Google.
GsiDeviceFlashPreparer	Préparateur cible qui flashe l'appareil avec l'image système générique Android.
ILabPreparer	Interface de marqueur pour les préparateurs d'ateliers Consultez `ITargetPreparer` pour obtenir une description de l'objectif de ces interfaces.
ITargetCleaner	Cette interface est obsolète. tearDown a été déplacé vers l'interface ITargetPreparer de base.
InstallAllTestZipAppsSetup	Un `ITargetPreparer` qui installe toutes les applications dans un fichier ZIP de test.
InstallApexModuleTargetPreparer
InstallApkSetup	Un `ITargetPreparer` qui installe un ou plusieurs APK situés sur le système de fichiers.
InstallBuildEnvApkSetup	Un `ITargetPreparer` qui installe un ou plusieurs APK de test à partir d'un environnement de compilation de plate-forme Android.
InstallKernelModulePreparer	Un préparateur de cibles qui installe des modules de noyau.
InstrumentationPreparer	Un `ITargetPreparer` qui exécute l'instrumentation
KillExistingEmulatorPreparer	Un `ITargetPreparer` qui arrête un émulateur en cours d'exécution.
KnownFailurePreparer	Préparateur cible pour ignorer la nouvelle tentative en cas d'échec connu.
LocalEmulatorLaunch	Un TargetPreparer qui lance un émulateur localement à partir d'un environnement de compilation Android.
LocalEmulatorSnapshot	TargetPreparer destiné à générer un instantané d'émulateur propre à partir d'un environnement de compilation/développement Android
MixKernelTargetPreparer	`ITargetPreparer` permettant de combiner une image de noyau avec l'image de l'appareil.
MixRadioTargetPreparer	Un `ITargetPreparer` qui permet de mélanger une image radio avec l'image de l'appareil.
ModuleOemTargetPreparer
NativeLeakCollector	Un `ITargetPreparer` qui exécute "dumpsys meminfo --unreachable -a" pour identifier la mémoire native inaccessible actuellement détenue par chaque processus.
NoApkTestSkipper	Préparateur spécial qui permet d'ignorer complètement une invocation (préparation et tests) s'il n'y a pas d'APK à tester.
PerfettoPreparer	Le préparateur Perfetto envoie le fichier de configuration sur l'appareil à un emplacement standard auquel Perfetto a accès.
ProfileTargetPreparer	Classe de base pour configurer le préparateur cible pour tout utilisateur de profil `android.os.usertype.profile.XXX`.
PushFileInvoker	Cette classe est obsolète. Utilisez plutôt `PushFilePreparer`.
PushFilePreparer	`ITargetPreparer` qui tente d'envoyer un nombre quelconque de fichiers depuis n'importe quel chemin d'accès à l'hôte vers n'importe quel chemin d'accès à l'appareil.
PythonVirtualenvPreparer	Configure un environnement virtuel Python sur l'hôte et installe les packages.
RebootTargetPreparer	Préparateur cible qui redémarre l'appareil.
RecoveryLogPreparer	Préparateur de cible utilisé pour collecter les journaux avant la récupération.
RemoveSystemAppPreparer	Un `ITargetPreparer` pour supprimer un APK de la partition système avant un test.
RestartSystemServerTargetPreparer	Préparateur cible qui redémarre le serveur système sans redémarrer l'appareil.
RootTargetPreparer	Préparateur cible qui effectue "adb root" ou "adb unroot" en fonction de l'option "force-root".
RootcanalForwarderPreparer
RunCommandTargetPreparer
RunHostCommandTargetPreparer	Préparateur cible pour exécuter des commandes hôtes arbitraires avant et après l'exécution du test.
RunHostScriptTargetPreparer	Préparateur cible qui exécute un script avant d'exécuter un test.
RunOnCloneProfileTargetPreparer
RunOnPrivateProfileTargetPreparer
RunOnSdkSandboxTargetPreparer	Un `ITargetPreparer` pour indiquer que les tests doivent être exécutés dans le bac à sable du SDK.
RunOnSecondaryUserTargetPreparer	Un `ITargetPreparer` pour s'assurer que le test s'exécute en tant qu'utilisateur secondaire.
RunOnSystemUserTargetPreparer	Un `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 dans cet utilisateur.
SemaphoreTokenTargetPreparer	Il s'agit d'un préparateur utilisé pour sérialiser l'exécution des tests dans l'hôte Tradefed à l'aide d'un jeton.
SideloadOtaTargetPreparer	Un préparateur de cibles qui effectue le transfert d'un package OTA spécifié, applique le package, attend le démarrage de l'appareil et injecte les propriétés de compilation de l'appareil à utiliser comme informations de compilation Ce préparateur de cible suppose que l'appareil sera en mode adb normal au démarrage et veillera à ce que l'appareil quitte le même mode, mais avec la version la plus récente appliquée.
StopServicesSetup	Un `ITargetPreparer` qui arrête les services sur l'appareil.
StubTargetPreparer	Implémentation vide d'espace réservé 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 de ROOT_DIR dans les informations de compilation.
SwitchUserTargetPreparer	Un `ITargetPreparer` qui passe au type d'utilisateur spécifié dans setUp.
TearDownPassThroughPreparer	Permet d'exécuter tearDown sur les préparateurs inclus dans une configuration en tant qu'objet.
TemperatureThrottlingWaiter	Un `ITargetPreparer` qui attend que la température de l'appareil redescende à la température cible
TestAppInstallSetup	Un `ITargetPreparer` qui installe une ou plusieurs applications à partir d'un dossier `IDeviceBuildInfo.getTestsDir()` sur l'appareil.
TestFilePushSetup	Un `ITargetPreparer` qui transfère un ou plusieurs fichiers/dossiers d'un dossier `IDeviceBuildInfo.getTestsDir()` vers l'appareil.
TestSystemAppInstallSetup	Un `ITargetPreparer` qui installe une ou plusieurs applications à partir d'un dossier `IDeviceBuildInfo.getTestsDir()` sur la partition /system de l'appareil.
TimeWaster	Un simple préparateur de cibles pour perdre du temps et potentiellement redémarrer l'appareil.
UserCleaner	Un `ITargetPreparer` qui supprime les utilisateurs secondaires lors de la suppression.
VisibleBackgroundUserPreparer	Préparateur cible pour exécuter des tests dans un utilisateur démarré en arrière-plan visible.
WaitForDeviceDatetimePreparer	Un `ITargetPreparer` qui attend que la date et l'heure soient définies sur l'appareil Ce préparateur peut éventuellement forcer un `TargetSetupError` si la date et l'heure ne sont pas définies dans le délai d'expiration.
WifiPreparer	Un `ITargetPreparer` qui configure le Wi-Fi sur l'appareil si nécessaire.

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

Par exemple, il 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 la configuration requise de l'environnement 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/la suppression de la cible après le test.
`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'invocation.

Génère
`TargetSetupError`	si une erreur fatale s'est produite lors de la configuration de l'environnement
`BuildError`	Si une erreur se produit lors 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/la suppression de la cible après le test.

Paramètres
`testInformation`	`TestInformation` : `TestInformation` de l'invocation.
`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/la suppression de la cible après le test.

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 ;