ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer
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