Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice


Fornisce un'API affidabile e di livello leggermente superiore a un IDevice IDevice .

Riprova i comandi del dispositivo per un importo configurabile e fornisce un'interfaccia di ripristino del dispositivo per i dispositivi che non rispondono.

Riepilogo

Costanti

int UNKNOWN_API_LEVEL

Valore predefinito quando non è possibile rilevare il livello API

Metodi pubblici

abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Controlla se una funzionalità è attualmente supportata o meno dato un livello minimamente supportato.

abstract void clearLogcat ()

Elimina tutti i dati logcat accumulati.

abstract void deleteFile (String deviceFilePath)

Metodo di supporto per eliminare un file o una directory sul dispositivo.

abstract boolean deviceSoftRestarted ( ProcessInfo prevSystemServerProcess)

Metodo di supporto per verificare se il dispositivo è stato riavviato in modo software confrontando il server_sistema corrente con il server_sistema precedente ProcessInfo .

abstract boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)

Metodo di supporto per verificare se il dispositivo è stato riavviato in modo graduale dall'ora UTC dall'epoca dal dispositivo e dal relativo ERROR(/TimeUnit) .

abstract boolean disableAdbRoot ()

Disattiva adb root.

abstract boolean doesFileExist (String deviceFilePath)

Metodo di supporto per determinare se il file esiste sul dispositivo.

abstract boolean enableAdbRoot ()

Attiva adb root.

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

Metodo di supporto che esegue un comando adb come comando di sistema con un timeout specificato.

abstract String executeAdbCommand (String... commandArgs)

Metodo di supporto che esegue un comando adb come comando di sistema.

abstract CommandResult executeFastbootCommand (String... commandArgs)

Metodo di supporto che esegue un comando di avvio rapido come comando di sistema con un timeout predefinito di 2 minuti.

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

Metodo di supporto che esegue un comando di avvio rapido come comando di sistema.

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

Metodo di supporto che esegue un comando di avvio rapido di lunga durata come comando di sistema con variabili di ambiente di sistema.

abstract CommandResult executeLongFastbootCommand (String... commandArgs)

Metodo di supporto che esegue un comando di avvio rapido di lunga durata come comando di sistema.

abstract String executeShellCommand (String command)

Metodo di supporto che esegue un comando adb shell e restituisce l'output come String .

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

Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.

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

Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.

abstract void executeShellCommand (String command, IShellOutputReceiver receiver)

Esegue il comando adb shell fornito, riprovando più volte se il comando non riesce.

abstract CommandResult executeShellV2Command (String command)

Metodo di supporto che esegue un comando adb shell e restituisce i risultati come CommandResult correttamente popolato con l'output dello stato del comando, stdout e stderr.

abstract CommandResult executeShellV2Command (String command, OutputStream pipeToOutput)

Metodo di supporto che esegue un comando adb shell e restituisce i risultati come CommandResult correttamente popolato con l'output dello stato del comando e stderr.

abstract CommandResult executeShellV2Command (String command, File pipeAsInput)

Metodo di supporto che esegue un comando adb shell e restituisce i risultati come CommandResult correttamente popolato con l'output dello stato del comando, stdout e stderr.

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

Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.

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

Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.

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

Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.

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

Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.

abstract CommandResult fastbootWipePartition (String partition)

Metodo di supporto che cancella una partizione per il dispositivo.

abstract int getApiLevel ()

Ottieni il livello API del dispositivo.

abstract String getBasebandVersion ()

Metodo pratico per ottenere la versione in banda base (radio) di questo dispositivo.

abstract Integer getBattery ()

Restituisce il livello della batteria corrente di un dispositivo o Null se il livello della batteria non è disponibile.

abstract boolean getBooleanProperty (String name, boolean defaultValue)

Restituisce il valore booleano della proprietà data.

abstract getBootHistory ()

Il metodo di supporto raccoglie la mappa della cronologia di avvio con il tempo di avvio e il motivo di avvio.

abstract getBootHistorySince (long utcEpochTime, TimeUnit timeUnit)

Il metodo helper raccoglie la mappa della cronologia di avvio con l'ora di avvio e il motivo di avvio dall'ora specificata dall'epoca dal dispositivo e dall'unità di tempo specificata.

abstract String getBootloaderVersion ()

Metodo pratico per ottenere la versione bootloader di questo dispositivo.

abstract InputStreamSource getBugreport ()

Recupera una segnalazione di bug dal dispositivo.

abstract InputStreamSource getBugreportz ()

Recupera un bugreportz dal dispositivo.

abstract String getBuildAlias ()

Recupera l'alias della build attualmente in esecuzione sul dispositivo.

abstract String getBuildFlavor ()

Recupera la versione di build per il dispositivo.

abstract String getBuildId ()

Recupera la build attualmente in esecuzione sul dispositivo.

abstract String getBuildSigningKeys ()

Restituisce il tipo di chiave utilizzato per firmare l'immagine del dispositivo

In genere i dispositivi Android possono essere firmati con chiavi di test (come in AOSP) o chiavi di rilascio (controllate dai singoli produttori di dispositivi)

abstract DeviceDescriptor getCachedDeviceDescriptor ()

Restituisce un DeviceDescriptor memorizzato nella cache se il dispositivo è allocato, altrimenti restituisce il DeviceDescriptor corrente.

abstract String[] getChildren (String deviceFilePath)

Alternativa all'utilizzo di IFileEntry che a volte non funziona a causa delle autorizzazioni.

abstract String getDeviceClass ()

Ottieni la classe del dispositivo.

abstract long getDeviceDate ()

Restituisce la data del dispositivo in millisecondi dall'epoca.

abstract DeviceDescriptor getDeviceDescriptor ()

Restituisce un DeviceDescriptor dalle informazioni sul dispositivo per ottenere informazioni su di esso senza passare l'oggetto dispositivo effettivo.

abstract TestDeviceState getDeviceState ()

Ottieni lo stato del dispositivo.

abstract long getDeviceTimeOffset (Date date)

Helper per ottenere la differenza di orario tra il dispositivo e un dato ERROR(/Date) .

abstract InputStreamSource getEmulatorOutput ()

Ottieni il flusso dell'emulatore stdout e stderr

abstract long getExternalStoreFreeSpace ()

Metodo di supporto per determinare la quantità di spazio libero sulla memoria esterna del dispositivo.

abstract String getFastbootProductType ()

Metodo pratico per ottenere il tipo di prodotto di questo dispositivo quando è in modalità di avvio rapido.

abstract String getFastbootProductVariant ()

Metodo pratico per ottenere il tipo di prodotto di questo dispositivo quando è in modalità di avvio rapido.

abstract String getFastbootSerialNumber ()

Restituisce il numero di serie della modalità di avvio rapido.

abstract String getFastbootVariable (String variableName)

Recupera il valore della variabile di avvio rapido specificato dal dispositivo.

abstract IFileEntry getFileEntry (String path)

Recupera un riferimento a un file remoto sul dispositivo.

abstract IDevice getIDevice ()

Restituisce un riferimento all'IDevice IDevice associato.

abstract long getIntProperty (String name, long defaultValue)

Restituisce il valore intero della proprietà data dal dispositivo.

abstract long getLastExpectedRebootTimeMillis ()

Restituisce l'ultima volta che le API Tradefed hanno attivato un riavvio in millisecondi da EPOCH come restituito da System.currentTimeMillis() .

abstract int getLaunchApiLevel ()

Ottieni il primo livello API avviato del dispositivo.

abstract InputStreamSource getLogcat ()

Afferra un flusso di snapshot dei dati logcat.

abstract InputStreamSource getLogcat (int maxBytes)

Afferra un flusso di snapshot degli ultimi maxBytes di dati logcat acquisiti.

abstract InputStreamSource getLogcatDump ()

Ottieni un dump del logcat corrente per il dispositivo.

abstract InputStreamSource getLogcatSince (long date)

Afferra un flusso di snapshot dei dati logcat acquisiti a partire dalla data fornita.

abstract String getMountPoint (String mountName)

Restituisce un punto di montaggio.

abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

Restituisce un MountPointInfo corrispondente al percorso del punto di montaggio specificato o null se il percorso non ha nulla montato o altrimenti non viene visualizzato in /proc/mounts come punto di montaggio.

abstract getMountPointInfo ()

Restituisce una versione analizzata delle informazioni in /proc/mounts sul dispositivo

abstract long getPartitionFreeSpace (String partition)

Metodo di supporto per determinare la quantità di spazio libero sulla partizione del dispositivo.

abstract ProcessInfo getProcessByName (String processName)

Il metodo di supporto esegue il comando "pidof" e "stat" e restituisce l'oggetto ProcessInfo con il PID e l'ora di inizio del processo del processo specificato.

abstract String getProcessPid (String process)

Restituisce il pid del servizio o null se qualcosa è andato storto.

abstract String getProductType ()

Metodo pratico per ottenere il tipo di prodotto di questo dispositivo.

abstract String getProductVariant ()

Metodo pratico per ottenere la variante di prodotto di questo dispositivo.

abstract String getProperty (String name)

Recupera il valore della proprietà specificato dal dispositivo.

abstract ITestDevice.RecoveryMode getRecoveryMode ()

Ottieni la modalità di ripristino corrente utilizzata per il dispositivo.

abstract String getSerialNumber ()

Metodo pratico per ottenere il numero di serie di questo dispositivo.

abstract getTombstones ()

Recupera e restituisci l'elenco delle lapidi dai dispositivi.

abstract long getTotalMemory ()

Restituisce la dimensione totale della memoria fisica in byte o -1 in caso di errore interno

abstract boolean getUseFastbootErase ()

Scopri se utilizzare la cancellazione rapida o il formato di avvio rapido per cancellare una partizione sul dispositivo.

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

Verifica se la piattaforma sul dispositivo supporta l'enumerazione delle app

abstract boolean isDeviceEncrypted ()

Restituisce se il dispositivo è crittografato.

abstract boolean isDirectory (String deviceFilePath)

Restituisce True se il percorso sul dispositivo è una directory, false in caso contrario.

abstract boolean isEncryptionSupported ()

Restituisce se la crittografia è supportata sul dispositivo.

abstract boolean isExecutable (String fullPath)

Restituisce True se il percorso del file sul dispositivo è un file eseguibile, false in caso contrario.

abstract boolean isHeadless ()

Restituisce true se il dispositivo è headless (senza schermo), false in caso contrario.

abstract boolean isRuntimePermissionSupported ()

Verifica se la piattaforma sul dispositivo supporta la concessione di autorizzazioni di runtime

abstract boolean isStateBootloaderOrFastbootd ()

Restituisce true se il dispositivo è in TestDeviceState#FASTBOOT o TestDeviceState.FASTBOOTD .

abstract boolean logAnrs ( ITestLogger logger)

Raccoglie e registra gli ANR dal dispositivo.

abstract boolean logBugreport (String dataName, ITestLogger listener)

Metodo di supporto per prendere una segnalazione di bug e registrarla ai giornalisti.

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

Registra un messaggio nel logcat del dispositivo.

abstract void nonBlockingReboot ()

Emette un comando per riavviare il dispositivo e ritorna al comando completo e quando il dispositivo non è più visibile ad adb.

abstract void postBootSetup ()

Eseguire le istruzioni per configurare il dispositivo per testarlo dopo ogni avvio.

default void postInvocationTearDown ()

Questo metodo è deprecato. Usa postInvocationTearDown(Throwable) .

abstract void postInvocationTearDown (Throwable invocationException)

Passaggi aggiuntivi per la pulizia specifica del dispositivo richiesta che verrà eseguita al termine della chiamata.

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

Passaggi aggiuntivi per la configurazione richiesta specifica del dispositivo che verrà eseguita sul dispositivo prima del flusso di chiamata.

abstract boolean pullDir (String deviceFilePath, File localDir)

Estrarre ricorsivamente il contenuto della directory dal dispositivo.

abstract File pullFile (String remoteFilePath, int userId)

Recupera un file dal dispositivo, lo archivia in un ERROR(/File) temporaneo locale e lo restituisce File .

abstract File pullFile (String remoteFilePath)

Recupera un file dal dispositivo, lo archivia in un ERROR(/File) temporaneo locale e lo restituisce File .

abstract boolean pullFile (String remoteFilePath, File localFile)

Recupera un file dal dispositivo.

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

Recupera un file dal dispositivo.

abstract String pullFileContents (String remoteFilePath)

Recupera un file dal dispositivo e ne restituisce il contenuto.

abstract File pullFileFromExternal (String remoteFilePath)

Un metodo pratico per recuperare un file dalla memoria esterna del dispositivo, archiviarlo in un ERROR(/File) temporaneo locale e restituire un riferimento a quel File .

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

Invia ricorsivamente il contenuto della directory al dispositivo escludendo alcune directory filtrate.

abstract boolean pushDir (File localDir, String deviceFilePath)

Invia ricorsivamente il contenuto della directory al dispositivo.

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

Variante di pushFile(File, String) che può opzionalmente valutare la necessità del provider di contenuti.

abstract boolean pushFile (File localFile, String deviceFilePath)

Invia un file al dispositivo.

abstract boolean pushString (String contents, String deviceFilePath)

File push creato da una stringa al dispositivo

abstract void reboot ()

Riavvia il dispositivo in modalità adb.

abstract void reboot (String reason)

Riavvia il dispositivo in modalità adb con un determinato reason per essere mantenuto durante il riavvio.

abstract void rebootIntoBootloader ()

Riavvia il dispositivo in modalità bootloader.

abstract void rebootIntoFastbootd ()

Riavvia il dispositivo in modalità di avvio rapido.

abstract void rebootIntoRecovery ()

Riavvia il dispositivo in modalità di ripristino adb.

abstract void rebootIntoSideload (boolean autoReboot)

Riavvia il dispositivo in modalità adb sideload (notare che questa è una modalità speciale in fase di ripristino)

Si blocca fino a quando il dispositivo non entra in modalità sideload

abstract void rebootIntoSideload ()

Riavvia il dispositivo in modalità adb sideload (notare che questa è una modalità speciale in fase di ripristino)

Si blocca fino a quando il dispositivo non entra in modalità sideload

abstract void rebootUntilOnline ()

Un'alternativa a reboot() che si blocca solo fino a quando il dispositivo non è online, ovvero visibile ad adb.

abstract void rebootUntilOnline (String reason)

Un'alternativa a reboot() che si blocca solo fino a quando il dispositivo non è online, ovvero visibile ad adb.

abstract void rebootUserspace ()

Riavvia solo la parte dello spazio utente del dispositivo.

abstract void rebootUserspaceUntilOnline ()

Un'alternativa a rebootUserspace() ()} che si blocca solo fino a quando il dispositivo non è online, ovvero visibile ad adb.

abstract void remountSystemWritable ()

Rendi scrivibile la partizione di sistema sul dispositivo.

abstract void remountVendorWritable ()

Rendi scrivibile la partizione del fornitore sul dispositivo.

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

Metodo pratico per eseguire ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) con uno o più listener passati come parametri.

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

Esegue i test della strumentazione e fornisce il ripristino del dispositivo.

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

Uguale a ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) ma esegue il test per un determinato utente.

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

Come ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) ma esegue il test per l'utente dato.

abstract void setDate (Date date)

Imposta la data sul dispositivo

Nota: l'impostazione della data sul dispositivo richiede il root

abstract void setOptions ( TestDeviceOptions options)

Impostare TestDeviceOptions per il dispositivo

abstract boolean setProperty (String propKey, String propValue)

Imposta il valore della proprietà specificato sul dispositivo.

abstract void setRecovery ( IDeviceRecovery recovery)

Imposta IDeviceRecovery da utilizzare per questo dispositivo.

abstract void setRecoveryMode ( ITestDevice.RecoveryMode mode)

Imposta la modalità di ripristino corrente da utilizzare per il dispositivo.

abstract void setUseFastbootErase (boolean useFastbootErase)

Imposta se utilizzare la cancellazione rapida o il formato di avvio rapido per cancellare una partizione sul dispositivo.

abstract void startLogcat ()

Inizia a catturare l'output logcat dal dispositivo in background.

abstract void stopEmulatorOutput ()

Chiudi ed elimina l'output dell'emulatore.

abstract void stopLogcat ()

Interrompi l'acquisizione dell'output logcat dal dispositivo ed elimina i dati logcat attualmente salvati.

abstract String switchToAdbTcp ()

Passa il dispositivo alla modalità adb-over-tcp.

abstract boolean switchToAdbUsb ()

Passa al dispositivo in modalità adb su USB.

abstract boolean syncFiles (File localFileDir, String deviceFilePath)

Sincronizza in modo incrementale il contenuto di una directory di file locale sul dispositivo.

abstract Bugreport takeBugreport ()

Prendi un bugreport e lo restituisce all'interno di un oggetto Bugreport per gestirlo.

abstract boolean unlockDevice ()

Sblocca il dispositivo se il dispositivo è in uno stato crittografato.

abstract boolean waitForBootComplete (long timeOut)

Si blocca fino a quando non viene impostato il flag di avvio completo del dispositivo.

abstract void waitForDeviceAvailable ()

Attende che il dispositivo sia reattivo e disponibile per il test.

abstract void waitForDeviceAvailable (long waitTime)

Attende che il dispositivo sia reattivo e disponibile per il test.

abstract void waitForDeviceBootloader ()

Si blocca fino a quando il dispositivo non è visibile tramite avvio rapido.

abstract boolean waitForDeviceInRecovery (long waitTime)

Blocca il dispositivo in modo che si trovi nello stato di "ripristino adb" (nota che questo è distinto da IDeviceRecovery ).

abstract boolean waitForDeviceInSideload (long waitTime)

Blocca il dispositivo in modo che sia nello stato 'adb sideload'

abstract boolean waitForDeviceNotAvailable (long waitTime)

Blocca il dispositivo per non essere disponibile ovvero mancante da adb

abstract void waitForDeviceOnline ()

Si blocca fino a quando il dispositivo non è visibile tramite adb.

abstract void waitForDeviceOnline (long waitTime)

Si blocca fino a quando il dispositivo non è visibile tramite adb.

abstract boolean waitForDeviceShell (long waitTime)

Attende che il dispositivo risponda a un comando di base della shell adb.

Costanti

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

Valore predefinito quando non è possibile rilevare il livello API

Valore costante: -1 (0xffffffff)

Metodi pubblici

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Controlla se una funzionalità è attualmente supportata o meno dato un livello minimamente supportato. Questo metodo tiene conto delle funzionalità non ancora rilasciate, prima che il livello dell'API venga innalzato.

Parametri
strictMinLevel int : il livello minimo possibile stretto che supporta la funzione.

ritorna
boolean Vero se il livello è supportato. Falso altrimenti.

Tiri
DeviceNotAvailableException

clearLogcat

public abstract void clearLogcat ()

Elimina tutti i dati logcat accumulati.

Ciò è utile nei casi in cui si desidera garantire che ITestDevice#getLogcat() restituisca solo i dati di registro prodotti dopo un determinato punto (ad esempio dopo il flashing di una nuova build del dispositivo, ecc.).

cancella il file

public abstract void deleteFile (String deviceFilePath)

Metodo di supporto per eliminare un file o una directory sul dispositivo.

Parametri
deviceFilePath String : il percorso assoluto del file sul dispositivo.

Tiri
DeviceNotAvailableException

deviceSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Metodo di supporto per verificare se il dispositivo è stato riavviato in modo software confrontando il server_sistema corrente con il server_sistema precedente ProcessInfo . Usa getProcessByName(String) per ottenere ProcessInfo .

Parametri
prevSystemServerProcess ProcessInfo : il precedente processo system_server ProcessInfo .

ritorna
boolean true se il dispositivo è stato riavviato in modo graduale

Tiri
RuntimeException se il dispositivo ha un motivo di avvio anomalo
DeviceNotAvailableException

deviceSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Metodo di supporto per verificare se il dispositivo è stato riavviato in modo graduale dall'ora UTC dall'epoca dal dispositivo e dal relativo ERROR(/TimeUnit) . Soft-Restart si riferisce a system_server riavviato al di fuori di un riavvio forzato del dispositivo (ad esempio: riavvio richiesto). Il dispositivo corrente utcEpochTime in Milliseccond può essere ottenuto con il metodo getDeviceDate() .

Parametri
utcEpochTime long : il tempo del dispositivo in secondi dall'epoca.

timeUnit TimeUnit : l'unità di tempo TimeUnit per il dato utcEpochTime.

ritorna
boolean true se il dispositivo è stato riavviato in modo graduale

Tiri
RuntimeException se il dispositivo ha un motivo di avvio anomalo
DeviceNotAvailableException

disabilitareAdbRoot

public abstract boolean disableAdbRoot ()

Disattiva adb root.

La disabilitazione di adb root potrebbe causare la disconnessione del dispositivo da adb. Questo metodo si bloccherà finché il dispositivo non sarà disponibile.

ritorna
boolean true caso di successo.

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

faFileExist

public abstract boolean doesFileExist (String deviceFilePath)

Metodo di supporto per determinare se il file esiste sul dispositivo.

Parametri
deviceFilePath String : il percorso assoluto del file sul dispositivo da controllare

ritorna
boolean true se il file esiste, false in caso contrario.

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

enableAdbRoot

public abstract boolean enableAdbRoot ()

Attiva adb root. Se l'impostazione "enable-root" è "false", registrerà un messaggio e tornerà senza abilitare root.

L'abilitazione di adb root potrebbe causare la disconnessione del dispositivo da adb. Questo metodo si bloccherà finché il dispositivo non sarà disponibile.

ritorna
boolean true caso di successo.

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

esegui AdbCommand

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

Metodo di supporto che esegue un comando adb come comando di sistema con un timeout specificato.

executeShellCommand(String) dovrebbe invece essere usato ove possibile, poiché questo metodo offre prestazioni e rilevamento degli errori migliori.

Parametri
timeout long : il tempo in millisecondi prima che il dispositivo sia considerato non rispondente, 0L per nessun timeout

commandArgs String : il comando adb e gli argomenti da eseguire

ritorna
String lo stdout dal comando. null se il comando non è stato eseguito.

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

esegui AdbCommand

public abstract String executeAdbCommand (String... commandArgs)

Metodo di supporto che esegue un comando adb come comando di sistema.

executeShellCommand(String) dovrebbe invece essere usato ove possibile, poiché questo metodo offre prestazioni e rilevamento degli errori migliori.

Parametri
commandArgs String : il comando adb e gli argomenti da eseguire

ritorna
String lo stdout dal comando. null se il comando non è stato eseguito.

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

esegui FastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

Metodo di supporto che esegue un comando di avvio rapido come comando di sistema con un timeout predefinito di 2 minuti.

Dovrebbe essere utilizzato quando il dispositivo è già in modalità di avvio rapido.

Parametri
commandArgs String : il comando fastboot e gli argomenti da eseguire

ritorna
CommandResult CommandResult contenente l'output del comando

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

esegui FastbootCommand

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

Metodo di supporto che esegue un comando di avvio rapido come comando di sistema.

Dovrebbe essere utilizzato quando il dispositivo è già in modalità di avvio rapido.

Parametri
timeout long : il tempo in millisecondi prima della scadenza del comando

commandArgs String : il comando fastboot e gli argomenti da eseguire

ritorna
CommandResult CommandResult contenente l'output del comando

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

executeLongFastbootCommand

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

Metodo di supporto che esegue un comando di avvio rapido di lunga durata come comando di sistema con variabili di ambiente di sistema.

Identico a executeFastbootCommand(String) tranne per l'utilizzo di un timeout più lungo.

Parametri
envVarMap : le variabili di ambiente di sistema con cui viene eseguito il comando fastboot

commandArgs String : il comando fastboot e gli argomenti da eseguire

ritorna
CommandResult CommandResult contenente l'output del comando

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

Metodo di supporto che esegue un comando di avvio rapido di lunga durata come comando di sistema.

Identico a executeFastbootCommand(String) tranne per l'utilizzo di un timeout più lungo.

Parametri
commandArgs String : il comando fastboot e gli argomenti da eseguire

ritorna
CommandResult CommandResult contenente l'output del comando

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

eseguiShellCommand

public abstract String executeShellCommand (String command)

Metodo di supporto che esegue un comando adb shell e restituisce l'output come String .

Parametri
command String : il comando adb shell da eseguire

ritorna
String l'output della shell

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

eseguiShellCommand

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

Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.

Parametri
command String : il comando adb shell da eseguire

receiver IShellOutputReceiver : IShellOutputReceiver a cui indirizzare l'output della shell.

maxTimeToOutputShellResponse long : il tempo massimo durante il quale il comando può non produrre alcuna risposta; unità come specificato in timeUnit

timeUnit TimeUnit : unità per maxTimeToOutputShellResponse

retryAttempts int : il numero massimo di volte per ripetere il comando se non riesce a causa di un'eccezione. DeviceNotResponsiveException verrà generata se retryAttempts viene eseguito senza successo.

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

eseguiShellCommand

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

Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.

Parametri
command String : il comando adb shell da eseguire

receiver IShellOutputReceiver : IShellOutputReceiver a cui indirizzare l'output della shell.

maxTimeoutForCommand long : il timeout massimo per il completamento del comando; unità come specificato in timeUnit

maxTimeToOutputShellResponse long : il tempo massimo durante il quale il comando può non produrre alcuna risposta; unità come specificato in timeUnit

timeUnit TimeUnit : unità per maxTimeToOutputShellResponse

retryAttempts int : il numero massimo di volte per ripetere il comando se non riesce a causa di un'eccezione. DeviceNotResponsiveException verrà generata se retryAttempts viene eseguito senza successo.

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

eseguiShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Esegue il comando adb shell fornito, riprovando più volte se il comando non riesce.

Una forma più semplice di executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) con valori predefiniti.

Parametri
command String : il comando adb shell da eseguire

receiver IShellOutputReceiver : IShellOutputReceiver a cui indirizzare l'output della shell.

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

eseguiShellV2Command

public abstract CommandResult executeShellV2Command (String command)

Metodo di supporto che esegue un comando adb shell e restituisce i risultati come CommandResult correttamente popolato con l'output dello stato del comando, stdout e stderr.

Parametri
command String : il comando da eseguire.

ritorna
CommandResult Il risultato in CommandResult .

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

eseguiShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

Metodo di supporto che esegue un comando adb shell e restituisce i risultati come CommandResult correttamente popolato con l'output dello stato del comando e stderr. stdout è indirizzato al flusso specificato.

Parametri
command String : il comando da eseguire.

pipeToOutput OutputStream : ERROR(/OutputStream) dove l'output std verrà reindirizzato o null.

ritorna
CommandResult Il risultato in CommandResult .

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

eseguiShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

Metodo di supporto che esegue un comando adb shell e restituisce i risultati come CommandResult correttamente popolato con l'output dello stato del comando, stdout e stderr.

Parametri
command String : il comando da eseguire.

pipeAsInput File : un ERROR(/File) che verrà inviato tramite pipe come input al comando o null.

ritorna
CommandResult Il risultato in CommandResult .

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

eseguiShellV2Command

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

Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.

Parametri
command String : il comando adb shell da eseguire

maxTimeoutForCommand long : il timeout massimo per il completamento del comando; unità come specificato in timeUnit

timeUnit TimeUnit : unità per maxTimeToOutputShellResponse

retryAttempts int : il numero massimo di volte per ripetere il comando se non riesce a causa di un'eccezione. DeviceNotResponsiveException verrà generata se retryAttempts viene eseguito senza successo.

ritorna
CommandResult

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

eseguiShellV2Command

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

Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.

Parametri
command String : il comando adb shell da eseguire

maxTimeoutForCommand long : il timeout massimo per il completamento del comando; unità come specificato in timeUnit

timeUnit TimeUnit : unità per maxTimeToOutputShellResponse

ritorna
CommandResult

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

eseguiShellV2Command

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

Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.

Parametri
command String : il comando adb shell da eseguire

pipeAsInput File : un ERROR(/File) che verrà inviato tramite pipe come input al comando o null.

pipeToOutput OutputStream : ERROR(/OutputStream) dove l'output std verrà reindirizzato o null.

maxTimeoutForCommand long : il timeout massimo per il completamento del comando; unità come specificato in timeUnit

timeUnit TimeUnit : unità per maxTimeToOutputShellResponse

retryAttempts int : il numero massimo di volte per ripetere il comando se non riesce a causa di un'eccezione. DeviceNotResponsiveException verrà generata se retryAttempts viene eseguito senza successo.

ritorna
CommandResult

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

eseguiShellV2Command

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

Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.

Parametri
command String : il comando adb shell da eseguire

pipeAsInput File : un ERROR(/File) che verrà inviato tramite pipe come input al comando o null.

pipeToOutput OutputStream : ERROR(/OutputStream) dove l'output std verrà reindirizzato o null.

pipeToError OutputStream : ERROR(/OutputStream) dove l'errore std verrà reindirizzato o null.

maxTimeoutForCommand long : il timeout massimo per il completamento del comando; unità come specificato in timeUnit

timeUnit TimeUnit : unità per maxTimeToOutputShellResponse

retryAttempts int : il numero massimo di volte per ripetere il comando se non riesce a causa di un'eccezione. DeviceNotResponsiveException verrà generata se retryAttempts viene eseguito senza successo.

ritorna
CommandResult

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

Metodo di supporto che cancella una partizione per il dispositivo.

Se getUseFastbootErase() è true , per cancellare la partizione verrà utilizzato fastboot erase. Il dispositivo deve quindi creare un filesystem al successivo avvio del dispositivo. In caso contrario, viene utilizzato il formato di avvio rapido che creerà un nuovo filesystem sul dispositivo.

Dovrebbe essere utilizzato quando il dispositivo è già in modalità di avvio rapido.

Parametri
partition String : la partizione da cancellare

ritorna
CommandResult CommandResult contenente l'output del comando

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

getApiLevel

public abstract int getApiLevel ()

Ottieni il livello API del dispositivo. Il valore predefinito UNKNOWN_API_LEVEL .

ritorna
int un numero intero che indica il livello API del dispositivo

Tiri
DeviceNotAvailableException

getBasebandVersion

public abstract String getBasebandVersion ()

Metodo pratico per ottenere la versione in banda base (radio) di questo dispositivo. Ottenere la versione radio è specifica del dispositivo, quindi potrebbe non restituire le informazioni corrette per tutti i dispositivi. Questo metodo si basa sulla proprietà gsm.version.baseband per restituire le informazioni sulla versione corretta. Questo non è accurato per alcuni dispositivi CDMA e la versione qui restituita potrebbe non corrispondere alla versione riportata da fastboot e potrebbe non restituire la versione per la radio CDMA. TL;DR questo metodo riporta una versione accurata solo se la proprietà gsm.version.baseband è la stessa della versione restituita da fastboot getvar version-baseband .

ritorna
String la versione String baseband o null se non può essere determinata (il dispositivo non ha radio o la stringa della versione non può essere letta)

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

prendi la batteria

public abstract Integer getBattery ()

Restituisce il livello della batteria corrente di un dispositivo o Null se il livello della batteria non è disponibile.

ritorna
Integer

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

Restituisce il valore booleano della proprietà data.

Parametri
name String : il nome della proprietà

defaultValue boolean : valore predefinito da restituire se la proprietà è vuota o non esiste.

ritorna
boolean true se la proprietà ha valore "1" , "y" , "yes" , "on" o "true" , false se la proprietà ha valore "0" , "n" , "no" , "off" , "false" o defaultValue contrario.

Tiri
DeviceNotAvailableException

getBootHistory

public abstract  getBootHistory ()

Il metodo di supporto raccoglie la mappa della cronologia di avvio con il tempo di avvio e il motivo di avvio.

ritorna
Mappa del tempo di avvio (ora UTC in secondi da Epoch) e motivo di avvio

Tiri
DeviceNotAvailableException

getBootHistoryDa

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

Il metodo helper raccoglie la mappa della cronologia di avvio con l'ora di avvio e il motivo di avvio dall'ora specificata dall'epoca dal dispositivo e dall'unità di tempo specificata. Il dispositivo corrente utcEpochTime in Millisecond può essere ottenuto con il metodo getDeviceDate() .

Parametri
utcEpochTime long : il tempo del dispositivo da Epoch.

timeUnit TimeUnit : l'unità di tempo TimeUnit .

ritorna
Mappa del tempo di avvio (ora UTC in secondi da Epoch) e motivo di avvio

Tiri
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

Metodo pratico per ottenere la versione bootloader di questo dispositivo.

Tenterà di recuperare la versione del bootloader dallo stato corrente del dispositivo. (ad esempio, se il dispositivo è in modalità di avvio rapido, tenterà di recuperare la versione da avvio rapido)

ritorna
String la versione del bootloader String o null se non può essere trovata

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

getBugreport

public abstract InputStreamSource getBugreport ()

Recupera una segnalazione di bug dal dispositivo.

L'implementazione di questo è garantita per continuare a funzionare su un dispositivo senza una sdcard (o dove la sdcard non è ancora montata).

ritorna
InputStreamSource Un InputStreamSource che produrrà i contenuti della segnalazione di bug su richiesta. In caso di errore, InputStreamSource produrrà un ERROR(/InputStream) vuoto.

getBugreportz

public abstract InputStreamSource getBugreportz ()

Recupera un bugreportz dal dispositivo. Il bugreport in formato zip contiene il bugreport principale e altri file di registro utili per il debug.

Supportato solo per 'versione adb' > 1.0.36

ritorna
InputStreamSource un InputStreamSource del file zip contenente il bugreportz, restituisce null in caso di errore.

getBuildAlias

public abstract String getBuildAlias ()

Recupera l'alias della build attualmente in esecuzione sul dispositivo.

L'alias di build è solitamente una stringa più leggibile rispetto all'id build (in genere un numero per le build di Nexus). Ad esempio, la versione finale di Android 4.2 ha l'alias di build JDQ39 e l'ID build 573038

ritorna
String l'alias build o fallback per build id se non è stato possibile recuperarlo

Tiri
DeviceNotAvailableException

getBuildFlavor

public abstract String getBuildFlavor ()

Recupera la versione di build per il dispositivo.

ritorna
String la versione di build o null se non è stato possibile recuperarla

Tiri
DeviceNotAvailableException

getBuildId

public abstract String getBuildId ()

Recupera la build attualmente in esecuzione sul dispositivo.

ritorna
String l'id build o IBuildInfo#UNKNOWN_BUILD_ID se non è stato possibile recuperarlo

Tiri
DeviceNotAvailableException

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

Restituisce il tipo di chiave utilizzato per firmare l'immagine del dispositivo

In genere i dispositivi Android possono essere firmati con chiavi di test (come in AOSP) o chiavi di rilascio (controllate dai singoli produttori di dispositivi)

ritorna
String La chiave di firma se trovata, null in caso contrario.

Tiri
DeviceNotAvailableException

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

Restituisce un DeviceDescriptor memorizzato nella cache se il dispositivo è allocato, altrimenti restituisce il DeviceDescriptor corrente.

ritorna
DeviceDescriptor

ottenereChildren

public abstract String[] getChildren (String deviceFilePath)

Alternativa all'utilizzo di IFileEntry che a volte non funziona a causa delle autorizzazioni.

Parametri
deviceFilePath String : è il percorso sul dispositivo dove effettuare la ricerca

ritorna
String[] Matrice di stringa contenente tutto il file in un percorso sul dispositivo.

Tiri
DeviceNotAvailableException

getDeviceClass

public abstract String getDeviceClass ()

Ottieni la classe del dispositivo.

ritorna
String la classe del dispositivo String .

getDeviceDate

public abstract long getDeviceDate ()

Restituisce la data del dispositivo in millisecondi dall'epoca.

ritorna
long la data del dispositivo in formato epoch.

Tiri
DeviceNotAvailableException

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

Restituisce un DeviceDescriptor dalle informazioni sul dispositivo per ottenere informazioni su di esso senza passare l'oggetto dispositivo effettivo.

ritorna
DeviceDescriptor

getDeviceState

public abstract TestDeviceState getDeviceState ()

Ottieni lo stato del dispositivo.

ritorna
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

Helper per ottenere la differenza di orario tra il dispositivo e un dato ERROR(/Date) . Usa Epoch Time internamente.

Parametri
date Date

ritorna
long la differenza in millisecondi

Tiri
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

Ottieni il flusso dell'emulatore stdout e stderr

ritorna
InputStreamSource uscita dell'emulatore

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

Metodo di supporto per determinare la quantità di spazio libero sulla memoria esterna del dispositivo.

ritorna
long la quantità di spazio libero in KB

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

getFastbootProductType

public abstract String getFastbootProductType ()

Metodo pratico per ottenere il tipo di prodotto di questo dispositivo quando è in modalità di avvio rapido.

Questo metodo dovrebbe essere utilizzato solo se il dispositivo deve essere in avvio rapido. In questo caso è una variante un po' più sicura rispetto al metodo getProductType() generico, perché ITestDevice saprà di ripristinare il dispositivo in avvio rapido se il dispositivo è in uno stato errato o non risponde.

ritorna
String il nome del tipo di prodotto String o null se non può essere determinato

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

Metodo pratico per ottenere il tipo di prodotto di questo dispositivo quando è in modalità di avvio rapido.

Questo metodo dovrebbe essere utilizzato solo se il dispositivo deve essere in avvio rapido. In questo caso è una variante un po' più sicura rispetto al metodo getProductType() generico, perché ITestDevice saprà di ripristinare il dispositivo in avvio rapido se il dispositivo è in uno stato errato o non risponde.

ritorna
String il nome del tipo di prodotto String o null se non può essere determinato

Tiri
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

Restituisce il numero di serie della modalità di avvio rapido.

ritorna
String

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

Recupera il valore della variabile di avvio rapido specificato dal dispositivo.

Parametri
variableName String : il nome della variabile

ritorna
String il valore della proprietà o null se non esiste

Tiri
UnsupportedOperationException
DeviceNotAvailableException

getFileEntry

public abstract IFileEntry getFileEntry (String path)

Recupera un riferimento a un file remoto sul dispositivo.

Parametri
path String : il percorso del file da recuperare. Può essere un percorso assoluto o relativo a '/'. (cioè sono supportate sia la sintassi "/system" che "system")

ritorna
IFileEntry l' IFileEntry o null se non è possibile trovare il file nel path specificato

Tiri
DeviceNotAvailableException

getIDevice

public abstract IDevice getIDevice ()

Restituisce un riferimento all'IDevice IDevice associato.

Un nuovo IDevice può essere allocato da DDMS ogni volta che il dispositivo si disconnette e si riconnette da adb. Pertanto i chiamanti non dovrebbero mantenere un riferimento a IDevice , perché quel riferimento potrebbe diventare obsoleto.

ritorna
IDevice il IDevice

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

Restituisce il valore intero della proprietà data dal dispositivo.

Parametri
name String : il nome della proprietà

defaultValue long : valore predefinito da restituire se la proprietà è vuota o non esiste.

ritorna
long il valore della proprietà o defaultValue se la proprietà è vuota, non esiste o non ha un valore intero.

Tiri
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

Restituisce l'ultima volta che le API Tradefed hanno attivato un riavvio in millisecondi da EPOCH come restituito da System.currentTimeMillis() .

ritorna
long

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

Ottieni il primo livello API avviato del dispositivo. Il valore predefinito UNKNOWN_API_LEVEL .

ritorna
int un numero intero che indica il primo livello API avviato del dispositivo

Tiri
DeviceNotAvailableException

getLogcat

public abstract InputStreamSource getLogcat ()

Afferra un flusso di snapshot dei dati logcat.

Funziona in due modalità:

  • Se il logcat è attualmente in fase di acquisizione in background, verranno restituiti fino a TestDeviceOptions.getMaxLogcatDataSize() byte del contenuto corrente dell'acquisizione logcat in background
  • In caso contrario, restituirà un dump statico dei dati logcat se il dispositivo sta attualmente rispondendo

    ritorna
    InputStreamSource

  • getLogcat

    public abstract InputStreamSource getLogcat (int maxBytes)

    Afferra un flusso di snapshot degli ultimi maxBytes di dati logcat acquisiti.

    Utile nei casi in cui si desidera acquisire istantanee frequenti dei dati logcat acquisiti senza incorrere nella penalizzazione di spazio su disco potenzialmente grande per ottenere l'intera snapshot getLogcat() .

    Parametri
    maxBytes int : la quantità massima di dati da restituire. Dovrebbe essere una quantità che può stare comodamente in memoria

    ritorna
    InputStreamSource

    getLogcatDump

    public abstract InputStreamSource getLogcatDump ()

    Ottieni un dump del logcat corrente per il dispositivo. A differenza getLogcat() , questo metodo restituirà sempre un dump statico del logcat.

    Ha lo svantaggio che nulla verrà restituito se il dispositivo non è raggiungibile.

    ritorna
    InputStreamSource un InputStreamSource dei dati logcat. Viene restituito un flusso vuoto se l'acquisizione dei dati logcat non riesce.

    getLogcatSince

    public abstract InputStreamSource getLogcatSince (long date)

    Afferra un flusso di snapshot dei dati logcat acquisiti a partire dalla data fornita. È necessario utilizzare l'ora sul dispositivo getDeviceDate() .

    Parametri
    date long : in millisecondi dal formato epoch di quando avviare lo snapshot fino al presente. (può essere ottenuto usando 'date +%s')

    ritorna
    InputStreamSource

    getMountPoint

    public abstract String getMountPoint (String mountName)

    Restituisce un punto di montaggio.

    Queries the device directly if the cached info in IDevice is not available.

    TODO: move this behavior to IDevice#getMountPoint(String)

    Parametri
    mountName String : the name of the mount point

    ritorna
    String the mount point or null

    getMountPointInfo

    public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

    Returns a MountPointInfo corresponding to the specified mountpoint path, or null if that path has nothing mounted or otherwise does not appear in /proc/mounts as a mountpoint.

    Parametri
    mountpoint String

    ritorna
    ITestDevice.MountPointInfo A ERROR(/List) of MountPointInfo containing the information in "/proc/mounts"

    Tiri
    DeviceNotAvailableException

    Guarda anche:

    getMountPointInfo

    public abstract  getMountPointInfo ()

    Returns a parsed version of the information in /proc/mounts on the device

    ritorna
    A ERROR(/List) of MountPointInfo containing the information in "/proc/mounts"

    Tiri
    DeviceNotAvailableException

    getPartitionFreeSpace

    public abstract long getPartitionFreeSpace (String partition)

    Helper method to determine amount of free space on device partition.

    Parametri
    partition String

    ritorna
    long the amount of free space in KB

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    getProcessByName

    public abstract ProcessInfo getProcessByName (String processName)

    Helper method runs the "pidof" and "stat" command and returns ProcessInfo object with PID and process start time of the given process.

    Parametri
    processName String : the proces name String.

    ritorna
    ProcessInfo ProcessInfo of given processName

    Tiri
    DeviceNotAvailableException

    getProcessPid

    public abstract String getProcessPid (String process)

    Returns the pid of the service or null if something went wrong.

    Parametri
    process String : The proces name String.

    ritorna
    String

    Tiri
    DeviceNotAvailableException

    getProductType

    public abstract String getProductType ()

    Convenience method to get the product type of this device.

    This method will work if device is in either adb or fastboot mode.

    ritorna
    String the String product type name. Will not be null

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered, or if product type can not be determined

    getProductVariant

    public abstract String getProductVariant ()

    Convenience method to get the product variant of this device.

    This method will work if device is in either adb or fastboot mode.

    ritorna
    String the String product variant name or null if it cannot be determined

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    getProperty

    public abstract String getProperty (String name)

    Retrieve the given property value from the device.

    Parametri
    name String : the property name

    ritorna
    String the property value or null if it does not exist

    Tiri
    DeviceNotAvailableException

    getRecoveryMode

    public abstract ITestDevice.RecoveryMode getRecoveryMode ()

    Get the current recovery mode used for the device.

    ritorna
    ITestDevice.RecoveryMode the current recovery mode used for the device.

    getSerialNumber

    public abstract String getSerialNumber ()

    Convenience method to get serial number of this device.

    ritorna
    String the String serial number

    getTombstones

    public abstract  getTombstones ()

    Fetch and return the list of tombstones from the devices. Requires root.

    method is best-effort so if one tombstone fails to be pulled for any reason it will be missing from the list. Only a DeviceNotAvailableException will terminate the method early.

    ritorna
    A list of tombstone files, empty if no tombstone.

    Tiri
    DeviceNotAvailableException

    Guarda anche:

    getTotalMemory

    public abstract long getTotalMemory ()

    Returns total physical memory size in bytes or -1 in case of internal error

    ritorna
    long

    getUseFastbootErase

    public abstract boolean getUseFastbootErase ()

    Get whether to use fastboot erase or fastboot format to wipe a partition on the device.

    ritorna
    boolean true if fastboot erase will be used or false if fastboot format will be used.

    isAdbRoot

    public abstract boolean isAdbRoot ()

    ritorna
    boolean true if device currently has adb root, false otherwise.

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    isAdbTcp

    public abstract boolean isAdbTcp ()

    ritorna
    boolean true if device is connected to adb-over-tcp, false otherwise.

    isAppEnumerationSupported

    public abstract boolean isAppEnumerationSupported ()

    Check whether platform on device supports app enumeration

    ritorna
    boolean True if app enumeration is supported, false otherwise

    Tiri
    DeviceNotAvailableException

    isDeviceEncrypted

    public abstract boolean isDeviceEncrypted ()

    Returns if the device is encrypted.

    ritorna
    boolean true if the device is encrypted.

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    isDirectory

    public abstract boolean isDirectory (String deviceFilePath)

    Return True if the path on the device is a directory, false otherwise.

    Parametri
    deviceFilePath String

    ritorna
    boolean

    Tiri
    DeviceNotAvailableException

    isEncryptionSupported

    public abstract boolean isEncryptionSupported ()

    Returns if encryption is supported on the device.

    ritorna
    boolean true if the device supports encryption.

    Tiri
    DeviceNotAvailableException

    isExecutable

    public abstract boolean isExecutable (String fullPath)

    Returns True if the file path on the device is an executable file, false otherwise.

    Parametri
    fullPath String

    ritorna
    boolean

    Tiri
    DeviceNotAvailableException

    isHeadless

    public abstract boolean isHeadless ()

    Return true if the device is headless (no screen), false otherwise.

    ritorna
    boolean

    Tiri
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public abstract boolean isRuntimePermissionSupported ()

    Check whether platform on device supports runtime permission granting

    ritorna
    boolean True if runtime permission are supported, false otherwise.

    Tiri
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public abstract boolean isStateBootloaderOrFastbootd ()

    Returns true if device is in TestDeviceState#FASTBOOT or TestDeviceState.FASTBOOTD .

    ritorna
    boolean

    logAnrs

    public abstract boolean logAnrs (ITestLogger logger)

    Collects and log ANRs from the device.

    Parametri
    logger ITestLogger : an ITestLogger to log the ANRs.

    ritorna
    boolean True if the logging was successful, false otherwise.

    Tiri
    DeviceNotAvailableException

    logBugreport

    public abstract boolean logBugreport (String dataName, 
                    ITestLogger listener)

    Helper method to take a bugreport and log it to the reporters.

    Parametri
    dataName String : name under which the bugreport will be reported.

    listener ITestLogger : an ITestLogger to log the bugreport.

    ritorna
    boolean True if the logging was successful, false otherwise.

    logOnDevice

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

    Log a message in the logcat of the device. This is a safe call that will not throw even if the logging fails.

    Parametri
    tag String : The tag under which we log our message in the logcat.

    level Log.LogLevel : The debug level of the message in the logcat.

    format String : The message format.

    args Object : the args to be replaced via String.format().

    nonBlockingReboot

    public abstract void nonBlockingReboot ()

    Issues a command to reboot device and returns on command complete and when device is no longer visible to adb.

    Tiri
    DeviceNotAvailableException

    postBootSetup

    public abstract void postBootSetup ()

    Perform instructions to configure device for testing that after every boot.

    Should be called after device is fully booted/available

    In normal circumstances this method doesn't need to be called explicitly, as implementations should perform these steps automatically when performing a reboot.

    Where it may need to be called is when device reboots due to other events (eg when a fastboot update command has completed)

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    postInvocationTearDown

    public void postInvocationTearDown ()

    Questo metodo è deprecato.
    Use postInvocationTearDown(Throwable) instead.

    Extra steps for device specific required clean up that will be executed after the invocation is done.

    postInvocationTearDown

    public abstract void postInvocationTearDown (Throwable invocationException)

    Extra steps for device specific required clean up that will be executed after the invocation is done.

    Parametri
    invocationException Throwable : if any, the final exception raised by the invocation failure.

    preInvocationSetup

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

    Extra steps for device specific required setup that will be executed on the device prior to the invocation flow.

    Parametri
    info IBuildInfo : The IBuildInfo of the device.

    attributes MultiMap : The attributes stored in the invocation context

    Tiri
    com.android.tradefed.targetprep.TargetSetupError
    DeviceNotAvailableException
    TargetSetupError

    pullDir

    public abstract boolean pullDir (String deviceFilePath, 
                    File localDir)

    Recursively pull directory contents from device.

    Parametri
    deviceFilePath String : the absolute file path of the remote source

    localDir File : the local directory to pull files into

    ritorna
    boolean true if file was pulled successfully. false otherwise.

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pullFile

    public abstract File pullFile (String remoteFilePath, 
                    int userId)

    Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

    Parametri
    remoteFilePath String : the absolute path to file on device.

    userId int : The user id to pull from

    ritorna
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pullFile

    public abstract File pullFile (String remoteFilePath)

    Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

    Parametri
    remoteFilePath String : the absolute path to file on device.

    ritorna
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pullFile

    public abstract boolean pullFile (String remoteFilePath, 
                    File localFile)

    Retrieves a file off device.

    Parametri
    remoteFilePath String : the absolute path to file on device.

    localFile File : the local file to store contents in. If non-empty, contents will be replaced.

    ritorna
    boolean true if file was retrieved successfully. false otherwise.

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pullFile

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

    Retrieves a file off device.

    Parametri
    remoteFilePath String : the absolute path to file on device.

    localFile File : the local file to store contents in. If non-empty, contents will be replaced.

    userId int : The user id to pull from

    ritorna
    boolean true if file was retrieved successfully. false otherwise.

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pullFileContents

    public abstract String pullFileContents (String remoteFilePath)

    Retrieves a file off device, and returns the contents.

    Parametri
    remoteFilePath String : the absolute path to file on device.

    ritorna
    String A String containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Tiri
    DeviceNotAvailableException

    pullFileFromExternal

    public abstract File pullFileFromExternal (String remoteFilePath)

    A convenience method to retrieve a file from the device's external storage, stores it in a local temporary ERROR(/File) , and return a reference to that File .

    Parametri
    remoteFilePath String : the path to file on device, relative to the device's external storage mountpoint

    ritorna
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pushDir

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

    Recursively push directory contents to device while excluding some directories that are filtered.

    Parametri
    localDir File : the local directory to push

    deviceFilePath String : the absolute file path of the remote destination

    excludedDirectories : Set of excluded directories names that shouldn't be pushed.

    ritorna
    boolean true if file was pushed successfully. false otherwise.

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath)

    Recursively push directory contents to device.

    Parametri
    localDir File : the local directory to push

    deviceFilePath String : the absolute file path of the remote destination

    ritorna
    boolean true if file was pushed successfully. false otherwise.

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pushFile

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

    Variant of pushFile(File, String) which can optionally consider evaluating the need for the content provider.

    Parametri
    localFile File : the local file to push

    deviceFilePath String : the remote destination absolute file path

    evaluateContentProviderNeeded boolean : whether to check if we need the content provider

    ritorna
    boolean true if file was pushed successfully. false otherwise.

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath)

    Push a file to device. By default using a content provider.

    Parametri
    localFile File : the local file to push

    deviceFilePath String : the remote destination absolute file path

    ritorna
    boolean true if file was pushed successfully. false otherwise.

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pushString

    public abstract boolean pushString (String contents, 
                    String deviceFilePath)

    Push file created from a string to device

    Parametri
    contents String : the contents of the file to push

    deviceFilePath String : the remote destination absolute file path

    ritorna
    boolean true if string was pushed successfully. false otherwise.

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    reboot

    public abstract void reboot ()

    Reboots the device into adb mode.

    Blocks until device becomes available.

    Tiri
    DeviceNotAvailableException if device is not available after reboot

    reboot

    public abstract void reboot (String reason)

    Reboots the device into adb mode with given reason to be persisted across reboot.

    Blocks until device becomes available.

    Last reboot reason can be obtained by querying sys.boot.reason propety.

    Parametri
    reason String : a reason for this reboot, or null if no reason is specified.

    Tiri
    DeviceNotAvailableException if device is not available after reboot

    rebootIntoBootloader

    public abstract void rebootIntoBootloader ()

    Reboots the device into bootloader mode.

    Blocks until device is in bootloader mode.

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    rebootIntoFastbootd

    public abstract void rebootIntoFastbootd ()

    Reboots the device into fastbootd mode.

    Blocks until device is in fastbootd mode.

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    rebootIntoRecovery

    public abstract void rebootIntoRecovery ()

    Reboots the device into adb recovery mode.

    Blocks until device enters recovery

    Tiri
    DeviceNotAvailableException if device is not available after reboot

    rebootIntoSideload

    public abstract void rebootIntoSideload (boolean autoReboot)

    Reboots the device into adb sideload mode (note that this is a special mode under recovery)

    Blocks until device enters sideload mode

    Parametri
    autoReboot boolean : whether to automatically reboot the device after sideload

    Tiri
    DeviceNotAvailableException if device is not in sideload after reboot

    rebootIntoSideload

    public abstract void rebootIntoSideload ()

    Reboots the device into adb sideload mode (note that this is a special mode under recovery)

    Blocks until device enters sideload mode

    Tiri
    DeviceNotAvailableException if device is not in sideload after reboot

    rebootUntilOnline

    public abstract void rebootUntilOnline ()

    An alternate to reboot() that only blocks until device is online ie visible to adb.

    Tiri
    DeviceNotAvailableException if device is not available after reboot

    rebootUntilOnline

    public abstract void rebootUntilOnline (String reason)

    An alternate to reboot() that only blocks until device is online ie visible to adb.

    Parametri
    reason String : a reason for this reboot, or null if no reason is specified.

    Tiri
    DeviceNotAvailableException if device is not available after reboot

    Guarda anche:

    rebootUserspace

    public abstract void rebootUserspace ()

    Reboots only userspace part of device.

    Blocks until device becomes available.

    WARNING. Userspace reboot is currently under active development, use it on your own risk.

    Tiri
    DeviceNotAvailableException if device is not available after reboot

    rebootUserspaceUntilOnline

    public abstract void rebootUserspaceUntilOnline ()

    An alternate to rebootUserspace() ()} that only blocks until device is online ie visible to adb.

    Tiri
    DeviceNotAvailableException if device is not available after reboot

    remountSystemWritable

    public abstract void remountSystemWritable ()

    Make the system partition on the device writable. May reboot the device.

    Tiri
    DeviceNotAvailableException

    remountVendorWritable

    public abstract void remountVendorWritable ()

    Make the vendor partition on the device writable. May reboot the device.

    Tiri
    DeviceNotAvailableException

    runInstrumentationTests

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

    Convenience method for performing ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) with one or more listeners passed as parameters.

    Parametri
    runner IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests

    listeners ITestLifeCycleReceiver : the test result listener(s)

    ritorna
    boolean true if test command completed. false if it failed to complete, but recovery succeeded

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered. ie test command failed to complete and recovery failed.

    runInstrumentationTests

    public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

    Runs instrumentation tests, and provides device recovery.

    If connection with device is lost before test run completes, and recovery succeeds, all listeners will be informed of testRunFailed and "false" will be returned. The test command will not be rerun. It is left to callers to retry if necessary.

    If connection with device is lost before test run completes, and recovery fails, all listeners will be informed of testRunFailed and DeviceNotAvailableException will be thrown.

    Parametri
    runner IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests

    listeners : the test result listeners

    ritorna
    boolean true if test command completed. false if it failed to complete due to device communication exception, but recovery succeeded

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered. ie test command failed to complete and recovery failed.

    runInstrumentationTestsAsUser

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

    Same as ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) but runs the test for a given user.

    Parametri
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    ritorna
    boolean

    Tiri
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

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

    Same as ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) but runs the test for the given user.

    Parametri
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    ritorna
    boolean

    Tiri
    DeviceNotAvailableException

    setDate

    public abstract void setDate (Date date)

    Sets the date on device

    Note: setting date on device requires root

    Parametri
    date Date : specify a particular date; will use host date if null

    Tiri
    DeviceNotAvailableException

    setOptions

    public abstract void setOptions (TestDeviceOptions options)

    Set the TestDeviceOptions for the device

    Parametri
    options TestDeviceOptions

    setProperty

    public abstract boolean setProperty (String propKey, 
                    String propValue)

    Sets the given property value on the device. Requires adb root is true.

    Parametri
    propKey String : The key targeted to be set.

    propValue String : The property value to be set.

    ritorna
    boolean returns True if the setprop command was successful, False otherwise.

    Tiri
    DeviceNotAvailableException

    setRecovery

    public abstract void setRecovery (IDeviceRecovery recovery)

    Set the IDeviceRecovery to use for this device. Should be set when device is first allocated.

    Parametri
    recovery IDeviceRecovery : the IDeviceRecovery

    setRecoveryMode

    public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

    Set the current recovery mode to use for the device.

    Used to control what recovery method to use when a device communication problem is encountered. Its recommended to only use this method sparingly when needed (for example, when framework is down, etc

    Parametri
    mode ITestDevice.RecoveryMode : whether 'recover till online only' mode should be on or not.

    setUseFastbootErase

    public abstract void setUseFastbootErase (boolean useFastbootErase)

    Set whether to use fastboot erase or fastboot format to wipe a partition on the device.

    Parametri
    useFastbootErase boolean : true if fastboot erase should be used or false if fastboot format should be used.

    startLogcat

    public abstract void startLogcat ()

    Start capturing logcat output from device in the background.

    Will have no effect if logcat output is already being captured. Data can be later retrieved via getLogcat.

    When the device is no longer in use, stopLogcat() must be called.

    startLogcat() and stopLogcat() do not normally need to be called when within a TF invocation context, as the TF framework will start and stop logcat.

    stopEmulatorOutput

    public abstract void stopEmulatorOutput ()

    Close and delete the emulator output.

    stopLogcat

    public abstract void stopLogcat ()

    Stop capturing logcat output from device, and discard currently saved logcat data.

    Will have no effect if logcat output is not being captured.

    switchToAdbTcp

    public abstract String switchToAdbTcp ()

    Switch device to adb-over-tcp mode.

    ritorna
    String the tcp serial number or null if device could not be switched

    Tiri
    DeviceNotAvailableException

    switchToAdbUsb

    public abstract boolean switchToAdbUsb ()

    Switch device to adb over usb mode.

    ritorna
    boolean true if switch was successful, false otherwise.

    Tiri
    DeviceNotAvailableException

    syncFiles

    public abstract boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

    Incrementally syncs the contents of a local file directory to device.

    Decides which files to push by comparing timestamps of local files with their remote equivalents. Only 'newer' or non-existent files will be pushed to device. Thus overhead should be relatively small if file set on device is already up to date.

    Hidden files (with names starting with ".") will be ignored.

    Example usage: syncFiles("/tmp/files", "/sdcard") will created a /sdcard/files directory if it doesn't already exist, and recursively push the /tmp/files contents to /sdcard/files.

    Parametri
    localFileDir File : the local file directory containing files to recursively push.

    deviceFilePath String : the remote destination absolute file path root. All directories in thos file path must be readable. ie pushing to /data/local/tmp when adb is not root will fail

    ritorna
    boolean true if files were synced successfully. false otherwise.

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    takeBugreport

    public abstract Bugreport takeBugreport ()

    Take a bugreport and returns it inside a Bugreport object to handle it. Return null in case of issue.

    File referenced in the Bugreport object need to be cleaned via Bugreport#close() .

    ritorna
    Bugreport

    unlockDevice

    public abstract boolean unlockDevice ()

    Unlocks the device if the device is in an encrypted state.

    This method may restart the framework but will not call postBootSetup() . Therefore, the device might not be fully ready to be tested when this method returns.

    ritorna
    boolean true if successful or if the device is unencrypted.

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.
    UnsupportedOperationException if encryption is not supported on the device.

    waitForBootComplete

    public abstract boolean waitForBootComplete (long timeOut)

    Blocks until the device's boot complete flag is set.

    Parametri
    timeOut long : time in msecs to wait for the flag to be set

    ritorna
    boolean true if device's boot complete flag is set within the timeout

    Tiri
    DeviceNotAvailableException

    waitForDeviceAvailable

    public abstract void waitForDeviceAvailable ()

    Waits for the device to be responsive and available for testing. Uses default timeout.

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    waitForDeviceAvailable

    public abstract void waitForDeviceAvailable (long waitTime)

    Waits for the device to be responsive and available for testing.

    Parametri
    waitTime long : the time in ms to wait

    Tiri
    DeviceNotAvailableException if device is still unresponsive after waitTime expires.

    waitForDeviceBootloader

    public abstract void waitForDeviceBootloader ()

    Blocks until device is visible via fastboot. Use default timeout.

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    waitForDeviceInRecovery

    public abstract boolean waitForDeviceInRecovery (long waitTime)

    Blocks for the device to be in the 'adb recovery' state (note this is distinct from IDeviceRecovery ).

    Parametri
    waitTime long : the time in ms to wait

    ritorna
    boolean true if device boots into recovery before time expires. false otherwise

    waitForDeviceInSideload

    public abstract boolean waitForDeviceInSideload (long waitTime)

    Blocks for the device to be in the 'adb sideload' state

    Parametri
    waitTime long : the time in ms to wait

    ritorna
    boolean true if device boots into sideload before time expires. false otherwise

    waitForDeviceNotAvailable

    public abstract boolean waitForDeviceNotAvailable (long waitTime)

    Blocks for the device to be not available ie missing from adb

    Parametri
    waitTime long : the time in ms to wait

    ritorna
    boolean true if device becomes not available before time expires. false otherwise

    waitForDeviceOnline

    public abstract void waitForDeviceOnline ()

    Blocks until device is visible via adb. Uses default timeout

    Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    waitForDeviceOnline

    public abstract void waitForDeviceOnline (long waitTime)

    Blocks until device is visible via adb.

    Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

    Parametri
    waitTime long : the time in ms to wait

    Tiri
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    waitForDeviceShell

    public abstract boolean waitForDeviceShell (long waitTime)

    Waits for device to be responsive to a basic adb shell command.

    Parametri
    waitTime long : the time in ms to wait

    ritorna
    boolean true if device becomes responsive before waitTime elapses.