INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice


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

Tenta nuovamente i comandi del dispositivo per un numero 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 minimo 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 gradualmente confrontando l'attuale system_server con il precedente system_server ProcessInfo .

abstract boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)

Metodo di supporto per verificare se il dispositivo è stato riavviato gradualmente 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 esiste un file 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 String executeAdbCommand (long timeout, envMap, String... commandArgs) executeAdbCommand (long timeout, envMap, String... commandArgs)

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

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

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

abstract CommandResult executeFastbootCommand (String... commandArgs)

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

abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

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

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

abstract String executeShellCommand (String command)

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

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

Esegue un comando della shell adb, 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 della shell adb, con più parametri per controllare il comportamento del comando.

abstract void executeShellCommand (String command, IShellOutputReceiver receiver)

Esegue il comando della shell adb specificato, riprovando più volte se il comando fallisce.

abstract CommandResult executeShellV2Command (String command)

Metodo di supporto che esegue un comando della shell adb 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 della shell adb e restituisce i risultati come CommandResult popolato correttamente con l'output dello stato del comando e stderr.

abstract CommandResult executeShellV2Command (String command, File pipeAsInput)

Metodo di supporto che esegue un comando della shell adb 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 della shell adb, con più parametri per controllare il comportamento del comando.

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

Esegue un comando della shell adb, 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 della shell adb, 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 della shell adb, 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 corrente della batteria 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à specificata.

abstract getBootHistory ()

Il metodo di supporto raccoglie la mappa della cronologia di avvio con l'ora di avvio e il motivo dell'avvio.

abstract getBootHistorySince (long utcEpochTime, TimeUnit timeUnit)

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

abstract String getBootloaderVersion ()

Metodo conveniente per ottenere la versione bootloader di questo 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 DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

abstract String[] getChildren (String deviceFilePath)

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

abstract AbstractConnection getConnection ()

Restituisce la connessione associata al dispositivo.

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 DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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)

Aiutante per ottenere la differenza oraria tra il dispositivo e un determinato 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 nella 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à fastboot.

abstract String getFastbootVariable (String variableName)

Recupera il valore della variabile fastboot specificato dal dispositivo.

abstract IFileEntry getFileEntry (String path)

Recupera un riferimento a un file remoto sul dispositivo.

abstract IDevice getIDevice ()

Restituisce un riferimento IDevice ddmlib associato.

abstract long getIntProperty (String name, long defaultValue)

Restituisce il valore intero della proprietà specificata dal dispositivo.

abstract long getLastExpectedRebootTimeMillis ()

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

abstract int getLaunchApiLevel ()

Ottieni il primo livello API avviato del dispositivo.

abstract InputStreamSource getLogcat ()

Acquisisce un flusso di snapshot dei dati logcat.

abstract InputStreamSource getLogcat (int maxBytes)

Acquisisce 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)

Acquisisce 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 quel percorso non ha nulla montato o altrimenti non appare 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 helper esegue il comando "pidof" e "stat" e restituisce l'oggetto ProcessInfo con PID e l'ora di inizio del processo specificato.

abstract String getProcessPid (String process)

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

abstract String getProductType ()

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

abstract String getProductVariant ()

Metodo conveniente 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 restituisce 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 ()

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

abstract boolean isBypassLowTargetSdkBlockSupported ()

Controlla se la piattaforma sul dispositivo supporta il bypass del blocco SDK con target basso nelle installazioni di app

abstract boolean isDebugfsMounted ()

Controlla se debugfs è montato.

abstract boolean isDeviceEncrypted ()

Restituisce se il dispositivo è crittografato.

abstract boolean isDirectory (String deviceFilePath)

Restituisce True se il percorso sul dispositivo è una directory, false altrimenti.

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

abstract boolean isHeadless ()

Restituisce vero se il dispositivo è senza testa (senza schermo), falso altrimenti.

abstract boolean isRuntimePermissionSupported ()

Controlla se la piattaforma sul dispositivo supporta la concessione delle 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 void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)

Registra un messaggio nel logcat del dispositivo.

abstract void mountDebugfs ()

Monta debugf.

abstract void nonBlockingReboot ()

Emette un comando per riavviare il dispositivo e ritorna al termine del comando 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. Utilizzare invece postInvocationTearDown(Throwable) .

abstract void postInvocationTearDown (Throwable invocationException)

Passaggi aggiuntivi per la pulizia richiesta specifica del dispositivo che verranno eseguiti al termine della chiamata.

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

Passaggi aggiuntivi per la configurazione richiesta specifica del dispositivo che verranno eseguiti sul dispositivo prima del flusso di chiamata.

abstract boolean pullDir (String deviceFilePath, File localDir)

Estrae 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 restituisce quel File .

abstract File pullFile (String remoteFilePath)

Recupera un file dal dispositivo, lo archivia in un ERROR(/File) temporaneo locale e restituisce quel 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 restituisce il contenuto.

abstract File pullFileFromExternal (String remoteFilePath)

Un metodo pratico per recuperare un file dalla memoria esterna del dispositivo, memorizzarlo 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 i contenuti 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ò facoltativamente prendere in considerazione la valutazione della necessità per il fornitore di contenuti.

abstract boolean pushFile (File localFile, String deviceFilePath)

Invia un file al dispositivo.

abstract boolean pushString (String contents, String deviceFilePath)

Invia il file 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 reason indicato per persistere durante il riavvio.

abstract void rebootIntoBootloader ()

Riavvia il dispositivo in modalità bootloader.

abstract void rebootIntoFastbootd ()

Riavvia il dispositivo in modalità fastbootd.

abstract void rebootIntoRecovery ()

Riavvia il dispositivo in modalità di ripristino adb.

abstract void rebootIntoSideload (boolean autoReboot)

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

Si blocca finché il dispositivo non entra in modalità sideload

abstract void rebootIntoSideload ()

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

Si blocca finché il dispositivo non entra in modalità sideload

abstract void rebootUntilOnline ()

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

abstract void rebootUntilOnline (String reason)

Un'alternativa a reboot() che si blocca solo finché 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 finché il dispositivo non è online, ovvero visibile ad adb.

abstract void remountSystemReadOnly ()

Rendi di sola lettura la partizione di sistema sul dispositivo.

abstract void remountSystemWritable ()

Rendere scrivibile la partizione di sistema sul dispositivo.

abstract void remountVendorReadOnly ()

Rendi di sola lettura la partizione del fornitore sul dispositivo.

abstract void remountVendorWritable ()

Rendere 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ù ascoltatori passati come parametri.

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

Esegue test della strumentazione e fornisce il ripristino del dispositivo.

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

Uguale a 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 il dato utente.

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

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

abstract void setDate (Date date)

Imposta la data sul dispositivo

Nota: l'impostazione della data sul dispositivo richiede root

abstract void setOptions ( TestDeviceOptions options)

Imposta TestDeviceOptions per il dispositivo

abstract boolean setProperty (String propKey, String propValue)

Imposta il valore della proprietà specificata 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 ad acquisire l'output di logcat dal dispositivo in background.

abstract void stopEmulatorOutput ()

Chiudi ed elimina l'output dell'emulatore.

abstract void stopLogcat ()

Interrompe 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 il dispositivo alla modalità adb tramite USB.

abstract boolean syncFiles (File localFileDir, String deviceFilePath)

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

abstract boolean unlockDevice ()

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

abstract void unmountDebugfs ()

Smonta debugf.

abstract boolean waitForBootComplete (long timeOut)

Si blocca finché non viene impostato il flag di avvio completo del dispositivo.

abstract boolean waitForDeviceAvailable ()

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

abstract boolean waitForDeviceAvailable (long waitTime)

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

abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

Attende che il dispositivo sia reattivo e disponibile senza considerare il percorso di ripristino.

abstract void waitForDeviceBootloader ()

Si blocca finché il dispositivo non è visibile tramite fastboot.

abstract boolean waitForDeviceInRecovery (long waitTime)

Blocchi affinché il dispositivo si trovi nello stato 'adb recovery' (nota che questo è distinto da IDeviceRecovery ).

abstract boolean waitForDeviceInSideload (long waitTime)

Blocchi affinché il dispositivo si trovi nello stato "adb sideload".

abstract boolean waitForDeviceNotAvailable (long waitTime)

I blocchi affinché il dispositivo non siano disponibili, ovvero mancanti da adb

abstract void waitForDeviceOnline ()

Si blocca finché il dispositivo non è visibile tramite adb.

abstract void waitForDeviceOnline (long waitTime)

Si blocca finché il dispositivo non è visibile tramite adb.

abstract boolean waitForDeviceShell (long waitTime)

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

Costanti

SCONOSCIUTO_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 minimo supportato. Questo metodo tiene conto delle funzionalità non ancora rilasciate, prima che il livello API venga aumentato.

Parametri
strictMinLevel int : il livello minimo possibile rigoroso che supporta la funzionalità.

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

Lancia
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

clearLogcat

public abstract void clearLogcat ()

Elimina tutti i dati logcat accumulati.

Ciò è utile nei casi in cui si desidera garantire ITestDevice#getLogcat() restituisca solo i dati di registro prodotti dopo un certo punto (ad esempio dopo aver eseguito il flashing di una nuova build di dispositivo e così via).

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.

Lancia
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

dispositivoSoftRiavviato

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Metodo di supporto per verificare se il dispositivo è stato riavviato gradualmente confrontando l'attuale system_server con il precedente system_server ProcessInfo . Utilizzare getProcessByName(String) per ottenere ProcessInfo .

Parametri
prevSystemServerProcess ProcessInfo : il precedente processo system_server ProcessInfo .

ritorna
boolean true se il dispositivo è stato riavviato gradualmente

Lancia
RuntimeException se il dispositivo ha un motivo di avvio anomalo
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

dispositivoSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Metodo di supporto per verificare se il dispositivo è stato riavviato gradualmente 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 hardware 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 gradualmente

Lancia
RuntimeException se il dispositivo ha un motivo di avvio anomalo
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

disabilitaAdbRoot

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 in caso di successo.

Lancia
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 esiste un file sul dispositivo.

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

ritorna
boolean true se il file esiste, false altrimenti.

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

abilitaAdbRoot

public abstract boolean enableAdbRoot ()

Attiva adb root. Se l'impostazione "enable-root" è "false", registrerà un messaggio e restituirà 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 in caso di successo.

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

eseguireAdbCommand

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 essere utilizzato invece ove possibile, poiché tale metodo fornisce un migliore rilevamento degli errori e prestazioni migliori.

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

commandArgs String : il comando adb e gli argomenti da eseguire

ritorna
String lo stdout dal comando. null se l'esecuzione del comando non è riuscita.

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

eseguireAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

executeShellCommand(String) dovrebbe essere utilizzato invece ove possibile, poiché tale metodo fornisce un migliore rilevamento degli errori e prestazioni migliori.

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

ritorna
String lo stdout dal comando. null se l'esecuzione del comando non è riuscita.

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

eseguireAdbCommand

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

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

executeShellCommand(String) dovrebbe essere utilizzato invece ove possibile, poiché tale metodo fornisce un migliore rilevamento degli errori e prestazioni migliori.

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

envMap : ambiente da impostare per il comando

commandArgs String : il comando adb e gli argomenti da eseguire

ritorna
String lo stdout dal comando. null se l'esecuzione del comando non è riuscita.

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

eseguire il comando Fastboot

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

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

Previsto per l'uso 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 il CommandResult contenente l'output del comando

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

eseguire il comando Fastboot

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

Previsto per l'uso quando il dispositivo è già in modalità di avvio rapido.

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

ritorna
CommandResult il CommandResult contenente l'output del comando

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

eseguire il comando Long Fastboot

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

Identico executeFastbootCommand(String) tranne che utilizza un timeout più lungo.

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

ritorna
CommandResult il CommandResult contenente l'output del comando

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

eseguire il comando Long Fastboot

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

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

Identico executeFastbootCommand(String) tranne che utilizza un timeout più lungo.

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

commandArgs String : il comando fastboot e gli argomenti da eseguire

ritorna
CommandResult il CommandResult contenente l'output del comando

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

eseguireShellCommand

public abstract String executeShellCommand (String command)

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

Parametri
command String : il comando della shell adb da eseguire

ritorna
String l'output della shell

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

eseguireShellCommand

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

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

Parametri
command String : il comando della shell adb da eseguire

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

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

timeUnit TimeUnit : unità per maxTimeToOutputShellResponse

retryAttempts int : il numero massimo di volte per riprovare il comando se fallisce a causa di un'eccezione. DeviceNotResponsiveException verrà generata se retryAttempts vengono eseguiti senza successo.

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

eseguireShellCommand

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

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

Parametri
command String : il comando della shell adb 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 periodo di tempo massimo durante il quale il comando può non emettere alcuna risposta; unità come specificato in timeUnit

timeUnit TimeUnit : unità per maxTimeToOutputShellResponse

retryAttempts int : il numero massimo di volte per riprovare il comando se fallisce a causa di un'eccezione. DeviceNotResponsiveException verrà generata se retryAttempts vengono eseguiti senza successo.

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

eseguireShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Esegue il comando della shell adb specificato, riprovando più volte se il comando fallisce.

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

Parametri
command String : il comando della shell adb da eseguire

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

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

eseguire il comando ShellV2

public abstract CommandResult executeShellV2Command (String command)

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

Parametri
command String : il comando che deve essere eseguito.

ritorna
CommandResult Il risultato in CommandResult .

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

eseguire il comando ShellV2

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

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

Parametri
command String : il comando che deve essere eseguito.

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

ritorna
CommandResult Il risultato in CommandResult .

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

eseguire il comando ShellV2

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

Parametri
command String : il comando che deve essere eseguito.

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

ritorna
CommandResult Il risultato in CommandResult .

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

eseguire il comando ShellV2

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

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

Parametri
command String : il comando della shell adb 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 riprovare il comando se fallisce a causa di un'eccezione. DeviceNotResponsiveException verrà generata se retryAttempts vengono eseguiti senza successo.

ritorna
CommandResult

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

eseguire il comando ShellV2

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

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

Parametri
command String : il comando della shell adb da eseguire

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

timeUnit TimeUnit : unità per maxTimeToOutputShellResponse

ritorna
CommandResult

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

eseguire il comando ShellV2

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

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

Parametri
command String : il comando della shell adb da eseguire

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

pipeToOutput OutputStream : ERROR(/OutputStream) in cui 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 riprovare il comando se fallisce a causa di un'eccezione. DeviceNotResponsiveException verrà generata se retryAttempts vengono eseguiti senza successo.

ritorna
CommandResult

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

eseguire il comando ShellV2

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

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

Parametri
command String : il comando della shell adb da eseguire

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

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

pipeToError OutputStream : ERROR(/OutputStream) dove verrà reindirizzato l'errore std 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 riprovare il comando se fallisce a causa di un'eccezione. DeviceNotResponsiveException verrà generata se retryAttempts vengono eseguiti senza successo.

ritorna
CommandResult

Lancia
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 , verrà utilizzata la cancellazione rapida per cancellare la partizione. Il dispositivo deve quindi creare un filesystem al successivo avvio del dispositivo. Altrimenti, viene utilizzato il formato fastboot che creerà un nuovo filesystem sul dispositivo.

Previsto per l'uso quando il dispositivo è già in modalità di avvio rapido.

Parametri
partition String : la partizione da cancellare

ritorna
CommandResult il CommandResult contenente l'output del comando

Lancia
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

Lancia
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBasebandVersion

public abstract String getBasebandVersion ()

Metodo pratico per ottenere la versione in banda base (radio) di questo dispositivo. Ottenere la versione radio è specifico 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 restituita qui potrebbe non corrispondere alla versione riportata da fastboot e potrebbe non restituire la versione per la radio CDMA. TL;DR questo metodo segnala una versione accurata solo se la proprietà gsm.version.baseband è uguale alla versione restituita da fastboot getvar version-baseband .

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

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

getBattery

public abstract Integer getBattery ()

Restituisce il livello corrente della batteria 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à specificata.

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 in caso contrario.

Lancia
DeviceNotAvailableException

getBootHistory

public abstract  getBootHistory ()

Il metodo di supporto raccoglie la mappa della cronologia di avvio con l'ora di avvio e il motivo dell'avvio.

ritorna
Mappa del tempo di avvio (ora UTC in secondi dall'epoca) e motivo dell'avvio

Lancia
DeviceNotAvailableException

getBootHistorySince

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

Il metodo di supporto raccoglie la mappa della cronologia di avvio con l'ora di avvio e il motivo dell'avvio dal momento specificato 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 trascorso dal dispositivo da Epoch.

timeUnit TimeUnit : l'unità di tempo TimeUnit .

ritorna
Mappa del tempo di avvio (ora UTC in secondi dall'epoca) e motivo dell'avvio

Lancia
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

Metodo conveniente per ottenere la versione bootloader di questo dispositivo.

Tenterà di recuperare la versione del bootloader dallo stato attuale del dispositivo. (ovvero, se il dispositivo è in modalità fastboot, tenterà di recuperare la versione da fastboot)

ritorna
String la versione del bootloader String o null se non è possibile trovarla

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

getBuildAlias

public abstract String getBuildAlias ()

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

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

ritorna
String l'alias di build o ricorrere all'ID di build se non è possibile recuperarlo

Lancia
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildFlavor

public abstract String getBuildFlavor ()

Recupera la versione di build per il dispositivo.

ritorna
String il sapore di build o null se non è stato possibile recuperarlo

Lancia
com.android.tradefed.device.DeviceNotAvailableException
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

Lancia
com.android.tradefed.device.DeviceNotAvailableException
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 altrimenti.

Lancia
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

ritorna
DeviceDescriptor

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

Parametri
shortDescriptor boolean : se limitare o meno il descrittore alle informazioni minime

ritorna
DeviceDescriptor

getChildren

public abstract String[] getChildren (String deviceFilePath)

Alternativa all'utilizzo 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 stringhe contenenti tutti i file in un percorso sul dispositivo.

Lancia
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getConnection

public abstract AbstractConnection getConnection ()

Restituisce la connessione associata al dispositivo.

ritorna
AbstractConnection

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

Lancia
com.android.tradefed.device.DeviceNotAvailableException
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

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

Parametri
shortDescriptor boolean : se limitare o meno il descrittore alle informazioni minime

ritorna
DeviceDescriptor

getDeviceState

public abstract TestDeviceState getDeviceState ()

Ottieni lo stato del dispositivo.

ritorna
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

Aiutante per ottenere la differenza oraria tra il dispositivo e un determinato ERROR(/Date) . Utilizza il tempo Epoch internamente.

Parametri
date Date

ritorna
long la differenza in millisecondi

Lancia
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 nella memoria esterna del dispositivo.

ritorna
long la quantità di spazio libero in KB

Lancia
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 generico getProductType() , poiché ITestDevice saprà ripristinare il dispositivo in avvio rapido se il dispositivo si trova in uno stato errato o non risponde.

ritorna
String il nome del tipo di prodotto String o null se non è possibile determinarlo

Lancia
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 generico getProductType() , poiché ITestDevice saprà ripristinare il dispositivo in avvio rapido se il dispositivo si trova in uno stato errato o non risponde.

ritorna
String il nome del tipo di prodotto String o null se non è possibile determinarlo

Lancia
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à fastboot.

ritorna
String

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

Recupera il valore della variabile fastboot specificato dal dispositivo.

Parametri
variableName String : il nome della variabile

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

Lancia
Eccezione operazione non supportata
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 un percorso relativo a "/". (cioè è supportata sia la sintassi "/system" che "system")

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

Lancia
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIDevice

public abstract IDevice getIDevice ()

Restituisce un riferimento IDevice ddmlib 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 , poiché tale riferimento potrebbe diventare obsoleto.

ritorna
IDevice l' IDevice

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

Restituisce il valore intero della proprietà specificata 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.

Lancia
DeviceNotAvailableException

getLastexpectedRebooTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

Restituisce l'ultima volta che le API FEDFED hanno innescato un riavvio in millisecondi da quando Epoch è tornato da System.currentTimeMillis() .

ritorna
long

getlaunchapilevel

public abstract int getLaunchApiLevel ()

Ottieni il primo livello API lanciato dal dispositivo. Predefiniti su UNKNOWN_API_LEVEL .

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

Lancia
com.android.tradefed.device.devicenotavailableException
DeviceNotAvailableException

getlogcat

public abstract InputStreamSource getLogcat ()

Afferra un flusso di istantanee dei dati LogCat.

Funziona in due modalità:

  • Se il logcat viene attualmente catturato in background, tornerà su TestDeviceOptions.getMaxLogcatDataSize() byte del contenuto corrente della cattura di 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 istantanee degli ultimi maxBytes dei dati LogCat catturati.

    Utile per i casi in cui si desidera catturare le snapshot frequenti dei dati di Logcat acquisiti senza incorrere nella penalità di spazio del disco potenzialmente grande di ottenere l'intera istantanea getLogcat() .

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

    ritorna
    InputStreamSource

    getlogcatdump

    public abstract InputStreamSource getLogcatDump ()

    Ottieni un dump del logcat corrente per il dispositivo. A differenza di 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 non cattura i dati di Logcat.

    getlogcatsince

    public abstract InputStreamSource getLogcatSince (long date)

    Afferra un flusso di snapshot di dati di logcat acquisiti a partire dalla data fornita. Il tempo sul dispositivo deve essere utilizzato getDeviceDate() .

    Parametri
    date long : in millisecondi dal formato epocale di quando iniziare l'istantanea fino al presente. (può essere ottenuto utilizzando "Data +%S")

    ritorna
    InputStreamSource

    getmountpoint

    public abstract String getMountPoint (String mountName)

    Restituisce un punto di montaggio.

    Interroga il dispositivo direttamente se le informazioni memorizzate nella cache in IDevice non sono disponibili.

    TODO: sposta questo comportamento su IDevice#getMountPoint(String)

    Parametri
    mountName String : il nome del punto di montaggio

    ritorna
    String il punto di montaggio o null

    getMountPointInfo

    public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

    Restituisce un MountPointInfo corrispondente al percorso MountPoint specificato o null se quel percorso non ha nulla montato o altrimenti non appare in /proc /monta come un mountpoint.

    Parametri
    mountpoint String

    ritorna
    ITestDevice.MountPointInfo Un ERROR(/List) di MountPointInfo contenente le informazioni in "/proc/mount"

    Lancia
    DeviceNotAvailableException

    Guarda anche:

    getMountPointInfo

    public abstract  getMountPointInfo ()

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

    ritorna
    Un ERROR(/List) di MountPointInfo contenente le informazioni in "/proc/mount"

    Lancia
    DeviceNotAvailableException

    getpartitionfrespace

    public abstract long getPartitionFreeSpace (String partition)

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

    Parametri
    partition String

    ritorna
    long La quantità di spazio libero in KB

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

    getprocessbyname

    public abstract ProcessInfo getProcessByName (String processName)

    Il metodo helper esegue il comando "PIDOF" e "STAT" e restituisce l'oggetto ProcessInfo con PID e il tempo di inizio del processo del processo dato.

    Parametri
    processName String : la stringa di nome Proces.

    ritorna
    ProcessInfo ProcessInfo di un determinato processo di processo

    Lancia
    DeviceNotAvailableException

    getProcessPid

    public abstract String getProcessPid (String process)

    Restituisce il PID del servizio o nullo se qualcosa è andato storto.

    Parametri
    process String : la stringa di nome Proces.

    ritorna
    String

    Lancia
    DeviceNotAvailableException

    GetProducTType

    public abstract String getProductType ()

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

    Questo metodo funzionerà se il dispositivo è in modalità ADB o Fastboot.

    ritorna
    String Il nome del tipo di prodotto String . Non sarà nullo

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata o se non è possibile determinare il tipo di prodotto

    getProductVariant

    public abstract String getProductVariant ()

    Metodo di convenienza per ottenere la variante del prodotto di questo dispositivo.

    Questo metodo funzionerà se il dispositivo è in modalità ADB o Fastboot.

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

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

    getproperty

    public abstract String getProperty (String name)

    Recupera il valore della proprietà dato dal dispositivo.

    Parametri
    name String : il nome della proprietà

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

    Lancia
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    getRecoverymode

    public abstract ITestDevice.RecoveryMode getRecoveryMode ()

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

    ritorna
    ITestDevice.RecoveryMode La modalità di ripristino corrente utilizzata per il dispositivo.

    getherialnumber

    public abstract String getSerialNumber ()

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

    ritorna
    String il numero di serie String

    GetTomb Stones

    public abstract  getTombstones ()

    Fetch e restituire l'elenco delle pietre tombali dai dispositivi. Richiede radice.

    Il metodo è il miglior sforzo, quindi se una lapide non viene tirata per qualsiasi motivo, mancherà dall'elenco. Solo un DeviceNotAvailableException terminerà presto il metodo.

    ritorna
    Un elenco di file di tomba, vuoto se nessuna tomba.

    Lancia
    DeviceNotAvailableException

    gettotalmemory

    public abstract long getTotalMemory ()

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

    ritorna
    long

    getusefastbooterase

    public abstract boolean getUseFastbootErase ()

    Ottieni se utilizzare Fastboot Cancella o Fastboot Formato per pulire una partizione sul dispositivo.

    ritorna
    boolean true se verrà utilizzato la cancellazione di Fastboot o false se verrà utilizzato il formato Fastboot.

    Isadbroot

    public abstract boolean isAdbRoot ()

    ritorna
    boolean true se il dispositivo ha attualmente la root ADB, false altrimenti.

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

    ISADBTCP

    public abstract boolean isAdbTcp ()

    ritorna
    boolean true se il dispositivo è collegato a ADB-over-TCP, false altrimenti.

    ISappenumerations supportato

    public abstract boolean isAppEnumerationSupported ()

    Controlla se la piattaforma sull'enumerazione dell'app supporta il dispositivo

    ritorna
    boolean Vero se l'enumerazione dell'app è supportata, false altrimenti

    Lancia
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    ISBYPASLOWTARGETSDKBLOCKSUPPORT

    public abstract boolean isBypassLowTargetSdkBlockSupported ()

    Controllare se la piattaforma sul dispositivo supporta il bypassing Blocco SDK target basso sulle installazioni di app

    ritorna
    boolean Vero se il blocco SDK bersaglio a basso taglio è supportato, falso altrimenti

    Lancia
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    isdebugfsmount

    public abstract boolean isDebugfsMounted ()

    Controlla se Debugfs è montato.

    ritorna
    boolean true se Debugfs è montato

    Lancia
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    isdeviceencrypted

    public abstract boolean isDeviceEncrypted ()

    Restituisce se il dispositivo è crittografato.

    ritorna
    boolean true se il dispositivo è crittografato.

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

    isdirectory

    public abstract boolean isDirectory (String deviceFilePath)

    Restituisce true se il percorso sul dispositivo è una directory, false altrimenti.

    Parametri
    deviceFilePath String

    ritorna
    boolean

    Lancia
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    è supportato

    public abstract boolean isEncryptionSupported ()

    Restituisce se la crittografia è supportata sul dispositivo.

    ritorna
    boolean true se il dispositivo supporta la crittografia.

    Lancia
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    isEcutable

    public abstract boolean isExecutable (String fullPath)

    Restituisce vero se il percorso del file sul dispositivo è un file eseguibile, falso altrimenti.

    Parametri
    fullPath String

    ritorna
    boolean

    Lancia
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    isheadless

    public abstract boolean isHeadless ()

    Restituisce true se il dispositivo è senza testa (nessuna schermata), falso altrimenti.

    ritorna
    boolean

    Lancia
    DeviceNotAvailableException

    isruntimepermissions supportato

    public abstract boolean isRuntimePermissionSupported ()

    Controlla se la piattaforma sul dispositivo supporta la concessione dell'autorizzazione di runtime

    ritorna
    boolean Vero se l'autorizzazione di runtime è supportata, false altrimenti.

    Lancia
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    ISSTATEBOOTLOOTHARDERORFASTBOOTD

    public abstract boolean isStateBootloaderOrFastbootd ()

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

    ritorna
    boolean

    Loganrs

    public abstract boolean logAnrs (ITestLogger logger)

    Raccogli e registri gli anRS dal dispositivo.

    Parametri
    logger ITestLogger : un ITestLogger per registrare gli anrs.

    ritorna
    boolean Vero se la registrazione ha avuto successo, falso altrimenti.

    Lancia
    DeviceNotAvailableException

    Logondevice

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

    Registra un messaggio nel logcat del dispositivo. Questa è una chiamata sicura che non lancerà anche se la registrazione fallisce.

    Parametri
    tag String : il tag in cui registriamo il nostro messaggio nel logcat.

    level Log.LogLevel : il livello di debug del messaggio nel logcat.

    format String : il formato del messaggio.

    args Object : l'args da sostituire tramite String.Format ().

    Mountdebugfs

    public abstract void mountDebugfs ()

    Mount Debugfs.

    Lancia
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    non bloccante

    public abstract void nonBlockingReboot ()

    Emette un comando per riavviare il dispositivo e restituisce il comando completo e quando il dispositivo non è più visibile all'ADB.

    Lancia
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    PostbootSetUp

    public abstract void postBootSetup ()

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

    Dovrebbe essere chiamato dopo che il dispositivo è completamente avviato/disponibile

    In circostanze normali questo metodo non deve essere chiamato esplicitamente, poiché le implementazioni dovrebbero eseguire automaticamente questi passaggi durante l'esecuzione di un riavvio.

    Dove potrebbe essere necessario chiamare è quando il dispositivo si riavvia a causa di altri eventi (ad es. Quando è stato completato un comando di aggiornamento rapido)

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

    PostInvocationTeardown

    public void postInvocationTearDown ()

    Questo metodo è deprecato.
    Usa invece postInvocationTearDown(Throwable) .

    Passaggi aggiuntivi per il dispositivo specifico richiesto Cleans che verrà eseguito dopo aver effettuato l'invocazione.

    PostInvocationTeardown

    public abstract void postInvocationTearDown (Throwable invocationException)

    Passaggi aggiuntivi per il dispositivo specifico richiesto Cleans che verrà eseguito dopo aver effettuato l'invocazione.

    Parametri
    invocationException Throwable : se presente, l'ultima eccezione sollevata dall'errore di invocazione.

    preinvocationsetup

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

    Passaggi aggiuntivi per il dispositivo specifico Impostazione richiesta che verrà eseguita sul dispositivo prima del flusso di invocazione.

    Parametri
    info IBuildInfo : l' IBuildInfo del dispositivo.

    attributes MultiMap : gli attributi memorizzati nel contesto di invocazione

    Lancia
    com.android.tradefed.targetprep.targetsetUperror
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException
    TargetSetupError

    pulldir

    public abstract boolean pullDir (String deviceFilePath, 
                    File localDir)

    Tirare in modo ricorsivo il contenuto della directory dal dispositivo.

    Parametri
    deviceFilePath String : il percorso del file assoluto della sorgente remota

    localDir File : la directory locale per attirare i file in

    ritorna
    boolean true se il file è stato tirato correttamente. false altrimenti.

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

    Pullfile

    public abstract File pullFile (String remoteFilePath, 
                    int userId)

    Recupera un dispositivo file off, lo memorizza in un ERROR(/File) e restituisce quel File .

    Parametri
    remoteFilePath String : il percorso assoluto da file sul dispositivo.

    userId int : l'ID utente da trarre da

    ritorna
    File Un ERROR(/File) contenente il contenuto del file del dispositivo o null se la copia non è riuscita per qualsiasi motivo (inclusi i problemi con il filesystem host)

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

    Pullfile

    public abstract File pullFile (String remoteFilePath)

    Recupera un dispositivo file off, lo memorizza in un ERROR(/File) e restituisce quel File .

    Parametri
    remoteFilePath String : il percorso assoluto da file sul dispositivo.

    ritorna
    File Un ERROR(/File) contenente il contenuto del file del dispositivo o null se la copia non è riuscita per qualsiasi motivo (inclusi i problemi con il filesystem host)

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

    Pullfile

    public abstract boolean pullFile (String remoteFilePath, 
                    File localFile)

    Recupera un dispositivo file off.

    Parametri
    remoteFilePath String : il percorso assoluto da file sul dispositivo.

    localFile File : il file locale per archiviare i contenuti in. Se non vuoto, i contenuti verranno sostituiti.

    ritorna
    boolean true se il file è stato recuperato correttamente. false altrimenti.

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

    Pullfile

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

    Recupera un dispositivo file off.

    Parametri
    remoteFilePath String : il percorso assoluto da file sul dispositivo.

    localFile File : il file locale per archiviare i contenuti in. Se non vuoto, i contenuti verranno sostituiti.

    userId int : l'ID utente da trarre da

    ritorna
    boolean true se il file è stato recuperato correttamente. false altrimenti.

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

    PullfileContents

    public abstract String pullFileContents (String remoteFilePath)

    Recupera un dispositivo file off e restituisce il contenuto.

    Parametri
    remoteFilePath String : il percorso assoluto da file sul dispositivo.

    ritorna
    String Una String contenente il contenuto del file del dispositivo o null se la copia non è riuscita per qualsiasi motivo (inclusi i problemi con il filesystem host)

    Lancia
    DeviceNotAvailableException

    Pullfilefromexternal

    public abstract File pullFileFromExternal (String remoteFilePath)

    Un metodo di convenienza per recuperare un file dall'archiviazione esterna del dispositivo, lo memorizza in un ERROR(/File) e restituire un riferimento a quel File .

    Parametri
    remoteFilePath String : il percorso del file sul dispositivo, relativo al monte di archiviazione esterno del dispositivo

    ritorna
    File Un ERROR(/File) contenente il contenuto del file del dispositivo o null se la copia non è riuscita per qualsiasi motivo (inclusi i problemi con il filesystem host)

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

    Pushdir

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

    Spingere ricorsivamente i contenuti della directory al dispositivo escludendo alcune directory che vengono filtrate.

    Parametri
    localDir File : la directory locale da spingere

    deviceFilePath String : il percorso del file assoluto della destinazione remota

    excludedDirectories : Insieme di nomi di directory esclusi che non dovrebbero essere spinti.

    ritorna
    boolean true se il file è stato spinto correttamente. false altrimenti.

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

    Pushdir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath)

    Spingere ricorsivamente i contenuti della directory al dispositivo.

    Parametri
    localDir File : la directory locale da spingere

    deviceFilePath String : il percorso del file assoluto della destinazione remota

    ritorna
    boolean true se il file è stato spinto correttamente. false altrimenti.

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

    Pushfile

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

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

    Parametri
    localFile File : il file locale da spingere

    deviceFilePath String : il percorso del file assoluto di destinazione remoto

    evaluateContentProviderNeeded boolean : se verificare se abbiamo bisogno del fornitore di contenuti

    ritorna
    boolean true se il file è stato spinto correttamente. false altrimenti.

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

    Pushfile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath)

    Spingere un file sul dispositivo. Per impostazione predefinita utilizzando un fornitore di contenuti.

    Parametri
    localFile File : il file locale da spingere

    deviceFilePath String : il percorso del file assoluto di destinazione remoto

    ritorna
    boolean true se il file è stato spinto correttamente. false altrimenti.

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

    spingendo

    public abstract boolean pushString (String contents, 
                    String deviceFilePath)

    Push File creato da una stringa a dispositivo

    Parametri
    contents String : il contenuto del file da spingere

    deviceFilePath String : il percorso del file assoluto di destinazione remoto

    ritorna
    boolean true se la stringa è stata spinta correttamente. false altrimenti.

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

    riavviare

    public abstract void reboot ()

    Riavvia il dispositivo in modalità ADB.

    Blocchi fino a quando il dispositivo non diventa disponibile.

    Lancia
    DeviceNotAvailableException Se il dispositivo non è disponibile dopo il riavvio

    riavviare

    public abstract void reboot (String reason)

    Riavvia il dispositivo in modalità ADB con una determinata reason per essere persistito attraverso il riavvio.

    Blocchi fino a quando il dispositivo non diventa disponibile.

    L'ultima ragione di riavvio può essere ottenuta interrogando sys.boot.reason Propety.

    Parametri
    reason String : un motivo di questo riavvio o null se non viene specificato alcun motivo.

    Lancia
    DeviceNotAvailableException Se il dispositivo non è disponibile dopo il riavvio

    RebootIntOBooTloader

    public abstract void rebootIntoBootloader ()

    Riavvia il dispositivo in modalità bootloader.

    Blocca fino a quando il dispositivo è in modalità bootloader.

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

    rebootIntOfastBootd

    public abstract void rebootIntoFastbootd ()

    Riavvia il dispositivo in modalità FastBootd.

    Blocchi fino a quando il dispositivo è in modalità FastBootd.

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

    rebootIntoTecovery

    public abstract void rebootIntoRecovery ()

    Riavvia il dispositivo in modalità di ripristino ADB.

    Blocca fino a quando il dispositivo non entra nel recupero

    Lancia
    DeviceNotAvailableException Se il dispositivo non è disponibile dopo il riavvio

    rebootIntosideload

    public abstract void rebootIntoSideload (boolean autoReboot)

    Riavvia il dispositivo in modalità Sideload ADB (si noti che questa è una modalità speciale in recupero)

    Blocca fino a quando il dispositivo non entra in modalità sideload

    Parametri
    autoReboot boolean : se riavviare automaticamente il dispositivo dopo sideload

    Lancia
    DeviceNotAvailableException Se il dispositivo non è in cordatura dopo il riavvio

    rebootIntosideload

    public abstract void rebootIntoSideload ()

    Riavvia il dispositivo in modalità Sideload ADB (si noti che questa è una modalità speciale in recupero)

    Blocca fino a quando il dispositivo non entra in modalità sideload

    Lancia
    DeviceNotAvailableException Se il dispositivo non è in cordatura dopo il riavvio

    RebootunTilonline

    public abstract void rebootUntilOnline ()

    Un alternativo al reboot() che blocca solo fino a quando il dispositivo è online, cioè visibile all'ADB.

    Lancia
    DeviceNotAvailableException Se il dispositivo non è disponibile dopo il riavvio

    RebootunTilonline

    public abstract void rebootUntilOnline (String reason)

    Un alternativo al reboot() che blocca solo fino a quando il dispositivo è online, cioè visibile all'ADB.

    Parametri
    reason String : un motivo di questo riavvio o null se non viene specificato alcun motivo.

    Lancia
    DeviceNotAvailableException Se il dispositivo non è disponibile dopo il riavvio

    Guarda anche:

    rebootuserspace

    public abstract void rebootUserspace ()

    Riavvia solo parte degli utenti parte del dispositivo.

    Blocchi fino a quando il dispositivo non diventa disponibile.

    AVVERTIMENTO. Il riavvio degli utenti è attualmente in fase di sviluppo attivo, utilizzarlo a proprio rischio.

    Lancia
    DeviceNotAvailableException Se il dispositivo non è disponibile dopo il riavvio

    RebootuserspaceUnTilonline

    public abstract void rebootUserspaceUntilOnline ()

    Un alternativo a rebootUserspace() () che blocca solo fino a quando il dispositivo è online, cioè visibile ad ADB.

    Lancia
    DeviceNotAvailableException Se il dispositivo non è disponibile dopo il riavvio

    RemountSystemReadonly

    public abstract void remountSystemReadOnly ()

    Rendi la partizione di sistema sul dispositivo di sola lettura. Può riavviare il dispositivo.

    Lancia
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    RemountSystemWritable

    public abstract void remountSystemWritable ()

    Rendi la partizione di sistema sul dispositivo scrivibile. Può riavviare il dispositivo.

    Lancia
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    RemountvendoReadonly

    public abstract void remountVendorReadOnly ()

    Rendi la partizione del fornitore sul dispositivo di sola lettura. Può riavviare il dispositivo.

    Lancia
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    RemountvendorWritable

    public abstract void remountVendorWritable ()

    Rendi la partizione del fornitore sul dispositivo scrivibile. Può riavviare il dispositivo.

    Lancia
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    RuninStrumentationTests

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

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

    Parametri
    runner IRemoteAndroidTestRunner : The IRemoteAndroidTestRunner che esegue i test

    listeners ITestLifeCycleReceiver : The Test Risultati Listener (S)

    ritorna
    boolean true se il comando di prova completato. false se non è riuscito a completare, ma il recupero è riuscito

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata. IE Comando Test non è riuscito a completare e il recupero non è riuscito.

    RuninStrumentationTests

    public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

    Esegue test di strumentazione e fornisce il recupero del dispositivo.

    Se la connessione con il dispositivo viene persa prima del completamento del test e il recupero abbia successo, tutti gli ascoltatori saranno informati di TestRunfaild e "False" verranno restituiti. Il comando di test non verrà eseguito. Viene lasciato ai chiamanti per riprovare se necessario.

    Se la connessione con il dispositivo viene persa prima del completamento del test e il recupero fallisce, tutti gli ascoltatori saranno informati di TestRunfaild e DevicenoTavailableException verrà lanciato.

    Parametri
    runner IRemoteAndroidTestRunner : The IRemoteAndroidTestRunner che esegue i test

    listeners : Listener del risultato del test

    ritorna
    boolean true se il comando di prova completato. false se non è riuscito a completare a causa dell'eccezione della comunicazione del dispositivo, ma il recupero è riuscito

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata. IE Comando Test non è riuscito a completare e il recupero non è riuscito.

    RuninStrumentationTestSasuser

    public abstract boolean 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.

    Parametri
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    ritorna
    boolean

    Lancia
    DeviceNotAvailableException

    RuninStrumentationTestSasuser

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

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

    Parametri
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    ritorna
    boolean

    Lancia
    DeviceNotAvailableException

    impostare la data

    public abstract void setDate (Date date)

    Imposta la data sul dispositivo

    Nota: la data di impostazione sul dispositivo richiede root

    Parametri
    date Date : specificare una data particolare; Utilizzerà la data host se null

    Lancia
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    setoptions

    public abstract void setOptions (TestDeviceOptions options)

    Imposta TestDeviceOptions per il dispositivo

    Parametri
    options TestDeviceOptions

    SetProperty

    public abstract boolean setProperty (String propKey, 
                    String propValue)

    Imposta il valore della proprietà dato sul dispositivo. Richiede che la radice ADB sia vera.

    Parametri
    propKey String : la chiave mirata da impostare.

    propValue String : il valore della proprietà da impostare.

    ritorna
    boolean Restituisce True se il comando setProp ha avuto successo, falso altrimenti.

    Lancia
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    SetRecovery

    public abstract void setRecovery (IDeviceRecovery recovery)

    Imposta su IDeviceRecovery su questo dispositivo. Dovrebbe essere impostato quando il dispositivo viene assegnato per la prima volta.

    Parametri
    recovery IDeviceRecovery : The IDeviceRecovery

    setRecoverymode

    public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

    Utilizzato per controllare quale metodo di recupero utilizzare quando si incontra un problema di comunicazione del dispositivo. Si consiglia di utilizzare questo metodo solo con parsimonia quando necessario (ad esempio, quando il framework è inattivo, ecc.

    Parametri
    mode ITestDevice.RecoveryMode : la modalità "Ripristina fino a quando online" dovrebbe essere attiva o meno.

    SetUeSeSfastBooterase

    public abstract void setUseFastbootErase (boolean useFastbootErase)

    Impostare se utilizzare Fastboot Cancella o Fastboot Formato per pulire una partizione sul dispositivo.

    Parametri
    useFastbootErase boolean : true se la cancellazione di Fastboot deve essere utilizzata o false se è necessario utilizzare un formato di stivale veloce.

    startlogcat

    public abstract void startLogcat ()

    Avvia l'acquisizione dell'output di Logcat dal dispositivo in background.

    Non avrà alcun effetto se l'output di Logcat è già stato catturato. I dati possono essere successivamente recuperati tramite getLogcat.

    Quando il dispositivo non è più in uso, deve essere chiamato stopLogcat() .

    startLogcat() e stopLogcat() normalmente non devono essere chiamati quando all'interno di un contesto di invocazione TF, poiché il framework TF inizierà e interromperà Logcat.

    stopemularOutput

    public abstract void stopEmulatorOutput ()

    Chiudere ed eliminare l'output dell'emulatore.

    StopLogcat

    public abstract void stopLogcat ()

    Interrompere l'acquisizione di output di logcat dal dispositivo e scartare i dati di logcat attualmente salvati.

    Non avrà alcun effetto se l'output di Logcat non viene acquisito.

    SwitchToadBtcp

    public abstract String switchToAdbTcp ()

    Passa il dispositivo in modalità ADB-over-TCP.

    ritorna
    String Il numero di serie TCP o null se il dispositivo non poteva essere commutato

    Lancia
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    SwitchToadBusb

    public abstract boolean switchToAdbUsb ()

    Passa il dispositivo su ADB in modalità USB.

    ritorna
    boolean true se Switch ha avuto successo, false altrimenti.

    Lancia
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    SyncFiles

    public abstract boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

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

    Decide quali file spingono confrontando i timestamp dei file locali con i loro equivalenti remoti. Solo i file "più nuovi" o inesistenti verranno spinti sul dispositivo. Pertanto, le spese generali dovrebbero essere relativamente piccole se il file impostato sul dispositivo è già aggiornato.

    I file nascosti (con nomi che iniziano con ".") Verranno ignorati.

    Esempio di utilizzo: syncFiles ("/tmp/files", "/sdcard") creerà la directory a/sdcard/file se non esiste già e spingere ricorsivamente il contenuto/tmp/files su/sdcard/files.

    Parametri
    localFileDir File : la directory dei file locali contenente file per spingere in modo ricorsivo.

    deviceFilePath String : il root del percorso del file assoluto di destinazione remoto. Tutte le directory nel percorso del file tos devono essere leggibili. cioè spingere a/data/locale/tmp quando l'ADB non è root fallirà

    ritorna
    boolean true se i file sono stati sincronizzati correttamente. false altrimenti.

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

    UnlockDevice

    public abstract boolean unlockDevice ()

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

    Questo metodo può riavviare il framework ma non chiamerà postBootSetup() . Pertanto, il dispositivo potrebbe non essere completamente pronto per essere testato al ritorno di questo metodo.

    ritorna
    boolean true in caso di successo o se il dispositivo non è crittografato.

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.
    UnsupportedOperationException Se la crittografia non è supportata sul dispositivo.

    unmountDebugfs

    public abstract void unmountDebugfs ()

    Debugfs non montare.

    Lancia
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    WaitTorBootComplete

    public abstract boolean waitForBootComplete (long timeOut)

    Blocchi fino a quando il flag completo del dispositivo non è impostato.

    Parametri
    timeOut long : tempo negli msec per attendere che la bandiera venga impostata

    ritorna
    boolean Vero se il flag completo di avvio del dispositivo è impostato entro il timeout

    Lancia
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    waitfordeviceavailable

    public abstract boolean waitForDeviceAvailable ()

    Aspetta che il dispositivo sia reattivo e disponibile per i test. Utilizza il timeout predefinito.

    ritorna
    boolean Vero se è disponibile un dispositivo, false se il ripristino è disabilitato e non disponibile.

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

    waitfordeviceavailable

    public abstract boolean waitForDeviceAvailable (long waitTime)

    Aspetta che il dispositivo sia reattivo e disponibile per i test.

    Parametri
    waitTime long : il tempo in MS da aspettare

    ritorna
    boolean Vero se è disponibile un dispositivo, false se il ripristino è disabilitato e non disponibile.

    Lancia
    DeviceNotAvailableException Se il dispositivo non risponde ancora dopo la scadenza.

    waitfordeviceavailableInRecoverPath

    public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

    Aspetta che il dispositivo sia reattivo e disponibile senza considerare il percorso di recupero.

    Parametri
    waitTime long

    ritorna
    boolean Vero se il dispositivo è disponibile, falso se non disponibile.

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

    waitFordevicebootloader

    public abstract void waitForDeviceBootloader ()

    Blocchi fino a quando il dispositivo è visibile tramite Fastboot. Usa il timeout predefinito.

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

    waitfordeviceinrecovery

    public abstract boolean waitForDeviceInRecovery (long waitTime)

    Blocchi che il dispositivo sia nello stato "ADB Recovery" (si noti che è distinto da IDeviceRecovery ).

    Parametri
    waitTime long : il tempo in MS da aspettare

    ritorna
    boolean true se il dispositivo si avvia nel recupero prima della scadenza del tempo. false altrimenti

    WaitFordeViceInsideload

    public abstract boolean waitForDeviceInSideload (long waitTime)

    Blocchi che il dispositivo sia nello stato "ADB Sideload"

    Parametri
    waitTime long : il tempo in MS da aspettare

    ritorna
    boolean true se il dispositivo si avvia in Sideload prima della scadenza del tempo. false altrimenti

    waitfordevicenotavailabile

    public abstract boolean waitForDeviceNotAvailable (long waitTime)

    Blocchi che il dispositivo non sia disponibile, cioè mancante da ADB

    Parametri
    waitTime long : il tempo in MS da aspettare

    ritorna
    boolean true se il dispositivo non diventa disponibile prima della scadenza del tempo. false altrimenti

    waitfordeviceonline

    public abstract void waitForDeviceOnline ()

    Blocchi fino a quando il dispositivo è visibile tramite ADB. Utilizza il timeout predefinito

    Nota che il dispositivo potrebbe non essere necessariamente sensibile ai comandi al completamento. Usa invece waitForDeviceAvailable() .

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

    waitfordeviceonline

    public abstract void waitForDeviceOnline (long waitTime)

    Blocchi fino a quando il dispositivo è visibile tramite ADB.

    Nota che il dispositivo potrebbe non essere necessariamente sensibile ai comandi al completamento. Usa invece waitForDeviceAvailable() .

    Parametri
    waitTime long : il tempo in MS da aspettare

    Lancia
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

    WaitFordeVicesHell

    public abstract boolean waitForDeviceShell (long waitTime)

    Aspetta che il dispositivo sia reattivo a un comando di base Shell di base.

    Parametri
    waitTime long : il tempo in MS da aspettare

    ritorna
    boolean true se il dispositivo diventa reattivo prima che trascorra waitTime .