ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer
AdbStopServerPreparer Zielvorbereitung, um den adb-Server auf dem Host vor und nach dem Ausführen von adb-Tests zu beenden. 
AllTestAppsInstallSetup Eine ITargetPreparer, mit der alle Apps aus einem IDeviceBuildInfo.getTestsDir()-Ordner auf dem Gerät installiert werden. 
AoaTargetPreparer ITargetPreparer, die eine Reihe von Aktionen (z.B. Klicks und Wischbewegungen) mit dem Android Open Accessory (AOAv2)-Protokoll ausführt. 
AppSetup Eine ITargetPreparer, die eine APK und die zugehörigen Tests installiert. 
ArtChrootPreparer Erstellen Sie ein Chroot-Verzeichnis für ART-Tests. 
BaseEmulatorPreparer Gemeinsamer Emulator-Vorbereiter. 
BaseTargetPreparer Basisimplementierungsklasse für ITargetPreparer, mit der festgelegt werden kann, ob das Objekt deaktiviert ist oder nicht. 
BuildInfoRecorder Eine ITargetPreparer, die Metadaten zu Build-Informationen in eine angegebene Datei schreibt. 
CheckPairingPreparer Eine CompanionAwarePreparer, die die BT-Kopplung zwischen primären und Companion-Geräten überprüft 
CompanionAllocator Basisklasse, die das Zuweisen und Freigeben des Companion-Geräts übernimmt

getCompanionDeviceSelectionOptions() sollte implementiert werden, um die Kriterien zu beschreiben, die für die Zuweisung des Companion-Geräts erforderlich sind. 

CompanionAwarePreparer Eine ITargetPreparer, die die Logik zum Abrufen eines bereits zugewiesenen Companion-Geräts kapselt. 
CompanionRunCommandTargetPreparer Ein ITargetPreparer, das bestimmte Befehle auf dem zugewiesenen Companion-Gerät ausführt 
CompanionTestAppInstallSetup Eine ITargetPreparer, mit der eine oder mehrere Apps aus einem IDeviceBuildInfo.getTestsDir()-Ordner auf einem zugewiesenen Companion-Gerät installiert werden. 
CompileBootImageWithSpeedTargetPreparer Der Boot-Classpath und der Systemserver werden mit dem Compilerfilter „speed“ neu kompiliert. 
CpuThrottlingWaiter Eine ITargetPreparer, die wartet, bis die maximale Taktfrequenz auf allen Kernen wiederhergestellt ist 
CreateAvdPreparer  
CreateUserPreparer Zielvorbereitung zum Erstellen von Nutzern und zum Bereinigen am Ende. 
DeviceActionTargetPreparer Ein ITargetPreparer, um Geräteaktionen auszuführen. 
DeviceBuildInfoBootStrapper Ein ITargetPreparer, das Build-Informationsfelder durch vom Gerät gelesene Attribute ersetzt

Dies ist nützlich für das Testen von Geräten mit Builds, die aus einer externen Quelle generiert wurden (z.B. 

DeviceBuildInfoInjector Ein ITargetPreparer, das DeviceBuildDescriptor-Metadaten in die IBuildInfo einfügt. 
DeviceCleaner Nach dem Test wird ein Neustart oder eine Formatierung als Bereinigungsaktion ausgeführt und optional wird das Display ausgeschaltet. 
DeviceFlashPreparer Ein ITargetPreparer, das ein Bild auf physischer Android-Hardware blinkt. 
DeviceImageZipFlashingTargetPreparer Ein Zielvorbereitungstool, das das Gerät mit Gerätebildern über ein bestimmtes Format flasht. 
DeviceOwnerTargetPreparer Ein ITargetPreparer, mit dem eine Komponente für den Geräteeigentümer eingerichtet wird. 
DeviceSetup Eine ITargetPreparer, die ein Gerät anhand der bereitgestellten Options für Tests konfiguriert. 
DeviceStorageFiller Zielvorbereitung so konfigurieren, dass der Speicherplatz belegt wird, damit ein gewisser Freiraum verfügbar ist. 
DeviceStringPusher Zielvorbereitung zum Schreiben eines Strings in eine Datei. 
DeviceUpdateTargetPreparer Eine abstrakte ITargetPreparer, die gängige Schritte zur Aktualisierung von Geräten mit einer Geräte-Imagedatei aus einer externen Quelle (im Gegensatz zu einem Build-Dienst) übernimmt. 
DeviceWiper Eine ITargetPreparer, die Nutzerdaten löscht 
DisableSELinuxTargetPreparer Zielvorbereitung, die SELinux deaktiviert, wenn es aktiviert ist. 
DynamicSystemPreparer Ein ITargetPreparer, das ein System-Image auf einem Gerätebuild mit dem dynamischen Systemupdate einrichtet. 
EraseUserDataPreparer Eine ITargetPreparer, mit der Nutzerdaten auf dem Gerät gelöscht werden. 
FastbootCommandPreparer Zielvorbereitung, die Fastboot auslöst und Fastboot-Befehle sendet. 
FastbootUpdateBootstrapPreparer Eine ITargetPreparer, die bestimmte Dateien (Bootloader, Radio, ZIP-Datei des Geräte-Images) in IDeviceBuildInfo platziert, um Geräte mit FastbootDeviceFlasher zu flashen, und dann Geräteattribute nach dem Start in die Build-Informationen einschleust, um Ergebnisse zu erfassen. 
FeatureFlagTargetPreparer Aktualisiert die DeviceConfig (Feature-Flags, die von einem Remote-Dienst optimiert wurden). 
FoldableModePreparer Ein Zielvorbereitungstool, mit dem der Faltstatus eines Geräts geändert werden kann. 
FolderSaver Eine ITargetPreparer, die Verzeichnisse vom Gerät abruft, komprimiert und im Logging-Backend speichert. 
GkiDeviceFlashPreparer Ein Zielvorbereitungstool, das das Gerät mit dem generischen Android Common Kernel-Image flasht. 
GsiDeviceFlashPreparer Ein Zielvorbereitungstool, das das Gerät mit dem generischen Android-System-Image flasht. 
ILabPreparer Markierungsoberfläche für Lab-Vorbereiter

Eine Beschreibung der Verwendung dieser Schnittstellen finden Sie unter ITargetPreparer. 

ITargetCleaner Diese Benutzeroberfläche wurde eingestellt. tearDown wurde in die Basis-ITargetPreparer-Schnittstelle verschoben. 
InstallAllTestZipAppsSetup Eine ITargetPreparer, die alle Apps in einer Test-Zip-Datei installiert. 
InstallApexModuleTargetPreparer  
InstallApkSetup Eine ITargetPreparer, die eine oder mehrere APKs im Dateisystem installiert. 
InstallBuildEnvApkSetup Eine ITargetPreparer, die eine oder mehrere Test-APKs aus einer Build-Umgebung der Android-Plattform installiert. 
InstallKernelModulePreparer Ein Zielvorbereiter, der Kernelmodule installiert. 
InstrumentationPreparer Ein ITargetPreparer, das die Instrumentierung ausführt 
KillExistingEmulatorPreparer Ein ITargetPreparer, mit dem ein laufender Emulator beendet wird. 
KnownFailurePreparer Zielvorbereitung, um den erneuten Versuch bei einem bekannten Fehler zu überspringen. 
LocalEmulatorLaunch Ein TargetPreparer, der einen Emulator lokal aus einer Android-Build-Umgebung startet. 
LocalEmulatorSnapshot Ein TargetPreparer zum Generieren eines sauberen Emulator-Snapshots aus einer Android-Build-/Entwicklungsumgebung 
MixKernelTargetPreparer Ein ITargetPreparer, mit dem sich ein Kernel-Image mit dem Geräte-Image kombinieren lässt. 
ModuleOemTargetPreparer  
NativeLeakCollector Eine ITargetPreparer, auf der „dumpsys meminfo --unreachable -a“ ausgeführt wird, um den nicht erreichbaren nativen Arbeitsspeicher zu ermitteln, der derzeit von jedem Prozess belegt ist. 
NoApkTestSkipper Spezieller Verantwortlicher für die Vorbereitung, mit dem eine Aufrufung (Vorbereitung und Tests) vollständig übersprungen werden kann, wenn keine APKs zum Testen vorhanden sind. 
PerfettoPreparer Perfetto Preparer überträgt die Konfigurationsdatei an einen Standardspeicherort auf dem Gerät, auf den perfetto zugreifen kann. 
ProfileTargetPreparer Basisklasse zum Einrichten des Zielvorbereiters für jeden Profilnutzer android.os.usertype.profile.XXX. 
PushFileInvoker Diese Klasse wurde eingestellt. Verwenden Sie stattdessen PushFilePreparer. 
PushFilePreparer Ein ITargetPreparer, mit dem versucht wird, eine beliebige Anzahl von Dateien von einem beliebigen Hostpfad zu einem beliebigen Gerätepfad zu übertragen. 
PythonVirtualenvPreparer Richtet eine virtuelle Python-Umgebung auf dem Host ein und installiert Pakete. 
RebootTargetPreparer Zielvorbereitung, die das Gerät neu startet. 
RecoveryLogPreparer Ein Zielvorbereitungstool, mit dem Protokolle vor der Wiederherstellung erfasst werden. 
RemoveSystemAppPreparer Eine ITargetPreparer zum Entfernen eines APK aus der Systempartition vor einem Testlauf. 
RestartSystemServerTargetPreparer Zielvorbereitung, die den Systemserver neu startet, ohne das Gerät neu zu starten. 
RootTargetPreparer Zielvorbereitung, die „adb root“ oder „adb unroot“ ausführt, je nach Option „force-root“. 
RootcanalForwarderPreparer  
RunCommandTargetPreparer  
RunHostCommandTargetPreparer Zielvorbereitung, um vor und nach dem Ausführen des Tests beliebige Hostbefehle auszuführen. 
RunHostScriptTargetPreparer Zielvorbereitung, die ein Script vor dem Ausführen eines Tests ausführt. 
RunOnCloneProfileTargetPreparer  
RunOnPrivateProfileTargetPreparer  
RunOnSdkSandboxTargetPreparer Ein ITargetPreparer, um anzugeben, dass Tests in der SDK-Sandbox ausgeführt werden sollen. 
RunOnSecondaryUserTargetPreparer Eine ITargetPreparer, damit der Test als sekundärer Nutzer ausgeführt wird. 
RunOnSystemUserTargetPreparer Ein ITargetPreparer, das angibt, dass Tests für den Nutzer (nicht für den aktuellen Nutzer) ausgeführt werden sollen. 
RunOnWorkProfileTargetPreparer Eine ITargetPreparer, die bei der Einrichtung ein Arbeitsprofil erstellt und angibt, dass Tests für diesen Nutzer ausgeführt werden sollen. 
SemaphoreTokenTargetPreparer Dies ist ein Wrapper, mit dem ein Token verwendet wird, um die Testausführung im Tradefed-Host zu serialisieren. 
SideloadOtaTargetPreparer Ein Zielvorbereiter, der das Sideloaden eines bestimmten OTA-Pakets durchführt, das Paket anwendet, auf das Starten des Geräts wartet und die Build-Eigenschaften des Geräts als Build-Informationen einschleust

Bei dieser Zielvorbereitung wird davon ausgegangen, dass sich das Gerät beim Starten im regulären ADB-Modus befindet. Außerdem wird dafür gesorgt, dass das Gerät im selben Modus beendet wird, jedoch mit der neueren Build-Version. 

StopServicesSetup Ein ITargetPreparer, das Dienste auf dem Gerät beendet. 
StubTargetPreparer Platzhalter für die leere Implementierung einer ITargetPreparer. 
SuiteApkInstaller Hier werden die angegebenen APKs für die Suite-Konfiguration installiert: entweder über die Variable $ANDROID_TARGET_OUT_TESTCASES oder das ROOT_DIR in den Build-Informationen. 
SwitchUserTargetPreparer Eine ITargetPreparer, die in setUp zur angegebenen Nutzerart wechselt. 
TearDownPassThroughPreparer Ermöglicht das Ausführen von tearDown für Vorbereiter, die in einer Konfiguration als Objekt enthalten sind. 
TemperatureThrottlingWaiter Ein ITargetPreparer, das wartet, bis die Temperatur des Geräts auf die Zieltemperatur gesunken ist 
TestAppInstallSetup Eine ITargetPreparer, mit der eine oder mehrere Apps aus einem IDeviceBuildInfo.getTestsDir()-Ordner auf dem Gerät installiert werden. 
TestFilePushSetup Eine ITargetPreparer, die eine oder mehrere Dateien/Verzeichnisse aus einem IDeviceBuildInfo.getTestsDir()-Ordner auf das Gerät überträgt. 
TestSystemAppInstallSetup Eine ITargetPreparer, mit der eine oder mehrere Apps aus einem IDeviceBuildInfo.getTestsDir()-Ordner auf der /system-Partition des Geräts installiert werden. 
TimeWaster Eine einfache Zielvorbereitung, die Zeit kostet und möglicherweise zum Neustart des Geräts führt. 
UserCleaner Eine ITargetPreparer, die sekundäre Nutzer beim Rückbau entfernt. 
VisibleBackgroundUserPreparer Zielvorbereitung zum Ausführen von Tests in einem Nutzer, der im Hintergrund sichtbar gestartet wird. 
WaitForDeviceDatetimePreparer Eine ITargetPreparer, die darauf wartet, dass das Datum und die Uhrzeit auf dem Gerät festgelegt werden

Optional kann dieser Vorbereiter TargetSetupError erzwingen, wenn das Datum und die Uhrzeit nicht innerhalb des Zeitlimits festgelegt werden. 

WifiPreparer Eine ITargetPreparer, die bei Bedarf das WLAN auf dem Gerät konfiguriert. 

Bereitet die Testumgebung für den Testlauf vor.

Beispielsweise wird Software installiert, Umgebungseinstellungen für Tests angepasst und Ziele gestartet.

In einer Konfiguration können mehrere ITargetPreparer angegeben werden. Es wird empfohlen, die erwartete Umgebung vor und nach der Einrichtung für jeden ITargetPreparer klar zu dokumentieren. Beispiel: Ein ITargetPreparer, der ein Gerät für den Test konfiguriert, muss nach dem ITargetPreparer ausgeführt werden, der Software installiert.

Zusammenfassung

Öffentliche Methoden

default void setUp(ITestDevice device, IBuildInfo buildInfo)

Diese Methode ist veraltet. Verwenden Sie stattdessen setUp(com.android.tradefed.invoker.TestInformation).

default void setUp(TestInformation testInformation)

Führen Sie die Zieleinrichtung für den Test durch.

default void tearDown(TestInformation testInformation, Throwable e)

Führen Sie nach dem Testen die Bereinigung/Deaktivierung des Ziels durch.

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

Diese Methode ist veraltet. Verwenden Sie stattdessen tearDown(com.android.tradefed.invoker.TestInformation, Throwable).

Öffentliche Methoden

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

Diese Methode ist veraltet.
Stattdessen setUp(com.android.tradefed.invoker.TestInformation) verwenden

Führen Sie die Zieleinrichtung für den Test durch.

Parameter
device ITestDevice: Der zu erstellende ITestDevice.
buildInfo IBuildInfo: Daten zum getesteten Build.
Ausgabe
TargetSetupError if fatal error occurred setting up environment
BuildError Wenn ein Fehler im Zusammenhang mit der BuildInfo auftritt
DeviceNotAvailableException wenn das Gerät nicht mehr reagiert

setUp

public void setUp (TestInformation testInformation)

Führen Sie die Zieleinrichtung für den Test durch.

Parameter
testInformation TestInformation: Die TestInformation der Aufrufs.
Ausgabe
TargetSetupError if fatal error occurred setting up environment
BuildError Wenn ein Fehler auftritt, weil der Build vorbereitet wird
DeviceNotAvailableException wenn das Gerät nicht mehr reagiert

tearDown

public void tearDown (TestInformation testInformation, 
                Throwable e)

Führen Sie nach dem Testen die Bereinigung/Deaktivierung des Ziels durch.

Parameter
testInformation TestInformation: Die TestInformation der Aufrufs.
e Throwable: Wenn der Aufruf mit einer Ausnahme beendet wurde, ist dies die Ausnahme, die auf Aufrufebene erfasst wurde. Andernfalls ist es null.
Ausgabe
DeviceNotAvailableException wenn das Gerät nicht mehr reagiert

tearDown

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

Diese Methode ist veraltet.
Stattdessen tearDown(com.android.tradefed.invoker.TestInformation, Throwable) verwenden

Führen Sie nach dem Testen die Bereinigung/Deaktivierung des Ziels durch.

Parameter
device ITestDevice: Der zu erstellende ITestDevice.
buildInfo IBuildInfo: Daten zum getesteten Build.
e Throwable: Wenn der Aufruf mit einer Ausnahme beendet wurde, ist dies die Ausnahme, die auf Aufrufebene erfasst wurde. Andernfalls ist es null.
Ausgabe
DeviceNotAvailableException wenn das Gerät nicht mehr reagiert