Ab dem 27. März 2025 empfehlen wir, android-latest-release anstelle von aosp-main zu verwenden, um AOSP zu erstellen und Beiträge dazu zu leisten. Weitere Informationen finden Sie unter Änderungen am AOSP.

Diese Seite wurde von der Cloud Translation API übersetzt.

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, CompileBootImageWithSpeedTargetPreparer, CpuThrottlingWaiter und 76 weitere.

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 `Option`s 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