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	Préparateur cible pour 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 (par exemple, des clics et des balayages) à 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 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	Élément `ITargetPreparer` qui écrit des 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 se charge de l'allocation et de la libération de l'appareil associé `getCompanionDeviceSelectionOptions()` doit être implémenté pour décrire les critères requis pour allouer 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	Il 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 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	`ITargetPreparer` qui remplace les champs d'informations de la compilation par des attributs lus depuis 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	Élément `ITargetPreparer` qui configure un composant de propriétaire de l'appareil.
DeviceSetup	`ITargetPreparer` qui configure un appareil pour les tests en fonction des `Option` fournies.
DeviceStorageFiller	Préparateur cible pour remplir l'espace de stockage afin de disposer d'une certaine quantité d'espace libre.
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).
Effacement des appareils	Un `ITargetPreparer` qui efface les données utilisateur
DésactiverSELinuxTargetPreparer	Préparateur cible qui désactive SELinux s'il est activé.
DynamicSystemPreparer	`ITargetPreparer` qui configure une image système au-dessus d'un build d'appareil avec la mise à jour système dynamique.
EraseUserDataPreparer	`ITargetPreparer` qui efface les données utilisateur de l'appareil.
FastbootCommandPreparer	Préparateur de cible qui déclenche fastboot et envoie des commandes fastboot.
FastbootUpdateBootstrapPreparer	Un élément `ITargetPreparer` qui prépare les fichiers spécifiés (bootloader, radio, fichier ZIP de l'image de l'appareil) dans `IDeviceBuildInfo` pour obtenir les appareils flashés avec `FastbootDeviceFlasher`, puis injecte les attributs de l'appareil post-amorçage dans les informations de compilation pour créer des 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	Préparateur cible qui flashe l'appareil avec une image système générique Android.
ILabPreparer	Interface de repère pour les préparateurs d'ateliers Consultez `ITargetPreparer` pour en savoir plus sur l'objectif de ces interfaces.
ITargetCleaner	Cette interface est obsolète. Déplacement de tearDown vers l'interface ITargetPreparer de base.
InstallAllTestZipAppsSetup	`ITargetPreparer` qui installe toutes les applications dans un fichier ZIP de test.
InstallApexModuleTargetPreparer
InstallApkSetup	Un `ITargetPreparer` qui installe un ou plusieurs APK situés dans le système de fichiers.
InstallBuildEnvApkSetup	`ITargetPreparer` qui installe un ou plusieurs APK de test à partir d'un environnement de compilation de plate-forme Android.
InstallKernelModulePreparer	Un préparateur de cible qui installe les modules du noyau
InstrumentationPreparer	Un `ITargetPreparer` qui exécute l'instrumentation
KillExampleEmulatorPreparer	Une `ITargetPreparer` qui arrête un émulateur en cours d'exécution.
KnownFailurePreparer	Préparateur de cible pour ignorer les nouvelles tentatives en cas d'échec connu.
LocalEmulatorLaunch	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	Un `ITargetPreparer` qui permet de combiner une image du noyau 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`.
PushFileRequestr	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 virtualenv Python sur l'hôte et installe les packages.
RebootTargetPreparer	Préparateur cible qui redémarre l'appareil.
RecoveryLogPreparer	Préparateur cible utilisé pour collecter les journaux avant la récupération.
RemoveSystemAppPreparer	Un `ITargetPreparer` pour supprimer un APK de la partition système avant l'exécution d'un test.
RestartSystemServerTargetPreparer	Préparateur de 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 élément `ITargetPreparer` pour indiquer que les tests doivent être exécutés dans le bac à sable du SDK
RunOnSecondUserTargetPreparer	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 élément `ITargetPreparer` qui crée un profil professionnel lors de la configuration et indique que les tests doivent être exécutés pour cet utilisateur.
SemaphoreTokenTargetPreparer	Il s'agit d'un outil de préparation qui permet d'utiliser un jeton pour sérialiser l'exécution du test dans l'hôte échangé.
SideloadOtaTargetPreparer	Un préparateur de cible qui effectue le téléchargement indépendant d'un package OTA spécifié, applique le package, attend que l'appareil démarre 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 standard au démarrage et s'assurera que l'appareil quitte le même mode, mais avec le build plus récent appliqué.
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 de ROOT_DIR dans les informations de build.
SwitchUserTargetPreparer	Élément `ITargetPreparer` qui bascule vers le genre d'utilisateur spécifié lors de la configuration.
TearDownPassThroughPreparer	Permet d'exécuter tearDown sur les préparateurs inclus dans une configuration en tant qu'objet.
TempératureThrottlingWaiter	Un `ITargetPreparer` qui attend que la température de l'appareil atteigne la température cible
TestAppInstallSetup	Un `ITargetPreparer` qui installe sur l'appareil une ou plusieurs applications à partir d'un dossier `IDeviceBuildInfo.getTestsDir()`.
TestFilePushSetup	`ITargetPreparer` qui transfère un ou plusieurs fichiers/répertoires d'un dossier `IDeviceBuildInfo.getTestsDir()` vers l'appareil.
TestSystemAppInstallSetup	Un `ITargetPreparer` qui installe une ou plusieurs applications depuis un dossier `IDeviceBuildInfo.getTestsDir()` vers la partition /system de l'appareil.
TimeWaster	Un simple préparateur de cibles pour perdre du temps et potentiellement redémarrer l'appareil.
UserCleaner	`ITargetPreparer` qui supprime les utilisateurs secondaires lors de la suppression.
VisibleBackgroundUserPreparer	Préparateur de cible pour l'exécution de tests chez un utilisateur lancé en mode visible 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 n'est pas définie dans le délai avant 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, elle installe des logiciels, ajuste les paramètres d'environnement pour les tests, lance les cibles, etc.

Notez que vous pouvez spécifier plusieurs ITargetPreparer dans une configuration. Il est recommandé que chaque ITargetPreparer documente clairement la préconfiguration et la post-configuration de l'environnement attendue. Par exemple, un ITargetPreparer qui configure un appareil à des fins de test 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 et la suppression 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

Configurer

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 testée.

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épondait plus

Configurer

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épondait 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 et la suppression de la cible après les tests.

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

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