Ab 2026 werden wir, um unser stabiles Entwicklungsmodell für den Trunk zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten, den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen. Verwenden Sie android-latest-release, um AOSP zu entwickeln und dazu beizutragen. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

Bekannte indirekte Unterklassen

AFlagsTargetPreparer, AdbStopServerPreparer, AllTestAppsInstallSetup, AoaTargetPreparer, AppSetup, ArtChrootPreparer, BaseEmulatorPreparer, BaseSwitchUserTargetPreparer, BaseSystemTestEnvPreparer, BaseTargetPreparer, BuildInfoRecorder, CheckPairingPreparer, CompanionAllocator, CompanionAwarePreparer, CompanionRunCommandTargetPreparer und 94 weitere.

AFlagsTargetPreparer	Verwendet `aflags`, um Flags vor dem Ausführen eines Tests zu überschreiben.
AdbStopServerPreparer	Zielvorbereiter zum Beenden des ADB-Servers auf dem Host vor und nach dem Ausführen von ADB-Tests.
AllTestAppsInstallSetup	Eine `ITargetPreparer`, mit der alle Apps aus einem `IDeviceBuildInfo.getTestsDir()`-Ordner auf dem Gerät installiert werden.
AoaTargetPreparer	`ITargetPreparer`, das eine Reihe von Aktionen (z.B. Klicks und Wischbewegungen) über das Android Open Accessory-Protokoll (AOAv2) ausführt.
AppSetup	Eine `ITargetPreparer`, die eine APK-Datei und die zugehörigen Tests installiert.
ArtChrootPreparer	Erstellen Sie ein Chroot-Verzeichnis für ART-Tests.
BaseEmulatorPreparer	Allgemeiner Preparer zum Starten eines lokalen Emulators.
BaseSwitchUserTargetPreparer	Eine `ITargetPreparer`, die in setUp zum angegebenen Nutzertyp wechselt.
BaseSystemTestEnvPreparer	Neustarts in der Testumgebung des Basissystems
BaseTargetPreparer	Basisimplementierungsklasse für `ITargetPreparer`, mit der gesteuert werden kann, ob das Objekt deaktiviert ist oder nicht.
BuildInfoRecorder	Ein `ITargetPreparer`, das Build-Metadaten in eine angegebene Datei schreibt.
CheckPairingPreparer	Ein `CompanionAwarePreparer`, das die Bluetooth-Kopplung zwischen primären und Companion-Geräten überprüft
CompanionAllocator	Basisklasse, die sich um die Zuweisung und Freigabe von Companion-Geräten kümmert `getCompanionDeviceSelectionOptions()` sollte implementiert werden, um die Kriterien zu beschreiben, die für die Zuweisung des Companion-Geräts erforderlich sind.
CompanionAwarePreparer	Ein `ITargetPreparer`, das die Logik zum Abrufen eines bereits zugewiesenen Begleitgeräts kapselt.
CompanionRunCommandTargetPreparer	Ein `ITargetPreparer`, das angegebene Befehle auf dem zugewiesenen Begleitgerät ausführt
CompanionTestAppInstallSetup	Ein `ITargetPreparer`, das eine oder mehrere Apps aus einem `IDeviceBuildInfo.getTestsDir()`-Ordner auf einem zugewiesenen Begleitgerät installiert.
CompatTargetPreparer	Eine `ITargetPreparer`, die das Gerät für die Ausführung von Kompatibilitätstests vorbereitet.
CompileBootImageWithSpeedTargetPreparer	Kompiliert den Boot-Klassenpfad und den Systemserver mit dem Compilerfilter „speed“ neu.
CpuThrottlingWaiter	Ein `ITargetPreparer`, das wartet, bis die maximale Frequenz auf allen Kernen auf das höchstmögliche Niveau zurückgesetzt wurde
CreateAvdPreparer
CreateUserPreparer	Zielvorbereiter zum Erstellen eines sekundären Nutzers und zum Bereinigen am Ende.
CrosDutTopologyPreparer	Ein Preparer, der das Tool „dt-converter“ ausführt, um die Testkonfiguration und Testparameter zu generieren.
CrosLsNexusPreparer	Ein Vorbereiter, der den LSNexus-Dienst für ein ChromeOS-Gerät startet und beendet.
CtsSettingsSetup	Eine `ITargetPreparer`, die die Einstellungen eines Geräts zur Vorbereitung auf die Ausführung von CTS-Tests konfiguriert.
DeviceActionTargetPreparer	Ein `ITargetPreparer` zum Ausführen von Geräteaktionen.
DeviceBuildInfoBootStrapper	Ein `ITargetPreparer`, das Felder mit Build-Informationen durch Attribute ersetzt, die vom Gerät gelesen werden. Das ist nützlich, um Geräte mit Builds zu testen, die aus einer externen Quelle generiert wurden (z.B.
DeviceBuildInfoInjector	Ein `ITargetPreparer`, das `DeviceBuildDescriptor`-Metadaten in das `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`, das ein Bild auf physischer Android-Hardware anzeigt.
DeviceImageZipFlashingTargetPreparer	Ein Zielvorbereiter, der das Gerät mit Geräte-Images flasht, die über ein bestimmtes Format bereitgestellt werden.
DeviceOwnerTargetPreparer	Ein `ITargetPreparer`, das eine Komponente für den Geräteeigentümer einrichtet.
DeviceSetup	Eine `ITargetPreparer`, die ein Gerät anhand der bereitgestellten `Option` für Tests konfiguriert.
DeviceStorageFiller	Zielvorbereiter, um Speicherplatz zu füllen, damit etwas freier Speicherplatz verfügbar ist.
DeviceStringPusher	Zielvorbereiter zum Schreiben eines Strings in eine Datei.
DeviceUpdateTargetPreparer	Eine abstrakte `ITargetPreparer`, die sich um die gängigen Schritte zum Aktualisieren von Geräten mit einer Gerätebilddatei aus einer externen Quelle (im Gegensatz zu einem Build-Dienst) kümmert.
DeviceWiper	Ein `ITargetPreparer`, das Nutzerdaten löscht
DexMetadataExtractor	Installiert Dex-Metadatendateien für die angegebenen APKs.
DisableSELinuxTargetPreparer	Target-Vorbereiter, der SELinux deaktiviert, falls aktiviert.
DynamicSystemPreparer	Ein `ITargetPreparer`, das ein Systemimage auf einem Geräte-Build mit dem dynamischen Systemupdate einrichtet.
EhideTargetPreparer	Startet „ehide“, wodurch die Ethernet-Schnittstelle im Android-Netzwerk-Stack ausgeblendet wird.
EraseUserDataPreparer	Ein `ITargetPreparer`, mit dem Nutzerdaten auf dem Gerät gelöscht werden.
FastbootCommandPreparer	Target-Vorbereiter, der Fastboot auslöst und Fastboot-Befehle sendet.
FastbootUpdateBootstrapPreparer	Ein `ITargetPreparer`, das bestimmte Dateien (Bootloader, Funkschnittstelle, Geräte-Image-ZIP) in `IDeviceBuildInfo` bereitstellt, damit Geräte mit `FastbootDeviceFlasher` geflasht werden können. Anschließend werden Geräteattribute nach dem Booten in die Build-Informationen eingefügt, um Ergebnisse zu melden.
FeatureFlagTargetPreparer	Diese Klasse wurde eingestellt. Verwenden Sie stattdessen `AFlagsTargetPreparer`.
FoldableModePreparer	Ein Ziel-Preparer, der den faltbaren Zustand eines Geräts ändern kann.
FolderSaver	Ein `ITargetPreparer`, das Verzeichnisse vom Gerät abruft, komprimiert und im Logging-Backend speichert.
FutilityCommandPreparer	Vorbereiter zum Ausführen von Befehlen zur Nutzlosigkeit.
GkiDeviceFlashPreparer	Ein Target-Preparer, der das Gerät mit einem generischen Image des Android Common Kernel flasht.
GoogleAccountPreparer	Ein `ITargetPreparer`, das die Konfiguration von Google-Konten unterstützt.
GoogleAppsSetup	Eine `ITargetPreparer`, die verschiedene Einrichtungsoptionen für Google-Apps unterstützt Hinweis: Auf einem Gerät muss zuerst ein Konto konfiguriert werden. Weitere Informationen finden Sie unter `GoogleAccountPreparer`
GoogleDeviceFlashPreparer	Eine Spezialisierung von `DeviceFlashPreparer`, die benutzerdefinierte Schritte unterstützt, die zum Flashen von Google-Geräten erforderlich sind.
GoogleDeviceSetup	Eine Erweiterung von `DeviceSetup`, mit der zusätzliche Google-spezifische Properties eingerichtet werden können.
GsiDeviceFlashPreparer	Ein Zielvorbereiter, der das Gerät mit einem generischen Android-Systemimage flasht.
HsumBootStrategyPreparer
ILabPreparer	Markierungsoberfläche für Lab-Vorbereiter Eine Beschreibung der Verwendung dieser Schnittstellen finden Sie unter `ITargetPreparer`.
ITargetCleaner	Diese Schnittstelle wurde eingestellt. tearDown wurde in die Basis-ITargetPreparer-Schnittstelle verschoben.
InstallAllTestZipAppsSetup	Ein `ITargetPreparer`, das alle Apps in einer Test-Zip-Datei installiert.
InstallApexModuleTargetPreparer
InstallApkSetup	Eine `ITargetPreparer`, die eine oder mehrere APKs installiert, die sich im Dateisystem befinden.
InstallBuildEnvApkSetup	Ein `ITargetPreparer`, das ein oder mehrere Test-APKs aus einer Android-Plattform-Build-Umgebung installiert.
InstallKernelModulePreparer	Ein Target-Preparer, der Kernelmodule installiert.
InstrumentationPreparer	Ein `ITargetPreparer`, das die Instrumentierung ausführt
KillExistingEmulatorPreparer	Ein `ITargetPreparer`, das einen laufenden Emulator beendet.
KnownFailurePreparer	Zielvorbereiter, um das Wiederholen eines bekannten Fehlers 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 ein Kernel-Image mit dem Geräte-Image gemischt werden kann.
MixRadioTargetPreparer	Ein `ITargetPreparer`, mit dem ein Radiosenderbild mit dem Gerätebild gemischt werden kann.
ModuleOemTargetPreparer
NativeLeakCollector	Ein `ITargetPreparer`, das „dumpsys meminfo --unreachable -a“ ausführt, um den nicht erreichbaren nativen Speicher zu ermitteln, der derzeit von jedem Prozess belegt wird.
NoApkTestSkipper	Spezielle Vorbereitung, mit der ein Aufruf vollständig übersprungen werden kann (Vorbereitung und Tests), wenn keine zu testenden APKs vorhanden sind.
PerfettoPreparer	Der Perfetto-Vorbereiter überträgt die Konfigurationsdatei an einen Standardspeicherort auf dem Gerät, auf den Perfetto zugreifen kann.
ProfileTargetPreparer	Basisklasse zum Einrichten des Zielvorbereiters für einen beliebigen Profilnutzer `android.os.usertype.profile.XXX`.
PushFileInvoker	Diese Klasse wurde eingestellt. Verwenden Sie stattdessen `PushFilePreparer`.
PushFilePreparer	Ein `ITargetPreparer`, das versucht, eine beliebige Anzahl von Dateien von einem beliebigen Hostpfad in einen beliebigen Gerätepfad zu übertragen.
PythonVirtualenvPreparer	Richtet eine virtuelle Python-Umgebung auf dem Host ein und installiert Pakete.
RamdumpPreparer	Ramdump aktivieren
RebootTargetPreparer	Zielvorbereiter, der das Gerät neu startet.
RecoveryLogPreparer	Ein Zielvorbereiter, der zum Erfassen von Logs vor der Wiederherstellung verwendet wird.
RemoveSystemAppPreparer	Ein `ITargetPreparer` zum Entfernen eines APKs aus der Systempartition vor einem Testlauf.
RestartSystemServerTargetPreparer	Target-Vorbereiter, 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	Target-Vorbereiter zum Ausführen beliebiger Hostbefehle vor und nach dem Ausführen des Tests.
RunHostScriptTargetPreparer	Zielvorbereiter, der ein Skript vor dem Ausführen eines Tests ausführt.
RunOnCloneProfileTargetPreparer
RunOnPrivateProfileTargetPreparer
RunOnSdkSandboxTargetPreparer	Ein `ITargetPreparer` für Markierungen, die angeben, dass Tests in der SDK-Sandbox ausgeführt werden sollen.
RunOnSecondaryUserTargetPreparer	Ein `ITargetPreparer`, um sicherzustellen, dass der Test als sekundärer Nutzer ausgeführt wird.
RunOnSystemUserTargetPreparer	Ein `ITargetPreparer`, das angibt, dass Tests für den Nutzer (und nicht für den aktuellen Nutzer) ausgeführt werden sollen.
RunOnWorkProfileTargetPreparer	Ein `ITargetPreparer`, das bei der Einrichtung ein Arbeitsprofil erstellt und angibt, dass Tests für diesen Nutzer ausgeführt werden sollen.
SemaphoreTokenTargetPreparer	Dies ist ein Vorbereiter, mit dem das Token verwendet wird, um die Testausführung im Tradefed-Host zu serialisieren.
Einstellungen – Einrichtung	Eine `ITargetPreparer`, die Geräteeinstellungen über die Instrumentierung von SettingsUtil.apk konfiguriert.
SideloadOtaTargetPreparer	Ein Target-Preparer, der ein angegebenes OTA-Paket sideloadet, das Paket anwendet, wartet, bis das Gerät hochgefahren ist, und die Build-Eigenschaften des Geräts als Build-Informationen einfügt. Bei diesem Zielvorbereiter wird davon ausgegangen, dass sich das Gerät beim Start im regulären ADB-Modus befindet. Er sorgt dafür, dass das Gerät im selben Modus beendet wird, aber mit dem neueren Build.
StopServicesSetup	Ein `ITargetPreparer`, das Dienste auf dem Gerät beendet.
StubTargetPreparer	Platzhalter für eine leere Implementierung von `ITargetPreparer`.
SuiteApkInstaller	Installiert die angegebenen APKs für die Suite-Konfiguration: entweder aus der Variablen $ANDROID_TARGET_OUT_TESTCASES oder aus ROOT_DIR in den Build-Informationen.
SwitchUserTargetPreparer	Standardimplementierung von `BaseSwitchUserTargetPreparer`. Weitere Informationen finden Sie in der Javadoc-Dokumentation dieser Klasse.
TearDownPassThroughPreparer	Ermöglicht das Ausführen von „tearDown“ für Preparer, die in einer Konfiguration als Objekt enthalten sind.
TemperatureThrottlingWaiter	Eine `ITargetPreparer`, die wartet, bis die Temperatur des Geräts die Zieltemperatur erreicht hat
TestAppInstallSetup	Eine `ITargetPreparer`, die eine oder mehrere Apps aus einem `IDeviceBuildInfo.getTestsDir()`-Ordner auf dem Gerät installiert.
TestFilePushSetup	Ein `ITargetPreparer`, das eine oder mehrere Dateien/Verzeichnisse aus einem `IDeviceBuildInfo.getTestsDir()`-Ordner auf das Gerät überträgt.
TestSystemAppInstallSetup	Eine `ITargetPreparer`, die eine oder mehrere Apps aus einem `IDeviceBuildInfo.getTestsDir()`-Ordner auf der /system-Partition des Geräts installiert.
TimeWaster	Ein einfacher Zielvorbereiter, um Zeit zu verschwenden und das Gerät möglicherweise neu zu starten.
UserCleaner	Ein `ITargetPreparer`, das sekundäre Nutzer beim Abbau entfernt.
VisibleBackgroundUserPreparer	Zielvorbereiter zum Ausführen von Tests in einem Nutzer, der im Hintergrund gestartet wird.
WaitForDeviceDatetimePreparer	Eine `ITargetPreparer`, die darauf wartet, dass Datum und Uhrzeit auf dem Gerät festgelegt werden Optional kann der Preparer ein `TargetSetupError` erzwingen, wenn das Datum/die Uhrzeit nicht innerhalb des Zeitlimits festgelegt wird.
WifiPreparer	Eine `ITargetPreparer`, die bei Bedarf WLAN auf dem Gerät konfiguriert.

Bereitet die Testumgebung für den Testlauf vor.

Beispiele: Software installieren, Umgebungseinstellungen für Tests anpassen, Ziele starten usw.

In einer Konfiguration können mehrere ITargetPreparer angegeben werden. Es wird empfohlen, dass jeder ITargetPreparer seine erwartete Umgebung vor und nach der Einrichtung klar dokumentiert. Ein ITargetPreparer, der ein Gerät für Tests konfiguriert, muss beispielsweise nach dem ITargetPreparer ausgeführt werden, der Software installiert.

Zusammenfassung

Öffentliche Methoden
`default void`	`setUp(ITestDevice device, IBuildInfo buildInfo)` Diese Methode wurde eingestellt. Verwenden Sie stattdessen `setUp(TestInformation)`.
`default void`	`setUp(TestInformation testInformation)` Richten Sie das Ziel für Tests ein.
`default void`	`tearDown(TestInformation testInformation, Throwable e)` Führen Sie nach dem Testen die Bereinigung/das Herunterfahren des Ziels durch.
`default void`	`tearDown(ITestDevice device, IBuildInfo buildInfo, Throwable e)` Diese Methode wurde eingestellt. Verwenden Sie stattdessen `tearDown(TestInformation,Throwable)`.

Öffentliche Methoden

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

Diese Methode wurde eingestellt.
Verwenden Sie stattdessen setUp(TestInformation).

Richten Sie das Ziel für Tests ein.

Parameter
`device`	`ITestDevice`: die vorzubereitende `ITestDevice`.
`buildInfo`	`IBuildInfo`: Daten zum Build, der getestet wird.

Löst aus
`DeviceNotAvailableException`	Wenn das Gerät nicht mehr reagiert
`BuildError`	Wenn ein Fehler im Zusammenhang mit BuildInfo auftritt
`TargetSetupError`	Wenn beim Einrichten der Umgebung ein schwerwiegender Fehler aufgetreten ist

setUp

public void setUp (TestInformation testInformation)

Richten Sie das Ziel für Tests ein.

Parameter
`testInformation`	`TestInformation`: Der `TestInformation` des Aufrufs.

Löst aus
`DeviceNotAvailableException`	Wenn das Gerät nicht mehr reagiert
`BuildError`	Wenn ein Fehler aufgrund der Vorbereitung des Builds auftritt
`TargetSetupError`	Wenn beim Einrichten der Umgebung ein schwerwiegender Fehler aufgetreten ist

tearDown

public void tearDown (TestInformation testInformation, 
                Throwable e)

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

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

Löst aus
`DeviceNotAvailableException`	Wenn das Gerät nicht mehr reagiert

tearDown

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

Diese Methode wurde eingestellt.
Verwenden Sie stattdessen tearDown(TestInformation,Throwable).

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

Parameter
`device`	`ITestDevice`: die vorzubereitende `ITestDevice`.
`buildInfo`	`IBuildInfo`: Daten zum Build, der getestet wird.
`e`	`Throwable`: Wenn der Aufruf mit einer Ausnahme beendet wurde, ist dies die Ausnahme, die auf Aufrufebene abgefangen wurde. Andernfalls ist es `null`.

Löst aus
`DeviceNotAvailableException`	Wenn das Gerät nicht mehr reagiert