ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

Bekannte indirekte Unterklassen AdbStopServerPreparer , AllTestAppsInstallSetup , AoaTargetPreparer , AppSetup , ArtChrootPreparer , BaseEmulatorPreparer , BaseTargetPreparer , BuildInfoRecorder , CheckPairingPreparer , CompanionAllocator , CompanionAwarePreparer , CompanionRunCommandTargetPreparer , CompanionTestAppInstallSetup , Comp ileBootImageWithSpeedTargetPreparer , CpuThrottlingWaiter und 73 andere. AdbStopServerPreparer Zielvorbereiter zum Stoppen des ADB-Servers auf dem Host vor und nach der Ausführung von ADB-Tests. AllTestAppsInstallSetup Ein ITargetPreparer , der alle Apps aus einem IDeviceBuildInfo#getTestsDir() Ordner auf dem Gerät installiert. AoaTargetPreparer ITargetPreparer , der eine Reihe von Aktionen (z. B. Klicks und Wischbewegungen) mithilfe des Android Open Accessoire (AOAv2)-Protokolls ausführt. AppSetup Ein ITargetPreparer , der eine APK und ihre Tests installiert. ArtChrootPreparer Erstellen Sie ein Chroot-Verzeichnis für ART-Tests. BaseEmulatorPreparer Gemeinsamer Vorbereiter zum Starten eines lokalen Emulators. BaseTargetPreparer Basisimplementierungsklasse für ITargetPreparer , mit der gesteuert werden kann, ob das Objekt deaktiviert ist oder nicht. BuildInfoRecorder Ein ITargetPreparer , der Build-Info-Metadaten in eine angegebene Datei schreibt. CheckPairingPreparer Ein CompanionAwarePreparer , der die BT-Verbindung zwischen Primär- und Begleitgeräten überprüft CompanionAllocator Basisklasse, die sich um die Zuweisung und Freigabe von Begleitgeräten kümmert getCompanionDeviceSelectionOptions() sollte implementiert werden, um die Kriterien zu beschreiben, die zum Zuweisen des Begleitgeräts erforderlich sind CompanionAwarePreparer Ein ITargetPreparer , der die Logik zum Abrufen eines bereits zugewiesenen Begleitgeräts kapselt. CompanionRunCommandTargetPreparer Ein ITargetPreparer , der bestimmte Befehle auf dem zugewiesenen Begleitgerät ausführt CompanionTestAppInstallSetup Ein ITargetPreparer , der eine oder mehrere Apps aus einem IDeviceBuildInfo#getTestsDir() Ordner auf einem zugewiesenen Begleitgerät installiert. CompileBootImageWithSpeedTargetPreparer Kompiliert den Boot-Klassenpfad und den Systemserver mit dem Compiler-Filter „Geschwindigkeit“ neu. CpuThrottlingWaiter Ein ITargetPreparer , der wartet, bis die maximale Frequenz aller Kerne auf die höchste verfügbare Stufe wiederhergestellt ist CreateAvdPreparer CreateUserPreparer Zielvorbereiter zum Erstellen eines Benutzers und zum Bereinigen am Ende. DeviceBuildInfoBootStrapper Ein ITargetPreparer , der Build-Infofelder durch vom Gerät gelesene Attribute ersetzt Dies ist nützlich zum Testen von Geräten mit Builds, die aus einer externen Quelle generiert wurden (z. B DeviceBuildInfoInjector Ein ITargetPreparer , der DeviceBuildDescriptor Metadaten in IBuildInfo einfügt. DeviceCleaner Führt nach dem Test einen Neustart oder eine Formatierung als Bereinigungsaktion durch und schaltet optional den Bildschirm aus DeviceFlashPreparer Ein ITargetPreparer , der ein Image auf physischer Android-Hardware flasht. DeviceImageZipFlashingTargetPreparer Ein Zielvorbereiter, der das Gerät mit Gerätebildern flasht, die über ein bestimmtes Format bereitgestellt werden. DeviceOwnerTargetPreparer Ein ITargetPreparer , der eine Gerätebesitzerkomponente einrichtet. Geräte-Setup Ein ITargetPreparer , der ein Gerät zum Testen basierend auf den bereitgestellten Option s konfiguriert. DeviceStorageFiller Der Zielvorbereiter soll den Speicher auffüllen, sodass etwas freier Speicherplatz verfügbar ist. DeviceStringPusher Zielvorbereiter zum Schreiben einer Zeichenfolge in eine Datei. DeviceUpdateTargetPreparer Ein abstrakter ITargetPreparer , der allgemeine Schritte rund um die Aktualisierung von Geräten mit einer Geräte-Image-Datei von einer externen Quelle (im Gegensatz zu einem Build-Service) übernimmt. DeviceWiper Ein ITargetPreparer , der Benutzerdaten löscht Deaktivieren Sie SELinuxTargetPreparer Zielvorbereiter, der SELinux deaktiviert, falls aktiviert. DynamicSystemPreparer Ein ITargetPreparer , der mit dem dynamischen Systemupdate ein Systemabbild auf einem Gerätebuild einrichtet. EraseUserDataPreparer Ein ITargetPreparer , der Benutzerdaten auf dem Gerät löscht. FastbootCommandPreparer Zielvorbereiter, der Fastboot auslöst und Fastboot-Befehle sendet. FastbootUpdateBootstrapPreparer Ein ITargetPreparer , der bestimmte Dateien (Bootloader, Radio, Geräte-Image-Zip) in IDeviceBuildInfo bereitstellt, um Geräte mit FastbootDeviceFlasher zu flashen, und dann Post-Boot-Geräteattribute für Ergebnisberichtszwecke in die Build-Informationen einfügt. FeatureFlagTargetPreparer Aktualisiert die DeviceConfig (Funktionsflags, die von einem Remotedienst optimiert werden). FoldingModePreparer Ein Zielvorbereiter, der den faltbaren Zustand eines Geräts ändern kann. FolderSaver Ein ITargetPreparer , der Verzeichnisse vom Gerät abruft, komprimiert und im Protokollierungs-Backend speichert. GkiDeviceFlashPreparer Ein Zielvorbereiter, der das Gerät mit dem generischen Android-Kernel-Image flasht. GsiDeviceFlashPreparer Ein Zielvorbereiter, der das Gerät mit einem generischen Android-System-Image flasht. ILabPreparer Markerschnittstelle für Laborvorbereiter Eine Beschreibung dessen, wofür diese Schnittstellen gedacht sind, finden Sie unter ITargetPreparer . ITargetCleaner Diese Schnittstelle ist veraltet. TearDown wurde in die Basis-ITargetPreparer-Schnittstelle verschoben. InstallAllTestZipAppsSetup Ein ITargetPreparer , der alle Apps in einer Test-ZIP-Datei installiert. InstallApexModuleTargetPreparer InstallApkSetup Ein ITargetPreparer , der eine oder mehrere APKs installiert, die sich im Dateisystem befinden. InstallBuildEnvApkSetup Ein ITargetPreparer , der eine oder mehrere Test-Apks von einer Android-Plattform-Build-Umgebung installiert. InstrumentationPreparer Ein ITargetPreparer , der die Instrumentierung ausführt KillExistingEmulatorPreparer Ein ITargetPreparer , der einen laufenden Emulator herunterfährt. KnownFailurePreparer Zielvorbereiter soll die Wiederholung bekannter Fehler ü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 , der es ermöglicht, ein Kernel-Image mit dem Geräte-Image zu mischen. ModulOemTargetPreparer NativeLeakCollector Ein ITargetPreparer , der „dumpsys meminfo --unreachable -a“ ausführt, um den nicht erreichbaren nativen Speicher zu identifizieren, der derzeit von jedem Prozess belegt ist. NoApkTestSkipper Spezieller Vorbereiter, der es ermöglicht, einen Aufruf vollständig zu überspringen (Vorbereitung und Tests), wenn keine APKs für Tests vorhanden sind. PerfettoPreparer Der Perfetto-Vorbereiter schiebt die Konfigurationsdatei an einem Standardspeicherort auf das Gerät, auf den Perfetto Zugriff hat. ProfileTargetPreparer Basisklasse zum Einrichten des Zielvorbereiters für jeden Profilbenutzer android.os.usertype.profile.XXX . PushFileInvoker Diese Klasse ist veraltet. Verwenden Sie stattdessen PushFilePreparer PushFilePreparer Ein ITargetPreparer , der versucht, eine beliebige Anzahl von Dateien von einem beliebigen Hostpfad auf einen beliebigen Gerätepfad zu übertragen. PythonVirtualenvPreparer Richtet eine virtuelle Python-Umgebung auf dem Host ein und installiert Pakete. RebootTargetPreparer Zielvorbereiter, der das Gerät neu startet. RecoveryLogPreparer Ein Zielvorbereiter, der zum Sammeln von Protokollen vor der Wiederherstellung verwendet wird. RemoveSystemAppPreparer Ein ITargetPreparer zum Entfernen einer APK von der Systempartition vor einem Testlauf. Starten Sie SystemServerTargetPreparer neu Zielvorbereiter, der den Systemserver neu startet, ohne das Gerät neu zu starten. RootTargetPreparer Zielvorbereiter, der „adb root“ oder „adb unroot“ basierend auf der Option „force-root“ ausführt. RootcanalForwarderPreparer RunCommandTargetPreparer RunHostCommandTargetPreparer Zielvorbereiter zum Ausführen beliebiger Hostbefehle vor und nach der Ausführung des Tests. RunHostScriptTargetPreparer Zielvorbereiter, der ein Skript ausführt, bevor ein Test ausgeführt wird. RunOnCloneProfileTargetPreparer RunOnSdkSandboxTargetPreparer Ein ITargetPreparer der markiert, dass Tests in der SDK-Sandbox ausgeführt werden sollen. RunOnSecondaryUserTargetPreparer Ein ITargetPreparer , der im Setup einen sekundären Benutzer erstellt und markiert, dass Tests in diesem Benutzer ausgeführt werden sollen. RunOnSystemUserTargetPreparer Ein ITargetPreparer , der markiert, dass Tests für den Benutzer (und nicht für den aktuellen Benutzer) ausgeführt werden sollen. RunOnWorkProfileTargetPreparer Ein ITargetPreparer , der im Setup ein Arbeitsprofil erstellt und markiert, dass Tests in diesem Benutzer ausgeführt werden sollen. SemaphoreTokenTargetPreparer Dies ist ein Vorbereiter, der zur Serialisierung der Testausführung im Tradefed-Host mithilfe eines Tokens verwendet wird. SideloadOtaTargetPreparer Ein Zielvorbereiter, der ein bestimmtes OTA-Paket seitlich lädt, das Paket anwendet, auf den Start des Geräts wartet und die Build-Eigenschaften des Geräts einfügt, um sie als Build-Informationen zu verwenden Dieser Zielvorbereiter geht davon aus, dass sich das Gerät beim Start im regulären ADB-Modus befindet, und stellt sicher, dass das Gerät im gleichen Modus, jedoch mit angewendetem neueren Build, beendet wird. StopServicesSetup Ein ITargetPreparer , der Dienste auf dem Gerät stoppt. StubTargetPreparer Leere Platzhalterimplementierung eines ITargetPreparer . SuiteApkInstaller Installiert bestimmte APKs für die Suite-Konfiguration: entweder über die Variable $ANDROID_TARGET_OUT_TESTCASES oder das ROOT_DIR in den Build-Informationen. SwitchUserTargetPreparer Ein ITargetPreparer , der in setUp zum angegebenen Benutzertyp wechselt. TearDownPassThroughPreparer Ermöglicht die Ausführung von TearDown auf Vorbereitern, die als Objekt in einer Konfiguration enthalten sind. TemperatureThrottlingWaiter Ein ITargetPreparer , der wartet, bis die Temperatur des Geräts den Zielwert erreicht TestAppInstallSetup Ein ITargetPreparer , der eine oder mehrere Apps aus einem IDeviceBuildInfo.getTestsDir() Ordner auf dem Gerät installiert. TestFilePushSetup Ein ITargetPreparer , der eine oder mehrere Dateien/Verzeichnisse aus einem IDeviceBuildInfo.getTestsDir() Ordner auf das Gerät schiebt. TestSystemAppInstallSetup Ein ITargetPreparer , der eine oder mehrere Apps aus einem IDeviceBuildInfo.getTestsDir() Ordner auf der /system-Partition auf dem Gerät installiert. Zeitverschwender Ein einfacher Zielvorbereiter, um Zeit zu verschwenden und das Gerät möglicherweise neu zu starten. UserCleaner Ein ITargetPreparer , der sekundäre Benutzer beim Teardown entfernt. VisibleBackgroundUserPreparer Zielvorbereiter zum Ausführen von Tests in einem Benutzer, der im sichtbaren Hintergrund gestartet wird. WaitForDeviceDatetimePreparer Ein ITargetPreparer , der darauf wartet, dass Datum und Uhrzeit auf dem Gerät festgelegt werden Optional kann dieser Vorbereiter einen TargetSetupError erzwingen, wenn Datum/Uhrzeit nicht innerhalb des Zeitlimits festgelegt wird, oder Host-Datum/Uhrzeit auf dem Gerät erzwingen. WifiPreparer Ein ITargetPreparer , der bei Bedarf WLAN auf dem Gerät konfiguriert.

---

Bereitet die Testumgebung für den Testlauf vor.

Installiert beispielsweise Software, optimiert die Umgebungseinstellungen zum Testen, startet Ziele usw.

Beachten Sie, dass in einer Konfiguration mehrere ITargetPreparer angegeben werden können. Es wird empfohlen, dass jeder ITargetPreparer seine erwartete Umgebung vor und nach der Einrichtung klar dokumentiert. Beispielsweise muss ein ITargetPreparer, der ein Gerät zum Testen konfiguriert, nach dem ITargetPreparer ausgeführt werden, der die 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 zum Testen durch.
default void	tearDown ( TestInformation testInformation, Throwable e) Führen Sie nach dem Testen die Bereinigung/Abbau 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

aufstellen

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

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

Führen Sie die Zieleinrichtung zum Testen durch.

Parameter
device	ITestDevice : das vorzubereitende ITestDevice .
buildInfo	IBuildInfo : Daten zum getesteten Build.

Würfe
TargetSetupError	wenn beim Einrichten der Umgebung ein schwerwiegender Fehler aufgetreten ist
BuildError	Wenn ein Fehler im Zusammenhang mit BuildInfo auftritt
DeviceNotAvailableException	wenn das Gerät nicht mehr reagiert

aufstellen

public void setUp (TestInformation testInformation)

Führen Sie die Zieleinrichtung zum Testen durch.

Parameter
testInformation	TestInformation : Die TestInformation des Aufrufs.

Würfe
TargetSetupError	wenn beim Einrichten der Umgebung ein schwerwiegender Fehler aufgetreten ist
BuildError	Wenn aufgrund der Vorbereitung des Builds ein Fehler auftritt
DeviceNotAvailableException	wenn das Gerät nicht mehr reagiert

abreißen

public void tearDown (TestInformation testInformation, 
                Throwable e)

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

Parameter
testInformation	TestInformation : Die TestInformation des Aufrufs.
e	Throwable : Wenn der Aufruf mit einer Ausnahme endete, ist dies die Ausnahme, die auf der Aufrufebene abgefangen wurde. Andernfalls ist null .

Würfe
DeviceNotAvailableException	wenn das Gerät nicht mehr reagiert

abreißen

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

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

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

Parameter
device	ITestDevice : das vorzubereitende ITestDevice .
buildInfo	IBuildInfo : Daten zum getesteten Build.
e	Throwable : Wenn der Aufruf mit einer Ausnahme endete, ist dies die Ausnahme, die auf der Aufrufebene abgefangen wurde. Andernfalls ist null .

Würfe
DeviceNotAvailableException	wenn das Gerät nicht mehr reagiert