INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice

Bietet eine zuverlässige und etwas höhere API für eine ddmlib IDevice.

Wiederholt Gerätebefehle eine konfigurierbare Anzahl von Malen und bietet eine Benutzeroberfläche zur Gerätewiederherstellung für Geräte, die nicht mehr reagieren.

Zusammenfassung

Konstanten

int UNKNOWN_API_LEVEL

Standardwert, wenn die API-Ebene nicht erkannt werden kann

Öffentliche Methoden

abstract boolean checkApiLevelAgainstNextRelease(int strictMinLevel)

Prüfen, ob eine Funktion derzeit unterstützt wird, wenn ein Mindestsupportlevel vorhanden ist

abstract void clearLogcat()

Löscht alle angesammelten 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 neu gestartet wurde, indem der aktuelle system_server mit dem vorherigen system_server ProcessInfo verglichen wird.

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 seiner ERROR(/TimeUnit) neu gestartet wurde.

abstract boolean disableAdbRoot()

Deaktiviert adb root.

abstract boolean doesFileExist(String deviceFilePath)

Hilfsmethode, um zu ermitteln, ob eine Datei auf dem Gerät vorhanden ist.

abstract boolean enableAdbRoot()

Aktiviert adb root.

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

Hilfsmethode, die einen adb-Befehl als Systembefehl mit einem angegebenen 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 angegebenen 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 einer Standardzeitüberschreitung von 2 Minuten ausführt.

abstract CommandResult executeLongFastbootCommand(String... commandArgs)

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

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

Hilfsmethode, die einen lang 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 weiteren Parametern aus, um das Befehlsverhalten zu steuern.

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

Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern.

abstract void executeShellCommand(String command, IShellOutputReceiver receiver)

Führt den angegebenen adb-Shell-Befehl aus und versucht bei einem Fehler mehrmals, ihn auszuführen.

abstract CommandResult executeShellV2Command(String command)

Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ergebnisse als CommandResult zurückgibt, die korrekt mit dem 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 korrekt mit der Befehlsstatusausgabe 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 korrekt mit dem Befehlsstatus, stdout und stderr ausgefüllt ist.

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

Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern.

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

Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern.

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

Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern.

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

Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern.

abstract CommandResult fastbootWipePartition(String partition)

Hilfsmethode zum Löschen einer Partition für das Gerät.

abstract int getApiLevel()

Rufe die API-Ebene des Geräts ab.

abstract String getBasebandVersion()

Diese Methode ist praktisch, um die Baseband-Version (Funkschnittstelle) dieses Geräts abzurufen.

abstract Integer getBattery()

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

abstract boolean getBooleanProperty(String name, boolean defaultValue)

Gibt den booleschen Wert der angegebenen Property zurück.

abstract getBootHistory()

Die Hilfsmethode erfasst die Boot-Verlaufskarte mit Bootzeit und Bootgrund.

abstract getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)

Mit dieser Hilfsmethode wird die Boot-Verlaufskarte mit Bootzeit und Bootgrund seit dem angegebenen Zeitpunkt seit der Epoche vom Gerät und der angegebenen Zeiteinheit erfasst.

abstract String getBootloaderVersion()

Diese Methode ist praktisch, um die Bootloader-Version dieses Geräts abzurufen.

abstract String getBuildAlias()

Ruft den Alias des Builds ab, der auf dem Gerät gerade ausgeführt wird.

abstract String getBuildFlavor()

Ruft die Build-Variante für das Gerät ab.

abstract String getBuildId()

Ruft den Build ab, der auf dem Gerät gerade ausgeführt wird.

abstract String getBuildSigningKeys()

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

Normalerweise können Android-Geräte mit Testschlüsseln (z. B. in AOSP) oder Release-Schlüsseln (von einzelnen Geräteherstellern gesteuert) signiert werden.

abstract DeviceDescriptor getCachedDeviceDescriptor()

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

abstract DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

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

abstract String[] getChildren(String deviceFilePath)

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

abstract AbstractConnection getConnection()

Gibt die mit dem Gerät verknüpfte Verbindung zurück.

abstract String getDeviceClass()

Geräteklasse abrufen

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 dazu zu erhalten, ohne das eigentliche Geräteobjekt zu übergeben.

abstract DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

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

abstract TestDeviceState getDeviceState()

Rufe den Status des Geräts ab.

abstract long getDeviceTimeOffset(Date date)

Hilft, die Zeitdifferenz zwischen dem Gerät und einer bestimmten ERROR(/Date) zu ermitteln.

abstract InputStreamSource getEmulatorOutput()

Stream von stdout und stderr des Emulators abrufen

abstract long getExternalStoreFreeSpace()

Hilfsmethode zum Ermitteln des freien Speicherplatzes auf dem externen Speicher des Geräts.

abstract String getFastbootProductType()

Diese Methode ist praktisch, um den Produkttyp dieses Geräts im Fastboot-Modus abzurufen.

abstract String getFastbootProductVariant()

Diese Methode ist praktisch, um den Produkttyp dieses Geräts im Fastboot-Modus abzurufen.

abstract String getFastbootSerialNumber()

Gibt die Seriennummer des Fastboot-Modus zurück.

abstract String getFastbootVariable(String variableName)

Ruft den angegebenen Wert der Fastboot-Variablen vom Gerät ab.

abstract IFileEntry getFileEntry(String path)

Eine Referenz auf eine Remotedatei auf dem Gerät abrufen

abstract IDevice getIDevice()

Gibt einen Verweis auf die zugehörige ddmlib-IDevice zurück.

abstract long getIntProperty(String name, long defaultValue)

Gibt den Ganzzahlwert der angegebenen Eigenschaft vom Gerät zurück.

abstract long getLastExpectedRebootTimeMillis()

Gibt an, wann Tradefed APIs zuletzt einen Neustart in Millisekunden seit der Epoche ausgelöst haben, wie von System.currentTimeMillis() zurückgegeben.

abstract int getLaunchApiLevel()

Das API-Level, mit dem das Gerät zum ersten Mal gestartet wurde.

abstract InputStreamSource getLogcat()

Erfasst einen Snapshot-Stream der Logcat-Daten.

abstract InputStreamSource getLogcat(int maxBytes)

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

abstract InputStreamSource getLogcatDump()

Einen Dump des aktuellen Logcat für das Gerät abrufen

abstract InputStreamSource getLogcatSince(long date)

Erfasst einen Snapshot-Stream der erfassten 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 an diesem Pfad nichts bereitgestellt ist oder er anderweitig nicht in /proc/mounts als Bereitstellungspunkt aufgeführt ist.

abstract getMountPointInfo()

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

abstract long getPartitionFreeSpace(String partition)

Hilfsmethode zum Bestimmen des freien Speicherplatzes auf der Gerätepartition.

abstract ProcessInfo getProcessByName(String processName)

Die Hilfsmethode führt die Befehle „pidof“ und „stat“ aus und gibt ein ProcessInfo-Objekt mit der PID und dem Prozessstartzeitpunkt des angegebenen Prozesses zurück.

abstract String getProcessPid(String process)

Gibt die Prozess-ID des Dienstes zurück oder „null“, wenn ein Fehler aufgetreten ist.

abstract String getProductType()

Eine praktische Methode, um den Produkttyp dieses Geräts zu ermitteln.

abstract String getProductVariant()

Eine praktische Methode, um die Produktvariante dieses Geräts abzurufen.

abstract String getProperty(String name)

Ruft den angegebenen Attributwert vom Gerät ab.

abstract ITestDevice.RecoveryMode getRecoveryMode()

Ruft den aktuellen Wiederherstellungsmodus ab, der für das Gerät verwendet wird.

abstract String getSerialNumber()

Eine praktische Methode, um die Seriennummer dieses Geräts zu erhalten.

abstract getTombstones()

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

abstract long getTotalMemory()

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

default String getTrackingSerial()

Rufen Sie für die Geräteverwaltung die Seriennummer ab, die zum Nachverfolgen des Geräts verwendet wird.

abstract boolean getUseFastbootErase()

Ermitteln Sie, ob Sie „fastboot erase“ oder „fastboot format“ verwenden müssen, um eine Partition auf dem Gerät zu löschen.

abstract boolean isAdbRoot()
abstract boolean isAdbTcp()
abstract boolean isAppEnumerationSupported()

Prüfen, ob die Plattform auf dem Gerät die App-Aufzählung unterstützt

abstract boolean isBypassLowTargetSdkBlockSupported()

Prüfen, ob die Plattform auf dem Gerät die Umgehung der Blockierung von App-Installationen aufgrund eines niedrigen Ziel-SDK 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, ob 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 „wahr“ zurück, wenn das Gerät headless (ohne Bildschirm) ist, andernfalls „falsch“.

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 ANRs auf dem Gerät.

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

Eine Nachricht im Logcat des Geräts protokollieren

abstract void mountDebugfs()

debugfs bereitstellen

abstract void nonBlockingReboot()

Gibt einen Befehl zum Neustarten des Geräts aus und gibt nach Abschluss des Befehls und wenn das Gerät für adb nicht mehr sichtbar ist, zurück.

abstract void postBootSetup()

Folgen Sie der Anleitung, um das Gerät für das Testen nach jedem Start zu konfigurieren.

default void postInvocationTearDown()

Diese Methode ist veraltet. Verwenden Sie stattdessen postInvocationTearDown(Throwable).

abstract void postInvocationTearDown(Throwable invocationException)

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

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

Zusätzliche Schritte für die erforderliche gerätespezifische Einrichtung, die vor dem Aufrufvorgang 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 einem lokalen temporären ERROR(/File) und gibt diesen File zurück.

abstract File pullFile(String remoteFilePath)

Ruft eine Datei vom Gerät ab, speichert sie in einem lokalen temporären ERROR(/File) und gibt diesen 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, in einem lokalen temporären ERROR(/File) zu speichern und einen Verweis auf diesen 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 rekursiv auf das Gerät übertragen und dabei einige Verzeichnisse ausschließen, die gefiltert werden.

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), bei der optional die Notwendigkeit für den Inhaltsanbieter berücksichtigt werden kann.

abstract boolean pushFile(File localFile, String deviceFilePath)

Dateien an das Gerät senden

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

Dateien an das Gerät senden

abstract boolean pushString(String contents, String deviceFilePath)

Aus einem String erstellte Datei an das Gerät senden

abstract void reboot()

Startet das Gerät im ADB-Modus neu.

abstract void reboot(String reason)

Startet das Gerät im ADB-Modus mit der angegebenen reason neu, die nach dem Neustart beibehalten werden soll.

abstract void rebootIntoBootloader()

Das Gerät wird im Bootloader-Modus neu gestartet.

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)

Das Gerät wird im adb-Sideload-Modus neu gestartet. Hinweis: Dies ist ein spezieller Modus unter Wiederherstellung.

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

abstract void rebootIntoSideload()

Das Gerät wird im adb-Sideload-Modus neu gestartet. Hinweis: Dies ist ein spezieller Modus unter Wiederherstellung.

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, also für adb sichtbar ist.

abstract void rebootUntilOnline(String reason)

Eine Alternative zu reboot(), die nur blockiert, bis das Gerät online ist, also für adb sichtbar ist.

abstract void rebootUserspace()

Startet nur den Nutzerbereich 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 sichtbar ist.

abstract void remountSystemReadOnly()

Die Systempartition auf dem Gerät schreibgeschützt machen.

abstract void remountSystemWritable()

Machen Sie die Systempartition auf dem Gerät beschreibbar.

abstract void remountVendorReadOnly()

Die Anbieterpartition auf dem Gerät schreibgeschützt machen.

abstract void remountVendorWritable()

Machen Sie die Anbieterpartition auf dem Gerät beschreibbar.

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

Diese praktische Methode führt ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) mit einem oder mehreren Listenern aus, die als Parameter übergeben werden.

abstract boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)

Führt Instrumentierungstests aus und bietet die Gerätewiederherstellung.

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

Entspricht ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)), führt den Test jedoch für den angegebenen Nutzer aus.

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

Entspricht ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...), führt den Test jedoch für einen bestimmten Nutzer aus.

abstract void setDate(Date date)

Das Datum auf dem Gerät wird festgelegt.

Hinweis: Zum Festlegen des Datums auf dem Gerät ist Root-Zugriff 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)

Legen Sie 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 setTrackingSerial(String trackingSerial)

Verfolgen Sie für die Geräteverwaltung die Seriennummer, die wir für die Referenzierung des Geräts verwenden.

abstract void setUseFastbootErase(boolean useFastbootErase)

Legen Sie fest, ob Sie „fastboot erase“ oder „fastboot format“ verwenden möchten, um eine Partition auf dem Gerät zu löschen.

abstract void startLogcat()

Starten Sie die Erfassung der Logcat-Ausgabe vom Gerät im Hintergrund.

abstract boolean startTradeInModeTesting(int timeoutMs)

Testen des Trade-In-Modus aktivieren

abstract void stopEmulatorOutput()

Schließen und löschen Sie die Emulatorausgabe.

abstract void stopLogcat()

Die Erfassung der Logcat-Ausgabe vom Gerät wird beendet und die derzeit gespeicherten Logcat-Daten werden verworfen.

abstract void stopTradeInModeTesting()

Testen des Trade-In-Modus beenden.

abstract String switchToAdbTcp()

Stellen Sie das Gerät auf den adb-over-tcp-Modus um.

abstract boolean switchToAdbUsb()

Stellen Sie das Gerät auf den Modus „adb over USB“ um.

abstract boolean syncFiles(File localFileDir, String deviceFilePath)

Synchronisiert den Inhalt eines lokalen Dateiverzeichnisses mit dem Gerät.

abstract boolean unlockDevice()

Entsperret das Gerät, wenn es verschlüsselt ist.

abstract void unmountDebugfs()

Entfernen Sie die Bereitstellung von debugfs.

abstract boolean waitForBootComplete(long timeOut)

Blockiert, bis das Flag „Boot complete“ des Geräts gesetzt ist.

abstract boolean waitForDeviceAvailable()

Wartet, bis das Gerät reagiert und für den Test verfügbar ist.

abstract boolean waitForDeviceAvailable(long waitTime)

Wartet, bis das Gerät reagiert und für den Test verfügbar ist.

abstract boolean waitForDeviceAvailableInRecoverPath(long waitTime)

Wartet, bis das Gerät reagiert 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)

Verhindert, dass sich das Gerät im Status „adb recovery“ befindet (dies ist nicht dasselbe wie IDeviceRecovery).

abstract boolean waitForDeviceInSideload(long waitTime)

Verhindert, dass sich das Gerät im Status „adb sideload“ befindet

abstract boolean waitForDeviceNotAvailable(long waitTime)

Blockiert, dass das Gerät nicht verfügbar ist, d. h. nicht in adb vorhanden ist

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

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

Standardwert, wenn die API-Ebene nicht erkannt werden kann

Konstanter Wert: −1 (0xffffffff)

Öffentliche Methoden

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Prüfen, ob eine Funktion derzeit unterstützt wird, wenn ein Mindestsupportlevel vorhanden ist Bei dieser Methode werden noch nicht veröffentlichte Funktionen berücksichtigt, bevor die API-Ebene erhöht wird.

Parameter
strictMinLevel int: Die strengste minimale Stufe, die das Feature 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 angesammelten Logcat-Daten.

Dies ist nützlich, wenn Sie sicherstellen möchten, dass ITestDevice.getLogcat() nur Protokolldaten zurückgibt, die nach einem bestimmten Zeitpunkt erstellt wurden (z. B. nach dem Flashen eines neuen Gerätebuilds).

deleteFile

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

deleteFile

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, von der aus gelöscht werden soll
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deviceSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Hilfsmethode, um zu prüfen, ob das Gerät neu gestartet wurde, indem der aktuelle system_server mit dem vorherigen system_server ProcessInfo verglichen wird. Verwende getProcessByName(String) als Zahlungsmethode, um ProcessInfo zu erhalten.

Parameter
prevSystemServerProcess ProcessInfo: den vorherigen system_server-Prozess ProcessInfo.
Returns
boolean true, wenn das Gerät neu gestartet wurde
Ausgabe
RuntimeException if device has abnormal boot reason
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deviceSoftRestartedSince

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 seiner ERROR(/TimeUnit) neu gestartet wurde. Ein richtlinienbasierter Neustart bezieht sich auf einen Neustart von system_server, der nicht durch einen erzwungenen Neustart des Geräts ausgelöst wurde (z. B. angeforderter Neustart). Die aktuelle utcEpochTime des Geräts in Millisekunden 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 neu gestartet wurde
Ausgabe
RuntimeException if device has abnormal boot reason
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

disableAdbRoot

public abstract boolean disableAdbRoot ()

Deaktiviert adb root.

Wenn Sie adb root deaktivieren, wird die Verbindung des Geräts zu adb möglicherweise getrennt. Bei dieser Methode wird die Blockierung aufrechterhalten, bis das Gerät verfügbar ist.

Returns
boolean true, wenn der Vorgang erfolgreich war.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath)

Hilfsmethode, um zu ermitteln, ob eine Datei auf dem Gerät vorhanden ist.

Parameter
deviceFilePath String: Der absolute Pfad der Datei auf dem Gerät, die geprüft werden soll.
Returns
boolean true, wenn die Datei vorhanden ist, andernfalls false.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

enableAdbRoot

public abstract boolean enableAdbRoot ()

Aktiviert adb root. Wenn die Einstellung „enable-root“ auf „false“ festgelegt ist, wird eine Meldung protokolliert und die Funktion wird nicht aktiviert.

Wenn Sie „adb root“ aktivieren, wird die Verbindung des Geräts zu ADB möglicherweise getrennt. Bei dieser Methode wird die Blockierung aufrechterhalten, bis das Gerät verfügbar ist.

Returns
boolean true, wenn der Vorgang erfolgreich war.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeAdbCommand

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

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

Verwenden Sie stattdessen nach Möglichkeit executeShellCommand(String), da diese Methode eine bessere Fehlererkennung und Leistung bietet.

Parameter
timeout long: die Zeit in Millisekunden, nach der das Gerät als nicht antwortend eingestuft wird, 0L für keinen Zeitüberschreitung
commandArgs String: der adb-Befehl und die Argumente, die ausgeführt werden sollen
Returns
String den stdout aus dem Befehl. null, wenn die Ausführung des Befehls fehlgeschlagen ist.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

Verwenden Sie stattdessen nach Möglichkeit executeShellCommand(String), da diese Methode eine bessere Fehlererkennung und Leistung bietet.

Parameter
commandArgs String: der adb-Befehl und die Argumente, die ausgeführt werden sollen
Returns
String den stdout aus dem Befehl. null, wenn die Ausführung des Befehls fehlgeschlagen ist.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeAdbCommand

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

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

Verwenden Sie stattdessen nach Möglichkeit executeShellCommand(String), da diese Methode eine bessere Fehlererkennung und Leistung bietet.

Parameter
timeout long: die Zeit in Millisekunden, nach der das Gerät als nicht antwortend eingestuft wird, 0L für keinen Zeitüberschreitung
envMap : Umgebung, die für den Befehl festgelegt werden soll
commandArgs String: der adb-Befehl und die Argumente, die ausgeführt werden sollen
Returns
String den stdout aus dem Befehl. null, wenn die Ausführung des Befehls fehlgeschlagen ist.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeFastbootCommand

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

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

Wird verwendet, wenn sich das Gerät bereits im Fastboot-Modus befindet.

Parameter
timeout long: die Zeit in Millisekunden, nach der der Befehl abläuft
commandArgs String: der Fastboot-Befehl und die zugehörigen Argumente
Returns
CommandResult „CommandResult“ mit der Befehlsausgabe
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

Hilfsmethode, die einen Fastboot-Befehl als Systembefehl mit einer Standardzeitüberschreitung von 2 Minuten ausführt.

Wird verwendet, wenn sich das Gerät bereits im Fastboot-Modus befindet.

Parameter
commandArgs String: der Fastboot-Befehl und die zugehörigen Argumente
Returns
CommandResult „CommandResult“ mit der Befehlsausgabe
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

Identisch mit executeFastbootCommand(String), mit Ausnahme einer längeren Zeitüberschreitung.

Parameter
commandArgs String: der Fastboot-Befehl und die zugehörigen Argumente
Returns
CommandResult „CommandResult“ mit der Befehlsausgabe
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeLongFastbootCommand

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

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

Identisch mit executeFastbootCommand(String), mit Ausnahme einer längeren Zeitüberschreitung.

Parameter
envVarMap : die Systemumgebungsvariablen, mit denen der Befehl „fastboot“ ausgeführt wird
commandArgs String: der Fastboot-Befehl und die zugehörigen Argumente
Returns
CommandResult „CommandResult“ mit der Befehlsausgabe
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeShellCommand

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 wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeShellCommand

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

Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern.

Parameter
command String: der auszuführende adb-Shell-Befehl
receiver IShellOutputReceiver: IShellOutputReceiver, an das die Shell-Ausgabe weitergeleitet werden soll.
maxTimeToOutputShellResponse long: Die maximale Zeitspanne, während der der Befehl keine Antwort ausgeben darf. Maßeinheit wie in timeUnit angegeben.
timeUnit TimeUnit: Einheit für maxTimeToOutputShellResponse
retryAttempts int: Die maximale Anzahl der Wiederholungen, die ein Befehl ausführen soll, wenn er aufgrund einer Ausnahme fehlschlägt. Die Ausnahme „DeviceNotResponsiveException“ wird geworfen, wenn retryAttempts ohne Erfolg ausgeführt wird.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeShellCommand

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

Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern.

Parameter
command String: der auszuführende adb-Shell-Befehl
receiver IShellOutputReceiver: IShellOutputReceiver, an das die Shell-Ausgabe weitergeleitet werden soll.
maxTimeoutForCommand long: Die maximale Zeitüberschreitung für den Befehl, Einheit wie in timeUnit angegeben
maxTimeToOutputShellResponse long: Die maximale Zeitspanne, während der der Befehl keine Antwort ausgeben darf. Maßeinheit wie in timeUnit angegeben.
timeUnit TimeUnit: Einheit für maxTimeToOutputShellResponse
retryAttempts int: Die maximale Anzahl der Wiederholungen, die der Befehl ausführen soll, wenn er aufgrund einer Ausnahme fehlschlägt. Die Ausnahme „DeviceNotResponsiveException“ wird geworfen, wenn retryAttempts ohne Erfolg ausgeführt wird.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Führt den angegebenen adb-Shell-Befehl aus und versucht bei einem Fehler mehrmals, ihn auszuführen.

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 das die Shell-Ausgabe weitergeleitet werden soll.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command)

Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ergebnisse als CommandResult zurückgibt, die korrekt mit dem 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 wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeShellV2Command

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 Befehlsstatusausgabe und stderr ausgefüllt ist. stdout wird an den angegebenen Stream weitergeleitet.

Parameter
command String: Der Befehl, der ausgeführt werden soll.
pipeToOutput OutputStream: ERROR(/OutputStream), an das die Standardausgabe weitergeleitet wird, oder null.
Returns
CommandResult Das Ergebnis in CommandResult.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ergebnisse als CommandResult zurückgibt, die korrekt mit dem Befehlsstatus, stdout und stderr ausgefüllt ist.

Parameter
command String: Der Befehl, der ausgeführt werden soll.
pipeAsInput File: Ein ERROR(/File), das als Eingabe an den Befehl übergeben wird, oder „null“.
Returns
CommandResult Das Ergebnis in CommandResult.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeShellV2Command

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

Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern.

Parameter
command String: der auszuführende adb-Shell-Befehl
maxTimeoutForCommand long: Die maximale Zeitüberschreitung für den Befehl, Einheit wie in timeUnit angegeben
timeUnit TimeUnit: Einheit für maxTimeToOutputShellResponse
retryAttempts int: Die maximale Anzahl der Wiederholungen, die der Befehl ausführen soll, wenn er aufgrund einer Ausnahme fehlschlägt. Die Ausnahme „DeviceNotResponsiveException“ wird geworfen, wenn retryAttempts ohne Erfolg ausgeführt wird.
Returns
CommandResult

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

executeShellV2Command

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

Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern.

Parameter
command String: der auszuführende adb-Shell-Befehl
maxTimeoutForCommand long: Die maximale Zeitüberschreitung für den Befehl, Einheit wie in timeUnit angegeben
timeUnit TimeUnit: Einheit für maxTimeToOutputShellResponse
Returns
CommandResult

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

executeShellV2Command

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

Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern.

Parameter
command String: der auszuführende adb-Shell-Befehl
pipeAsInput File: Ein ERROR(/File), das als Eingabe an den Befehl übergeben wird, oder „null“.
pipeToOutput OutputStream: ERROR(/OutputStream), an das die Standardausgabe weitergeleitet wird, oder null.
maxTimeoutForCommand long: Die maximale Zeitüberschreitung für den Befehl, Einheit wie in timeUnit angegeben
timeUnit TimeUnit: Einheit für maxTimeToOutputShellResponse
retryAttempts int: Die maximale Anzahl der Wiederholungen, die der Befehl ausführen soll, wenn er aufgrund einer Ausnahme fehlschlägt. Die Ausnahme „DeviceNotResponsiveException“ wird geworfen, wenn retryAttempts ohne Erfolg ausgeführt wird.
Returns
CommandResult

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

executeShellV2Command

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 weiteren Parametern aus, um das Befehlsverhalten zu steuern.

Parameter
command String: der auszuführende adb-Shell-Befehl
pipeAsInput File: Ein ERROR(/File), das als Eingabe an den Befehl übergeben wird, oder „null“.
pipeToOutput OutputStream: ERROR(/OutputStream), an das die Standardausgabe weitergeleitet wird, oder null.
pipeToError OutputStream: ERROR(/OutputStream), an das der Standardfehler weitergeleitet wird, oder null.
maxTimeoutForCommand long: Die maximale Zeitüberschreitung für den Befehl, Einheit wie in timeUnit angegeben
timeUnit TimeUnit: Einheit für maxTimeToOutputShellResponse
retryAttempts int: Die maximale Anzahl der Wiederholungen, die der Befehl ausführen soll, wenn er aufgrund einer Ausnahme fehlschlägt. Die Ausnahme „DeviceNotResponsiveException“ wird geworfen, wenn retryAttempts ohne Erfolg ausgeführt wird.
Returns
CommandResult

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

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

Hilfsmethode zum Löschen einer Partition für das Gerät.

Wenn getUseFastbootErase() true ist, wird die Partition mit „fastboot erase“ gelöscht. Das Gerät muss dann beim nächsten Start ein Dateisystem erstellen. Andernfalls wird „fastboot format“ verwendet, wodurch ein neues Dateisystem auf dem Gerät erstellt wird.

Wird verwendet, wenn sich das Gerät bereits im Fastboot-Modus befindet.

Parameter
partition String: die zu löschende Partition
Returns
CommandResult „CommandResult“ mit der Befehlsausgabe
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

getApiLevel

public abstract int getApiLevel ()

Rufe die API-Ebene des Geräts ab. 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 ()

Diese Methode ist praktisch, um die Baseband-Version (Funkschnittstelle) dieses Geräts abzurufen. Die Abfrage der Funkversion ist gerätespezifisch und daher werden möglicherweise nicht für alle Geräte die richtigen Informationen zurückgegeben. Bei dieser Methode wird die Eigenschaft „gsm.version.baseband“ verwendet, um die richtigen Versionsinformationen zurückzugeben. Bei einigen CDMA-Geräten ist das nicht korrekt. Die hier zurückgegebene Version stimmt möglicherweise nicht mit der von fastboot gemeldeten Version überein und ist möglicherweise nicht die Version für das CDMA-Funkmodul. Zusammenfassung: Mit dieser Methode wird nur dann die korrekte Version erfasst, wenn die Property „gsm.version.baseband“ mit der von fastboot getvar version-baseband zurückgegebenen Version übereinstimmt.

Returns
String die Baseband-Version String oder null, wenn sie nicht ermittelt werden kann (kein Funkschnittstellenmodul oder Versionsstring kann nicht gelesen werden)
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

getBattery

public abstract Integer getBattery ()

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

Returns
Integer

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

Gibt den booleschen Wert der angegebenen Property zurück.

Parameter
name String: der Property-Name
defaultValue boolean: Standardwert, der zurückgegeben wird, wenn das Attribut leer ist oder nicht vorhanden ist.
Returns
boolean true, wenn die Property den Wert "1", "y", "yes", "on" oder "true" hat, false, wenn die Property den Wert "0", "n", "no", "off", "false" oder defaultValue hat.
Ausgabe
DeviceNotAvailableException

getBootHistory

public abstract  getBootHistory ()

Die Hilfsmethode erfasst die Boot-Verlaufskarte mit Bootzeit und Bootgrund.

Returns
Zuordnung von Bootzeit (UTC-Zeit in Sekunden seit der Epoche) und Bootgrund
Ausgabe
DeviceNotAvailableException

getBootHistorySince

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

Mit dieser Hilfsmethode wird die Boot-Verlaufskarte mit Bootzeit und Bootgrund seit dem angegebenen Zeitpunkt seit der Epoche vom Gerät und der angegebenen Zeiteinheit erfasst. Die aktuelle utcEpochTime des Geräts in Millisekunden kann über die Methode getDeviceDate() abgerufen werden.

Parameter
utcEpochTime long: Die Gerätezeit seit der Epoche.
timeUnit TimeUnit: die Zeiteinheit TimeUnit.
Returns
Zuordnung von Bootzeit (UTC-Zeit in Sekunden seit der Epoche) und Bootgrund
Ausgabe
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

Diese Methode ist praktisch, um die Bootloader-Version dieses Geräts abzurufen.

Es wird versucht, die Bootloaderversion aus dem aktuellen Status des Geräts abzurufen. Wenn sich das Gerät im Fastboot-Modus befindet, wird versucht, die Version aus Fastboot abzurufen.

Returns
String die String-Bootloaderversion oder null, falls diese nicht gefunden werden kann
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

getBuildAlias

public abstract String getBuildAlias ()

Ruft den Alias des Builds ab, der auf dem Gerät gerade ausgeführt wird.

Der Build-Alias ist in der Regel ein besser lesbarer String als die Build-ID (in der Regel eine Zahl für Nexus-Builds). Der finale Android 4.2-Release hat beispielsweise den Build-Alias JDQ39 und die Build-ID 573038.

Returns
String den Build-Alias oder die Build-ID, falls er nicht abgerufen werden konnte
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildFlavor

public abstract String getBuildFlavor ()

Ruft die Build-Variante für das Gerät ab.

Returns
String die Build-Variante oder „null“, wenn sie nicht abgerufen werden konnte
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildId

public abstract String getBuildId ()

Ruft den Build ab, der auf dem Gerät gerade ausgeführt wird.

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.

Normalerweise können Android-Geräte mit Testschlüsseln (z. B. in AOSP) oder Release-Schlüsseln (von einzelnen Geräteherstellern gesteuert) signiert werden.

Returns
String Der Signaturschlüssel, falls gefunden, andernfalls „null“.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

Gibt einen im Cache gespeicherten 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 einen im Cache gespeicherten DeviceDescriptor zurück, wenn das Gerät zugewiesen ist. Andernfalls wird der aktuelle DeviceDescriptor zurückgegeben.

Parameter
shortDescriptor boolean: Ob der Deskriptor auf die minimalen Informationen beschränkt werden soll
Returns
DeviceDescriptor

getChildren

public abstract String[] getChildren (String deviceFilePath)

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

Parameter
deviceFilePath String: ist der Pfad auf dem Gerät, unter dem die Suche durchgeführt werden soll.
Returns
String[] String-Array, das alle Dateien in einem Pfad auf dem Gerät enthält.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getConnection

public abstract AbstractConnection getConnection ()

Gibt die mit dem Gerät verknüpfte Verbindung zurück.

Returns
AbstractConnection

getDeviceClass

public abstract String getDeviceClass ()

Geräteklasse abrufen

Returns
String der 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 Epoch-Format.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

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

Returns
DeviceDescriptor

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

Parameter
shortDescriptor boolean: Ob der Deskriptor auf die minimalen Informationen beschränkt werden soll
Returns
DeviceDescriptor

getDeviceState

public abstract TestDeviceState getDeviceState ()

Rufe den Status des Geräts ab.

Returns
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

Hilft, die Zeitdifferenz zwischen dem Gerät und einer bestimmten ERROR(/Date) zu ermitteln. Verwenden Sie die Epochenzeit intern.

Parameter
date Date

Returns
long den Unterschied in Millisekunden
Ausgabe
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

Stream von stdout und stderr des Emulators abrufen

Returns
InputStreamSource Emulatorausgabe

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

Hilfsmethode zum Ermitteln des freien Speicherplatzes auf dem externen Speicher des Geräts.

Returns
long den freien Speicherplatz in KB
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

getFastbootProductType

public abstract String getFastbootProductType ()

Diese Methode ist praktisch, um den Produkttyp dieses Geräts im Fastboot-Modus abzurufen.

Diese Methode sollte nur verwendet werden, wenn sich das Gerät im Fastboot-Modus befindet. Das ist in diesem Fall eine etwas sicherere Variante als die generische getProductType()-Methode, da ITestDevice das Gerät wieder in den Fastboot-Modus versetzen kann, wenn es sich in einem falschen Status befindet oder nicht reagiert.

Returns
String den Namen des String-Produkttyps oder null, falls er nicht ermittelt werden kann
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

Diese Methode ist praktisch, um den Produkttyp dieses Geräts im Fastboot-Modus abzurufen.

Diese Methode sollte nur verwendet werden, wenn sich das Gerät im Fastboot-Modus befindet. Das ist in diesem Fall eine etwas sicherere Variante als die generische getProductType()-Methode, da ITestDevice das Gerät wieder in den Fastboot-Modus versetzen kann, wenn es sich in einem falschen Status befindet oder nicht reagiert.

Returns
String den Namen des String-Produkttyps oder null, falls er nicht ermittelt werden kann
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

Gibt die Seriennummer des Fastboot-Modus zurück.

Returns
String

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

Ruft den angegebenen Wert der Fastboot-Variablen vom Gerät ab.

Parameter
variableName String: der Variablenname
Returns
String den Property-Wert oder null, falls er nicht vorhanden ist
Ausgabe
UnsupportedOperationException
DeviceNotAvailableException

getFileEntry

public abstract IFileEntry getFileEntry (String path)

Eine Referenz auf eine Remotedatei auf dem Gerät abrufen

Parameter
path String: Der Dateipfad, der abgerufen werden soll. Kann ein absoluter Pfad oder ein Pfad relativ zu „/“ sein. Das heißt, 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 zugehörige ddmlib-IDevice zurück.

Jedes Mal, wenn die Verbindung des Geräts zu adb getrennt und wiederhergestellt wird, kann von DDMS eine neue IDevice zugewiesen werden. Daher sollten Aufrufer keinen Verweis auf die IDevice speichern, da dieser Verweis möglicherweise veraltet.

Returns
IDevice die IDevice

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

Gibt den Ganzzahlwert der angegebenen Eigenschaft vom Gerät zurück.

Parameter
name String: der Property-Name
defaultValue long: Standardwert, der zurückgegeben wird, wenn das Attribut leer ist oder nicht vorhanden ist.
Returns
long den Eigenschaftswert oder defaultValue, wenn die Eigenschaft leer ist, nicht vorhanden oder kein Ganzzahlwert ist.
Ausgabe
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

Gibt an, wann Tradefed APIs zuletzt einen Neustart in Millisekunden seit der Epoche ausgelöst haben, wie von System.currentTimeMillis() zurückgegeben.

Returns
long

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

Das API-Level, mit dem das Gerät zum ersten Mal gestartet wurde. 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.

Es gibt zwei Modi:

  • Wenn der Logcat derzeit im Hintergrund erfasst wird, werden bis zu TestDeviceOptions.getMaxLogcatDataSize() Byte des aktuellen Inhalts der Logcat-Aufzeichnung im Hintergrund zurückgegeben.
  • Andernfalls wird ein statischer Dump der Logcat-Daten zurückgegeben, wenn das Gerät derzeit antwortet.

    Returns
    InputStreamSource

    • getLogcat

    public abstract InputStreamSource getLogcat (int maxBytes)

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

    Nützlich, wenn Sie häufige Snapshots der erfassten Logcat-Daten erstellen möchten, ohne den potenziellen großen Speicherplatzverbrauch durch den gesamten getLogcat()-Snapshot in Kauf nehmen zu müssen.

    Parameter
    maxBytes int: Die maximale Anzahl der zurückzugebenden Daten. Sollte ein Wert sein, der problemlos in den Arbeitsspeicher passt.
    Returns
    InputStreamSource

    getLogcatDump

    public abstract InputStreamSource getLogcatDump ()

    Einen Dump des aktuellen Logcat für das Gerät abrufen Im Gegensatz zu getLogcat() gibt diese Methode immer einen statischen Dump des Logcat 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 Erfassung von Logcat-Daten fehlschlägt, wird ein leerer Stream zurückgegeben.

    getLogcatSince

    public abstract InputStreamSource getLogcatSince (long date)

    Erfasst einen Snapshot-Stream der erfassten Logcat-Daten ab dem angegebenen Datum. Die Uhrzeit auf dem Gerät sollte getDeviceDate() sein.

    Parameter
    date long: Startzeit des Snapshots bis zum aktuellen Zeitpunkt in Millisekunden seit der Epoche. (kann mit „date +%s“ abgerufen werden)
    Returns
    InputStreamSource

    getMountPoint

    public abstract String getMountPoint (String mountName)

    Gibt einen Bereitstellungspunkt zurück.

    Das Gerät wird direkt abgefragt, wenn die im Cache in IDevice gespeicherten Informationen nicht verfügbar sind.

    TODO: dieses Verhalten zu IDevice.getMountPoint(String) verschieben

    Parameter
    mountName String: der Name des Bereitstellungspunkts
    Returns
    String den Bereitstellungspunkt oder null

    Weitere Informationen

    getMountPointInfo

    public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

    Parameter
    mountpoint String

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

    Weitere Informationen

    getMountPointInfo

    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 Bestimmen des freien Speicherplatzes auf der Gerätepartition.

    Parameter
    partition String

    Returns
    long den freien Speicherplatz in KB
    Ausgabe
    DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

    getProcessByName

    public abstract ProcessInfo getProcessByName (String processName)

    Die Hilfsmethode führt die Befehle „pidof“ und „stat“ aus und gibt ein ProcessInfo-Objekt mit der PID und dem Prozessstartzeitpunkt des angegebenen Prozesses zurück.

    Parameter
    processName String: Der String für den Prozessnamen.
    Returns
    ProcessInfo ProcessInfo des angegebenen processName
    Ausgabe
    DeviceNotAvailableException

    getProcessPid

    public abstract String getProcessPid (String process)

    Gibt die Prozess-ID des Dienstes zurück oder „null“, wenn ein Fehler aufgetreten ist.

    Parameter
    process String: Der String für den Prozessnamen.
    Returns
    String

    Ausgabe
    DeviceNotAvailableException

    getProductType

    public abstract String getProductType ()

    Eine praktische Methode, um den Produkttyp dieses Geräts zu ermitteln.

    Diese Methode funktioniert, wenn sich das Gerät im ADB- oder Fastboot-Modus befindet.

    Returns
    String den Namen des String-Produkttyps. darf nicht null sein
    Ausgabe
    DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wurde und nicht wiederhergestellt werden kann oder wenn der Produkttyp nicht ermittelt werden kann

    getProductVariant

    public abstract String getProductVariant ()

    Eine praktische Methode, um die Produktvariante dieses Geräts abzurufen.

    Diese Methode funktioniert, wenn sich das Gerät im ADB- oder Fastboot-Modus befindet.

    Returns
    String den Namen der String-Produktvariante oder null, falls dieser nicht ermittelt werden kann
    Ausgabe
    DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

    getProperty

    public abstract String getProperty (String name)

    Ruft den angegebenen Attributwert vom Gerät ab.

    Parameter
    name String: der Property-Name
    Returns
    String den Property-Wert oder null, falls er nicht vorhanden ist
    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    getRecoveryMode

    public abstract ITestDevice.RecoveryMode getRecoveryMode ()

    Ruft den aktuellen Wiederherstellungsmodus ab, der für das Gerät verwendet wird.

    Returns
    ITestDevice.RecoveryMode den aktuellen Wiederherstellungsmodus, der für das Gerät verwendet wird.

    getSerialNumber

    public abstract String getSerialNumber ()

    Eine praktische Methode, um die Seriennummer dieses Geräts zu erhalten.

    Returns
    String die Seriennummer String

    getTombstones

    public abstract  getTombstones ()

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

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

    Returns
    Eine Liste von Tombstone-Dateien, leer, wenn kein Tombstone vorhanden ist.
    Ausgabe
    DeviceNotAvailableException

    Weitere Informationen

    getTotalMemory

    public abstract long getTotalMemory ()

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

    Returns
    long

    getTrackingSerial

    public String getTrackingSerial ()

    Rufen Sie für die Geräteverwaltung die Seriennummer ab, die zum Nachverfolgen des Geräts verwendet wird.

    Returns
    String

    getUseFastbootErase

    public abstract boolean getUseFastbootErase ()

    Ermitteln Sie, ob Sie „fastboot erase“ oder „fastboot format“ verwenden müssen, um eine Partition auf dem Gerät zu löschen.

    Returns
    boolean true, wenn „fastboot erase“ verwendet werden soll, oder false, wenn „fastboot format“ verwendet werden soll.

    Weitere Informationen

    isAdbRoot

    public abstract boolean isAdbRoot ()

    Returns
    boolean true, wenn das Gerät derzeit adb-Root hat, false andernfalls.
    Ausgabe
    DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

    isAdbTcp

    public abstract boolean isAdbTcp ()

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

    isAppEnumerationSupported

    public abstract boolean isAppEnumerationSupported ()

    Prüfen, ob die Plattform auf dem Gerät die App-Aufzählung unterstützt

    Returns
    boolean „True“, wenn die App-Aufzählung unterstützt wird, andernfalls „False“
    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockSupported

    public abstract boolean isBypassLowTargetSdkBlockSupported ()

    Prüfen, ob die Plattform auf dem Gerät die Umgehung der Blockierung von App-Installationen aufgrund eines niedrigen Ziel-SDK unterstützt

    Returns
    boolean „True“, wenn das Umgehen des Blocks für niedrige Ziel-SDKs 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 wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

    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, ob die Verschlüsselung auf dem Gerät unterstützt wird.

    Returns
    boolean true, wenn das Gerät die Verschlüsselung unterstützt.
    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isExecutable

    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

    isHeadless

    public abstract boolean isHeadless ()

    Gibt „wahr“ zurück, wenn das Gerät headless (ohne Bildschirm) ist, andernfalls „falsch“.

    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

    logAnrs

    public abstract boolean logAnrs (ITestLogger logger)

    Erfasst und protokolliert ANRs auf dem Gerät.

    Parameter
    logger ITestLogger: einen ITestLogger zum Protokollieren der ANRs.
    Returns
    boolean „True“, wenn die Protokollierung erfolgreich war, andernfalls „false“.
    Ausgabe
    DeviceNotAvailableException

    logOnDevice

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

    Eine Nachricht im Logcat des Geräts protokollieren Dies ist ein sicherer Aufruf, der auch dann nicht fehlschlägt, wenn die Protokollierung fehlschlägt.

    Parameter
    tag String: Das Tag, unter dem wir unsere Nachricht im Logcat protokollieren.
    level Log.LogLevel: Die Debugebene der Nachricht im Logcat.
    format String: Das Nachrichtenformat.
    args Object: Die Argumente, die über String.format() ersetzt werden sollen.

    mountDebugfs

    public abstract void mountDebugfs ()

    debugfs bereitstellen

    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    nonBlockingReboot

    public abstract void nonBlockingReboot ()

    Gibt einen Befehl zum Neustarten des Geräts aus und gibt nach Abschluss des Befehls und wenn das Gerät für adb nicht mehr sichtbar ist, zurück.

    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postBootSetup

    public abstract void postBootSetup ()

    Folgen Sie der Anleitung, um das Gerät für das Testen nach jedem Start zu konfigurieren.

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

    Normalerweise muss diese Methode nicht explizit aufgerufen werden, da diese Schritte bei einem Neustart automatisch ausgeführt werden sollten.

    Dies kann erforderlich sein, wenn das Gerät aufgrund anderer Ereignisse neu gestartet wird, z. B. wenn ein Fastboot-Update-Befehl abgeschlossen wurde.

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

    postInvocationTearDown

    public void postInvocationTearDown ()

    Diese Methode ist veraltet.
    Verwenden Sie stattdessen postInvocationTearDown(Throwable).

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

    postInvocationTearDown

    public abstract void postInvocationTearDown (Throwable invocationException)

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

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

    preInvocationSetup

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

    Zusätzliche Schritte für die erforderliche gerätespezifische Einrichtung, die vor dem Aufrufvorgang 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 gezogen werden sollen
    Returns
    boolean true, wenn die Datei erfolgreich abgerufen wurde. Andernfalls false.
    Ausgabe
    DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

    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 gezogen werden sollen
    userId int: die Nutzer-ID, aus der Daten abgerufen werden sollen
    Returns
    boolean true, wenn die Datei erfolgreich abgerufen wurde. Andernfalls false.
    Ausgabe
    DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

    pullFile

    public abstract File pullFile (String remoteFilePath, 
                int userId)

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

    Parameter
    remoteFilePath String: Der absolute Pfad zur Datei auf dem Gerät.
    userId int: Die Nutzer-ID, aus der Daten abgerufen werden sollen
    Returns
    File Eine ERROR(/File) mit dem Inhalt der Gerätedatei oder null, wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (z. B. aufgrund von Problemen mit dem Hostdateisystem)
    Ausgabe
    DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

    pullFile

    public abstract File pullFile (String remoteFilePath)

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

    Parameter
    remoteFilePath String: Der absolute Pfad zur Datei auf dem Gerät.
    Returns
    File Eine ERROR(/File) mit dem Inhalt der Gerätedatei oder null, wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (z. B. aufgrund von Problemen mit dem Hostdateisystem)
    Ausgabe
    DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

    pullFile

    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 die Inhalte gespeichert werden sollen. Wenn das Feld nicht leer ist, wird der Inhalt ersetzt.
    Returns
    boolean true, wenn die Datei erfolgreich abgerufen wurde. Andernfalls false.
    Ausgabe
    DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

    pullFile

    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 die Inhalte gespeichert werden sollen. Wenn das Feld nicht leer ist, wird der Inhalt ersetzt.
    userId int: Die Nutzer-ID, aus der Daten abgerufen werden sollen
    Returns
    boolean true, wenn die Datei erfolgreich abgerufen wurde. Andernfalls false.
    Ausgabe
    DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

    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 Eine String mit dem Inhalt der Gerätedatei oder null, wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (z. B. aufgrund von 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, in einem lokalen temporären ERROR(/File) zu speichern und einen Verweis auf diesen File zurückzugeben.

    Parameter
    remoteFilePath String: Pfad zur Datei auf dem Gerät, relativ zum Bereitstellungspunkt des externen Speichers des Geräts
    Returns
    File Eine ERROR(/File) mit dem Inhalt der Gerätedatei oder null, wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (z. B. aufgrund von Problemen mit dem Hostdateisystem)
    Ausgabe
    DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

    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 gepusht werden soll
    deviceFilePath String: der absolute Dateipfad des Remote-Ziels
    userId int: die Nutzer-ID, an die gesendet werden soll
    Returns
    boolean true, wenn die Datei erfolgreich gepusht wurde. Andernfalls false.
    Ausgabe
    DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

    pushDir

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

    Verzeichnisinhalte rekursiv auf das Gerät übertragen und dabei einige Verzeichnisse ausschließen, die gefiltert werden.

    Parameter
    localDir File: das lokale Verzeichnis, das gepusht werden soll
    deviceFilePath String: der absolute Dateipfad des Remote-Ziels
    excludedDirectories : Liste der auszuschließenden Verzeichnisnamen, die nicht gepusht werden sollen.
    Returns
    boolean true, wenn die Datei erfolgreich gepusht wurde. Andernfalls false.
    Ausgabe
    DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

    pushDir

    public abstract boolean pushDir (File localDir, 
                String deviceFilePath)

    Verzeichnisinhalte rekursiv auf das Gerät übertragen.

    Parameter
    localDir File: das lokale Verzeichnis, das gepusht werden soll
    deviceFilePath String: der absolute Dateipfad des Remote-Ziels
    Returns
    boolean true, wenn die Datei erfolgreich gepusht wurde. Andernfalls false.
    Ausgabe
    DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

    pushFile

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

    Variante von pushFile(File, String), bei der optional die Notwendigkeit für den Inhaltsanbieter berücksichtigt werden kann.

    Parameter
    localFile File: die lokale Datei, die gepusht werden soll
    deviceFilePath String: der absolute Dateipfad des Remote-Ziels
    evaluateContentProviderNeeded boolean: ob geprüft werden soll, ob wir den Contentanbieter benötigen
    Returns
    boolean true, wenn die Datei erfolgreich gepusht wurde. Andernfalls false.
    Ausgabe
    DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

    pushFile

    public abstract boolean pushFile (File localFile, 
                String deviceFilePath)

    Dateien an das Gerät senden Standardmäßig wird ein Contentanbieter verwendet.

    Parameter
    localFile File: die lokale Datei, die gepusht werden soll
    deviceFilePath String: der absolute Dateipfad des Remote-Ziels
    Returns
    boolean true, wenn die Datei erfolgreich gepusht wurde. Andernfalls false.
    Ausgabe
    DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

    pushFile

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

    Dateien an das Gerät senden Standardmäßig wird ein Contentanbieter verwendet.

    Parameter
    localFile File: die lokale Datei, die gepusht werden soll
    deviceFilePath String: der absolute Dateipfad des Remote-Ziels
    userId int: die userId, an die gepusht werden soll
    Returns
    boolean true, wenn die Datei erfolgreich gepusht wurde. Andernfalls false.
    Ausgabe
    DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

    pushString

    public abstract boolean pushString (String contents, 
                String deviceFilePath)

    Aus einem String erstellte Datei an das Gerät senden

    Parameter
    contents String: der Inhalt der Datei, die gepusht werden soll
    deviceFilePath String: der absolute Dateipfad des Remote-Ziels
    Returns
    boolean true, wenn der String erfolgreich gepusht wurde. Andernfalls false.
    Ausgabe
    DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

    neu starten

    public abstract void reboot ()

    Startet das Gerät im ADB-Modus neu.

    Blockiert, bis das Gerät verfügbar ist.

    Ausgabe
    DeviceNotAvailableException if device is not available after reboot

    neu starten

    public abstract void reboot (String reason)

    Startet das Gerät im ADB-Modus mit der angegebenen reason neu, die nach dem Neustart beibehalten werden soll.

    Blockiert, bis das Gerät verfügbar ist.

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

    Parameter
    reason String: Ein Grund für diesen Neustart oder null, wenn kein Grund angegeben ist.
    Ausgabe
    DeviceNotAvailableException if device is not available after reboot

    rebootIntoBootloader

    public abstract void rebootIntoBootloader ()

    Das Gerät wird im Bootloader-Modus neu gestartet.

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

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

    rebootIntoFastbootd

    public abstract void rebootIntoFastbootd ()

    Startet das Gerät im Fastbootd-Modus neu.

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

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

    rebootIntoRecovery

    public abstract void rebootIntoRecovery ()

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

    Blockiert, bis das Gerät in den Wiederherstellungsmodus wechselt

    Ausgabe
    DeviceNotAvailableException if device is not available after reboot

    rebootIntoSideload

    public abstract void rebootIntoSideload (boolean autoReboot)

    Das Gerät wird im adb-Sideload-Modus neu gestartet. Hinweis: Dies ist ein spezieller Modus unter Wiederherstellung.

    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 if device is not in sideload after reboot

    rebootIntoSideload

    public abstract void rebootIntoSideload ()

    Das Gerät wird im adb-Sideload-Modus neu gestartet. Hinweis: Dies ist ein spezieller Modus unter Wiederherstellung.

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

    Ausgabe
    DeviceNotAvailableException if device is not in sideload after reboot

    rebootUntilOnline

    public abstract void rebootUntilOnline ()

    Eine Alternative zu reboot(), die nur blockiert, bis das Gerät online ist, also für adb sichtbar ist.

    Ausgabe
    DeviceNotAvailableException if device is not available after reboot

    rebootUntilOnline

    public abstract void rebootUntilOnline (String reason)

    Eine Alternative zu reboot(), die nur blockiert, bis das Gerät online ist, also für adb sichtbar ist.

    Parameter
    reason String: Ein Grund für diesen Neustart oder null, wenn kein Grund angegeben ist.
    Ausgabe
    DeviceNotAvailableException if device is not available after reboot

    Weitere Informationen

    rebootUserspace

    public abstract void rebootUserspace ()

    Startet nur den Nutzerbereich des Geräts neu.

    Blockiert, bis das Gerät verfügbar ist.

    ACHTUNG: Der Neustart im Userspace befindet sich derzeit in aktiver Entwicklung. Die Nutzung erfolgt auf eigenes Risiko.

    Ausgabe
    DeviceNotAvailableException if device is not available after reboot

    rebootUserspaceUntilOnline

    public abstract void rebootUserspaceUntilOnline ()

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

    Ausgabe
    DeviceNotAvailableException if device is not available after reboot

    remountSystemReadOnly

    public abstract void remountSystemReadOnly ()

    Die Systempartition auf dem Gerät schreibgeschützt machen. Das Gerät wird möglicherweise neu gestartet.

    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountSystemWritable

    public abstract void remountSystemWritable ()

    Machen Sie die Systempartition auf dem Gerät beschreibbar. Das Gerät wird möglicherweise neu gestartet.

    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountVendorReadOnly

    public abstract void remountVendorReadOnly ()

    Die Anbieterpartition auf dem Gerät schreibgeschützt machen. Das Gerät wird möglicherweise neu gestartet.

    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountVendorWritable

    public abstract void remountVendorWritable ()

    Machen Sie die Anbieterpartition auf dem Gerät beschreibbar. Das Gerät wird möglicherweise neu gestartet.

    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    runInstrumentationTests

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

    Diese praktische Methode führt ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) mit einem oder mehreren Listenern aus, die als Parameter übergeben werden.

    Parameter
    runner IRemoteAndroidTestRunner: die IRemoteAndroidTestRunner, auf der die Tests ausgeführt werden
    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 Wenn die Verbindung zum Gerät unterbrochen wurde und nicht wiederhergestellt werden kann. Das bedeutet, dass der Testbefehl nicht abgeschlossen und die Wiederherstellung fehlgeschlagen ist.

    runInstrumentationTests

    public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

    Führt Instrumentierungstests aus und bietet die Gerätewiederherstellung.

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

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

    Parameter
    runner IRemoteAndroidTestRunner: die IRemoteAndroidTestRunner, auf der die Tests ausgeführt werden
    listeners : die Testergebnis-Listener
    Returns
    boolean true, wenn der Testbefehl abgeschlossen ist. false, wenn die Ausführung aufgrund einer Ausnahme bei der Gerätekommunikation fehlgeschlagen ist, die Wiederherstellung aber erfolgreich war
    Ausgabe
    DeviceNotAvailableException Wenn die Verbindung zum Gerät unterbrochen wurde und nicht wiederhergestellt werden kann. Das bedeutet, dass der Testbefehl nicht abgeschlossen und die Wiederherstellung fehlgeschlagen ist.

    runInstrumentationTestsAsUser

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

    Entspricht ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)), führt den Test jedoch 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)

    Entspricht ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...), führt den Test jedoch für einen bestimmten Nutzer aus.

    Parameter
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    Returns
    boolean

    Ausgabe
    DeviceNotAvailableException

    setDate

    public abstract void setDate (Date date)

    Das Datum auf dem Gerät wird festgelegt.

    Hinweis: Zum Festlegen des Datums auf dem Gerät ist Root-Zugriff erforderlich.

    Parameter
    date Date: ein bestimmtes Datum angeben; es wird das Datum des Hosts verwendet, wenn null
    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    setOptions

    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 „adb root“ auf „wahr“ gesetzt ist.

    Parameter
    propKey String: Der Schlüssel, der festgelegt werden soll.
    propValue String: Der festzulegende Property-Wert.
    Returns
    boolean gibt True zurück, wenn der Befehl „setprop“ erfolgreich war, andernfalls „False“.
    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    setRecovery

    public abstract void setRecovery (IDeviceRecovery recovery)

    Legen Sie die IDeviceRecovery fest, die für dieses Gerät verwendet werden soll. Sollte festgelegt werden, wenn das Gerät zum ersten Mal zugewiesen wird.

    Parameter
    recovery IDeviceRecovery: die IDeviceRecovery

    setRecoveryMode

    public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

    Hiermit wird festgelegt, welche Wiederherstellungsmethode verwendet werden soll, wenn ein Problem mit der Gerätekommunikation auftritt. Wir empfehlen, diese Methode nur sparsam zu verwenden, wenn sie erforderlich ist (z. B. wenn das Framework ausgefallen ist).

    Parameter
    mode ITestDevice.RecoveryMode: ob der Modus „Nur bis zur Onlinewiederherstellung“ aktiviert sein soll

    setTrackingSerial

    public abstract void setTrackingSerial (String trackingSerial)

    Verfolgen Sie für die Geräteverwaltung die Seriennummer, die wir für die Referenzierung des Geräts verwenden.

    Parameter
    trackingSerial String

    setUseFastbootErase

    public abstract void setUseFastbootErase (boolean useFastbootErase)

    Legen Sie fest, ob Sie „fastboot erase“ oder „fastboot format“ verwenden möchten, um eine Partition auf dem Gerät zu löschen.

    Parameter
    useFastbootErase boolean: true, wenn „fastboot erase“ verwendet werden soll, oder false, wenn „fastboot format“ verwendet werden soll.

    Weitere Informationen

    startLogcat

    public abstract void startLogcat ()

    Starten Sie die Erfassung der Logcat-Ausgabe vom Gerät im Hintergrund.

    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 in einem TF-Aufrufkontext befinden, da das TF-Framework logcat startet und beendet.

    startTradeInModeTesting

    public abstract boolean startTradeInModeTesting (int timeoutMs)

    Testen des Trade-In-Modus aktivieren Das Gerät wird gelöscht und neu gestartet.

    Parameter
    timeoutMs int

    Returns
    boolean „True“, wenn erfolgreich, andernfalls „false“
    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    stopEmulatorOutput

    public abstract void stopEmulatorOutput ()

    Schließen und löschen Sie die Emulatorausgabe.

    stopLogcat

    public abstract void stopLogcat ()

    Die Erfassung der Logcat-Ausgabe vom Gerät wird beendet und die derzeit gespeicherten Logcat-Daten werden verworfen.

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

    stopTradeInModeTesting

    public abstract void stopTradeInModeTesting ()

    Testen des Trade-In-Modus beenden. Das Gerät wird neu gestartet.

    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    switchToAdbTcp

    public abstract String switchToAdbTcp ()

    Stellen Sie das Gerät auf den adb-over-tcp-Modus um.

    Returns
    String die TCP-Seriennummer oder null, wenn das Gerät nicht umgestellt werden konnte
    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    switchToAdbUsb

    public abstract boolean switchToAdbUsb ()

    Stellen Sie das Gerät auf den Modus „adb over USB“ um.

    Returns
    boolean true, wenn die Umstellung erfolgreich war, andernfalls false.
    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    syncFiles

    public abstract boolean syncFiles (File localFileDir, 
                String deviceFilePath)

    Synchronisiert den Inhalt eines lokalen Dateiverzeichnisses mit dem Gerät.

    Entscheidet, welche Dateien gepusht werden sollen, indem Zeitstempel lokaler Dateien mit den entsprechenden Remote-Dateien verglichen werden. Nur neuere oder nicht vorhandene Dateien werden auf das Gerät gepusht. Der Overhead sollte also relativ gering sein, wenn die Datei auf dem Gerät bereits auf dem neuesten Stand ist.

    Ausgeblendete Dateien (mit Namen, die mit einem Punkt beginnen) werden ignoriert.

    Beispiel: Mit syncFiles("/tmp/files", "/sdcard") wird das Verzeichnis „/sdcard/files“ erstellt, falls es noch nicht vorhanden ist, und der Inhalt von „/tmp/files“ wird rekursiv in „/sdcard/files“ kopiert.

    Parameter
    localFileDir File: das lokale Dateiverzeichnis mit Dateien, die rekursiv gepusht werden sollen.
    deviceFilePath String: der absolute Pfad des Remote-Zielorders. Alle Verzeichnisse in diesem Dateipfad müssen lesbar sein. Wenn also adb nicht root ist, schlägt das Übertragen in /data/local/tmp fehl.
    Returns
    boolean true, wenn die Dateien erfolgreich synchronisiert wurden. Andernfalls false.
    Ausgabe
    DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

    unlockDevice

    public abstract boolean unlockDevice ()

    Entsperret das Gerät, wenn es verschlüsselt ist.

    Diese Methode kann das Framework neu starten, ruft aber postBootSetup() nicht auf. Daher ist das Gerät möglicherweise noch nicht vollständig für den Test bereit, wenn diese Methode zurückgegeben wird.

    Returns
    boolean true, wenn der Vorgang erfolgreich war oder das Gerät nicht verschlüsselt ist.
    Ausgabe
    DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.
    UnsupportedOperationException wenn die Verschlüsselung auf dem Gerät nicht unterstützt wird.

    unmountDebugfs

    public abstract void unmountDebugfs ()

    Entfernen Sie die Bereitstellung von debugfs.

    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    waitForBootComplete

    public abstract boolean waitForBootComplete (long timeOut)

    Blockiert, bis das Flag „Boot complete“ des Geräts gesetzt ist.

    Parameter
    timeOut long: Zeit in Millisekunden, die gewartet werden soll, bis das Flag gesetzt wird
    Returns
    boolean „true“, wenn das Flag „Boot complete“ des Geräts innerhalb des Zeitlimits gesetzt wird
    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    waitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable ()

    Wartet, bis das Gerät reagiert und für den Test verfügbar ist. Es wird das Standardzeitlimit verwendet.

    Returns
    boolean „True“, wenn das Gerät verfügbar ist, „False“, wenn die Wiederherstellung deaktiviert und nicht verfügbar ist.
    Ausgabe
    DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

    waitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable (long waitTime)

    Wartet, bis das Gerät reagiert und für den Test 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 if device is still unresponsive after waitTime expires.

    waitForDeviceAvailableInRecoverPath

    public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

    Wartet, bis das Gerät reagiert 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.
    Ausgabe
    DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

    waitForDeviceBootloader

    public abstract void waitForDeviceBootloader ()

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

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

    waitForDeviceInRecovery

    public abstract boolean waitForDeviceInRecovery (long waitTime)

    Verhindert, dass sich das Gerät im Status „adb recovery“ befindet (dies ist nicht dasselbe wie IDeviceRecovery).

    Parameter
    waitTime long: die Wartezeit in ms
    Returns
    boolean true, wenn das Gerät vor Ablauf der Zeit in den Wiederherstellungsmodus startet. false andernfalls

    waitForDeviceInSideload

    public abstract boolean waitForDeviceInSideload (long waitTime)

    Verhindert, dass sich das Gerät im Status „adb sideload“ befindet

    Parameter
    waitTime long: die Wartezeit in ms
    Returns
    boolean true, wenn das Gerät vor Ablauf der Zeit in den Sideload-Modus startet. false andernfalls

    waitForDeviceNotAvailable

    public abstract boolean waitForDeviceNotAvailable (long waitTime)

    Blockiert, dass das Gerät nicht verfügbar ist, d. h. nicht in adb vorhanden ist

    Parameter
    waitTime long: die Wartezeit in ms
    Returns
    boolean true, wenn das Gerät vor Ablauf der Zeit nicht mehr verfügbar ist. false andernfalls

    waitForDeviceOnline

    public abstract void waitForDeviceOnline ()

    Blockiert, bis das Gerät über adb sichtbar ist. Standardzeitlimit wird verwendet

    Das Gerät reagiert nach Abschluss möglicherweise nicht auf Befehle. Verwenden Sie stattdessen waitForDeviceAvailable().

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

    waitForDeviceOnline

    public abstract void waitForDeviceOnline (long waitTime)

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

    Das Gerät reagiert nach Abschluss möglicherweise nicht auf Befehle. Verwenden Sie stattdessen waitForDeviceAvailable().

    Parameter
    waitTime long: die Wartezeit in ms
    Ausgabe
    DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

    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 reagiert, bevor waitTime abgelaufen ist.