INativeDevice

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

Standardwert, wenn die API-Ebene nicht erkannt werden kann

Konstanter Wert: -1 (0xffffffff)

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

clearLogcat

public abstract void clearLogcat ()

Löscht alle angesammelten Logcat-Daten.

Das ist nützlich, wenn Sie sicherstellen möchten, dass ITestDevice.getLogcat() nur Logdaten zurückgibt, die nach einem bestimmten Zeitpunkt erzeugt wurden, z. B. nach dem Flashen eines neuen Geräte-Builds.

deleteFile

public abstract void deleteFile (String deviceFilePath)

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

deleteFile

public abstract void deleteFile (String deviceFilePath, 
                int userId)

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

deviceSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Hilfsmethode zum Prüfen, ob das Gerät durch Vergleich des aktuellen system_server mit dem vorherigen system_server ProcessInfo neu gestartet wurde. Verwende getProcessByName(String) als Zahlungsmethode, um ProcessInfo zu erhalten.

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 seinem TimeUnit neu gestartet wurde. Ein Soft-Restart bezieht sich auf einen Neustart von system_server außerhalb eines Hard-Reboot des Geräts (z. B. ein angeforderter Neustart). Die aktuelle utcEpochTime des Geräts in Millisekunden kann mit der Methode getDeviceDate() abgerufen werden.

disableAdbRoot

public abstract boolean disableAdbRoot ()

Deaktiviert den ADB-Root-Zugriff.

Wenn Sie „adb root“ deaktivieren, kann es sein, dass die Verbindung des Geräts zu ADB getrennt wird. Diese Methode wird blockiert, bis das Gerät verfügbar ist.

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath)

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

enableAdbRoot

public abstract boolean enableAdbRoot ()

Aktiviert den ADB-Root-Zugriff. Wenn die Einstellung „enable-root“ auf „false“ gesetzt ist, wird eine Meldung protokolliert und die Funktion wird beendet, ohne Root zu aktivieren.

Wenn Sie „adb root“ aktivieren, kann es passieren, dass die Verbindung des Geräts zu ADB getrennt wird. Diese Methode wird blockiert, bis das Gerät verfügbar ist.

executeAdbCommand

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

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

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

executeAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

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

executeAdbCommand

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

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

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

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (String... commandArgs)

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

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

executeAdbV2Command

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

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

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

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (long timeout, 
                Map<String, String> envMap, 
                int retryAttempts, 
                String... commandArgs)

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

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

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (long timeout, 
                Map<String, String> envMap, 
                String... commandArgs)

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

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

executeFastbootCommand

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

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

Sollte verwendet werden, wenn sich das Gerät bereits im Schnellstartmodus befindet.

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

Sollte verwendet werden, wenn sich das Gerät bereits im Schnellstartmodus befindet.

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

Identisch mit executeFastbootCommand(String...), verwendet jedoch ein längeres Zeitlimit.

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (Map<String, String> envVarMap, 
                String... commandArgs)

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

Identisch mit executeFastbootCommand(String...), verwendet jedoch ein längeres Zeitlimit.

executeShellCommand

public abstract String executeShellCommand (String command)

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

executeShellCommand

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

Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Führt den angegebenen ADB-Shell-Befehl aus und versucht es mehrmals, wenn der Befehl fehlschlägt.

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

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 zur Steuerung des Befehlsverhaltens aus.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command)

Hilfsmethode, die einen ADB-Shell-Befehl ausführt und die Ergebnisse als CommandResult zurückgibt, die mit der Befehlsstatusausgabe, stdout und stderr gefüllt ist.

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 zur Steuerung des Befehlsverhaltens aus.

executeShellV2Command

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

Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.

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 mit der Befehlsstatusausgabe, stdout und stderr gefüllt ist.

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

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 zur Steuerung des Befehlsverhaltens aus.

executeShellV2Command

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

Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.

executeShellV2Command

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

Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                IShellOutputReceiver receiver)

Hilfsmethode, die einen ADB-Shell-Befehl ausführt und die Ergebnisse als CommandResult zurückgibt, die mit der Befehlsstatusausgabe, stdout und stderr gefüllt ist.

fastbootOemRamdumpNow

public abstract CommandResult fastbootOemRamdumpNow ()

Hilfsmethode, die einen RAM-Dump über den Fastboot-Modus auslöst.

Bei dieser Methode wird der Befehl „oem ramdump now“ ausgeführt. Im Gegensatz zu ERROR(/#executeFastbootCommand()) werden keine Wiederholungen oder Geräte-Recovery-Versuche unternommen, wenn der Befehl fehlschlägt oder der Status ungültig ist, da ein Geräteabsturz das beabsichtigte Ergebnis ist. Sollte verwendet werden, wenn sich das Gerät bereits im Schnellstartmodus befindet.

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

Helper-Methode, mit der eine Partition für das Gerät gelöscht wird.

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

Sollte verwendet werden, wenn sich das Gerät bereits im Schnellstartmodus befindet.

getApiLevel

public abstract int getApiLevel ()

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

getApiLevelFull

public abstract int getApiLevelFull ()

Ähnlich wie getApiLevel(), gibt aber die vollständige Version zurück.

getBasebandVersion

public abstract String getBasebandVersion ()

Einfache Methode zum Abrufen der Baseband-Version (Funkmodul) dieses Geräts. Das Abrufen der Funkversion ist gerätespezifisch. Daher werden möglicherweise nicht für alle Geräte die richtigen Informationen zurückgegeben. Diese Methode basiert auf der Eigenschaft „gsm.version.baseband“, um die korrekten Versionsinformationen zurückzugeben. Diese Angabe ist für einige CDMA-Geräte nicht korrekt und die hier zurückgegebene Version stimmt möglicherweise nicht mit der Version überein, die von Fastboot gemeldet wird. Außerdem wird möglicherweise nicht die Version für die CDMA-Funkschnittstelle zurückgegeben. Kurz gesagt: Mit dieser Methode wird nur dann eine genaue Version zurückgegeben, wenn die Eigenschaft „gsm.version.baseband“ mit der von fastboot getvar version-baseband zurückgegebenen Version übereinstimmt.

getBattery

public abstract Integer getBattery ()

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

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

Gibt den booleschen Wert der angegebenen Property zurück.

getBootHistory

public abstract Map<Long, String> getBootHistory ()

Die Hilfsmethode erfasst die Bootverlaufskarte mit Bootzeit und Bootgrund.

getBootHistorySince

public abstract Map<Long, String> getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

getBootloaderVersion

public abstract String getBootloaderVersion ()

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

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

getBuildAlias

public abstract String getBuildAlias ()

Rufen Sie 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 Nummer für Nexus-Builds). Beispiel: Der finale Release von Android 4.2 hat den Build-Alias JDQ39 und die Build-ID 573038.

getBuildFlavor

public abstract String getBuildFlavor ()

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

getBuildId

public abstract String getBuildId ()

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

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

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

Android-Geräte werden in der Regel mit Testschlüsseln (wie in AOSP) oder Releaseschlüsseln (die von den einzelnen Geräteherstellern verwaltet werden) signiert.

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

getChildren

public abstract String[] getChildren (String deviceFilePath)

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

getConnection

public abstract AbstractConnection getConnection ()

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

getDeviceClass

public abstract String getDeviceClass ()

Geräteklasse abrufen

getDeviceDate

public abstract long getDeviceDate ()

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

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

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

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

getDeviceState

public abstract TestDeviceState getDeviceState ()

Gerätestatus abrufen

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

Helper zum Abrufen der Zeitdifferenz zwischen dem Gerät und einem bestimmten Date. Verwenden Sie intern die Epoch-Zeit.

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

Stream von Emulator-stdout und -stderr abrufen

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

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

getFastbootProductType

public abstract String getFastbootProductType ()

Bequeme Methode zum Abrufen des Produkttyps dieses Geräts im Fastboot-Modus.

Diese Methode sollte nur verwendet werden, wenn sich das Gerät im Fastboot-Modus befinden soll. Sie ist in diesem Fall etwas sicherer als die generische getProductType()-Methode, da ITestDevice weiß, wie das Gerät in den Fastboot-Modus versetzt wird, wenn es sich im falschen Status befindet oder nicht reagiert.

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

Bequeme Methode zum Abrufen des Produkttyps dieses Geräts im Fastboot-Modus.

Diese Methode sollte nur verwendet werden, wenn sich das Gerät im Fastboot-Modus befinden soll. Sie ist in diesem Fall etwas sicherer als die generische getProductType()-Methode, da ITestDevice weiß, wie das Gerät in den Fastboot-Modus versetzt wird, wenn es sich im falschen Status befindet oder nicht reagiert.

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

Gibt die Seriennummer im Fastboot-Modus zurück.

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

Ruft den angegebenen Fastboot-Variablenwert vom Gerät ab.

getFileEntry

public abstract IFileEntry getFileEntry (String path)

Eine Referenz auf eine Remotedatei auf dem Gerät abrufen

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 ein neuer IDevice zugewiesen werden. Aufrufer sollten daher keinen Verweis auf IDevice beibehalten, da dieser Verweis möglicherweise veraltet ist.

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

Gibt den Ganzzahlwert der angegebenen Eigenschaft des Geräts zurück.

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

Gibt die letzte Zeit zurück, zu der Tradefed-APIs einen Neustart ausgelöst haben, in Millisekunden seit EPOCH, wie von System.currentTimeMillis() zurückgegeben.

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

Ruft das API-Level des Geräts bei der ersten Markteinführung ab. Die Standardeinstellung ist UNKNOWN_API_LEVEL.

getLogcat

public abstract InputStreamSource getLogcat ()

Erstellt einen Snapshot-Stream der logcat-Daten.

Funktioniert in zwei Modi:

getLogcat

public abstract InputStreamSource getLogcat (int maxBytes)

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

Nützlich, wenn Sie häufig Snapshots der erfassten logcat-Daten erstellen möchten, ohne den potenziell großen Speicherplatzbedarf des gesamten getLogcat()-Snapshots in Kauf zu nehmen.

getLogcatDump

public abstract InputStreamSource getLogcatDump ()

Rufen Sie einen Dump des aktuellen Logcat für das Gerät ab. 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.

getLogcatSince

public abstract InputStreamSource getLogcatSince (long date)

Ruft einen Snapshot-Stream der erfassten logcat-Daten ab, beginnend mit dem angegebenen Datum. Die Zeit auf dem Gerät sollte getDeviceDate() verwendet werden.

getMountPoint

public abstract String getMountPoint (String mountName)

Gibt einen Bereitstellungspunkt zurück.

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

AUFGABE: Dieses Verhalten zu IDevice.getMountPoint(String) verschieben

getMountPointInfo

public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

Gibt ein MountPointInfo zurück, das dem angegebenen Mountpoint-Pfad entspricht, oder null, wenn für diesen Pfad nichts gemountet ist oder er anderweitig nicht als Mountpoint in /proc/mounts angezeigt wird.

getMountPointInfo

public abstract List<ITestDevice.MountPointInfo> getMountPointInfo ()

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

getPartitionFreeSpace

public abstract long getPartitionFreeSpace (String partition)

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

getProcessByName

public abstract ProcessInfo getProcessByName (String processName)

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

getProcessPid

public abstract String getProcessPid (String process)

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

getProductType

public abstract String getProductType ()

Bequeme Methode zum Abrufen des Produkttyps dieses Geräts.

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

getProductVariant

public abstract String getProductVariant ()

Bequeme Methode zum Abrufen der Produktvariante dieses Geräts.

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

getProperty

public abstract String getProperty (String name)

Ruft den angegebenen Attributwert vom Gerät ab.

getRecoveryMode

public abstract ITestDevice.RecoveryMode getRecoveryMode ()

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

getSerialNumber

public abstract String getSerialNumber ()

Bequeme Methode zum Abrufen der Seriennummer dieses Geräts.

getTombstones

public abstract List<File> getTombstones ()

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

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

getTotalMemory

public abstract long getTotalMemory ()

Gibt die Gesamtgröße des physischen Speichers in Byte zurück oder -1 im Falle eines internen Fehlers.

getTrackingSerial

public String getTrackingSerial ()

Rufen Sie die Seriennummer ab, die zum Verfolgen des Geräts verwendet wird.

getUseFastbootErase

public abstract boolean getUseFastbootErase ()

Gibt an, ob zum Löschen einer Partition auf dem Gerät „fastboot erase“ oder „fastboot format“ verwendet werden soll.

isAdbRoot

public abstract boolean isAdbRoot ()

isAdbTcp

public abstract boolean isAdbTcp ()

isAppEnumerationSupported

public abstract boolean isAppEnumerationSupported ()

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

isBypassLowTargetSdkBlockSupported

public abstract boolean isBypassLowTargetSdkBlockSupported ()

Prüfen, ob die Plattform auf dem Gerät das Umgehen der Blockierung aufgrund des niedrigen Ziel-SDK bei der App-Installation unterstützt

isDebugfsMounted

public abstract boolean isDebugfsMounted ()

Prüfen Sie, ob „debugfs“ gemountet ist.

isDeviceEncrypted

public abstract boolean isDeviceEncrypted ()

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

isDirectory

public abstract boolean isDirectory (String deviceFilePath)

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

isEncryptionSupported

public abstract boolean isEncryptionSupported ()

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

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“.

isHeadless

public abstract boolean isHeadless ()

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

isRuntimePermissionSupported

public abstract boolean isRuntimePermissionSupported ()

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

isStateBootloaderOrFastbootd

public abstract boolean isStateBootloaderOrFastbootd ()

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

logAnrs

public abstract boolean logAnrs (ITestLogger logger)

Erfasst und protokolliert ANR-Fehler vom Gerät.

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 keine Ausnahme auslöst, wenn die Protokollierung fehlschlägt.

mountDebugfs

public abstract void mountDebugfs ()

debugfs bereitstellen.

nonBlockingReboot

public abstract void nonBlockingReboot ()

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

postBootSetup

public abstract void postBootSetup ()

Führen Sie die Anleitung aus, um das Gerät nach jedem Booten für Tests zu konfigurieren.

Sollte aufgerufen werden, nachdem das Gerät vollständig hochgefahren wurde

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

Der Aufruf ist möglicherweise erforderlich, wenn das Gerät aufgrund anderer Ereignisse neu gestartet wird, z. B. wenn ein Fastboot-Updatebefehl abgeschlossen wurde.

postInvocationTearDown

public void postInvocationTearDown ()

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

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

postInvocationTearDown

public abstract void postInvocationTearDown (Throwable invocationException)

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

preInvocationSetup

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

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

pullDir

public abstract boolean pullDir (String deviceFilePath, 
                File localDir)

Verzeichnisinhalte rekursiv vom Gerät abrufen.

pullDir

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

Verzeichnisinhalte rekursiv vom Gerät abrufen.

pullDir

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

Verzeichnisinhalte rekursiv vom Gerät abrufen.

pullFile

public abstract File pullFile (String remoteFilePath, 
                int userId)

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

pullFile

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

Ruft eine Datei vom Gerät ab.

pullFile

public abstract File pullFile (String remoteFilePath)

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

pullFile

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

Ruft eine Datei vom Gerät ab.

pullFile

public abstract boolean pullFile (String remoteFilePath, 
                File localFile)

Ruft eine Datei vom Gerät ab.

pullFileContents

public abstract String pullFileContents (String remoteFilePath)

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

pullFileFromExternal

public abstract File pullFileFromExternal (String remoteFilePath)

Eine Hilfsmethode zum Abrufen einer Datei aus dem externen Speicher des Geräts, die sie in einem lokalen temporären File speichert und eine Referenz auf dieses File zurückgibt.

pushDir

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

Verzeichnisinhalte rekursiv auf das Gerät übertragen.

pushDir

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

Verzeichnisinhalte rekursiv auf das Gerät übertragen, wobei einige gefilterte Verzeichnisse ausgeschlossen werden.

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath)

Verzeichnisinhalte rekursiv auf das Gerät übertragen.

pushFile

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

Eine Datei auf ein Gerät übertragen Standardmäßig wird ein Contentanbieter verwendet.

pushFile

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

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

pushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath)

Eine Datei auf ein Gerät übertragen Standardmäßig wird ein Contentanbieter verwendet.

pushString

public abstract boolean pushString (String contents, 
                String deviceFilePath)

Aus einem String erstellte Datei an ein Gerät senden

neu starten

public abstract void reboot ()

Startet das Gerät im ADB-Modus neu.

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

neu starten

public abstract void reboot (String reason)

Startet das Gerät im ADB-Modus neu. Der angegebene reason wird beim Neustart beibehalten.

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

Der Grund für den letzten Neustart kann durch Abfragen des Attributs sys.boot.reason abgerufen werden.

neu starten

public String reboot (String command, 
                String reason)

Startet das Gerät mit dem angegebenen command neu.

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

Der Grund für den letzten Neustart kann durch Abfragen des Attributs sys.boot.reason abgerufen werden.

rebootIntoBootloader

public abstract void rebootIntoBootloader ()

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

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

rebootIntoFastbootd

public abstract void rebootIntoFastbootd ()

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

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

rebootIntoRecovery

public abstract void rebootIntoRecovery ()

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

Blöcke, bis das Gerät in den Wiederherstellungsmodus wechselt

rebootIntoSideload

public abstract void rebootIntoSideload (boolean autoReboot)

Das Gerät wird im ADB-Sideload-Modus neu gestartet. Das ist ein spezieller Modus unter „Recovery“.

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

rebootIntoSideload

public abstract void rebootIntoSideload ()

Das Gerät wird im ADB-Sideload-Modus neu gestartet. Das ist ein spezieller Modus unter „Recovery“.

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

rebootUntilOnline

public abstract void rebootUntilOnline ()

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

rebootUntilOnline

public abstract void rebootUntilOnline (String reason)

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

rebootUserspace

public abstract void rebootUserspace ()

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

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

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

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.

remountSystemReadOnly

public abstract void remountSystemReadOnly ()

Die Systempartition auf dem Gerät schreibgeschützt machen. Möglicherweise muss das Gerät neu gestartet werden.

remountSystemWritable

public abstract void remountSystemWritable ()

Machen Sie die Systempartition auf dem Gerät beschreibbar. Möglicherweise muss das Gerät neu gestartet werden.

remountVendorReadOnly

public abstract void remountVendorReadOnly ()

Machen Sie die Anbieterpartition auf dem Gerät schreibgeschützt. Möglicherweise muss das Gerät neu gestartet werden.

remountVendorWritable

public abstract void remountVendorWritable ()

Machen Sie die Anbieterpartition auf dem Gerät beschreibbar. Möglicherweise muss das Gerät neu gestartet werden.

runInstrumentationTests

public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                Collection<ITestLifeCycleReceiver> listeners)

Führt Instrumentierungstests aus und bietet die Möglichkeit zur Geräte-Wiederherstellung.

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

Wenn die Verbindung zum Gerät verloren geht, bevor der Testlauf abgeschlossen ist, und die Wiederherstellung fehlschlägt, werden alle Listener über „testRunFailed“ informiert und „DeviceNotAvailableException“ wird ausgelöst.

runInstrumentationTests

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

Bequeme Methode zum Ausführen von runInstrumentationTests(IRemoteAndroidTestRunner,Collection) mit einem oder mehreren Listenern, die als Parameter übergeben werden.

runInstrumentationTestsAsUser

public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                Collection<ITestLifeCycleReceiver> listeners)

Wie ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,Collection), führt den Test jedoch für den angegebenen Nutzer aus.

runInstrumentationTestsAsUser

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

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

setDate

public abstract void setDate (Date date)

Legt das Datum auf dem Gerät fest

Hinweis: Das Festlegen des Datums auf dem Gerät erfordert Root-Zugriff.

setOptions

public abstract void setOptions (TestDeviceOptions options)

TestDeviceOptions für das Gerät festlegen

setProperty

public abstract boolean setProperty (String propKey, 
                String propValue)

Legt den angegebenen Eigenschaftswert auf dem Gerät fest. Erfordert, dass „adb root“ auf „true“ gesetzt ist.

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.

setRecoveryMode

public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

Legt den aktuellen Wiederherstellungsmodus fest, der für das Gerät verwendet werden soll.

Wird verwendet, um zu steuern, welche Wiederherstellungsmethode verwendet werden soll, wenn ein Problem bei der Gerätekommunikation auftritt. Wir empfehlen, diese Methode nur sparsam zu verwenden, wenn sie erforderlich ist (z. B. wenn das Framework nicht funktioniert).

setTrackingSerial

public abstract void setTrackingSerial (String trackingSerial)

Zur Geräteverwaltung wird die Seriennummer erfasst, die wir zur Referenzierung des Geräts verwenden.

setUseFastbootErase

public abstract void setUseFastbootErase (boolean useFastbootErase)

Legen Sie fest, ob zum Löschen einer Partition auf dem Gerät „fastboot erase“ oder „fastboot format“ verwendet werden soll.

startLogcat

public abstract void startLogcat ()

Logcat-Ausgabe vom Gerät im Hintergrund erfassen.

Hat keine Auswirkungen, wenn die logcat-Ausgabe bereits erfasst wird. 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)

Aktivieren Sie den Testmodus für die Inzahlungnahme. Das Gerät wird zurückgesetzt und neu gestartet.

stopEmulatorOutput

public abstract void stopEmulatorOutput ()

Schließen Sie die Emulatorausgabe und löschen Sie sie.

stopLogcat

public abstract void stopLogcat ()

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

Hat keine Auswirkungen, wenn keine logcat-Ausgabe erfasst wird.

stopTradeInModeTesting

public abstract void stopTradeInModeTesting ()

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

switchToAdbTcp

public abstract String switchToAdbTcp ()

Gerät in den ADB-over-TCP-Modus versetzen.

switchToAdbUsb

public abstract boolean switchToAdbUsb ()

Schalten Sie das Gerät in den ADB-over-USB-Modus.

syncFiles

public abstract boolean syncFiles (File localFileDir, 
                String deviceFilePath)

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

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

Ausgeblendete Dateien (deren Namen mit „.“ beginnen) werden ignoriert.

Beispiel für die Verwendung: 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“ übertragen.

unlockDevice

public abstract boolean unlockDevice ()

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

unmountDebugfs

public abstract void unmountDebugfs ()

debugfs trennen.

waitForBootComplete

public abstract boolean waitForBootComplete (long timeOut)

Blockiert, bis das Boot-Complete-Flag des Geräts gesetzt ist.

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable ()

Wartet, bis das Gerät reagiert und für Tests verfügbar ist. Standard-Zeitlimit wird verwendet.

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable (long waitTime)

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

waitForDeviceAvailableInRecoverPath

public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

waitForDeviceBootloader

public abstract void waitForDeviceBootloader ()

Wird blockiert, bis das Gerät über Fastboot sichtbar ist. Standard-Zeitlimit verwenden

waitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

Sperrt das Gerät, wenn es sich im Status „adb recovery“ befindet. Dieser Status unterscheidet sich von IDeviceRecovery.

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

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

waitForDeviceNotAvailable

public abstract boolean waitForDeviceNotAvailable (long waitTime)

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

waitForDeviceOnline

public abstract void waitForDeviceOnline ()

Wird blockiert, bis das Gerät über ADB sichtbar ist. Standard-Zeitlimit wird verwendet

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

waitForDeviceOnline

public abstract void waitForDeviceOnline (long waitTime)

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

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

waitForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

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