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 , Kompilieren BootImageWithSpeedTargetPreparer , CpuThrottlingWaiter und 72 weitere. AdbStopServerPreparer Zielvorbereiter, um den Adb-Server auf dem Host vor und nach dem Ausführen von Adb-Tests zu stoppen. 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 Swipes) unter Verwendung des Android Open Accessory (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 Allgemeiner 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-Bindung zwischen Primär- und Begleitgeräten überprüft CompanionAllocator Basisklasse, die sich um das Zuweisen und Freigeben 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 auf allen Kernen auf dem höchsten verfügbaren Niveau wiederhergestellt ist CreateAvdPreparer CreateUserPreparer Zielvorbereiter zum Erstellen von Benutzern und zum Aufräumen am Ende. DeviceBuildInfoBootStrapper Ein ITargetPreparer , der Build-Info-Felder 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 DeviceBuildInfoInjector Ein ITargetPreparer , der DeviceBuildDescriptor Metadaten in die IBuildInfo einfügt. Gerätereiniger 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äteabbildern 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 bereitgestellten Option konfiguriert. DeviceStorageFiller Zielvorbereiter zum Auffüllen des Speichers, damit etwas freier Speicherplatz verfügbar ist. DeviceStringPusher Zielersteller zum Schreiben einer Zeichenfolge in eine Datei. DeviceUpdateTargetPreparer Ein abstrakter ITargetPreparer , der sich um allgemeine Schritte rund um das Aktualisieren von Geräten mit einer Geräte-Image-Datei aus einer externen Quelle kümmert (im Gegensatz zu einem Build-Service). DeviceWiper Ein ITargetPreparer , der Benutzerdaten löscht Deaktivieren Sie SELinuxTargetPreparer Zielvorbereiter, der SELinux deaktiviert, falls aktiviert. DynamicSystemPreparer Ein ITargetPreparer , der ein Systemabbild auf einem Geräteaufbau mit dem dynamischen Systemupdate 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 geflasht zu bekommen, und dann Post-Boot-Geräteattribute in die Build-Informationen für Ergebnisberichtszwecke einfügt. FeatureFlagTargetPreparer Aktualisiert die DeviceConfig (Feature-Flags, die von einem Remotedienst optimiert werden). FoldableModePreparer Ein Zielvorbereiter, der den faltbaren Zustand eines Geräts umschalten kann. FolderSaver Ein ITargetPreparer , der Verzeichnisse vom Gerät abzieht, komprimiert und im Protokollierungs-Backend speichert. GkiDeviceFlashPreparer Ein Target-Vorbereiter, der das Gerät mit einem allgemeinen Android-Kernel-Image flasht. GsiDeviceFlashPreparer Ein Zielvorbereiter, der das Gerät mit einem generischen Android-Systemabbild flasht. ILabPreparer Marker-Schnittstelle für Laboranten Siehe ITargetPreparer für eine Beschreibung, wofür diese Schnittstellen gedacht sind. 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. InstrumentierungPreparer Ein ITargetPreparer , der die Instrumentierung ausführt KillExistingEmulatorPreparer Ein ITargetPreparer , der einen laufenden Emulator herunterfährt. KnownFailurePreparer Zielersteller, um Wiederholungsversuche bei bekannten Fehlern 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 , der es ermöglicht, ein Kernel-Image mit dem Geräte-Image zu mischen. ModuleOemTargetPreparer NativeLeakCollector Ein ITargetPreparer , der 'dumpsys meminfo --unreachable -a' ausführt, um den nicht erreichbaren nativen Speicher zu identifizieren, der derzeit von jedem Prozess gehalten wird. NoApkTestSkipper Spezieller Vorbereiter, der es ermöglicht, einen Aufruf vollständig zu überspringen (Vorbereitung und Tests), wenn es keine APKs zum Testen gibt. PerfettoPreparer Der Perfetto-Vorbereiter überträgt 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 verschieben. PythonVirtualenvPreparer Richtet eine Python-virtuelle Umgebung auf dem Host ein und installiert Pakete. Starten Sie TargetPreparer neu Zielvorbereiter, der das Gerät neu startet. RecoveryLogPreparer Ein Zielvorbereiter, der zum Sammeln von Protokollen vor der Wiederherstellung verwendet wird. SystemAppPreparer entfernen 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 Zielersteller, der „adb root“ oder „adb unroot“ basierend auf der Option „force-root“ ausführt. RunCommandTargetPreparer Führen Sie HostCommandTargetPreparer aus Zielvorbereiter zum Ausführen beliebiger Hostbefehle vor und nach dem Ausführen des Tests. Führen Sie HostScriptTargetPreparer aus Zielvorbereiter, der ein Skript ausführt, bevor er einen Test ausführt. RunOnCloneProfileTargetPreparer RunOnSdkSandboxTargetPreparer Ein ITargetPreparer zum Markieren, dass Tests in der SDK-Sandbox ausgeführt werden sollen. RunOnSecondaryUserTargetPreparer Ein ITargetPreparer , der einen sekundären Benutzer im Setup 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 ein Arbeitsprofil im Setup erstellt und markiert, dass Tests in diesem Benutzer ausgeführt werden sollen. SemaphoreTokenTargetPreparer Dies ist ein Ersteller, der verwendet wird, um Token zu verwenden, um die Testausführung in einem Tradefed-Host zu serialisieren. SideloadOtaTargetPreparer Ein Target-Vorbereiter, der Sideload eines angegebenen OTA-Pakets durchführt, das Paket anwendet, auf das Hochfahren des Geräts wartet und die Build-Eigenschaften des Geräts zur Verwendung als Build-Informationen einfügt 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 selben Modus beendet wird, aber mit dem neueren Build angewendet wird. StopServicesSetup Ein ITargetPreparer , der Dienste auf dem Gerät stoppt. StubTargetPreparer Leere Platzhalterimplementierung eines ITargetPreparer . SuiteApkInstaller Installiert angegebene APKs für die Suite-Konfiguration: entweder aus der Variablen $ANDROID_TARGET_OUT_TESTCASES oder dem ROOT_DIR in Build-Informationen. SwitchUserTargetPreparer Ein ITargetPreparer , der in setUp zur angegebenen Benutzerart wechselt. TearDownPassThroughPreparer Ermöglicht das Ausführen von TearDown auf Erstellern, die in einer Konfiguration als Objekt enthalten sind. TemperaturdrosselungKellner Ein ITargetPreparer , der wartet, bis die Temperatur des Geräts den Zielwert erreicht hat 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 überträgt. 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 datetime auf dem Gerät festgelegt wird Optional kann dieser Ersteller einen TargetSetupError erzwingen, wenn datetime nicht innerhalb des Timeouts gesetzt ist, oder Host-datetime 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 Umgebungseinstellungen zum Testen, startet Ziele usw.

Beachten Sie, dass mehrere ITargetPreparer s in einer Konfiguration angegeben werden können. Es wird empfohlen, dass jeder ITargetPreparer seine erwartete Umgebung vor und nach der Einrichtung klar dokumentiert. zB 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 Zielreinigung/Teardown 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 über den zu testenden Build.

Wirft
TargetSetupError	wenn ein schwerwiegender Fehler beim Einrichten der Umgebung aufgetreten ist
BuildError	Wenn ein Fehler im Zusammenhang mit der 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.

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

niederreißen

public void tearDown (TestInformation testInformation, 
                Throwable e)

Führen Sie nach dem Testen die Zielreinigung/Teardown 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 .

Wirft
DeviceNotAvailableException	wenn das Gerät nicht mehr reagiert

niederreiß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 Zielreinigung/Teardown durch.

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

Wirft
DeviceNotAvailableException	wenn das Gerät nicht mehr reagiert