À 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 76 autres.

AdbStopServerPreparer	Préparateur cible pour arrêter le serveur adb sur l'hôte avant et après l'exécution des tests adb.
AllTestAppsInstallSetup	`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	`ITargetPreparer` qui installe un APK et ses tests
ArtChrootPreparer	Créez un répertoire chroot pour les tests ART.
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é.
CheckPairingPreparer	Un `CompanionAwarePreparer` qui vérifie l'association BT entre l'appareil principal et l'appareil associé
CompanionAllocator	Classe de base qui gère l'allocation et la libération de l'appareil compagnon `getCompanionDeviceSelectionOptions()` doit être implémenté pour décrire les critères nécessaires à l'allocation de l'appareil associé.
CompanionAwarePreparer	`ITargetPreparer` qui encapsule la logique d'obtention d'un appareil compagnon déjà alloué.
CompanionRunCommandTargetPreparer	Un `ITargetPreparer` qui exécute les commandes spécifiées sur l'appareil compagnon attribué
CompanionTestAppInstallSetup	`ITargetPreparer` qui installe une ou plusieurs applications à partir d'un dossier `IDeviceBuildInfo.getTestsDir()` sur un appareil compagnon attribué.
CompileBootImageWithSpeedTargetPreparer	Recompile le chemin d'accès au classpath de démarrage et le serveur système avec le filtre de compilateur "speed".
CpuThrottlingWaiter	Un `ITargetPreparer` qui attend que la fréquence maximale de tous les cœurs soit rétablie au niveau le plus élevé disponible
CreateAvdPreparer
CreateUserPreparer	Préparateur de cible pour créer un utilisateur et le nettoyer à la fin.
DeviceActionTargetPreparer	Un `ITargetPreparer` pour effectuer des actions sur l'appareil.
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.
DeviceOwnerTargetPreparer	`ITargetPreparer` qui configure un composant propriétaire de l'appareil.
DeviceSetup	`ITargetPreparer` qui configure un appareil pour les tests en fonction des `Option` fournies.
DeviceStorageFiller	Définissez le préparateur cible sur "remplir l'espace de stockage" afin de libérer de l'espace.
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 d'image d'appareil à partir 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	`ITargetPreparer` qui configure une image système sur une version d'appareil avec la mise à jour système dynamique.
EraseUserDataPreparer	`ITargetPreparer` qui efface les données utilisateur sur l'appareil.
FastbootCommandPreparer	Préparateur de cible qui déclenche fastboot et envoie des commandes fastboot.
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.
FeatureFlagTargetPreparer	Met à jour DeviceConfig (indicateurs de fonctionnalité configurés par un service distant).
FoldableModePreparer	Préparateur cible pouvant modifier l'état pliable d'un appareil.
FolderSaver	Un `ITargetPreparer` qui extrait des répertoires de l'appareil, les compresse et les enregistre dans le backend de journalisation.
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.
ILabPreparer	Interface de repère pour les préparateurs d'atelier Consultez `ITargetPreparer` pour en savoir plus sur l'objectif de ces interfaces.
ITargetCleaner	Cette interface est obsolète. tearDown a été déplacé vers l'interface de base ITargetPreparer.
InstallAllTestZipAppsSetup	`ITargetPreparer` qui installe toutes les applications dans un fichier ZIP de test.
InstallApexModuleTargetPreparer
InstallApkSetup	`ITargetPreparer` qui installe un ou plusieurs APK situés sur le système de fichiers.
InstallBuildEnvApkSetup	`ITargetPreparer` qui installe un ou plusieurs APK de test à partir d'un environnement de compilation de la plate-forme Android.
InstallKernelModulePreparer	Un préparateur de cible qui installe des modules de noyau.
InstrumentationPreparer	Un `ITargetPreparer` qui exécute l'instrumentation
KillExistingEmulatorPreparer	`ITargetPreparer` qui arrête un émulateur en cours d'exécution.
KnownFailurePreparer	Préparateur cible pour ignorer la nouvelle tentative d'échec connu.
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
MixKernelTargetPreparer	`ITargetPreparer` permettant de mélanger une image de kernel 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 de complètement ignorer une invocation (préparation et tests) s'il n'y a pas d'APK à tester.
PerfettoPreparer	Le préparateur Perfetto transfère le fichier de configuration sur l'appareil à un emplacement standard auquel Perfetto a accès.
ProfileTargetPreparer	Classe de base pour configurer le préparateur de cible pour n'importe quel utilisateur de profil `android.os.usertype.profile.XXX`.
PushFileInvoker	Cette classe est obsolète. Utilisez plutôt `PushFilePreparer`.
PushFilePreparer	`ITargetPreparer` qui tente de transférer un nombre quelconque de fichiers à partir de n'importe quel chemin d'hôte vers n'importe quel chemin d'appareil.
PythonVirtualenvPreparer	Configure un environnement virtuel Python sur l'hôte et installe des paquets.
RebootTargetPreparer	Préparateur cible qui redémarre l'appareil.
RecoveryLogPreparer	Un préparateur de cible utilisé pour collecter les journaux avant la récupération.
RemoveSystemAppPreparer	`ITargetPreparer` permettant de 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 exécute "adb root" ou "adb unroot" en fonction de l'option "force-root".
RootcanalForwarderPreparer
RunCommandTargetPreparer
RunHostCommandTargetPreparer	Préparateur cible pour exécuter des commandes d'hôte arbitraires avant et après l'exécution du test.
RunHostScriptTargetPreparer	Préparateur de cible qui exécute un script avant d'exécuter un test.
RunOnCloneProfileTargetPreparer
RunOnPrivateProfileTargetPreparer
RunOnSdkSandboxTargetPreparer	Un `ITargetPreparer` indique que les tests doivent s'exécuter dans le bac à sable du SDK.
RunOnSecondaryUserTargetPreparer	Un `ITargetPreparer` pour s'assurer que le test s'exécute en tant qu'utilisateur secondaire.
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.
SemaphoreTokenTargetPreparer	Il s'agit d'un préparateur utilisé pour utiliser le jeton afin de sérialiser l'exécution des tests dans l'hôte tradefed.
SideloadOtaTargetPreparer	Un préparateur de cible qui effectue le téléchargement parallèle 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 part du principe que l'appareil sera en mode adb standard au démarrage et s'assurera que l'appareil se ferme dans le même mode, mais avec la version plus récente appliquée.
StopServicesSetup	`ITargetPreparer` qui arrête les services sur l'appareil.
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.
SwitchUserTargetPreparer	`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 atteigne la température cible
TestAppInstallSetup	`ITargetPreparer` qui installe une ou plusieurs applications à partir d'un dossier `IDeviceBuildInfo.getTestsDir()` sur l'appareil.
TestFilePushSetup	`ITargetPreparer` qui transfère un ou plusieurs fichiers/répertoires d'un dossier `IDeviceBuildInfo.getTestsDir()` vers l'appareil.
TestSystemAppInstallSetup	`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 cible pour perdre du temps et redémarrer l'appareil.
UserCleaner	Un `ITargetPreparer` qui supprime les utilisateurs secondaires lors du démontage.
VisibleBackgroundUserPreparer	Préparateur cible pour exécuter des tests dans un utilisateur démarré en arrière-plan.
WaitForDeviceDatetimePreparer	`ITargetPreparer` qui attend que la date et l'heure soient définies sur l'appareil Ce préparateur peut éventuellement forcer une `TargetSetupError` si la date et l'heure ne sont pas définies avant l'expiration du délai.
WifiPreparer	`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, 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