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 79 weitere.

AdbStopServerPreparer	Zielvorbereiter zum Beenden des ADB-Servers auf dem Host vor und nach dem Ausführen von ADB-Tests.
AllTestAppsInstallSetup	Ein `ITargetPreparer`, mit dem 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	Ein `ITargetPreparer`, das ein APK und die zugehörigen Tests installiert.
ArtChrootPreparer	Erstellen Sie ein Chroot-Verzeichnis für ART-Tests.
BaseEmulatorPreparer	Allgemeiner Preparer 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`, das Metadaten zu Build-Informationen 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 Begleitgerä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 Companion-Gerät ausführt
CompanionTestAppInstallSetup	Eine `ITargetPreparer`, die 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 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 des Nutzers und zum Bereinigen am Ende.
DeviceActionTargetPreparer	Ein `ITargetPreparer` zum Ausführen von Geräteaktionen.
DeviceBuildInfoBootStrapper	Ein `ITargetPreparer`, das Build-Infofelder durch Attribute ersetzt, die vom Gerät gelesen werden Dies 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`s 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
DisableSELinuxTargetPreparer	Target-Vorbereiter, der SELinux deaktiviert, falls es aktiviert ist.
DynamicSystemPreparer	Ein `ITargetPreparer`, das ein System-Image auf einem Geräte-Build mit dem dynamischen Systemupdate einrichtet.
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, Funkmodul, 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	Aktualisiert die DeviceConfig (durch einen Remotedienst abgestimmte Feature-Flags).
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.
GsiDeviceFlashPreparer	Ein Zielvorbereiter, der das Gerät mit einem generischen Android-System-Image flasht.
ILabPreparer	Markierungsschnittstelle 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`, mit der eine oder mehrere APKs installiert werden, 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	Eine `ITargetPreparer`, mit der ein Radiobild 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 Zugriff hat.
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.
RebootTargetPreparer	Zielvorbereiter, der das Gerät neu startet.
RecoveryLogPreparer	Ein Target-Preparer, 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-Preparer zum Ausführen beliebiger Hostbefehle vor und nach dem Ausführen des Tests.
RunHostScriptTargetPreparer	Target-Vorbereiter, der ein Skript vor dem Ausführen eines Tests ausführt.
RunOnCloneProfileTargetPreparer
RunOnPrivateProfileTargetPreparer
RunOnSdkSandboxTargetPreparer	Eine `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 Preparer, mit dem das Token verwendet wird, um die Testausführung im Tradefed-Host zu serialisieren.
SideloadOtaTargetPreparer	Ein Target-Preparer, der ein angegebenes OTA-Paket sideloadet, das Paket anwendet, wartet, bis das Gerät hochgefahren ist, und die Geräte-Build-Eigenschaften 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	Ein `ITargetPreparer`, das in setUp zum angegebenen Nutzertyp wechselt.
TearDownPassThroughPreparer	Ermöglicht das Ausführen von „tearDown“ für Preparer, die in einer Konfiguration als Objekt enthalten sind.
TemperatureThrottlingWaiter	Ein `ITargetPreparer`, das wartet, bis die Temperatur des Geräts die Zieltemperatur erreicht hat
TestAppInstallSetup	Eine `ITargetPreparer`, mit der eine oder mehrere Apps aus einem `IDeviceBuildInfo.getTestsDir()`-Ordner auf dem Gerät installiert werden.
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 dieser 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 die 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 ist veraltet. Verwenden Sie stattdessen `setUp(com.android.tradefed.invoker.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 ist veraltet. Verwenden Sie stattdessen `tearDown(com.android.tradefed.invoker.TestInformation, Throwable)`.

Öffentliche Methoden

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

Diese Methode wurde eingestellt.
Verwenden Sie stattdessen setUp(com.android.tradefed.invoker.TestInformation).

Richten Sie das Ziel für Tests ein.

Parameter
`device`	`ITestDevice`: die vorzubereitende `ITestDevice`.
`buildInfo`	`IBuildInfo`: Daten zum zu testenden Build.

Ausgabe
`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

setUp

public void setUp (TestInformation testInformation)

Richten Sie das Ziel für Tests ein.

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

Ausgabe
`TargetSetupError`	Wenn beim Einrichten der Umgebung ein schwerwiegender Fehler aufgetreten ist
`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/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`.

Ausgabe
`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(com.android.tradefed.invoker.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 zu testenden Build.
`e`	`Throwable`: Wenn der Aufruf mit einer Ausnahme beendet wurde, ist dies die Ausnahme, die auf Aufrufebene abgefangen wurde. Andernfalls ist es `null`.

Ausgabe
`DeviceNotAvailableException`	Wenn das Gerät nicht mehr reagiert