Natives Gerät

public interface INativeDevice

com.android.tradefed.device.INativeDevice

Bekannte indirekte abgeleitete Klassen IManagedTestDevice, ITestDevice, LocalAndroidVirtualDevice, ManagedRemoteDevice, NativeDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice, TestDevice IManagedTestDevice Ein ITestDevice, dessen Lebenszyklus verwaltet wird.  ITestDevice Stellt eine zuverlässige und etwas höhere API für ein ddmlib-IDevice bereit.  LocalAndroidVirtualDevice Die Klasse für lokale virtuelle Geräte, die auf dem TradeFed-Host ausgeführt werden.  ManagedRemoteDevice Ein Gerät, das in einer virtuellen Maschine ausgeführt wird und die wir per Fernzugriff über eine Tradefed-Instanz in der VM verwalten.  NativeDevice Standardimplementierung eines ITestDevice Nicht-Full-Stack-Android-Geräts.  Verschachteltes Remote-Gerät Darstellung des Geräts, das in einer entfernten Cuttlefish-VM ausgeführt wird.  Remote-Android-Gerät Implementierung einer ITestDevice für ein Full-Stack-Android-Gerät, das über ADB Connect verbunden wird.  RemoteAndroidVirtualDevice Erweitert das RemoteAndroidDevice-Verhalten für ein Full-Stack-Android-Gerät, das in Google Compute Engine (Gce) ausgeführt wird.  Testgerät Implementierung von ITestDevice für ein Full-Stack-Android-Gerät

---

Stellt eine zuverlässige und etwas höhere API für ein ddmlib-IDevice bereit.

Wiederholt Gerätebefehle für einen konfigurierbaren Betrag und bietet eine Oberfläche zur Gerätewiederherstellung für Geräte, die nicht reagieren.

Zusammenfassung

Konstanten
int	UNKNOWN_API_LEVEL Standardwert, wenn das API-Level nicht erkannt werden kann

Öffentliche Methoden
abstract boolean	checkApiLevelAgainstNextRelease(int strictMinLevel) Prüfen Sie, ob eine Funktion derzeit mit einer minimal unterstützten Stufe unterstützt wird.
abstract void	clearLogcat() Löscht alle akkumulierten Logcat-Daten.
abstract void	deleteFile(String deviceFilePath) Hilfsmethode zum Löschen einer Datei oder eines Verzeichnisses auf dem Gerät.
abstract void	deleteFile(String deviceFilePath, int userId) Hilfsmethode zum Löschen einer Datei oder eines Verzeichnisses auf dem Gerät.
abstract boolean	deviceSoftRestarted(ProcessInfo prevSystemServerProcess) Hilfsmethode, um zu prüfen, ob das Gerät weich gestartet wurde. Dazu wird der aktuelle Systemserver mit dem vorherigen „system_server“ ProcessInfo verglichen.
abstract boolean	deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit) Hilfsmethode, um zu prüfen, ob das Gerät seit der UTC-Zeit seit der Epoche vom Gerät und seinem ERROR(/TimeUnit) vorläufig neu gestartet wurde.
abstract boolean	disableAdbRoot() Deaktiviert den ADB-Root.
abstract boolean	doesFileExist(String deviceFilePath) Hilfsmethode zum Ermitteln, ob eine Datei auf dem Gerät vorhanden ist.
abstract boolean	enableAdbRoot() Aktiviert den ADB-Stamm.
abstract String	executeAdbCommand(long timeout, String... commandArgs) Hilfsmethode, die einen adb-Befehl als Systembefehl mit einem bestimmten Zeitlimit ausführt.
abstract String	executeAdbCommand(String... commandArgs) Hilfsmethode, die einen adb-Befehl als Systembefehl ausführt.
abstract String	executeAdbCommand(long timeout, envMap, String... commandArgs) Hilfsmethode, die einen adb-Befehl als Systembefehl mit einem bestimmten Zeitlimit ausführt.
abstract CommandResult	executeFastbootCommand(long timeout, String... commandArgs) Hilfsmethode, die einen Fastboot-Befehl als Systembefehl ausführt.
abstract CommandResult	executeFastbootCommand(String... commandArgs) Hilfsmethode, die einen Fastboot-Befehl als Systembefehl mit einem Standardzeitlimit von 2 Minuten ausführt.
abstract CommandResult	executeLongFastbootCommand(String... commandArgs) Hilfsmethode, die einen lange laufenden Fastboot-Befehl als Systembefehl ausführt.
abstract CommandResult	executeLongFastbootCommand( envVarMap, String... commandArgs) Hilfsmethode, die einen lange laufenden Fastboot-Befehl als Systembefehl mit Systemumgebungsvariablen ausführt.
abstract String	executeShellCommand(String command) Hilfsmethode, die einen ADB-Shell-Befehl ausführt und die Ausgabe als String zurückgibt.
abstract void	executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) Führt einen adb-Shell-Befehl mit mehr Parametern zur Steuerung des Befehlsverhaltens aus.
abstract void	executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) Führt einen adb-Shell-Befehl mit mehr Parametern zur Steuerung des Befehlsverhaltens aus.
abstract void	executeShellCommand(String command, IShellOutputReceiver receiver) Führt den angegebenen adb-Shell-Befehl aus und wiederholt einen mehrfachen Versuch, wenn der Befehl fehlschlägt.
abstract CommandResult	executeShellV2Command(String command) Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ergebnisse als CommandResult zurückgibt, die ordnungsgemäß mit der Ausgabe des Befehlsstatus (stdout und stderr) ausgefüllt ist.
abstract CommandResult	executeShellV2Command(String command, OutputStream pipeToOutput) Hilfsmethode, die einen ADB-Shell-Befehl ausführt und die Ergebnisse als CommandResult zurückgibt, die ordnungsgemäß mit der Befehlsausgabe und stderr ausgefüllt ist.
abstract CommandResult	executeShellV2Command(String command, File pipeAsInput) Hilfsmethode, die einen ADB-Shell-Befehl ausführt und die Ergebnisse als CommandResult zurückgibt, die ordnungsgemäß mit der Befehlsausgabeausgabe, stdout und stderr ausgefüllt ist.
abstract CommandResult	executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Führt einen adb-Shell-Befehl mit mehr Parametern zur Steuerung des Befehlsverhaltens aus.
abstract CommandResult	executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit) Führt einen adb-Shell-Befehl mit mehr Parametern zur Steuerung des Befehlsverhaltens aus.
abstract CommandResult	executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Führt einen adb-Shell-Befehl mit mehr Parametern zur Steuerung des Befehlsverhaltens aus.
abstract CommandResult	executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Führt einen adb-Shell-Befehl mit mehr Parametern zur Steuerung des Befehlsverhaltens aus.
abstract CommandResult	fastbootWipePartition(String partition) Hilfsmethode zum Löschen einer Partition auf dem Gerät.
abstract int	getApiLevel() API-Level des Geräts abrufen
abstract String	getBasebandVersion() Praktische Methode zum Abrufen der Baseband- bzw. Funkversion dieses Geräts.
abstract Integer	getBattery() Gibt den aktuellen Akkustand eines Geräts oder Null zurück, wenn der Akkustand nicht verfügbar ist.
abstract boolean	getBooleanProperty(String name, boolean defaultValue) Gibt einen booleschen Wert der angegebenen Eigenschaft zurück.
abstract	getBootHistory() Die Hilfsmethode erfasst die Boot-Verlaufszuordnung mit Startzeit und Startgrund.
abstract	getBootHistorySince(long utcEpochTime, TimeUnit timeUnit) Die Hilfsmethode erfasst die Bootverlaufszuordnung mit Bootzeit und Bootgrund seit der angegebenen Zeit seit der Epoche ab dem Gerät und der angegebenen Zeiteinheit.
abstract String	getBootloaderVersion() Praktische Methode zum Abrufen der Bootloader-Version dieses Geräts.
abstract String	getBuildAlias() Rufen Sie den Alias des Builds ab, den das Gerät derzeit ausführt.
abstract String	getBuildFlavor() Rufen Sie den Build-Flavor für das Gerät ab.
abstract String	getBuildId() Rufen Sie den Build ab, den das Gerät derzeit ausführt.
abstract String	getBuildSigningKeys() Gibt den Schlüsseltyp zurück, der zum Signieren des Geräte-Images verwendet wurde Android-Geräte können in der Regel mit Testschlüsseln (wie in AOSP) oder Release-Schlüsseln (von den einzelnen Geräteherstellern kontrolliert) signiert sein.
abstract DeviceDescriptor	getCachedDeviceDescriptor() Gibt ein im Cache gespeichertes DeviceDescriptor zurück, wenn das Gerät zugewiesen ist. Andernfalls wird der aktuelle DeviceDescriptor zurückgegeben.
abstract DeviceDescriptor	getCachedDeviceDescriptor(boolean shortDescriptor) Gibt ein im Cache gespeichertes DeviceDescriptor zurück, wenn das Gerät zugewiesen ist. Andernfalls wird der aktuelle DeviceDescriptor zurückgegeben.
abstract String[]	getChildren(String deviceFilePath) Eine Alternative zur Verwendung von IFileEntry, die aufgrund von Berechtigungen manchmal nicht funktioniert.
abstract AbstractConnection	getConnection() Gibt die Verbindung zurück, die dem Gerät zugeordnet ist.
abstract String	getDeviceClass() Rufen Sie die Geräteklasse ab.
abstract long	getDeviceDate() Gibt das Datum des Geräts in Millisekunden seit der Epoche zurück.
abstract DeviceDescriptor	getDeviceDescriptor() Gib ein DeviceDescriptor aus den Geräteinformationen zurück, um Informationen zu erhalten, ohne das tatsächliche Geräteobjekt zu übergeben.
abstract DeviceDescriptor	getDeviceDescriptor(boolean shortDescriptor) Gib ein DeviceDescriptor aus den Geräteinformationen zurück, um Informationen zu erhalten, ohne das tatsächliche Geräteobjekt zu übergeben.
abstract TestDeviceState	getDeviceState() Rufen Sie den Status des Geräts ab.
abstract long	getDeviceTimeOffset(Date date) Hilfsfunktion, um den Zeitunterschied zwischen dem Gerät und einem bestimmten ERROR(/Date) zu ermitteln.
abstract InputStreamSource	getEmulatorOutput() Stream für Emulatoren stdout und stderr abrufen
abstract long	getExternalStoreFreeSpace() Hilfsmethode zum Ermitteln der Menge an freiem Speicherplatz im externen Gerätespeicher.
abstract String	getFastbootProductType() Praktische Methode zum Abrufen des Produkttyps dieses Geräts, wenn es sich im Schnellstartmodus (Fastboot mode) befindet.
abstract String	getFastbootProductVariant() Praktische Methode zum Abrufen des Produkttyps dieses Geräts, wenn es sich im Schnellstartmodus (Fastboot mode) befindet.
abstract String	getFastbootSerialNumber() Gibt die Seriennummer des Fastboot-Modus zurück.
abstract String	getFastbootVariable(String variableName) Rufen Sie den angegebenen Wert der Fastboot-Variable vom Gerät ab.
abstract IFileEntry	getFileEntry(String path) Rufen Sie einen Verweis auf eine Remote-Datei auf dem Gerät ab.
abstract IDevice	getIDevice() Gibt einen Verweis auf die verknüpfte ddmlib-IDevice zurück.
abstract long	getIntProperty(String name, long defaultValue) Gibt einen ganzzahligen Wert der angegebenen Eigenschaft vom Gerät zurück.
abstract long	getLastExpectedRebootTimeMillis() Gibt in Millisekunden zurück, wann die Tradefed APIs zuletzt einen Neustart ausgelöst haben, seit EPOCH von System.currentTimeMillis() zurückgegeben wurde.
abstract int	getLaunchApiLevel() Das erste API-Level des Geräts abrufen.
abstract InputStreamSource	getLogcat() Erfasst einen Snapshot-Stream der Logcat-Daten.
abstract InputStreamSource	getLogcat(int maxBytes) Erfasst einen Snapshot-Stream der letzten maxBytes der erfassten Logcat-Daten.
abstract InputStreamSource	getLogcatDump() Dump des aktuellen Logcats für das Gerät abrufen
abstract InputStreamSource	getLogcatSince(long date) Erfasst einen Snapshot-Stream erfasster Logcat-Daten ab dem angegebenen Datum.
abstract String	getMountPoint(String mountName) Gibt einen Bereitstellungspunkt zurück.
abstract ITestDevice.MountPointInfo	getMountPointInfo(String mountpoint) Gibt ein MountPointInfo zurück, das dem angegebenen Bereitstellungspunktpfad entspricht, oder null, wenn in diesem Pfad nichts bereitgestellt ist oder anderweitig nicht in /proc/mounts als Bereitstellungspunkt angezeigt wird.
abstract	getMountPointInfo() Gibt eine geparste Version der Informationen in /proc/mounts auf dem Gerät zurück
abstract long	getPartitionFreeSpace(String partition) Hilfsmethode zum Ermitteln der Menge an freiem Speicherplatz auf der Gerätepartition.
abstract ProcessInfo	getProcessByName(String processName) Die Hilfsmethode führt die Befehle "pidof" und "stat" aus und gibt das Objekt ProcessInfo mit PID und Prozessstartzeit des angegebenen Prozesses zurück.
abstract String	getProcessPid(String process) Gibt die PID des Dienstes oder null zurück, wenn ein Fehler aufgetreten ist.
abstract String	getProductType() Praktische Methode zum Abrufen des Produkttyps dieses Geräts.
abstract String	getProductVariant() Praktische Methode zum Abrufen der Produktvariante dieses Geräts.
abstract String	getProperty(String name) Ruft den angegebenen Attributwert vom Gerät ab.
abstract ITestDevice.RecoveryMode	getRecoveryMode() Rufen Sie den aktuellen Wiederherstellungsmodus des Geräts ab.
abstract String	getSerialNumber() Eine praktische Methode zum Abrufen der Seriennummer dieses Geräts.
abstract	getTombstones() Die Liste der Tombstones von den Geräten abrufen und zurückgeben.
abstract long	getTotalMemory() Gibt die Gesamtgröße des physischen Arbeitsspeichers in Byte oder -1 bei einem internen Fehler zurück.
abstract boolean	getUseFastbootErase() Legen Sie fest, ob eine Partition auf dem Gerät mit der Funktion „Fastboot Deletion“ oder „Fastboot“ gelöscht werden soll.
abstract boolean	isAdbRoot()
abstract boolean	isAdbTcp()
abstract boolean	isAppEnumerationSupported() Prüfen, ob die Plattform auf dem Gerät die Auflistung von Apps unterstützt
abstract boolean	isBypassLowTargetSdkBlockSupported() Prüfen, ob die Plattform auf dem Gerät das Umgehen eines niedrigen SDK-Zielblocks bei App-Installationen unterstützt
abstract boolean	isDebugfsMounted() Prüfen Sie, ob debugfs bereitgestellt ist.
abstract boolean	isDeviceEncrypted() Gibt an, ob das Gerät verschlüsselt ist.
abstract boolean	isDirectory(String deviceFilePath) Gibt „True“ zurück, wenn der Pfad auf dem Gerät ein Verzeichnis ist, andernfalls „false“.
abstract boolean	isEncryptionSupported() Gibt zurück, wenn die Verschlüsselung auf dem Gerät unterstützt wird.
abstract boolean	isExecutable(String fullPath) Gibt "True" zurück, wenn der Dateipfad auf dem Gerät eine ausführbare Datei ist, andernfalls "False".
abstract boolean	isHeadless() Gibt „true“ zurück, wenn das Gerät monitorlos ist (kein Bildschirm), andernfalls „false“.
abstract boolean	isRuntimePermissionSupported() Prüfen, ob die Plattform auf dem Gerät die Gewährung von Laufzeitberechtigungen unterstützt
abstract boolean	isStateBootloaderOrFastbootd() Gibt „true“ zurück, wenn sich das Gerät in TestDeviceState#FASTBOOT oder TestDeviceState.FASTBOOTD befindet.
abstract boolean	logAnrs(ITestLogger logger) Erfasst und protokolliert ANR-Fehler vom Gerät.
abstract void	logOnDevice(String tag, Log.LogLevel level, String format, Object... args) Protokolliert eine Nachricht im Logcat des Geräts.
abstract void	mountDebugfs() Stellen Sie debugfs bereit.
abstract void	nonBlockingReboot() Gibt einen Befehl zum Neustart des Geräts aus und wird zurückgegeben, wenn der Befehl abgeschlossen ist und das Gerät für ADB nicht mehr sichtbar ist.
abstract void	postBootSetup() Führen Sie die Anweisungen aus, um das Gerät nach jedem Start so zu konfigurieren, dass es getestet wird.
default void	postInvocationTearDown() Diese Methode wurde verworfen. Verwende stattdessen postInvocationTearDown(Throwable).
abstract void	postInvocationTearDown(Throwable invocationException) Zusätzliche Schritte für die gerätespezifische erforderliche Bereinigung, die nach dem Aufruf ausgeführt wird.
default void	preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes) Zusätzliche Schritte für die gerätespezifische erforderliche Einrichtung, die vor dem Aufruffluss auf dem Gerät ausgeführt werden.
abstract boolean	pullDir(String deviceFilePath, File localDir) Verzeichnisinhalte rekursiv vom Gerät abrufen.
abstract boolean	pullDir(String deviceFilePath, File localDir, int userId) Verzeichnisinhalte rekursiv vom Gerät abrufen.
abstract File	pullFile(String remoteFilePath, int userId) Ruft eine Datei vom Gerät ab, speichert sie in einer lokalen temporären ERROR(/File) und gibt diese File zurück.
abstract File	pullFile(String remoteFilePath) Ruft eine Datei vom Gerät ab, speichert sie in einer lokalen temporären ERROR(/File) und gibt diese File zurück.
abstract boolean	pullFile(String remoteFilePath, File localFile) Ruft eine Datei vom Gerät ab.
abstract boolean	pullFile(String remoteFilePath, File localFile, int userId) Ruft eine Datei vom Gerät ab.
abstract String	pullFileContents(String remoteFilePath) Ruft eine Datei vom Gerät ab und gibt den Inhalt zurück.
abstract File	pullFileFromExternal(String remoteFilePath) Eine praktische Methode, um eine Datei aus dem externen Speicher des Geräts abzurufen, sie in einer lokalen temporären ERROR(/File) zu speichern und einen Verweis auf diese File zurückzugeben.
abstract boolean	pushDir(File localDir, String deviceFilePath, int userId) Verzeichnisinhalte rekursiv auf das Gerät übertragen.
abstract boolean	pushDir(File localDir, String deviceFilePath, excludedDirectories) Verzeichnisinhalte werden rekursiv auf das Gerät übertragen und gleichzeitig einige gefilterte Verzeichnisse ausgeschlossen.
abstract boolean	pushDir(File localDir, String deviceFilePath) Verzeichnisinhalte rekursiv auf das Gerät übertragen.
abstract boolean	pushFile(File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded) Variante von pushFile(File, String), die optional den Bedarf an den Contentanbieter prüfen kann
abstract boolean	pushFile(File localFile, String deviceFilePath) Übertragen Sie eine Datei per Push auf das Gerät.
abstract boolean	pushFile(File localFile, String deviceFilePath, int userId) Übertragen Sie eine Datei per Push auf das Gerät.
abstract boolean	pushString(String contents, String deviceFilePath) Aus einem String erstellte Datei per Push an Gerät übertragen
abstract void	reboot() Startet das Gerät im ADB-Modus neu.
abstract void	reboot(String reason) Startet das Gerät im ADB-Modus neu, wobei die angegebenen reason bei jedem Neustart beibehalten werden.
abstract void	rebootIntoBootloader() Startet das Gerät im Bootloader-Modus neu.
abstract void	rebootIntoFastbootd() Startet das Gerät im Fastbootd-Modus neu.
abstract void	rebootIntoRecovery() Das Gerät wird im ADB-Wiederherstellungsmodus neu gestartet.
abstract void	rebootIntoSideload(boolean autoReboot) Startet das Gerät im ADB-Sideload-Modus neu. Beachten Sie, dass dies ein spezieller Modus für die Wiederherstellung ist. Wird blockiert, bis das Gerät in den Sideload-Modus wechselt
abstract void	rebootIntoSideload() Startet das Gerät im ADB-Sideload-Modus neu. Beachten Sie, dass dies ein spezieller Modus für die Wiederherstellung ist. Wird blockiert, bis das Gerät in den Sideload-Modus wechselt
abstract void	rebootUntilOnline() Eine Alternative zu reboot(), die nur blockiert, bis das Gerät online ist, d. h. für ADB.
abstract void	rebootUntilOnline(String reason) Eine Alternative zu reboot(), die nur blockiert, bis das Gerät online ist, d. h. für ADB.
abstract void	rebootUserspace() Startet nur den Userspace-Teil des Geräts neu.
abstract void	rebootUserspaceUntilOnline() Eine Alternative zu rebootUserspace() ()}, die nur blockiert, bis das Gerät online ist, d. h. für ADB.
abstract void	remountSystemReadOnly() Machen Sie die Systempartition auf dem Gerät schreibgeschützt.
abstract void	remountSystemWritable() Machen Sie die Systempartition auf dem Gerät beschreibbar.
abstract void	remountVendorReadOnly() Machen Sie die Anbieterpartition auf dem Gerät schreibgeschützt.
abstract void	remountVendorWritable() Machen Sie die Anbieterpartition auf dem Gerät beschreibbar.
abstract boolean	runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners) Praktische Methode zur Ausführung von ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) mit einem oder mehreren Listenern, die als Parameter übergeben werden.
abstract boolean	runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners) Führt Instrumentierungstests durch und bietet Gerätewiederherstellung.
abstract boolean	runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners) Hat dieselbe Funktion wie ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)), führt aber den Test für den angegebenen Nutzer aus.
abstract boolean	runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners) Hat dieselbe Funktion wie ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...), führt aber den Test für einen bestimmten Nutzer aus.
abstract void	setDate(Date date) Legt das Datum auf dem Gerät fest Hinweis: Zum Festlegen des Datums auf dem Gerät ist ein Root erforderlich
abstract void	setOptions(TestDeviceOptions options) TestDeviceOptions für das Gerät festlegen
abstract boolean	setProperty(String propKey, String propValue) Legt den angegebenen Property-Wert auf dem Gerät fest.
abstract void	setRecovery(IDeviceRecovery recovery) Lege die IDeviceRecovery fest, die für dieses Gerät verwendet werden soll.
abstract void	setRecoveryMode(ITestDevice.RecoveryMode mode) Legen Sie den aktuellen Wiederherstellungsmodus für das Gerät fest.
abstract void	setUseFastbootErase(boolean useFastbootErase) Legen Sie fest, ob eine Partition auf dem Gerät mithilfe des Schnellstart-Löschens oder des Fastboot-Formats gelöscht werden soll.
abstract void	startLogcat() Starte die Aufzeichnung der Logcat-Ausgabe vom Gerät im Hintergrund.
abstract void	stopEmulatorOutput() Schließen und löschen Sie die Emulatorausgabe.
abstract void	stopLogcat() Erfassen der Logcat-Ausgabe vom Gerät beenden und aktuell gespeicherte Logcat-Daten verwerfen.
abstract String	switchToAdbTcp() Wechseln Sie auf dem Gerät in den ADB-over-tcp-Modus.
abstract boolean	switchToAdbUsb() Schalte das Gerät in den ADB-over-USB-Modus um.
abstract boolean	syncFiles(File localFileDir, String deviceFilePath) Der Inhalt eines lokalen Dateiverzeichnisses wird inkrementell mit dem Gerät synchronisiert.
abstract boolean	unlockDevice() Entsperrt das Gerät, wenn es verschlüsselt ist
abstract void	unmountDebugfs() Trennen Sie „debugfs“.
abstract boolean	waitForBootComplete(long timeOut) Blockiert, bis das Flag „Boot abgeschlossen“ des Geräts gesetzt wird.
abstract boolean	waitForDeviceAvailable() Wartet, bis das Gerät reagiert und zum Testen verfügbar ist.
abstract boolean	waitForDeviceAvailable(long waitTime) Wartet, bis das Gerät reagiert und zum Testen verfügbar ist.
abstract boolean	waitForDeviceAvailableInRecoverPath(long waitTime) Wartet, bis das Gerät responsiv und verfügbar ist, ohne den Wiederherstellungspfad zu berücksichtigen.
abstract void	waitForDeviceBootloader() Blockiert, bis das Gerät über Fastboot sichtbar ist.
abstract boolean	waitForDeviceInRecovery(long waitTime) Blöcke für das Gerät, die sich im Status „ADB-Wiederherstellung“ befinden. Beachten Sie, dass dies nicht mit IDeviceRecovery zu tun ist.
abstract boolean	waitForDeviceInSideload(long waitTime) Blöcke für das Gerät, die sich im Status „ADB-Sideload“ befinden
abstract boolean	waitForDeviceNotAvailable(long waitTime) Blockierungen für das Gerät, die nicht verfügbar sind, d. h. in ADB fehlen
abstract void	waitForDeviceOnline() Blockiert, bis das Gerät über ADB sichtbar ist.
abstract void	waitForDeviceOnline(long waitTime) Blockiert, bis das Gerät über ADB sichtbar ist.
abstract boolean	waitForDeviceShell(long waitTime) Wartet, bis das Gerät auf einen einfachen ADB-Shell-Befehl reagiert.

Konstanten

UNBEKANNTE_API_EBENE

public static final int UNKNOWN_API_LEVEL

Standardwert, wenn das API-Level nicht erkannt werden kann

Konstante Wert: -1 (0xffffffff)

Öffentliche Methoden

checkApiLevelAgainstNextRelease (API-LevelAgainstNextRelease)

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Prüfen Sie, ob eine Funktion derzeit mit einer minimal unterstützten Stufe unterstützt wird. Bei dieser Methode werden noch nicht veröffentlichte Funktionen berücksichtigt, bevor das API-Level erhöht wird.

Parameter
strictMinLevel	int: Die strikte Mindeststufe, die die Funktion unterstützt.

Returns
boolean	„True“, wenn das Level unterstützt wird. Andernfalls „false“.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

ClearLogcat

public abstract void clearLogcat ()

Löscht alle akkumulierten Logcat-Daten.

Das ist in Fällen nützlich, in denen ITestDevice#getLogcat() nur Logdaten zurückgibt, die nach einem bestimmten Zeitpunkt erstellt wurden (z. B. nach dem Flashen eines neuen Geräte-Builds).

Datei löschen

public abstract void deleteFile (String deviceFilePath)

Hilfsmethode zum Löschen einer Datei oder eines Verzeichnisses auf dem Gerät.

Parameter
deviceFilePath	String: Der absolute Pfad der Datei auf dem Gerät.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Datei löschen

public abstract void deleteFile (String deviceFilePath, 
                int userId)

Hilfsmethode zum Löschen einer Datei oder eines Verzeichnisses auf dem Gerät.

Parameter
deviceFilePath	String: Der absolute Pfad der Datei auf dem Gerät.
userId	int: Die Nutzer-ID, aus der gelöscht werden soll

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deviceSoftNeustart

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Hilfsmethode, um zu prüfen, ob das Gerät weich gestartet wurde. Dazu wird der aktuelle Systemserver mit dem vorherigen „system_server“ ProcessInfo verglichen. getProcessByName(String) verwenden, um ProcessInfo zu erhalten.

Parameter
prevSystemServerProcess	ProcessInfo: der vorherige Systemserver-Prozess ProcessInfo

Returns
boolean	true, wenn das Gerät vorläufig neu gestartet wurde

Ausgabe
RuntimeException	wenn das Gerät einen ungewöhnlichen Start hat
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deviceSoftneustart seit

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Hilfsmethode, um zu prüfen, ob das Gerät seit der UTC-Zeit seit der Epoche vom Gerät und seinem ERROR(/TimeUnit) vorläufig neu gestartet wurde. Ein vorläufiger Neustart bezieht sich auf den Neustart des Systemservers, der außerhalb eines harten Neustarts des Geräts neu gestartet wurde (z. B. angeforderter Neustart). Die aktuelle utcEpochTime des Geräts in Milliseccond kann mit der Methode getDeviceDate() abgerufen werden.

Parameter
utcEpochTime	long: die Gerätezeit in Sekunden seit der Epoche.
timeUnit	TimeUnit: die Zeiteinheit TimeUnit für die angegebene utcEpochTime.

Returns
boolean	true, wenn das Gerät vorläufig neu gestartet wurde

Ausgabe
RuntimeException	wenn das Gerät einen ungewöhnlichen Start hat
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deaktiviereAdbRoot

public abstract boolean disableAdbRoot ()

Deaktiviert den ADB-Root.

Das Deaktivieren der ADB-Root-Instanz kann dazu führen, dass das Gerät von ADB getrennt wird. Diese Methode wird blockiert, bis das Gerät verfügbar ist.

Returns
boolean	true, wenn der Vorgang erfolgreich war.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

tutFileExist

public abstract boolean doesFileExist (String deviceFilePath)

Hilfsmethode zum Ermitteln, ob eine Datei auf dem Gerät vorhanden ist.

Parameter
deviceFilePath	String: der absolute Pfad der zu prüfenden Datei auf dem Gerät

Returns
boolean	true, wenn die Datei vorhanden ist, andernfalls false.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

EnableAdbRoot

public abstract boolean enableAdbRoot ()

Aktiviert den ADB-Stamm. Wenn die Einstellung „enable-root“ auf „false“ gesetzt ist, wird eine Meldung protokolliert und ohne Root-Aktivierung zurückgegeben.

Wenn du den ADB-Root aktivierst, wird möglicherweise die Verbindung zwischen dem Gerät und ADB getrennt. Diese Methode wird blockiert, bis das Gerät verfügbar ist.

Returns
boolean	true, wenn der Vorgang erfolgreich war.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

Befehl ausführen

public abstract String executeAdbCommand (long timeout, 
                String... commandArgs)

Hilfsmethode, die einen adb-Befehl als Systembefehl mit einem bestimmten Zeitlimit ausführt.

Nach Möglichkeit sollte executeShellCommand(String) verwendet werden, da diese Methode eine bessere Fehlererkennung und Leistung bietet.

Parameter
timeout	long: die Zeit in Millisekunden, nach der das Gerät als nicht mehr reagiert; 0 L für kein Zeitlimit
commandArgs	String: der ADB-Befehl und die auszuführenden Argumente

Returns
String	den Befehl „stdout“. null, wenn der Befehl nicht ausgeführt werden konnte.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

Befehl ausführen

public abstract String executeAdbCommand (String... commandArgs)

Hilfsmethode, die einen adb-Befehl als Systembefehl ausführt.

Nach Möglichkeit sollte executeShellCommand(String) verwendet werden, da diese Methode eine bessere Fehlererkennung und Leistung bietet.

Parameter
commandArgs	String: der ADB-Befehl und die auszuführenden Argumente

Returns
String	den Befehl „stdout“. null, wenn der Befehl nicht ausgeführt werden konnte.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

Befehl ausführen

public abstract String executeAdbCommand (long timeout, 
                 envMap, 
                String... commandArgs)

Hilfsmethode, die einen adb-Befehl als Systembefehl mit einem bestimmten Zeitlimit ausführt.

Nach Möglichkeit sollte executeShellCommand(String) verwendet werden, da diese Methode eine bessere Fehlererkennung und Leistung bietet.

Parameter
timeout	long: die Zeit in Millisekunden, nach der das Gerät als nicht mehr reagiert; 0 L für kein Zeitlimit
envMap	ist die für den Befehl festzulegende Umgebung.
commandArgs	String: der ADB-Befehl und die auszuführenden Argumente

Returns
String	den Befehl „stdout“. null, wenn der Befehl nicht ausgeführt werden konnte.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

Schnellstart-Befehl ausführen

public abstract CommandResult executeFastbootCommand (long timeout, 
                String... commandArgs)

Hilfsmethode, die einen Fastboot-Befehl als Systembefehl ausführt.

Kann verwendet werden, wenn sich das Gerät bereits im Schnellstartmodus (Fastboot mode) befindet.

Parameter
timeout	long: die Zeit in Millisekunden, bevor der Befehl abläuft
commandArgs	String: der Fastboot-Befehl und die auszuführenden Argumente

Returns
CommandResult	das CommandResult-Element mit der Ausgabe des Befehls

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

Schnellstart-Befehl ausführen

public abstract CommandResult executeFastbootCommand (String... commandArgs)

Hilfsmethode, die einen Fastboot-Befehl als Systembefehl mit einem Standardzeitlimit von 2 Minuten ausführt.

Kann verwendet werden, wenn sich das Gerät bereits im Schnellstartmodus (Fastboot mode) befindet.

Parameter
commandArgs	String: der Fastboot-Befehl und die auszuführenden Argumente

Returns
CommandResult	das CommandResult-Element mit der Ausgabe des Befehls

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

LongFastbootCommand ausführen

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

Hilfsmethode, die einen lange laufenden Fastboot-Befehl als Systembefehl ausführt.

Identisch mit executeFastbootCommand(String), mit dem Unterschied, dass ein längeres Zeitlimit verwendet wird.

Parameter
commandArgs	String: der Fastboot-Befehl und die auszuführenden Argumente

Returns
CommandResult	das CommandResult-Element mit der Ausgabe des Befehls

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

LongFastbootCommand ausführen

public abstract CommandResult executeLongFastbootCommand ( envVarMap, 
                String... commandArgs)

Hilfsmethode, die einen lange laufenden Fastboot-Befehl als Systembefehl mit Systemumgebungsvariablen ausführt.

Identisch mit executeFastbootCommand(String), mit dem Unterschied, dass ein längeres Zeitlimit verwendet wird.

Parameter
envVarMap	: die Systemumgebungsvariablen, mit denen der fastboot-Befehl ausgeführt wird
commandArgs	String: der Fastboot-Befehl und die auszuführenden Argumente

Returns
CommandResult	das CommandResult-Element mit der Ausgabe des Befehls

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

AusführenShellCommand

public abstract String executeShellCommand (String command)

Hilfsmethode, die einen ADB-Shell-Befehl ausführt und die Ausgabe als String zurückgibt.

Parameter
command	String: der auszuführende ADB-Shell-Befehl

Returns
String	die Shell-Ausgabe

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

AusführenShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

Führt einen adb-Shell-Befehl mit mehr Parametern zur Steuerung des Befehlsverhaltens aus.

Parameter
command	String: der auszuführende ADB-Shell-Befehl
receiver	IShellOutputReceiver: IShellOutputReceiver, an den die Shell-Ausgabe weitergeleitet werden soll.
maxTimeToOutputShellResponse	long: die maximale Zeitspanne, während der der Befehl keine Antwort ausgeben darf; Einheit gemäß timeUnit
timeUnit	TimeUnit: Einheit für maxTimeToOutputShellResponse
retryAttempts	int: die maximale Anzahl der Wiederholungen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. DeviceNotResponsiveException wird geworfen, wenn retryAttempts erfolglos ausgeführt wird.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

Weitere Informationen:

• executeShellCommand(String, IShellOutputReceiver)
• TimeUtil

AusführenShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeoutForCommand, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

Führt einen adb-Shell-Befehl mit mehr Parametern zur Steuerung des Befehlsverhaltens aus.

Parameter
command	String: der auszuführende ADB-Shell-Befehl
receiver	IShellOutputReceiver: IShellOutputReceiver, an den die Shell-Ausgabe weitergeleitet werden soll.
maxTimeoutForCommand	long: das maximale Zeitlimit für die Ausführung des Befehls; die Einheit gemäß timeUnit.
maxTimeToOutputShellResponse	long: die maximale Zeitspanne, während der der Befehl keine Antwort ausgeben darf; Einheit gemäß timeUnit
timeUnit	TimeUnit: Einheit für maxTimeToOutputShellResponse
retryAttempts	int: die maximale Anzahl der Wiederholungen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. DeviceNotResponsiveException wird geworfen, wenn retryAttempts erfolglos ausgeführt wird.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

Weitere Informationen:

• executeShellCommand(String, IShellOutputReceiver)
• TimeUtil

AusführenShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Führt den angegebenen adb-Shell-Befehl aus und wiederholt einen mehrfachen Versuch, wenn der Befehl fehlschlägt.

Eine einfachere Form von executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) mit Standardwerten.

Parameter
command	String: der auszuführende ADB-Shell-Befehl
receiver	IShellOutputReceiver: IShellOutputReceiver, an den die Shell-Ausgabe weitergeleitet werden soll.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

AusführenShellV2Command

public abstract CommandResult executeShellV2Command (String command)

Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ergebnisse als CommandResult zurückgibt, die ordnungsgemäß mit der Ausgabe des Befehlsstatus (stdout und stderr) ausgefüllt ist.

Parameter
command	String: Der Befehl, der ausgeführt werden soll.

Returns
CommandResult	Das Ergebnis in CommandResult.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

AusführenShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

Hilfsmethode, die einen ADB-Shell-Befehl ausführt und die Ergebnisse als CommandResult zurückgibt, die korrekt mit der Befehlsausgabe und stderr. stdout ausgefüllt sind und an den angegebenen Stream weitergeleitet werden.

Parameter
command	String: Der Befehl, der ausgeführt werden soll.
pipeToOutput	OutputStream: ERROR(/OutputStream), an die die Standardausgabe weitergeleitet wird, oder null.

Returns
CommandResult	Das Ergebnis in CommandResult.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

AusführenShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

Hilfsmethode, die einen ADB-Shell-Befehl ausführt und die Ergebnisse als CommandResult zurückgibt, die ordnungsgemäß mit der Befehlsausgabeausgabe, stdout und stderr ausgefüllt ist.

Parameter
command	String: Der Befehl, der ausgeführt werden soll.
pipeAsInput	File: Ein ERROR(/File)-Wert, der als Eingabe für den Befehl verwendet wird, oder null.

Returns
CommandResult	Das Ergebnis in CommandResult.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

AusführenShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Führt einen adb-Shell-Befehl mit mehr Parametern zur Steuerung des Befehlsverhaltens aus.

Parameter
command	String: der auszuführende ADB-Shell-Befehl
maxTimeoutForCommand	long: das maximale Zeitlimit für die Ausführung des Befehls; die Einheit gemäß timeUnit.
timeUnit	TimeUnit: Einheit für maxTimeToOutputShellResponse
retryAttempts	int: die maximale Anzahl der Wiederholungen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. DeviceNotResponsiveException wird geworfen, wenn retryAttempts erfolglos ausgeführt wird.

Returns
CommandResult

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

Weitere Informationen:

• executeShellV2Command(String)
• TimeUtil

AusführenShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

Führt einen adb-Shell-Befehl mit mehr Parametern zur Steuerung des Befehlsverhaltens aus.

Parameter
command	String: der auszuführende ADB-Shell-Befehl
maxTimeoutForCommand	long: das maximale Zeitlimit für die Ausführung des Befehls; die Einheit gemäß timeUnit.
timeUnit	TimeUnit: Einheit für maxTimeToOutputShellResponse

Returns
CommandResult

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

Weitere Informationen:

• executeShellV2Command(String)
• TimeUtil

AusführenShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Führt einen adb-Shell-Befehl mit mehr Parametern zur Steuerung des Befehlsverhaltens aus.

Parameter
command	String: der auszuführende ADB-Shell-Befehl
pipeAsInput	File: Ein ERROR(/File)-Wert, der als Eingabe für den Befehl verwendet wird, oder null.
pipeToOutput	OutputStream: ERROR(/OutputStream), an die die Standardausgabe weitergeleitet wird, oder null.
maxTimeoutForCommand	long: das maximale Zeitlimit für die Ausführung des Befehls; die Einheit gemäß timeUnit.
timeUnit	TimeUnit: Einheit für maxTimeToOutputShellResponse
retryAttempts	int: die maximale Anzahl der Wiederholungen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. DeviceNotResponsiveException wird geworfen, wenn retryAttempts erfolglos ausgeführt wird.

Returns
CommandResult

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

Weitere Informationen:

• executeShellV2Command(String)
• TimeUtil

AusführenShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                OutputStream pipeToError, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Führt einen adb-Shell-Befehl mit mehr Parametern zur Steuerung des Befehlsverhaltens aus.

Parameter
command	String: der auszuführende ADB-Shell-Befehl
pipeAsInput	File: Ein ERROR(/File)-Wert, der als Eingabe für den Befehl verwendet wird, oder null.
pipeToOutput	OutputStream: ERROR(/OutputStream), an die die Standardausgabe weitergeleitet wird, oder null.
pipeToError	OutputStream: ERROR(/OutputStream), an die der Standardfehler weitergeleitet wird, oder null.
maxTimeoutForCommand	long: das maximale Zeitlimit für die Ausführung des Befehls; die Einheit gemäß timeUnit.
timeUnit	TimeUnit: Einheit für maxTimeToOutputShellResponse
retryAttempts	int: die maximale Anzahl der Wiederholungen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. DeviceNotResponsiveException wird geworfen, wenn retryAttempts erfolglos ausgeführt wird.

Returns
CommandResult

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

Weitere Informationen:

• executeShellV2Command(String)
• TimeUtil

FastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

Hilfsmethode zum Löschen einer Partition auf dem Gerät.

Wenn getUseFastbootErase() den Wert true hat, wird die Partition mit Fastboot-Löschungen gelöscht. Das Gerät muss beim nächsten Start ein Dateisystem erstellen. Andernfalls wird das Fastboot-Format verwendet, wodurch ein neues Dateisystem auf dem Gerät erstellt wird.

Kann verwendet werden, wenn sich das Gerät bereits im Schnellstartmodus (Fastboot mode) befindet.

Parameter
partition	String: die zu löschende Partition

Returns
CommandResult	das CommandResult-Element mit der Ausgabe des Befehls

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

getApiLevel

public abstract int getApiLevel ()

API-Level des Geräts abrufen Die Standardeinstellung ist UNKNOWN_API_LEVEL.

Returns
int	eine Ganzzahl, die das API-Level des Geräts angibt

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBasebandVersion

public abstract String getBasebandVersion ()

Praktische Methode zum Abrufen der Baseband- bzw. Funkversion dieses Geräts. Das Abrufen der Radioversion ist gerätespezifisch, sodass möglicherweise nicht für alle Geräte die richtigen Informationen zurückgegeben werden. Diese Methode benötigt die Eigenschaft „gsm.version.baseband“, um die richtigen Versionsinformationen zurückzugeben. Bei einigen CDMA-Geräten ist dies nicht korrekt und die hier zurückgegebene Version stimmt möglicherweise nicht mit der von Fastboot gemeldeten Version überein und gibt nicht die Version für das CDMA-Radio zurück. Zusammenfassung: Diese Methode gibt nur dann eine korrekte Version zurück, wenn das Attribut „gsm.version.baseband“ mit der von fastboot getvar version-baseband zurückgegebenen Version übereinstimmt.

Returns
String	die String-Baseband-Version oder null, wenn diese nicht ermittelt werden kann (Gerät hat keine Funkschnittstelle oder der Versionsstring kann nicht gelesen werden)

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

getAkku

public abstract Integer getBattery ()

Gibt den aktuellen Akkustand eines Geräts oder Null zurück, wenn der Akkustand nicht verfügbar ist.

Returns
Integer

getBoolescheProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

Gibt einen booleschen Wert der angegebenen Eigenschaft zurück.

Parameter
name	String: der Name der Property
defaultValue	boolean: Standardwert, der zurückgegeben wird, wenn das Attribut leer oder nicht vorhanden ist.

Returns
boolean	true, wenn das Attribut den Wert "1", "y", "yes", "on" oder "true" hat, false, wenn das Attribut den Wert "0", "n", "no", "off", "false" oder defaultValue hat.

Ausgabe
DeviceNotAvailableException

getBootVerlauf

public abstract  getBootHistory ()

Die Hilfsmethode erfasst die Boot-Verlaufszuordnung mit Startzeit und Startgrund.

Returns
	Karte der Bootzeit (UTC-Zeit in Sekunden seit Epoche) und des Bootgrunds

Ausgabe
DeviceNotAvailableException

getBootVerlaufSeit

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

Die Hilfsmethode erfasst die Bootverlaufszuordnung mit Bootzeit und Bootgrund seit der angegebenen Zeit seit der Epoche ab dem Gerät und der angegebenen Zeiteinheit. Die aktuelle utcEpochTime des Geräts in Millisekunden kann mit der Methode getDeviceDate() abgerufen werden.

Parameter
utcEpochTime	long: die Gerätezeit seit Epoche.
timeUnit	TimeUnit: die Zeiteinheit TimeUnit.

Returns
	Karte der Bootzeit (UTC-Zeit in Sekunden seit Epoche) und des Bootgrunds

Ausgabe
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

Praktische Methode zum Abrufen der Bootloader-Version dieses Geräts.

Es wird versucht, die Bootloader-Version aus dem aktuellen Gerätezustand abzurufen. (d. h., wenn sich das Gerät im Fastboot-Modus befindet, versucht es, die Version über Fastboot abzurufen)

Returns
String	die Bootloader-Version String oder null, wenn sie nicht gefunden werden kann

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

getBuildAlias

public abstract String getBuildAlias ()

Rufen Sie den Alias des Builds ab, den das Gerät derzeit ausführt.

Der Build-Alias ist in der Regel eine lesbarere Zeichenfolge als die Build-ID (in der Regel eine Nummer für Nexus-Builds). Die endgültige Android-Version 4.2 hat beispielsweise den Build-Alias JDQ39 und die Build-ID 573038.

Returns
String	Den Build-Alias oder Fallback auf die Build-ID, wenn diese nicht abgerufen werden konnte

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

GetBuildFlavor

public abstract String getBuildFlavor ()

Rufen Sie den Build-Flavor für das Gerät ab.

Returns
String	Den Build-Flavor oder null, wenn er nicht abgerufen werden konnte.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildId

public abstract String getBuildId ()

Rufen Sie den Build ab, den das Gerät derzeit ausführt.

Returns
String	Die Build-ID oder IBuildInfo#UNKNOWN_BUILD_ID, falls sie nicht abgerufen werden konnte

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

Gibt den Schlüsseltyp zurück, der zum Signieren des Geräte-Images verwendet wurde

Android-Geräte können in der Regel mit Testschlüsseln (wie in AOSP) oder Release-Schlüsseln (von den einzelnen Geräteherstellern kontrolliert) signiert sein.

Returns
String	Signaturschlüssel, falls gefunden, andernfalls null.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

Gibt ein im Cache gespeichertes DeviceDescriptor zurück, wenn das Gerät zugewiesen ist. Andernfalls wird der aktuelle DeviceDescriptor zurückgegeben.

Returns
DeviceDescriptor

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Gibt ein im Cache gespeichertes DeviceDescriptor zurück, wenn das Gerät zugewiesen ist. Andernfalls wird der aktuelle DeviceDescriptor zurückgegeben.

Parameter
shortDescriptor	boolean: Gibt an, ob der Deskriptor auf das Minimum der Informationen beschränkt werden soll

Returns
DeviceDescriptor

getChildren

public abstract String[] getChildren (String deviceFilePath)

Eine Alternative zur Verwendung von IFileEntry, die aufgrund von Berechtigungen manchmal nicht funktioniert.

Parameter
deviceFilePath	String: Pfad auf dem Gerät, in dem die Suche ausgeführt werden soll

Returns
String[]	String-Array, das die gesamte Datei in einem Pfad auf dem Gerät enthält

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getConnection

public abstract AbstractConnection getConnection ()

Gibt die Verbindung zurück, die dem Gerät zugeordnet ist.

Returns
AbstractConnection

getDeviceClass

public abstract String getDeviceClass ()

Rufen Sie die Geräteklasse ab.

Returns
String	Geräteklasse String.

getDeviceDate

public abstract long getDeviceDate ()

Gibt das Datum des Geräts in Millisekunden seit der Epoche zurück.

Returns
long	Das Datum des Geräts im Epochenformat.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getDeviceDescriptor,

public abstract DeviceDescriptor getDeviceDescriptor ()

Gib ein DeviceDescriptor aus den Geräteinformationen zurück, um Informationen zu erhalten, ohne das tatsächliche Geräteobjekt zu übergeben.

Returns
DeviceDescriptor

getDeviceDescriptor,

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Gib ein DeviceDescriptor aus den Geräteinformationen zurück, um Informationen zu erhalten, ohne das tatsächliche Geräteobjekt zu übergeben.

Parameter
shortDescriptor	boolean: Gibt an, ob der Deskriptor auf das Minimum der Informationen beschränkt werden soll

Returns
DeviceDescriptor

getDeviceState

public abstract TestDeviceState getDeviceState ()

Rufen Sie den Status des Geräts ab.

Returns
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

Hilfsfunktion, um den Zeitunterschied zwischen dem Gerät und einem bestimmten ERROR(/Date) zu ermitteln. Verwenden Sie die Epochenzeit intern.

Parameter
date	Date

Returns
long	Differenz in Millisekunden

Ausgabe
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

Stream für Emulatoren stdout und stderr abrufen

Returns
InputStreamSource	Emulatorausgabe

GetExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

Hilfsmethode zum Ermitteln der Menge an freiem Speicherplatz im externen Gerätespeicher.

Returns
long	die Menge an freiem Speicherplatz in KB

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

getFastbootProductType (GetFastbootProductType)

public abstract String getFastbootProductType ()

Praktische Methode zum Abrufen des Produkttyps dieses Geräts, wenn es sich im Schnellstartmodus (Fastboot mode) befindet.

Diese Methode sollte nur verwendet werden, wenn das Gerät im Schnellstartmodus (Fastboot mode) aktiviert sein soll. Dies ist eine etwas sicherere Variante als die generische getProductType()-Methode in diesem Fall, da ITestDevice weiß, dass das Gerät in den Fastboot-Modus wiederhergestellt werden kann, wenn sich das Gerät im falschen Zustand befindet oder nicht reagiert.

Returns
String	den Namen des Produkttyps „String“ oder „null“, wenn er nicht ermittelt werden kann

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

GetFastbootProductVariant

public abstract String getFastbootProductVariant ()

Praktische Methode zum Abrufen des Produkttyps dieses Geräts, wenn es sich im Schnellstartmodus (Fastboot mode) befindet.

Diese Methode sollte nur verwendet werden, wenn das Gerät im Schnellstartmodus (Fastboot mode) aktiviert sein soll. Dies ist eine etwas sicherere Variante als die generische getProductType()-Methode in diesem Fall, da ITestDevice weiß, dass das Gerät in den Fastboot-Modus wiederhergestellt werden kann, wenn sich das Gerät im falschen Zustand befindet oder nicht reagiert.

Returns
String	den Namen des Produkttyps „String“ oder „null“, wenn er nicht ermittelt werden kann

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

getFastbootSerialNumber (GetFastbootSerialNumber)

public abstract String getFastbootSerialNumber ()

Gibt die Seriennummer des Fastboot-Modus zurück.

Returns
String

GetFastbootVariable

public abstract String getFastbootVariable (String variableName)

Rufen Sie den angegebenen Wert der Fastboot-Variable vom Gerät ab.

Parameter
variableName	String: der Variablenname

Returns
String	den Attributwert oder null, falls nicht vorhanden

Ausgabe
	supportedOperationException
DeviceNotAvailableException

getFileEntry

public abstract IFileEntry getFileEntry (String path)

Rufen Sie einen Verweis auf eine Remote-Datei auf dem Gerät ab.

Parameter
path	String: der abzurufende Dateipfad. Kann ein absoluter Pfad oder Pfad relativ zu „/“ sein (d. h., sowohl die Syntax „/system“ als auch „system“ wird unterstützt)

Returns
IFileEntry	IFileEntry oder null, wenn die Datei unter der angegebenen path nicht gefunden werden kann

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIDevice

public abstract IDevice getIDevice ()

Gibt einen Verweis auf die verknüpfte ddmlib-IDevice zurück.

Jedes Mal, wenn das Gerät die Verbindung zu ADB trennt und wieder eine Verbindung herstellt, kann von DDMS eine neue IDevice zugewiesen werden. Aufrufer sollten daher keinen Verweis auf IDevice beibehalten, da dieser Verweis möglicherweise veraltet ist.

Returns
IDevice	IDevice

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

Gibt einen ganzzahligen Wert der angegebenen Eigenschaft vom Gerät zurück.

Parameter
name	String: der Name der Property
defaultValue	long: Standardwert, der zurückgegeben wird, wenn das Attribut leer oder nicht vorhanden ist.

Returns
long	Den Attributwert oder defaultValue, wenn das Attribut leer ist, nicht vorhanden ist oder keinen ganzzahligen Wert hat

Ausgabe
DeviceNotAvailableException

getLastErwarteteNeustartzeitMillis

public abstract long getLastExpectedRebootTimeMillis ()

Gibt in Millisekunden zurück, wann die Tradefed APIs zuletzt einen Neustart ausgelöst haben, seit EPOCH von System.currentTimeMillis() zurückgegeben wurde.

Returns
long

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

Das erste API-Level des Geräts abrufen. Die Standardeinstellung ist UNKNOWN_API_LEVEL.

Returns
int	Eine Ganzzahl, die das erste gestartete API-Level des Geräts angibt

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getLogcat

public abstract InputStreamSource getLogcat ()

Erfasst einen Snapshot-Stream der Logcat-Daten.

Funktioniert in zwei Modi:

Wenn der Logcat derzeit im Hintergrund erfasst wird, werden bis zu TestDeviceOptions.getMaxLogcatDataSize() Byte des aktuellen Inhalts der Hintergrund-Logcat-Erfassung zurückgegeben.

Andernfalls wird ein statischer Dump der Logcat-Daten zurückgegeben, wenn das Gerät gerade antwortet

Returns
InputStreamSource

getLogcat

public abstract InputStreamSource getLogcat (int maxBytes)

Erfasst einen Snapshot-Stream der letzten maxBytes der erfassten Logcat-Daten.

Dies ist nützlich, wenn Sie häufige Snapshots der erfassten Logcat-Daten erfassen möchten, ohne dass durch das Abrufen des gesamten getLogcat()-Snapshots die Speicherplatzstrafe erhöht wird.

Parameter
maxBytes	int: Die maximale Datenmenge, die zurückgegeben werden soll. Sollte ein Betrag sein, der bequem in den Arbeitsspeicher passt

Returns
InputStreamSource

getLogcatDump

public abstract InputStreamSource getLogcatDump ()

Dump des aktuellen Logcats für das Gerät abrufen Im Gegensatz zu getLogcat() gibt diese Methode immer einen statischen Dump des Logcats zurück.

Hat den Nachteil, dass nichts zurückgegeben wird, wenn das Gerät nicht erreichbar ist.

Returns
InputStreamSource	Eine InputStreamSource der Logcat-Daten. Wenn die Logcat-Daten nicht erfasst werden können, wird ein leerer Stream zurückgegeben.

getLogcatDa

public abstract InputStreamSource getLogcatSince (long date)

Erfasst einen Snapshot-Stream erfasster Logcat-Daten ab dem angegebenen Datum. Die Uhrzeit auf dem Gerät sollte in getDeviceDate() verwendet werden.

Parameter
date	long: in Millisekunden seit dem Epochenformat für den Start des Snapshots bis zum aktuellen Zeitpunkt. (kann über 'Datum +%s' abgerufen werden)

Returns
InputStreamSource

MountPoint abrufen

public abstract String getMountPoint (String mountName)

Gibt einen Bereitstellungspunkt zurück.

Fragt das Gerät direkt ab, wenn die im Cache gespeicherten Informationen in IDevice nicht verfügbar sind.

AUFGABE: Dieses Verhalten auf IDevice#getMountPoint(String) verschieben

Parameter
mountName	String: der Name des Bereitstellungspunkts

Returns
String	den Bereitstellungspunkt oder null

Weitere Informationen:

• IDevice.getMountPoint(String)

MountPointInfo abrufen

public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

Gibt ein MountPointInfo zurück, das dem angegebenen Bereitstellungspunktpfad entspricht, oder null, wenn in diesem Pfad nichts bereitgestellt ist oder anderweitig nicht in /proc/mounts als Bereitstellungspunkt angezeigt wird.

Parameter
mountpoint	String

Returns
ITestDevice.MountPointInfo	Ein ERROR(/List) von MountPointInfo mit den Informationen in „/proc/mounts“

Ausgabe
DeviceNotAvailableException

Weitere Informationen:

• getMountPointInfo()

MountPointInfo abrufen

public abstract  getMountPointInfo ()

Gibt eine geparste Version der Informationen in /proc/mounts auf dem Gerät zurück

Returns
	Ein ERROR(/List) von MountPointInfo mit den Informationen in „/proc/mounts“

Ausgabe
DeviceNotAvailableException

getPartitionFreeSpace

public abstract long getPartitionFreeSpace (String partition)

Hilfsmethode zum Ermitteln der Menge an freiem Speicherplatz auf der Gerätepartition.

Parameter
partition	String

Returns
long	die Menge an freiem Speicherplatz in KB

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

getProcessByName

public abstract ProcessInfo getProcessByName (String processName)

Die Hilfsmethode führt die Befehle "pidof" und "stat" aus und gibt das Objekt ProcessInfo mit PID und Prozessstartzeit des angegebenen Prozesses zurück.

Parameter
processName	String: der String des Vorgangsnamens.

Returns
ProcessInfo	ProcessInfo zu angegebenem processName

Ausgabe
DeviceNotAvailableException

getProcessPid

public abstract String getProcessPid (String process)

Gibt die PID des Dienstes oder null zurück, wenn ein Fehler aufgetreten ist.

Parameter
process	String: Der String des Vorgangsnamens.

Returns
String

Ausgabe
DeviceNotAvailableException

GetProductType

public abstract String getProductType ()

Praktische Methode zum Abrufen des Produkttyps dieses Geräts.

Diese Methode funktioniert, wenn sich das Gerät entweder im ADB- oder im Schnellstartmodus (Fastboot mode) befindet.

Returns
String	den Namen des Produkttyps String. Ist nicht null

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden oder der Produkttyp kann nicht ermittelt werden.

GetProductVariant

public abstract String getProductVariant ()

Praktische Methode zum Abrufen der Produktvariante dieses Geräts.

Diese Methode funktioniert, wenn sich das Gerät entweder im ADB- oder im Schnellstartmodus (Fastboot mode) befindet.

Returns
String	den String-Namen der Produktvariante oder null, wenn er nicht ermittelt werden kann

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

getProperty

public abstract String getProperty (String name)

Ruft den angegebenen Attributwert vom Gerät ab.

Parameter
name	String: der Name der Property

Returns
String	den Attributwert oder null, falls nicht vorhanden

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getRecoveryMode

public abstract ITestDevice.RecoveryMode getRecoveryMode ()

Rufen Sie den aktuellen Wiederherstellungsmodus des Geräts ab.

Returns
ITestDevice.RecoveryMode	den aktuellen Wiederherstellungsmodus des Geräts.

getSerialNumber

public abstract String getSerialNumber ()

Eine praktische Methode zum Abrufen der Seriennummer dieses Geräts.

Returns
String	die String-Seriennummer

Tombstones abrufen

public abstract  getTombstones ()

Die Liste der Tombstones von den Geräten abrufen und zurückgeben. Erfordert Root.

ist Best-Effort-Methode. Wenn ein Tombstone aus irgendeinem Grund nicht abgerufen werden kann, fehlt er in der Liste. Nur DeviceNotAvailableException beendet die Methode vorzeitig.

Returns
	Eine Liste von Tombstone-Dateien, leer, wenn keine Tombstone-Dateien vorhanden sind.

Ausgabe
DeviceNotAvailableException

Weitere Informationen:

• Tombstones-Dokumentation

getTotalMemory

public abstract long getTotalMemory ()

Gibt die Gesamtgröße des physischen Arbeitsspeichers in Byte oder -1 bei einem internen Fehler zurück.

Returns
long

getUseFastbootDELETE

public abstract boolean getUseFastbootErase ()

Legen Sie fest, ob eine Partition auf dem Gerät mit der Funktion „Fastboot Deletion“ oder „Fastboot“ gelöscht werden soll.

Returns
boolean	true, wenn die Daten über Fastboot gelöscht werden, oder false, wenn das Schnellstart-Format verwendet wird.

Weitere Informationen:

• fastbootWipePartition(String)

isAdbRoot

public abstract boolean isAdbRoot ()

Returns
boolean	true, wenn das Gerät derzeit den ADB-Root hat, andernfalls false.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

isAdbTcp

public abstract boolean isAdbTcp ()

Returns
boolean	true, wenn das Gerät mit ADB-over-tcp verbunden ist, andernfalls false.

isAppEnumerationSupported

public abstract boolean isAppEnumerationSupported ()

Prüfen, ob die Plattform auf dem Gerät die Auflistung von Apps unterstützt

Returns
boolean	„True“, wenn die App-Enumeration unterstützt wird, andernfalls „False“

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isBypassLowTargetSdkBlockSupported (IsBypassLowTargetSdkBlockSupported)

public abstract boolean isBypassLowTargetSdkBlockSupported ()

Prüfen, ob die Plattform auf dem Gerät das Umgehen eines niedrigen SDK-Zielblocks bei App-Installationen unterstützt

Returns
boolean	„True“, wenn das Umgehen einer niedrigen SDK-Blockierung unterstützt wird, andernfalls „False“

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isDebugfsMounted

public abstract boolean isDebugfsMounted ()

Prüfen Sie, ob debugfs bereitgestellt ist.

Returns
boolean	true, wenn debugfs bereitgestellt ist

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

IsDeviceEncrypted

public abstract boolean isDeviceEncrypted ()

Gibt an, ob das Gerät verschlüsselt ist.

Returns
boolean	true, wenn das Gerät verschlüsselt ist.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

isDirectory

public abstract boolean isDirectory (String deviceFilePath)

Gibt „True“ zurück, wenn der Pfad auf dem Gerät ein Verzeichnis ist, andernfalls „false“.

Parameter
deviceFilePath	String

Returns
boolean

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isEncryptionSupported

public abstract boolean isEncryptionSupported ()

Gibt zurück, wenn die Verschlüsselung auf dem Gerät unterstützt wird.

Returns
boolean	true, wenn das Gerät Verschlüsselung unterstützt.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isExecutable (Kann ausgeführt werden)

public abstract boolean isExecutable (String fullPath)

Gibt "True" zurück, wenn der Dateipfad auf dem Gerät eine ausführbare Datei ist, andernfalls "False".

Parameter
fullPath	String

Returns
boolean

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

ist monitorlos

public abstract boolean isHeadless ()

Gibt „true“ zurück, wenn das Gerät monitorlos ist (kein Bildschirm), andernfalls „false“.

Returns
boolean

Ausgabe
DeviceNotAvailableException

isRuntimePermissionSupported

public abstract boolean isRuntimePermissionSupported ()

Prüfen, ob die Plattform auf dem Gerät die Gewährung von Laufzeitberechtigungen unterstützt

Returns
boolean	„True“, wenn Laufzeitberechtigungen unterstützt werden, andernfalls „False“.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isStateBootloaderOrFastbootd

public abstract boolean isStateBootloaderOrFastbootd ()

Gibt „true“ zurück, wenn sich das Gerät in TestDeviceState#FASTBOOT oder TestDeviceState.FASTBOOTD befindet.

Returns
boolean

Loganr

public abstract boolean logAnrs (ITestLogger logger)

Erfasst und protokolliert ANR-Fehler vom Gerät.

Parameter
logger	ITestLogger: Ein ITestLogger zum Protokollieren der ANR-Fehler.

Returns
boolean	Der Wert ist "True", wenn das Logging erfolgreich war, andernfalls "False".

Ausgabe
DeviceNotAvailableException

LogOnDevice

public abstract void logOnDevice (String tag, 
                Log.LogLevel level, 
                String format, 
                Object... args)

Protokolliert eine Nachricht im Logcat des Geräts. Dies ist ein sicherer Aufruf, der auch dann nicht ausgelöst wird, wenn das Logging fehlschlägt.

Parameter
tag	String: Das Tag, unter dem wir die Nachricht im Logcat protokollieren.
level	Log.LogLevel: Die Debug-Ebene der Nachricht im Logcat.
format	String: Das Nachrichtenformat.
args	Object: die Argumente, die durch String.format() ersetzt werden sollen.

mountDebugfs

public abstract void mountDebugfs ()

Stellen Sie debugfs bereit.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Neustart ohne Blockierung

public abstract void nonBlockingReboot ()

Gibt einen Befehl zum Neustart des Geräts aus und wird zurückgegeben, wenn der Befehl abgeschlossen ist und das Gerät für ADB nicht mehr sichtbar ist.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

PostBoot-Einrichtung

public abstract void postBootSetup ()

Führen Sie die Anweisungen aus, um das Gerät nach jedem Start so zu konfigurieren, dass es getestet wird.

Sollte aufgerufen werden, nachdem das Gerät vollständig gestartet/verfügbar ist

Unter normalen Umständen muss diese Methode nicht explizit aufgerufen werden, da Implementierungen diese Schritte beim Neustart automatisch ausführen sollten.

Er muss möglicherweise aufgerufen werden, wenn das Gerät aufgrund anderer Ereignisse neu startet (z. B. wenn ein fastboot-Updatebefehl abgeschlossen wurde).

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

postInvocationTearDown

public void postInvocationTearDown ()

Diese Methode wurde verworfen.
Verwenden Sie stattdessen postInvocationTearDown(Throwable).

Zusätzliche Schritte für die gerätespezifische erforderliche Bereinigung, die nach dem Aufruf ausgeführt wird.

postInvocationTearDown

public abstract void postInvocationTearDown (Throwable invocationException)

Zusätzliche Schritte für die gerätespezifische erforderliche Bereinigung, die nach dem Aufruf ausgeführt wird.

Parameter
invocationException	Throwable: falls vorhanden, die letzte durch den Aufruffehler ausgelöste Ausnahme.

preInvocationSetup

public void preInvocationSetup (IBuildInfo info, 
                MultiMap<String, String> attributes)

Zusätzliche Schritte für die gerätespezifische erforderliche Einrichtung, die vor dem Aufruffluss auf dem Gerät ausgeführt werden.

Parameter
info	IBuildInfo: Die IBuildInfo des Geräts.
attributes	MultiMap: die im Aufrufkontext gespeicherten Attribute

Ausgabe
	com.android.tradefed.targetprep.TargetSetupError
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException
TargetSetupError

PullDir

public abstract boolean pullDir (String deviceFilePath, 
                File localDir)

Verzeichnisinhalte rekursiv vom Gerät abrufen.

Parameter
deviceFilePath	String: der absolute Dateipfad der Remote-Quelle
localDir	File: das lokale Verzeichnis, in das Dateien abgerufen werden sollen

Returns
boolean	true, wenn die Datei abgerufen wurde. Andernfalls false.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

PullDir

public abstract boolean pullDir (String deviceFilePath, 
                File localDir, 
                int userId)

Verzeichnisinhalte rekursiv vom Gerät abrufen.

Parameter
deviceFilePath	String: der absolute Dateipfad der Remote-Quelle
localDir	File: das lokale Verzeichnis, in das Dateien abgerufen werden sollen
userId	int: die Nutzer-ID, aus der abgerufen werden soll

Returns
boolean	true, wenn die Datei abgerufen wurde. Andernfalls false.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

Pull-Datei

public abstract File pullFile (String remoteFilePath, 
                int userId)

Ruft eine Datei vom Gerät ab, speichert sie in einer lokalen temporären ERROR(/File) und gibt diese File zurück.

Parameter
remoteFilePath	String: der absolute Pfad zur Datei auf dem Gerät.
userId	int: Die Nutzer-ID, aus der abgerufen werden soll

Returns
File	Ein ERROR(/File) mit dem Inhalt der Gerätedatei oder null, wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (einschließlich Problemen mit dem Hostdateisystem)

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

Pull-Datei

public abstract File pullFile (String remoteFilePath)

Ruft eine Datei vom Gerät ab, speichert sie in einer lokalen temporären ERROR(/File) und gibt diese File zurück.

Parameter
remoteFilePath	String: der absolute Pfad zur Datei auf dem Gerät.

Returns
File	Ein ERROR(/File) mit dem Inhalt der Gerätedatei oder null, wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (einschließlich Problemen mit dem Hostdateisystem)

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

Pull-Datei

public abstract boolean pullFile (String remoteFilePath, 
                File localFile)

Ruft eine Datei vom Gerät ab.

Parameter
remoteFilePath	String: der absolute Pfad zur Datei auf dem Gerät.
localFile	File: Die lokale Datei, in der Inhalte gespeichert werden sollen. Wenn das Feld nicht leer ist, werden Inhalte ersetzt.

Returns
boolean	true, wenn die Datei abgerufen wurde. Andernfalls false.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

Pull-Datei

public abstract boolean pullFile (String remoteFilePath, 
                File localFile, 
                int userId)

Ruft eine Datei vom Gerät ab.

Parameter
remoteFilePath	String: der absolute Pfad zur Datei auf dem Gerät.
localFile	File: Die lokale Datei, in der Inhalte gespeichert werden sollen. Wenn das Feld nicht leer ist, werden Inhalte ersetzt.
userId	int: Die Nutzer-ID, aus der abgerufen werden soll

Returns
boolean	true, wenn die Datei abgerufen wurde. Andernfalls false.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

PullFileContents

public abstract String pullFileContents (String remoteFilePath)

Ruft eine Datei vom Gerät ab und gibt den Inhalt zurück.

Parameter
remoteFilePath	String: der absolute Pfad zur Datei auf dem Gerät.

Returns
String	Ein String mit dem Inhalt der Gerätedatei oder null, wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (einschließlich Problemen mit dem Hostdateisystem)

Ausgabe
DeviceNotAvailableException

PullFileFromExternal

public abstract File pullFileFromExternal (String remoteFilePath)

Eine praktische Methode, um eine Datei aus dem externen Speicher des Geräts abzurufen, sie in einer lokalen temporären ERROR(/File) zu speichern und einen Verweis auf diese File zurückzugeben.

Parameter
remoteFilePath	String: Pfad zur Datei auf dem Gerät, relativ zum Bereitstellungspunkt des externen Speichers

Returns
File	Ein ERROR(/File) mit dem Inhalt der Gerätedatei oder null, wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (einschließlich Problemen mit dem Hostdateisystem)

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

PushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath, 
                int userId)

Verzeichnisinhalte rekursiv auf das Gerät übertragen.

Parameter
localDir	File: das lokale Verzeichnis, das übertragen werden soll
deviceFilePath	String: der absolute Dateipfad des Remote-Ziels
userId	int: die Nutzer-ID, an die übertragen werden soll

Returns
boolean	true, wenn die Datei übertragen wurde. Andernfalls false.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

PushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath, 
                 excludedDirectories)

Verzeichnisinhalte werden rekursiv auf das Gerät übertragen und gleichzeitig einige gefilterte Verzeichnisse ausgeschlossen.

Parameter
localDir	File: das lokale Verzeichnis, das übertragen werden soll
deviceFilePath	String: der absolute Dateipfad des Remote-Ziels
excludedDirectories	: Satz ausgeschlossener Verzeichnisnamen, die nicht übertragen werden sollen.

Returns
boolean	true, wenn die Datei übertragen wurde. Andernfalls false.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

PushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath)

Verzeichnisinhalte rekursiv auf das Gerät übertragen.

Parameter
localDir	File: das lokale Verzeichnis, das übertragen werden soll
deviceFilePath	String: der absolute Dateipfad des Remote-Ziels

Returns
boolean	true, wenn die Datei übertragen wurde. Andernfalls false.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

Push-Datei

public abstract boolean pushFile (File localFile, 
                String deviceFilePath, 
                boolean evaluateContentProviderNeeded)

Variante von pushFile(File, String), die optional den Bedarf an den Contentanbieter prüfen kann

Parameter
localFile	File: die lokale Datei, die übertragen werden soll
deviceFilePath	String: der absolute Dateipfad des Remote-Ziels
evaluateContentProviderNeeded	boolean: ob geprüft werden soll, ob der Contentanbieter benötigt wird

Returns
boolean	true, wenn die Datei übertragen wurde. Andernfalls false.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

Push-Datei

public abstract boolean pushFile (File localFile, 
                String deviceFilePath)

Übertragen Sie eine Datei per Push auf das Gerät. Standardmäßig wird ein Contentanbieter verwendet.

Parameter
localFile	File: die lokale Datei, die übertragen werden soll
deviceFilePath	String: der absolute Dateipfad des Remote-Ziels

Returns
boolean	true, wenn die Datei übertragen wurde. Andernfalls false.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

Push-Datei

public abstract boolean pushFile (File localFile, 
                String deviceFilePath, 
                int userId)

Übertragen Sie eine Datei per Push auf das Gerät. Standardmäßig wird ein Contentanbieter verwendet.

Parameter
localFile	File: die lokale Datei, die übertragen werden soll
deviceFilePath	String: der absolute Dateipfad des Remote-Ziels
userId	int: die Nutzer-ID, an die übertragen werden soll

Returns
boolean	true, wenn die Datei übertragen wurde. Andernfalls false.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

Push-String

public abstract boolean pushString (String contents, 
                String deviceFilePath)

Aus einem String erstellte Datei per Push an Gerät übertragen

Parameter
contents	String: der Inhalt der zu übertragenden Datei
deviceFilePath	String: der absolute Dateipfad des Remote-Ziels

Returns
boolean	true, wenn der String erfolgreich übertragen wurde. Andernfalls false.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

neu starten

public abstract void reboot ()

Startet das Gerät im ADB-Modus neu.

Wird blockiert, bis das Gerät verfügbar ist.

Ausgabe
DeviceNotAvailableException	Gerät nach Neustart nicht verfügbar

neu starten

public abstract void reboot (String reason)

Startet das Gerät im ADB-Modus neu, wobei die angegebenen reason bei jedem Neustart beibehalten werden.

Wird blockiert, bis das Gerät verfügbar ist.

Der Grund für den letzten Neustart kann durch Abfrage der sys.boot.reason-Eigenschaft abgerufen werden.

Parameter
reason	String: ein Grund für diesen Neustart oder null, wenn kein Grund angegeben ist.

Ausgabe
DeviceNotAvailableException	Gerät nach Neustart nicht verfügbar

NeustartIntoBootloader

public abstract void rebootIntoBootloader ()

Startet das Gerät im Bootloader-Modus neu.

Wird blockiert, bis sich das Gerät im Bootloader-Modus befindet.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

NeustartIntoFastbootd

public abstract void rebootIntoFastbootd ()

Startet das Gerät im Fastbootd-Modus neu.

Blockiert, bis sich das Gerät im Fastbootd-Modus befindet.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

NeustartIntoRecovery

public abstract void rebootIntoRecovery ()

Das Gerät wird im ADB-Wiederherstellungsmodus neu gestartet.

Blockiert, bis das Gerät mit der Wiederherstellung beginnt

Ausgabe
DeviceNotAvailableException	Gerät nach Neustart nicht verfügbar

NeustartIntoSideload

public abstract void rebootIntoSideload (boolean autoReboot)

Startet das Gerät im ADB-Sideload-Modus neu. Beachten Sie, dass dies ein spezieller Modus für die Wiederherstellung ist.

Wird blockiert, bis das Gerät in den Sideload-Modus wechselt

Parameter
autoReboot	boolean: ob das Gerät nach dem Sideload automatisch neu gestartet werden soll

Ausgabe
DeviceNotAvailableException	Gerät ist nach Neustart nicht im Sideload

NeustartIntoSideload

public abstract void rebootIntoSideload ()

Startet das Gerät im ADB-Sideload-Modus neu. Beachten Sie, dass dies ein spezieller Modus für die Wiederherstellung ist.

Wird blockiert, bis das Gerät in den Sideload-Modus wechselt

Ausgabe
DeviceNotAvailableException	Gerät ist nach Neustart nicht im Sideload

NeustartUntilOnline

public abstract void rebootUntilOnline ()

Eine Alternative zu reboot(), die nur blockiert, bis das Gerät online ist, d. h. für ADB.

Ausgabe
DeviceNotAvailableException	Gerät nach Neustart nicht verfügbar

NeustartUntilOnline

public abstract void rebootUntilOnline (String reason)

Eine Alternative zu reboot(), die nur blockiert, bis das Gerät online ist, d. h. für ADB.

Parameter
reason	String: ein Grund für diesen Neustart oder null, wenn kein Grund angegeben ist.

Ausgabe
DeviceNotAvailableException	Gerät nach Neustart nicht verfügbar

Weitere Informationen:

• reboot(String)

Nutzerbereich neu starten

public abstract void rebootUserspace ()

Startet nur den Userspace-Teil des Geräts neu.

Wird blockiert, bis das Gerät verfügbar ist.

WARNUNG. Der Neustart des Userspaces wird derzeit aktiv entwickelt. Sie können ihn auf eigenes Risiko verwenden.

Ausgabe
DeviceNotAvailableException	Gerät nach Neustart nicht verfügbar

NeustartUserspaceUntilOnline

public abstract void rebootUserspaceUntilOnline ()

Eine Alternative zu rebootUserspace() ()}, die nur blockiert, bis das Gerät online ist, d. h. für ADB.

Ausgabe
DeviceNotAvailableException	Gerät nach Neustart nicht verfügbar

remountSystemReadOnly

public abstract void remountSystemReadOnly ()

Machen Sie die Systempartition auf dem Gerät schreibgeschützt. Gerät kann neu gestartet werden.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

remountSystemWritable

public abstract void remountSystemWritable ()

Machen Sie die Systempartition auf dem Gerät beschreibbar. Gerät kann neu gestartet werden.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

remountVendorReadOnly

public abstract void remountVendorReadOnly ()

Machen Sie die Anbieterpartition auf dem Gerät schreibgeschützt. Gerät kann neu gestartet werden.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

remountVendorWritable (remountVendorWritable)

public abstract void remountVendorWritable ()

Machen Sie die Anbieterpartition auf dem Gerät beschreibbar. Gerät kann neu gestartet werden.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

runInstrumentationTests

public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                ITestLifeCycleReceiver... listeners)

Praktische Methode zur Ausführung von ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) mit einem oder mehreren Listenern, die als Parameter übergeben werden.

Parameter
runner	IRemoteAndroidTestRunner: die IRemoteAndroidTestRunner, die die Tests ausführt
listeners	ITestLifeCycleReceiver: die Testergebnis-Listener

Returns
boolean	true, wenn der Testbefehl abgeschlossen ist. false, wenn der Vorgang nicht abgeschlossen werden konnte, die Wiederherstellung aber erfolgreich war

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden, d. h., der Testbefehl konnte nicht abgeschlossen werden und die Wiederherstellung ist fehlgeschlagen.

runInstrumentationTests

public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

Führt Instrumentierungstests durch und bietet Gerätewiederherstellung.

Wenn die Verbindung zum Gerät vor Abschluss des Testlaufs unterbrochen wird und die Wiederherstellung erfolgreich ist, werden alle Listener über testRunFailed informiert und „false“ zurückgegeben. Der Testbefehl wird nicht noch einmal ausgeführt. Anrufer müssen es bei Bedarf noch einmal versuchen.

Wenn die Verbindung zum Gerät vor Abschluss des Testlaufs unterbrochen wird und die Wiederherstellung fehlschlägt, werden alle Listener über „testRunFailed“ informiert und „DeviceNotAvailableException“ wird ausgelöst.

Parameter
runner	IRemoteAndroidTestRunner: die IRemoteAndroidTestRunner, die die Tests ausführt
listeners	: die Testergebnis-Listener

Returns
boolean	true, wenn der Testbefehl abgeschlossen ist. false, wenn der Vorgang aufgrund einer Ausnahme bei der Gerätekommunikation nicht abgeschlossen, die Wiederherstellung aber erfolgreich war

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden, d. h., der Testbefehl konnte nicht abgeschlossen werden und die Wiederherstellung ist fehlgeschlagen.

runInstrumentationTestsAsUser

public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                 listeners)

Hat dieselbe Funktion wie ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)), führt aber den Test für den angegebenen Nutzer aus.

Parameter
runner	IRemoteAndroidTestRunner
userId	int
listeners

Returns
boolean

Ausgabe
DeviceNotAvailableException

runInstrumentationTestsAsUser

public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                ITestLifeCycleReceiver... listeners)

Hat dieselbe Funktion wie ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...), führt aber den Test für einen bestimmten Nutzer aus.

Parameter
runner	IRemoteAndroidTestRunner
userId	int
listeners	ITestLifeCycleReceiver

Returns
boolean

Ausgabe
DeviceNotAvailableException

Datum festlegen

public abstract void setDate (Date date)

Legt das Datum auf dem Gerät fest

Hinweis: Zum Festlegen des Datums auf dem Gerät ist ein Root erforderlich

Parameter
date	Date: gibt ein bestimmtes Datum an. Es wird das Hostdatum verwendet, wenn null

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Optionen

public abstract void setOptions (TestDeviceOptions options)

TestDeviceOptions für das Gerät festlegen

Parameter
options	TestDeviceOptions

setProperty

public abstract boolean setProperty (String propKey, 
                String propValue)

Legt den angegebenen Property-Wert auf dem Gerät fest. Erfordert, dass der ADB-Stamm „true“ ist.

Parameter
propKey	String: Der festzulegende Schlüssel.
propValue	String: Der festzulegende Attributwert.

Returns
boolean	Gibt True zurück, wenn der Befehl „setprop“ erfolgreich war, andernfalls „False“.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Wiederherstellung festlegen

public abstract void setRecovery (IDeviceRecovery recovery)

Lege die IDeviceRecovery fest, die für dieses Gerät verwendet werden soll. Sollte bei der ersten Zuweisung des Geräts festgelegt werden.

Parameter
recovery	IDeviceRecovery: die IDeviceRecovery

Wiederherstellungsmodus festlegen

public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

Legen Sie den aktuellen Wiederherstellungsmodus für das Gerät fest.

Damit wird gesteuert, welche Wiederherstellungsmethode bei Problemen mit der Gerätekommunikation verwendet werden soll. Es wird empfohlen, diese Methode nur sparsam zu verwenden, wenn sie benötigt wird (z. B. wenn das Framework ausgefallen ist usw.)

Parameter
mode	ITestDevice.RecoveryMode: Gibt an, ob der Modus „Nur bis online wiederherstellen“ aktiviert sein soll oder nicht.

Schnellstart-Funktion verwenden

public abstract void setUseFastbootErase (boolean useFastbootErase)

Legen Sie fest, ob eine Partition auf dem Gerät mithilfe des Schnellstart-Löschens oder des Fastboot-Formats gelöscht werden soll.

Parameter
useFastbootErase	boolean: true, wenn die Daten mit Fastboot-Löschung gelöscht werden sollen, oder false, wenn das Fastboot-Format verwendet werden soll.

Weitere Informationen:

• fastbootWipePartition(String)

startLogcat

public abstract void startLogcat ()

Starte die Aufzeichnung der Logcat-Ausgabe vom Gerät im Hintergrund.

Dies hat keine Auswirkungen, wenn die Logcat-Ausgabe bereits erfasst wird. Die Daten können später über getLogcat abgerufen werden.

Wenn das Gerät nicht mehr verwendet wird, muss stopLogcat() aufgerufen werden.

startLogcat() und stopLogcat() müssen normalerweise nicht aufgerufen werden, wenn sie sich im Kontext eines TF-Aufrufs befinden, da das TF-Framework Logcat startet und beendet.

stopEmulatorOutput

public abstract void stopEmulatorOutput ()

Schließen und löschen Sie die Emulatorausgabe.

stopLogcat

public abstract void stopLogcat ()

Erfassen der Logcat-Ausgabe vom Gerät beenden und aktuell gespeicherte Logcat-Daten verwerfen.

Dies hat keine Auswirkungen, wenn die Logcat-Ausgabe nicht erfasst wird.

SwitchToAdbTcp

public abstract String switchToAdbTcp ()

Wechseln Sie auf dem Gerät in den ADB-over-tcp-Modus.

Returns
String	Die TCP-Seriennummer oder null, wenn das Gerät nicht gewechselt werden konnte

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Wechsel zu AdBUsb

public abstract boolean switchToAdbUsb ()

Schalte das Gerät in den ADB-over-USB-Modus um.

Returns
boolean	true, wenn der Wechsel erfolgreich war, andernfalls false.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Dateien synchronisieren

public abstract boolean syncFiles (File localFileDir, 
                String deviceFilePath)

Der Inhalt eines lokalen Dateiverzeichnisses wird inkrementell mit dem Gerät synchronisiert.

Entscheidet, welche Dateien übertragen werden sollen, indem die Zeitstempel lokaler Dateien mit ihren Remote-Entsprechungen verglichen werden. Es werden nur neuere oder nicht vorhandene Dateien auf das Gerät übertragen. Daher sollte der Aufwand relativ gering sein, wenn der Dateisatz auf dem Gerät bereits auf dem neuesten Stand ist.

Verborgene Dateien, deren Namen mit „.“ beginnen, werden ignoriert.

Beispielanwendung: syncFiles("/tmp/files", "/sdcard") erstellt ein /sdcard/files-Verzeichnis, falls es noch nicht vorhanden ist, und überträgt die /tmp/files-Inhalte rekursiv in das Verzeichnis /sdcard/files.

Parameter
localFileDir	File: das lokale Dateiverzeichnis, das die Dateien enthält, die rekursiv übertragen werden sollen.
deviceFilePath	String: Stamm des absoluten Dateipfads des Remote-Ziels Alle Verzeichnisse in diesem Dateipfad müssen lesbar sein, d. h., das Senden von Push-Nachrichten an „/data/local/tmp“, wenn ADB kein Root ist, schlägt fehl.

Returns
boolean	true, wenn die Dateien synchronisiert wurden. Andernfalls false.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

Gerät entsperren

public abstract boolean unlockDevice ()

Entsperrt das Gerät, wenn es verschlüsselt ist

Diese Methode kann das Framework neu starten, ruft jedoch nicht postBootSetup() auf. Daher ist das Gerät möglicherweise nicht vollständig zum Testen bereit, wenn diese Methode zurückgegeben wird.

Returns
boolean	true, wenn der Vorgang erfolgreich war oder das Gerät unverschlüsselt ist.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.
UnsupportedOperationException	wenn das Gerät keine Verschlüsselung unterstützt.

unmountDebugfs

public abstract void unmountDebugfs ()

Trennen Sie „debugfs“.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

WartefürBootAbgeschlossen

public abstract boolean waitForBootComplete (long timeOut)

Blockiert, bis das Flag „Boot abgeschlossen“ des Geräts gesetzt wird.

Parameter
timeOut	long: Zeit in Millisekunden, die gewartet wird, bis das Flag gesetzt wird

Returns
boolean	"true", wenn das Flag "Boot abgeschlossen" des Geräts innerhalb des Zeitlimits gesetzt ist

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

WaitForDeviceVerfügbar

public abstract boolean waitForDeviceAvailable ()

Wartet, bis das Gerät reagiert und zum Testen verfügbar ist. Verwendet das Standardzeitlimit.

Returns
boolean	„True“, wenn das Gerät verfügbar ist, „False“, wenn die Wiederherstellung deaktiviert und nicht verfügbar ist.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

WaitForDeviceVerfügbar

public abstract boolean waitForDeviceAvailable (long waitTime)

Wartet, bis das Gerät reagiert und zum Testen verfügbar ist.

Parameter
waitTime	long: die Wartezeit in ms

Returns
boolean	„True“, wenn das Gerät verfügbar ist, „False“, wenn die Wiederherstellung deaktiviert und nicht verfügbar ist.

Ausgabe
DeviceNotAvailableException	wenn das Gerät nach Ablauf der Wartezeit immer noch nicht reagiert.

WaitForDeviceAvailableInRecoveryPath

public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

Wartet, bis das Gerät responsiv und verfügbar ist, ohne den Wiederherstellungspfad zu berücksichtigen.

Parameter
waitTime	long

Returns
boolean	„True“, wenn das Gerät verfügbar ist, „False“, wenn nicht verfügbar.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

WaitForDeviceBootloader

public abstract void waitForDeviceBootloader ()

Blockiert, bis das Gerät über Fastboot sichtbar ist. Standardzeitlimit verwenden.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

WaitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

Blöcke für das Gerät, die sich im Status „ADB-Wiederherstellung“ befinden. Beachten Sie, dass dies nicht mit IDeviceRecovery zu tun ist.

Parameter
waitTime	long: die Wartezeit in ms

Returns
boolean	true, wenn das Gerät vor Ablauf des Zeitlimits in die Wiederherstellung startet. Andernfalls false

WartefürGerätInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

Blöcke für das Gerät, die sich im Status „ADB-Sideload“ befinden

Parameter
waitTime	long: die Wartezeit in ms

Returns
boolean	true, wenn das Gerät vor Ablauf der Zeit in Sideload startet. Andernfalls false

WaitForDeviceNotAvailable

public abstract boolean waitForDeviceNotAvailable (long waitTime)

Blockierungen für das Gerät, die nicht verfügbar sind, d. h. in ADB fehlen

Parameter
waitTime	long: die Wartezeit in ms

Returns
boolean	true, wenn das Gerät vor Ablauf der Zeit nicht verfügbar wird. Andernfalls false

WarteFürGerätOnline

public abstract void waitForDeviceOnline ()

Blockiert, bis das Gerät über ADB sichtbar ist. Verwendet Standardzeitüberschreitung

Beachten Sie, dass das Gerät nach Abschluss der Ausführung nicht unbedingt auf Befehle reagiert. Verwende stattdessen waitForDeviceAvailable().

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

WarteFürGerätOnline

public abstract void waitForDeviceOnline (long waitTime)

Blockiert, bis das Gerät über ADB sichtbar ist.

Beachten Sie, dass das Gerät nach Abschluss der Ausführung nicht unbedingt auf Befehle reagiert. Verwende stattdessen waitForDeviceAvailable().

Parameter
waitTime	long: die Wartezeit in ms

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

WaitForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

Wartet, bis das Gerät auf einen einfachen ADB-Shell-Befehl reagiert.

Parameter
waitTime	long: die Wartezeit in ms

Returns
boolean	true, wenn das Gerät vor Ablauf des waitTime responsiv wird.