INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice


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

Esegue nuovamente i comandi del dispositivo per un numero di volte configurabile e fornisce un'interfaccia di recupero 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 in base a un livello di supporto minimo.

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 void deleteFile(String deviceFilePath, int userId)

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

abstract boolean deviceSoftRestarted(ProcessInfo prevSystemServerProcess)

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

abstract boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

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

abstract boolean disableAdbRoot()

Disattiva il root ADB.

abstract boolean doesFileExist(String deviceFilePath)

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

abstract boolean enableAdbRoot()

Attiva il root adb.

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)

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

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

abstract String executeShellCommand(String command)

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

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

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

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

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

abstract void executeShellCommand(String command, IShellOutputReceiver receiver)

Esegue il comando adb shell specificato, riprova più volte se il comando non va a buon fine.

abstract CommandResult executeShellV2Command(String command)

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

abstract CommandResult executeShellV2Command(String command, OutputStream pipeToOutput)

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

abstract CommandResult executeShellV2Command(String command, File pipeAsInput)

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

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

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

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

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

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

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

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

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

abstract CommandResult fastbootWipePartition(String partition)

Metodo di supporto che cancella una partizione del dispositivo.

abstract int getApiLevel()

Recupera il livello API del dispositivo.

abstract String getBasebandVersion()

Metodo pratico per ottenere la versione banda di 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 assistenza raccoglie la mappa della cronologia dell'avvio con l'ora e il motivo dell'avvio.

abstract getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)

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

abstract String getBootloaderVersion()

Metodo pratico per ottenere la versione del bootloader di questo dispositivo.

abstract String getBuildAlias()

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

abstract String getBuildFlavor()

Recupera il flavor 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 di IFileEntry che a volte non funziona a causa delle autorizzazioni.

abstract AbstractConnection getConnection()

Restituisce la connessione associata al dispositivo.

abstract String getDeviceClass()

Recupera la classe del dispositivo.

abstract long getDeviceDate()

Restituisce la data del dispositivo in millisecondi dall'epoca.

abstract DeviceDescriptor getDeviceDescriptor()

Restituire un DeviceDescriptor dalle informazioni del dispositivo per ottenere informazioni su di esso senza dover passare l'oggetto del dispositivo effettivo.

abstract DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

Restituire un DeviceDescriptor dalle informazioni del dispositivo per ottenere informazioni su di esso senza dover passare l'oggetto del dispositivo effettivo.

abstract TestDeviceState getDeviceState()

Recupera lo stato del dispositivo.

abstract long getDeviceTimeOffset(Date date)

Funzione di supporto per ottenere la differenza di fuso orario tra il dispositivo e un determinato ERROR(/Date).

abstract InputStreamSource getEmulatorOutput()

Ottieni lo stream di stdout e stderr dell'emulatore

abstract long getExternalStoreFreeSpace()

Metodo di supporto per determinare la quantità di spazio libero sullo spazio di archiviazione esterno del dispositivo.

abstract String getFastbootProductType()

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

abstract String getFastbootProductVariant()

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

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 alla libreria ddmlib IDevice associata.

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 dall'epoca EPOCH come riportato da System.currentTimeMillis().

abstract int getLaunchApiLevel()

Ottieni il livello API del primo lancio del dispositivo.

abstract InputStreamSource getLogcat()

Acquisisce uno stream di snapshot dei dati di logcat.

abstract InputStreamSource getLogcat(int maxBytes)

Acquisisce uno stream di snapshot degli ultimi maxBytes dati logcat acquisiti.

abstract InputStreamSource getLogcatDump()

Ottieni un dump del logcat corrente per il dispositivo.

abstract InputStreamSource getLogcatSince(long date)

Acquisisce uno stream di snapshot dei dati logcat acquisiti a partire dalla data indicata.

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 non è montato nulla in quel percorso o se non viene visualizzato come punto di montaggio in /proc/mounts.

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 nella partizione del dispositivo.

abstract ProcessInfo getProcessByName(String processName)

Il metodo di supporto esegue i comandi "pidof" e "stat" e restituisce l'oggetto ProcessInfo con il PID e l'ora di inizio del processo in questione.

abstract String getProcessPid(String process)

Restituisce il pid del servizio o null se si è verificato un problema.

abstract String getProductType()

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

abstract String getProductVariant()

Metodo pratico per ottenere la variante del 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 tombstone dai dispositivi.

abstract long getTotalMemory()

Restituisce le dimensioni totali della memoria fisica in byte o -1 in caso di errore interno

default String getTrackingSerial()

Per la gestione del dispositivo, ottieni il numero di serie utilizzato per monitorarlo.

abstract boolean getUseFastbootErase()

Scopri se utilizzare fastboot erase o fastboot format per cancellare una partizione sul dispositivo.

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

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

abstract boolean isBypassLowTargetSdkBlockSupported()

Verificare se la piattaforma sul dispositivo supporta il bypass del blocco dell'SDK target basso per le installazioni di app

abstract boolean isDebugfsMounted()

Controlla se debugfs è montato.

abstract boolean isDeviceEncrypted()

Restituisce true se il dispositivo è criptato.

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, altrimenti restituisce false.

abstract boolean isHeadless()

Restituisce true se il dispositivo è senza display (nessun schermo), false 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 debugfs.

abstract void nonBlockingReboot()

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

abstract void postBootSetup()

Segui le istruzioni per configurare il dispositivo per i test dopo ogni avvio.

default void postInvocationTearDown()

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

abstract void postInvocationTearDown(Throwable invocationException)

Passaggi aggiuntivi per la pulizia richiesta specifica del dispositivo che verranno eseguiti al termine dell'invocazione.

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)

Estrai in modo ricorsivo i contenuti della directory dal dispositivo.

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

Estrai in modo ricorsivo i contenuti della directory dal dispositivo.

abstract File pullFile(String remoteFilePath, int userId)

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

abstract File pullFile(String remoteFilePath)

Recupera un file dal dispositivo, lo memorizza in un ERROR(/File) temporaneo locale e restituisce questo 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 i contenuti.

abstract File pullFileFromExternal(String remoteFilePath)

Un metodo pratico per recuperare un file dallo spazio di archiviazione esterno del dispositivo, memorizzarlo in un ERROR(/File)temporaneo locale e restituire un riferimento a quel File.

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

Esegui il push dei contenuti della directory sul dispositivo in modo ricorsivo.

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

Esegui il push dei contenuti delle directory sul dispositivo in modo ricorsivo, escludendo alcune directory filtrate.

abstract boolean pushDir(File localDir, String deviceFilePath)

Esegui il push dei contenuti della directory sul dispositivo in modo ricorsivo.

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

Variante di pushFile(File, String) che può eventualmente prendere in considerazione la valutazione del bisogno per il fornitore di contenuti.

abstract boolean pushFile(File localFile, String deviceFilePath)

Invia un file al dispositivo.

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

Invia un file al dispositivo.

abstract boolean pushString(String contents, String deviceFilePath)

Inviare 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 il valore reason specificato da mantenere dopo 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 (tieni presente che si tratta di una modalità speciale in fase di recupero)

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

abstract void rebootIntoSideload()

Riavvia il dispositivo in modalità sideload adb (tieni presente che si tratta di una modalità speciale in fase di recupero)

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

abstract void rebootUntilOnline()

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

abstract void rebootUntilOnline(String reason)

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

abstract void rebootUserspace()

Riavvia solo la parte dello spazio utente del dispositivo.

abstract void rebootUserspaceUntilOnline()

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

abstract void remountSystemReadOnly()

Imposta la partizione di sistema sul dispositivo come di sola lettura.

abstract void remountSystemWritable()

Rendi la partizione di sistema sul dispositivo scrivibile.

abstract void remountVendorReadOnly()

Imposta la partizione del fornitore sul dispositivo come di sola lettura.

abstract void remountVendorWritable()

Rendi la partizione del fornitore sul dispositivo scrivibile.

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

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

abstract boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)

Esegue test di strumentazione e fornisce il recupero del dispositivo.

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

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

Come 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 i permessi di root

abstract void setOptions(TestDeviceOptions options)

Impostare TestDeviceOptions per il dispositivo

abstract boolean setProperty(String propKey, String propValue)

Imposta il valore della proprietà specificato sul dispositivo.

abstract void setRecovery(IDeviceRecovery recovery)

Imposta il 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 setTrackingSerial(String trackingSerial)

Per la gestione del dispositivo, monitora il numero di serie che utilizziamo per fare riferimento al dispositivo.

abstract void setUseFastbootErase(boolean useFastbootErase)

Imposta se utilizzare l'opzione fastboot erase o fastboot format 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()

Interrompi l'acquisizione dell'output di Logcat dal dispositivo ed elimina i dati di 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 i contenuti di una directory di file locale con il dispositivo.

abstract boolean unlockDevice()

Sblocca il dispositivo se è criptato.

abstract void unmountDebugfs()

Smonta debugfs.

abstract boolean waitForBootComplete(long timeOut)

Blocca fino al momento in cui non viene impostato il flag di completamento dell'avvio del dispositivo.

abstract boolean waitForDeviceAvailable()

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

abstract boolean waitForDeviceAvailable(long waitTime)

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

abstract boolean waitForDeviceAvailableInRecoverPath(long waitTime)

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

abstract void waitForDeviceBootloader()

Blocca fino a quando il dispositivo non è visibile tramite fastboot.

abstract boolean waitForDeviceInRecovery(long waitTime)

Impedisce al dispositivo di trovarsi nello stato "adb recovery" (tieni presente che questo è diverso da IDeviceRecovery).

abstract boolean waitForDeviceInSideload(long waitTime)

Blocca il dispositivo in stato "sideload adb"

abstract boolean waitForDeviceNotAvailable(long waitTime)

Blocca il dispositivo in modo che non sia disponibile, ad esempio non sia presente in adb

abstract void waitForDeviceOnline()

Blocca fino a quando il dispositivo non è visibile tramite adb.

abstract void waitForDeviceOnline(long waitTime)

Blocca fino a quando il dispositivo non è visibile tramite adb.

abstract boolean waitForDeviceShell(long waitTime)

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

Costanti

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

Valore predefinito quando non è possibile rilevare il livello API

Valore costante: -1 (0xffffffff)

Metodi pubblici

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Controlla se una funzionalità è attualmente supportata in base a un livello di supporto minimo. Questo metodo prende in considerazione le funzionalità non ancora rilasciate, prima dell'aumento del livello dell'API.

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

Ritorni
boolean True se il livello è supportato. Falso negli altri casi.

Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

clearLogcat

public abstract void clearLogcat ()

Elimina tutti i dati logcat accumulati.

Questa operazione è utile nei casi in cui vuoi assicurarti che ITestDevice.getLogcat() restituisca solo i dati di log generati dopo un determinato punto (ad esempio dopo il flashing di una nuova build del dispositivo e così via).

deleteFile

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.

Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deleteFile

public abstract void deleteFile (String deviceFilePath, 
                int userId)

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

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

userId int: l'ID utente da cui eliminare gli elementi

Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deviceSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

Parametri
prevSystemServerProcess ProcessInfo: il processo system_server precedente ProcessInfo.

Ritorni
boolean true se il dispositivo è stato riavviato in modo soft

Lanci
RuntimeException if device has abnormal boot reason
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deviceSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Metodo di supporto per verificare se il dispositivo è stato riavviato in modo soft dall'ora UTC dall'epoca del dispositivo e del relativo ERROR(/TimeUnit). Con riavvio soft si intende il riavvio di system_server al di fuori di un riavvio forzato del dispositivo (ad esempio, riavvio richiesto). Il valore utcEpochTime corrente del dispositivo in millisecondi può essere ottenuto tramite il metodo getDeviceDate().

Parametri
utcEpochTime long: l'ora del dispositivo in secondi dall'epoca.

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

Ritorni
boolean true se il dispositivo è stato riavviato in modo soft

Lanci
RuntimeException if device has abnormal boot reason
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

disableAdbRoot

public abstract boolean disableAdbRoot ()

Disattiva il root ADB.

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

Ritorni
boolean true se l'operazione è riuscita.

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

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath)

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

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

Ritorni
boolean true se il file esiste, false altrimenti.

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

enableAdbRoot

public abstract boolean enableAdbRoot ()

Attiva il root adb. Se l'impostazione "enable-root" è "false", verrà registrato un messaggio e il metodo verrà restituito senza attivare il ruolo di root.

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

Ritorni
boolean true se l'operazione è riuscita.

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

executeAdbCommand

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), ove possibile, in quanto questo metodo offre un migliore rilevamento degli errori e un rendimento migliore.

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

commandArgs String: il comando adb e gli argomenti da eseguire

Ritorni
String l'output standard del comando. null se l'esecuzione del comando non è riuscita.

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

executeAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

executeShellCommand(String), ove possibile, in quanto questo metodo offre un migliore rilevamento degli errori e un rendimento migliore.

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

Ritorni
String l'output standard del comando. null se l'esecuzione del comando non è riuscita.

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

executeAdbCommand

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), ove possibile, in quanto questo metodo offre un migliore rilevamento degli errori e un rendimento migliore.

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

envMap : ambiente da impostare per il comando

commandArgs String: il comando adb e gli argomenti da eseguire

Ritorni
String l'output standard del comando. null se l'esecuzione del comando non è riuscita.

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

executeFastbootCommand

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

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

Deve essere utilizzato quando il dispositivo è già in modalità Fastboot.

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

commandArgs String: il comando fastboot e gli argomenti da eseguire

Ritorni
CommandResult il CommandResult contenente l'output del comando

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

executeFastbootCommand

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.

Deve essere utilizzato quando il dispositivo è già in modalità Fastboot.

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

Ritorni
CommandResult il CommandResult contenente l'output del comando

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

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

È identico a executeFastbootCommand(String), tranne per il fatto che utilizza un timeout più lungo.

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

Ritorni
CommandResult il CommandResult contenente l'output del comando

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

executeLongFastbootCommand

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

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

È identico a executeFastbootCommand(String), tranne per il fatto che utilizza un timeout più lungo.

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

commandArgs String: il comando fastboot e gli argomenti da eseguire

Ritorni
CommandResult il CommandResult contenente l'output del comando

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

executeShellCommand

public abstract String executeShellCommand (String command)

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

Parametri
command String: il comando adb shell da eseguire

Ritorni
String l'output della shell

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

executeShellCommand

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

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

Parametri
command String: il comando adb shell da eseguire

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

maxTimeToOutputShellResponse long: il periodo di tempo massimo durante il quale il comando è autorizzato a non produrre alcuna risposta; unità specificata in timeUnit

timeUnit TimeUnit: unità per maxTimeToOutputShellResponse

retryAttempts int: il numero massimo di volte per riprovare il comando se non va a buon fine a causa di un'eccezione. Viene generata un'eccezione DeviceNotResponsiveException se le operazioni retryAttempts vengono eseguite senza esito.

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

executeShellCommand

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

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

Parametri
command String: il comando adb shell da eseguire

receiver IShellOutputReceiver: il 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 è autorizzato a non produrre alcuna risposta; unità specificata in timeUnit

timeUnit TimeUnit: unità per maxTimeToOutputShellResponse

retryAttempts int: il numero massimo di volte per riprovare il comando se non va a buon fine a causa di un'eccezione. Viene generata un'eccezione DeviceNotResponsiveException se retryAttempts viene eseguita senza esito.

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

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Esegue il comando adb shell specificato, riprova più volte se il comando non va a buon fine.

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

Parametri
command String: il comando adb shell da eseguire

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

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command)

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

Parametri
command String: il comando da eseguire.

Ritorni
CommandResult Il risultato in CommandResult.

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

Metodo di supporto che esegue un comando adb shell e restituisce i risultati come CommandResult compilato correttamente con l'output dello stato del comando e stderr. stdout viene indirizzato allo stream specificato.

Parametri
command String: il comando da eseguire.

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

Ritorni
CommandResult Il risultato in CommandResult.

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

Parametri
command String: il comando da eseguire.

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

Ritorni
CommandResult Il risultato in CommandResult.

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

executeShellV2Command

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

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

Parametri
command String: il comando adb shell da eseguire

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

timeUnit TimeUnit: unità per maxTimeToOutputShellResponse

retryAttempts int: il numero massimo di volte per riprovare il comando se non va a buon fine a causa di un'eccezione. Viene generata un'eccezione DeviceNotResponsiveException se retryAttempts viene eseguita senza esito.

Ritorni
CommandResult

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

executeShellV2Command

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

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

Parametri
command String: il comando adb shell da eseguire

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

timeUnit TimeUnit: unità per maxTimeToOutputShellResponse

Ritorni
CommandResult

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

executeShellV2Command

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

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

Parametri
command String: il comando adb shell da eseguire

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

pipeToOutput OutputStream: ERROR(/OutputStream) dove verrà reindirizzato l'output standard 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 non va a buon fine a causa di un'eccezione. Viene generata un'eccezione DeviceNotResponsiveException se retryAttempts viene eseguita senza esito.

Ritorni
CommandResult

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

executeShellV2Command

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

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

Parametri
command String: il comando adb shell da eseguire

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

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

pipeToError OutputStream: ERROR(/OutputStream) dove verrà reindirizzato l'errore standard 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 non va a buon fine a causa di un'eccezione. Viene generata un'eccezione DeviceNotResponsiveException se retryAttempts viene eseguita senza esito.

Ritorni
CommandResult

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

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

Metodo di supporto che cancella una partizione del dispositivo.

Se getUseFastbootErase() è true, verrà utilizzata la cancellazione di Fastboot per cancellare la partizione. Al successivo riavvio, il dispositivo deve creare un file system. In caso contrario, viene utilizzato il formato fastboot, che crea un nuovo file system sul dispositivo.

Deve essere utilizzato quando il dispositivo è già in modalità Fastboot.

Parametri
partition String: la partizione da cancellare

Ritorni
CommandResult il CommandResult contenente l'output del comando

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

getApiLevel

public abstract int getApiLevel ()

Recupera il livello API del dispositivo. Il valore predefinito è UNKNOWN_API_LEVEL.

Ritorni
int Un numero intero che indica il livello API del dispositivo

Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBasebandVersion

public abstract String getBasebandVersion ()

Metodo pratico per ottenere la versione banda di base (radio) di questo dispositivo. L'ottenimento della versione radio è specifica per il dispositivo, pertanto 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 corrette. Questo valore non è preciso per alcuni dispositivi CDMA e la versione restituita qui potrebbe non corrispondere alla versione segnalata da fastboot e potrebbe non restituire la versione per la radio CDMA. TL;DR questo metodo riporta la versione accurata solo se la proprietà gsm.version.baseband è uguale alla versione restituita da fastboot getvar version-baseband.

Ritorni
String la versione banda di base String o null se non è possibile determinarla (il dispositivo non ha radio o la stringa di versione non può essere letta)

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

getBattery

public abstract Integer getBattery ()

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

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

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

Lanci
DeviceNotAvailableException

getBootHistory

public abstract  getBootHistory ()

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

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

Lanci
DeviceNotAvailableException

getBootHistorySince

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

Il metodo di supporto raccoglie la mappa della cronologia dell'avvio con l'ora di avvio e il motivo dell'avvio dal momento specificato dall'epoca del dispositivo e dall'unità di tempo specificata. Il valore utcEpochTime corrente del dispositivo in millisecondi può essere ottenuto tramite il metodo getDeviceDate().

Parametri
utcEpochTime long: l'ora del dispositivo dall'epoca.

timeUnit TimeUnit: l'unità di tempo TimeUnit.

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

Lanci
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

Metodo pratico per ottenere la versione del bootloader di questo dispositivo.

Proverà a recuperare la versione del bootloader dallo stato attuale del dispositivo. (ad es. se il dispositivo è in modalità Fastboot, tenterà di recuperare la versione da Fastboot)

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

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

getBuildAlias

public abstract String getBuildAlias ()

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

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

Ritorni
String l'alias build o l'ID build di riserva se non è stato possibile recuperarlo

Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildFlavor

public abstract String getBuildFlavor ()

Recupera il flavor di build per il dispositivo.

Ritorni
String il flavor di build o null se non è stato possibile recuperarlo

Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildId

public abstract String getBuildId ()

Recupera la build attualmente in esecuzione sul dispositivo.

Ritorni
String l'ID build o IBuildInfo.UNKNOWN_BUILD_ID se non è stato possibile recuperarlo

Lanci
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).

Ritorni
String La chiave di firma, se trovata, altrimenti null.

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

Ritorni
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: indica se limitare o meno il descrittore alle informazioni minime

Ritorni
DeviceDescriptor

getChildren

public abstract String[] getChildren (String deviceFilePath)

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

Parametri
deviceFilePath String: è il percorso sul dispositivo in cui eseguire la ricerca

Ritorni
String[] Array di stringhe contenente tutti i file in un percorso sul dispositivo.

Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getConnection

public abstract AbstractConnection getConnection ()

Restituisce la connessione associata al dispositivo.

Ritorni
AbstractConnection

getDeviceClass

public abstract String getDeviceClass ()

Recupera la classe del dispositivo.

Ritorni
String la classe del dispositivo String.

getDeviceDate

public abstract long getDeviceDate ()

Restituisce la data del dispositivo in millisecondi dall'epoca.

Ritorni
long La data del dispositivo in formato epoch.

Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

Restituire un DeviceDescriptor dalle informazioni del dispositivo per ottenere informazioni su di esso senza dover passare l'oggetto del dispositivo effettivo.

Ritorni
DeviceDescriptor

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Restituire un DeviceDescriptor dalle informazioni del dispositivo per ottenere informazioni su di esso senza dover passare l'oggetto del dispositivo effettivo.

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

Ritorni
DeviceDescriptor

getDeviceState

public abstract TestDeviceState getDeviceState ()

Recupera lo stato del dispositivo.

Ritorni
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

Funzione di supporto per ottenere la differenza di fuso orario tra il dispositivo e un determinato ERROR(/Date). Utilizza internamente il tempo Epoch.

Parametri
date Date

Ritorni
long la differenza in millisecondi

Lanci
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

Ottieni lo stream di stdout e stderr dell'emulatore

Ritorni
InputStreamSource output dell'emulatore

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

Metodo di supporto per determinare la quantità di spazio libero sullo spazio di archiviazione esterno del dispositivo.

Ritorni
long la quantità di spazio libero in KB

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

getFastbootProductType

public abstract String getFastbootProductType ()

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

Questo metodo deve essere utilizzato solo se il dispositivo è in modalità Fastboot. In questo caso è una variante un po' più sicura rispetto al metodo generico getProductType(), perché ITestDevice sa come recuperare il dispositivo in fastboot se è in uno stato errato o non risponde.

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

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

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

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

Questo metodo deve essere utilizzato solo se il dispositivo è in modalità Fastboot. In questo caso è una variante un po' più sicura rispetto al metodo generico getProductType(), perché ITestDevice sa come recuperare il dispositivo in fastboot se è in uno stato errato o non risponde.

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

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

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

Restituisce il numero di serie della modalità Fastboot.

Ritorni
String

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

Recupera il valore della variabile fastboot specificato dal dispositivo.

Parametri
variableName String: il nome della variabile

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

Lanci
UnsupportedOperationException
DeviceNotAvailableException

getFileEntry

public abstract IFileEntry getFileEntry (String path)

Recupera un riferimento a un file remoto sul dispositivo.

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

Ritorni
IFileEntry IFileEntry o null se non è possibile trovare il file in path

Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIDevice

public abstract IDevice getIDevice ()

Restituisce un riferimento alla libreria ddmlib IDevice associata.

Un nuovo IDevice potrebbe essere allocato da DDMS ogni volta che il dispositivo si scollega e si ricollega da adb. Pertanto, gli utenti che chiamano non devono conservare un riferimento a IDevice, poiché questo riferimento potrebbe diventare obsoleto.

Ritorni
IDevice 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.

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

Lanci
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

Restituisce l'ultima volta che le API TradeFed hanno attivato un riavvio in millisecondi dall'epoca EPOCH come riportato da System.currentTimeMillis().

Ritorni
long

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

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

Ritorni
int Un numero intero che indica il primo livello API del dispositivo lanciato

Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getLogcat

public abstract InputStreamSource getLogcat ()

Acquisisce uno stream di snapshot dei dati di logcat.

Funziona in due modalità:

  • Se il logcat è attualmente in fase di acquisizione in background, restituisce fino a TestDeviceOptions.getMaxLogcatDataSize() byte dei contenuti correnti dell'acquisizione di logcat in background
  • In caso contrario, restituirà un dump statico dei dati di logcat se il dispositivo è attualmente in risposta

    Ritorni
    InputStreamSource

  • getLogcat

    public abstract InputStreamSource getLogcat (int maxBytes)

    Acquisisce uno stream di snapshot degli ultimi maxBytes dati logcat acquisiti.

    È utile nei casi in cui vuoi acquisire snapshot frequenti dei dati logcat acquisiti senza incorrere nella penalizzazione dello spazio su disco potenzialmente elevato dell'intero snapshot getLogcat().

    Parametri
    maxBytes int: la quantità massima di dati da restituire. Deve essere un importo che possa essere memorizzato comodamente in memoria

    Ritorni
    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 non viene restituito nulla se il dispositivo non è raggiungibile.

    Ritorni
    InputStreamSource un InputStreamSource dei dati di Logcat. Viene restituito uno stream vuoto se non riesce a acquisire i dati di logcat.

    getLogcatSince

    public abstract InputStreamSource getLogcatSince (long date)

    Acquisisce uno stream di snapshot dei dati logcat acquisiti a partire dalla data indicata. Deve essere utilizzato l'ora sul dispositivo getDeviceDate().

    Parametri
    date long: in millisecondi dal formato epoch di quando iniziare lo snapshot fino al momento attuale. (può essere ottenuto utilizzando "data +%s")

    Ritorni
    InputStreamSource

    getMountPoint

    public abstract String getMountPoint (String mountName)

    Restituisce un punto di montaggio.

    Esegue query direttamente sul dispositivo se le informazioni memorizzate nella cache in IDevice non sono disponibili.

    DA FARE: sposta questo comportamento in IDevice.getMountPoint(String)

    Parametri
    mountName String: il nome del punto di montaggio

    Ritorni
    String il punto di montaggio o null

    getMountPointInfo

    public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

    Parametri
    mountpoint String

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

    Lanci
    DeviceNotAvailableException

    Vedi anche:

    getMountPointInfo

    public abstract  getMountPointInfo ()

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

    Ritorni
    Un ERROR(/List) di MountPointInfo contenente le informazioni in "/proc/mounts"

    Lanci
    DeviceNotAvailableException

    getPartitionFreeSpace

    public abstract long getPartitionFreeSpace (String partition)

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

    Parametri
    partition String

    Ritorni
    long la quantità di spazio libero in KB

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

    getProcessByName

    public abstract ProcessInfo getProcessByName (String processName)

    Il metodo di supporto esegue i comandi "pidof" e "stat" e restituisce l'oggetto ProcessInfo con il PID e l'ora di inizio del processo in questione.

    Parametri
    processName String: la stringa del nome del processo.

    Ritorni
    ProcessInfo ProcessInfo del nome processo specificato

    Lanci
    DeviceNotAvailableException

    getProcessPid

    public abstract String getProcessPid (String process)

    Restituisce il pid del servizio o null se si è verificato un problema.

    Parametri
    process String: la stringa del nome del processo.

    Ritorni
    String

    Lanci
    DeviceNotAvailableException

    getProductType

    public abstract String getProductType ()

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

    Questo metodo funziona se il dispositivo è in modalità adb o fastboot.

    Ritorni
    String Il nome del tipo di prodotto String. Non sarà null

    Lanci
    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 pratico per ottenere la variante del prodotto di questo dispositivo.

    Questo metodo funziona se il dispositivo è in modalità adb o fastboot.

    Ritorni
    String il nome della variante di prodotto String o null se non è possibile determinarlo

    Lanci
    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à specificato dal dispositivo.

    Parametri
    name String: il nome della proprietà

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

    Lanci
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    getRecoveryMode

    public abstract ITestDevice.RecoveryMode getRecoveryMode ()

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

    Ritorni
    ITestDevice.RecoveryMode la modalità di ripristino corrente utilizzata per il dispositivo.

    getSerialNumber

    public abstract String getSerialNumber ()

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

    Ritorni
    String il numero di serie String

    getTombstones

    public abstract  getTombstones ()

    Recupera e restituisce l'elenco delle tombstone dai dispositivi. Richiede i permessi di root.

    è il metodo del massimo impegno, quindi se non è possibile estrarre una tomba per qualsiasi motivo, questa non sarà presente nell'elenco. Solo un DeviceNotAvailableException termina il metodo in anticipo.

    Ritorni
    Un elenco di file tombstone, vuoto se non sono presenti tombstone.

    Lanci
    DeviceNotAvailableException

    getTotalMemory

    public abstract long getTotalMemory ()

    Restituisce le dimensioni totali della memoria fisica in byte o -1 in caso di errore interno

    Ritorni
    long

    getTrackingSerial

    public String getTrackingSerial ()

    Per la gestione del dispositivo, ottieni il numero di serie utilizzato per monitorarlo.

    Ritorni
    String

    getUseFastbootErase

    public abstract boolean getUseFastbootErase ()

    Scopri se utilizzare fastboot erase o fastboot format per cancellare una partizione sul dispositivo.

    Ritorni
    boolean true se verrà utilizzata la cancellazione tramite fastboot o false se verrà utilizzato il formato tramite fastboot.

    isAdbRoot

    public abstract boolean isAdbRoot ()

    Ritorni
    boolean true se il dispositivo ha attualmente il root adb, false altrimenti.

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

    isAdbTcp

    public abstract boolean isAdbTcp ()

    Ritorni
    boolean true se il dispositivo è connesso ad adb-over-tcp, false altrimenti.

    isAppEnumerationSupported

    public abstract boolean isAppEnumerationSupported ()

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

    Ritorni
    boolean True se l'enumerazione delle app è supportata, false in caso contrario

    Lanci
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockSupported

    public abstract boolean isBypassLowTargetSdkBlockSupported ()

    Verificare se la piattaforma sul dispositivo supporta il bypass del blocco dell'SDK target basso per le installazioni di app

    Ritorni
    boolean True se è supportato il blocco di bypass dell'SDK target basso, false in caso contrario

    Lanci
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isDebugfsMounted

    public abstract boolean isDebugfsMounted ()

    Controlla se debugfs è montato.

    Ritorni
    boolean true se debugfs è montato

    Lanci
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isDeviceEncrypted

    public abstract boolean isDeviceEncrypted ()

    Restituisce true se il dispositivo è criptato.

    Ritorni
    boolean true se il dispositivo è criptato.

    Lanci
    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

    Ritorni
    boolean

    Lanci
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isEncryptionSupported

    public abstract boolean isEncryptionSupported ()

    Restituisce se la crittografia è supportata sul dispositivo.

    Ritorni
    boolean true se il dispositivo supporta la crittografia.

    Lanci
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isExecutable

    public abstract boolean isExecutable (String fullPath)

    Restituisce True se il percorso del file sul dispositivo è un file eseguibile, altrimenti restituisce false.

    Parametri
    fullPath String

    Ritorni
    boolean

    Lanci
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isHeadless

    public abstract boolean isHeadless ()

    Restituisce true se il dispositivo è senza display (nessun schermo), false altrimenti.

    Ritorni
    boolean

    Lanci
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public abstract boolean isRuntimePermissionSupported ()

    Controlla se la piattaforma sul dispositivo supporta la concessione delle autorizzazioni di runtime

    Ritorni
    boolean Vero se le autorizzazioni di runtime sono supportate, falso in caso contrario.

    Lanci
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public abstract boolean isStateBootloaderOrFastbootd ()

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

    Ritorni
    boolean

    logAnrs

    public abstract boolean logAnrs (ITestLogger logger)

    Raccoglie e registra gli ANR dal dispositivo.

    Parametri
    logger ITestLogger: un ITestLogger per registrare gli ANR.

    Ritorni
    boolean Vero se il logging è riuscito, falso in caso contrario.

    Lanci
    DeviceNotAvailableException

    logOnDevice

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

    Registra un messaggio nel logcat del dispositivo. Si tratta di una chiamata sicura che non verrà lanciata anche se il logging non va a buon fine.

    Parametri
    tag String: il tag sotto il quale registriamo il messaggio nel logcat.

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

    format String: il formato del messaggio.

    args Object: gli argomenti da sostituire tramite String.format().

    mountDebugfs

    public abstract void mountDebugfs ()

    Monta debugfs.

    Lanci
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    nonBlockingReboot

    public abstract void nonBlockingReboot ()

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

    Lanci
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postBootSetup

    public abstract void postBootSetup ()

    Segui le istruzioni per configurare il dispositivo per i test dopo ogni avvio.

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

    In circostanze normali, questo metodo non deve essere chiamato esplicitamente, poiché le implementazioni dovrebbero eseguire questi passaggi automaticamente durante il riavvio.

    Potrebbe essere necessario chiamarlo quando il dispositivo si riavvia a causa di altri eventi (ad esempio al termine di un comando di aggiornamento fastboot).

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

    postInvocationTearDown

    public void postInvocationTearDown ()

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

    Passaggi aggiuntivi per la pulizia richiesta specifica del dispositivo che verranno eseguiti al termine dell'invocazione.

    postInvocationTearDown

    public abstract void postInvocationTearDown (Throwable invocationException)

    Passaggi aggiuntivi per la pulizia richiesta specifica del dispositivo che verranno eseguiti al termine dell'invocazione.

    Parametri
    invocationException Throwable: se presente, l'eccezione finale sollevata dal fallimento dell'invocazione.

    preInvocationSetup

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

    Parametri
    info IBuildInfo: il IBuildInfo del dispositivo.

    attributes MultiMap: gli attributi memorizzati nel contesto di chiamata

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

    pullDir

    public abstract boolean pullDir (String deviceFilePath, 
                    File localDir)

    Estrai in modo ricorsivo i contenuti della directory dal dispositivo.

    Parametri
    deviceFilePath String: il percorso file assoluto dell'origine remota

    localDir File: la directory locale in cui importare i file

    Ritorni
    boolean true se il file è stato recuperato correttamente. false in caso contrario.

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

    pullDir

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

    Estrai in modo ricorsivo i contenuti della directory dal dispositivo.

    Parametri
    deviceFilePath String: il percorso file assoluto dell'origine remota

    localDir File: la directory locale in cui importare i file

    userId int: l'ID utente da cui estrarre i dati

    Ritorni
    boolean true se il file è stato recuperato correttamente. false in caso contrario.

    Lanci
    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 file dal dispositivo, lo memorizza in un ERROR(/File) temporaneo locale e restituisce questo File.

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

    userId int: l'ID utente da cui estrarre i dati

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

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

    pullFile

    public abstract File pullFile (String remoteFilePath)

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

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

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

    Lanci
    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 file dal dispositivo.

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

    localFile File: il file locale in cui memorizzare i contenuti. Se non è vuoto, i contenuti verranno sostituiti.

    Ritorni
    boolean true se il file è stato recuperato correttamente. false in caso contrario.

    Lanci
    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 file dal dispositivo.

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

    localFile File: il file locale in cui memorizzare i contenuti. Se non è vuoto, i contenuti verranno sostituiti.

    userId int: l'ID utente da cui estrarre i dati

    Ritorni
    boolean true se il file è stato recuperato correttamente. false in caso contrario.

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

    pullFileContents

    public abstract String pullFileContents (String remoteFilePath)

    Recupera un file dal dispositivo e restituisce i contenuti.

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

    Ritorni
    String Un String contenente i contenuti del file del dispositivo o null se la copia non è riuscita per qualsiasi motivo (inclusi problemi con il file system host)

    Lanci
    DeviceNotAvailableException

    pullFileFromExternal

    public abstract File pullFileFromExternal (String remoteFilePath)

    Un metodo pratico per recuperare un file dallo spazio di archiviazione esterno del dispositivo, memorizzarlo in un ERROR(/File)temporaneo locale e restituire un riferimento a quel File.

    Parametri
    remoteFilePath String: il percorso del file sul dispositivo, rispetto al mountpoint dello spazio di archiviazione esterno del dispositivo

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

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

    pushDir

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

    Esegui il push dei contenuti della directory sul dispositivo in modo ricorsivo.

    Parametri
    localDir File: la directory locale da inviare tramite push

    deviceFilePath String: il percorso file assoluto della destinazione remota

    userId int: l'ID utente a cui eseguire il push

    Ritorni
    boolean true se il file è stato inviato correttamente. false in caso contrario.

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

    pushDir

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

    Esegui il push dei contenuti delle directory sul dispositivo in modo ricorsivo, escludendo alcune directory filtrate.

    Parametri
    localDir File: la directory locale da inviare tramite push

    deviceFilePath String: il percorso file assoluto della destinazione remota

    excludedDirectories : insieme di nomi di directory escluse che non devono essere inviate.

    Ritorni
    boolean true se il file è stato inviato correttamente. false in caso contrario.

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

    pushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath)

    Esegui il push dei contenuti della directory sul dispositivo in modo ricorsivo.

    Parametri
    localDir File: la directory locale da inviare tramite push

    deviceFilePath String: il percorso file assoluto della destinazione remota

    Ritorni
    boolean true se il file è stato inviato correttamente. false in caso contrario.

    Lanci
    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ò eventualmente prendere in considerazione la valutazione del bisogno per il fornitore di contenuti.

    Parametri
    localFile File: il file locale da inviare

    deviceFilePath String: il percorso file assoluto della destinazione remota

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

    Ritorni
    boolean true se il file è stato inviato correttamente. false in caso contrario.

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

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath)

    Invia un file al dispositivo. Per impostazione predefinita, viene utilizzato un fornitore di contenuti.

    Parametri
    localFile File: il file locale da inviare

    deviceFilePath String: il percorso file assoluto della destinazione remota

    Ritorni
    boolean true se il file è stato inviato correttamente. false in caso contrario.

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

    pushFile

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

    Invia un file al dispositivo. Per impostazione predefinita, viene utilizzato un fornitore di contenuti.

    Parametri
    localFile File: il file locale da inviare

    deviceFilePath String: il percorso file assoluto della destinazione remota

    userId int: l'ID utente a cui inviare il push

    Ritorni
    boolean true se il file è stato inviato correttamente. false in caso contrario.

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

    pushString

    public abstract boolean pushString (String contents, 
                    String deviceFilePath)

    Inviare il file creato da una stringa al dispositivo

    Parametri
    contents String: i contenuti del file da spingere

    deviceFilePath String: il percorso file assoluto della destinazione remota

    Ritorni
    boolean true se la stringa è stata inviata correttamente. false in caso contrario.

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

    fai ripartire

    public abstract void reboot ()

    Riavvia il dispositivo in modalità adb.

    Blocca fino a quando il dispositivo non diventa disponibile.

    Lanci
    DeviceNotAvailableException if device is not available after reboot

    fai ripartire

    public abstract void reboot (String reason)

    Riavvia il dispositivo in modalità ADB con il valore reason specificato da mantenere dopo il riavvio.

    Blocca fino a quando il dispositivo non diventa disponibile.

    Il motivo dell'ultimo riavvio può essere ottenuto eseguendo una query sulla proprietà sys.boot.reason.

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

    Lanci
    DeviceNotAvailableException if device is not available after reboot

    rebootIntoBootloader

    public abstract void rebootIntoBootloader ()

    Riavvia il dispositivo in modalità bootloader.

    Blocca finché il dispositivo non è in modalità bootloader.

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

    Blocca finché il dispositivo non è in modalità fastbootd.

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

    rebootIntoRecovery

    public abstract void rebootIntoRecovery ()

    Riavvia il dispositivo in modalità di ripristino adb.

    Blocca fino a quando il dispositivo non entra in modalità di recupero

    Lanci
    DeviceNotAvailableException if device is not available after reboot

    rebootIntoSideload

    public abstract void rebootIntoSideload (boolean autoReboot)

    Riavvia il dispositivo in modalità sideload adb (tieni presente che si tratta di una modalità speciale in fase di recupero)

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

    Parametri
    autoReboot boolean: indica se riavviare automaticamente il dispositivo dopo il sideload

    Lanci
    DeviceNotAvailableException if device is not in sideload after reboot

    rebootIntoSideload

    public abstract void rebootIntoSideload ()

    Riavvia il dispositivo in modalità sideload adb (tieni presente che si tratta di una modalità speciale in fase di recupero)

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

    Lanci
    DeviceNotAvailableException if device is not in sideload after reboot

    rebootUntilOnline

    public abstract void rebootUntilOnline ()

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

    Lanci
    DeviceNotAvailableException if device is not available after reboot

    rebootUntilOnline

    public abstract void rebootUntilOnline (String reason)

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

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

    Lanci
    DeviceNotAvailableException if device is not available after reboot

    Vedi anche:

    rebootUserspace

    public abstract void rebootUserspace ()

    Riavvia solo la parte dello spazio utente del dispositivo.

    Blocca fino a quando il dispositivo non diventa disponibile.

    AVVISO. Il riavvio nello spazio utente è attualmente in fase di sviluppo attivo. Utilizzalo a tuo rischio.

    Lanci
    DeviceNotAvailableException if device is not available after reboot

    rebootUserspaceUntilOnline

    public abstract void rebootUserspaceUntilOnline ()

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

    Lanci
    DeviceNotAvailableException if device is not available after reboot

    remountSystemReadOnly

    public abstract void remountSystemReadOnly ()

    Imposta la partizione di sistema sul dispositivo come di sola lettura. Il dispositivo potrebbe riavviarsi.

    Lanci
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountSystemWritable

    public abstract void remountSystemWritable ()

    Rendi la partizione di sistema sul dispositivo scrivibile. Il dispositivo potrebbe riavviarsi.

    Lanci
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountVendorReadOnly

    public abstract void remountVendorReadOnly ()

    Imposta la partizione del fornitore sul dispositivo come di sola lettura. Il dispositivo potrebbe riavviarsi.

    Lanci
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountVendorWritable

    public abstract void remountVendorWritable ()

    Rendi la partizione del fornitore sul dispositivo scrivibile. Il dispositivo potrebbe riavviarsi.

    Lanci
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    runInstrumentationTests

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

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

    Parametri
    runner IRemoteAndroidTestRunner: il IRemoteAndroidTestRunner che esegue i test

    listeners ITestLifeCycleReceiver: gli ascoltatori dei risultati del test

    Ritorni
    boolean true se il comando di test è stato completato. false se non è stato completato, ma il recupero è andato a buon fine

    Lanci
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata. Ad esempio, il comando di test non è stato completato 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 dell'esecuzione del test e il recupero va a buon fine, tutti gli ascoltatori verranno informati di testRunFailed e verrà restituito "false". Il comando di test non verrà eseguito di nuovo. Se necessario, è compito dei chiamanti riprovare.

    Se la connessione con il dispositivo viene persa prima del completamento dell'esecuzione del test e il recupero non va a buon fine, tutti gli ascoltatori verranno informati di testRunFailed e verrà lanciata l'eccezione DeviceNotAvailableException.

    Parametri
    runner IRemoteAndroidTestRunner: il IRemoteAndroidTestRunner che esegue i test

    listeners : gli ascoltatori dei risultati del test

    Ritorni
    boolean true se il comando di test è stato completato. false se non è stato completato a causa di un'eccezione di comunicazione del dispositivo, ma il recupero è riuscito

    Lanci
    DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata. Ad esempio, il comando di test non è stato completato 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 specificato.

    Parametri
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    Ritorni
    boolean

    Lanci
    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

    Ritorni
    boolean

    Lanci
    DeviceNotAvailableException

    setDate

    public abstract void setDate (Date date)

    Imposta la data sul dispositivo

    Nota: l'impostazione della data sul dispositivo richiede i permessi di root

    Parametri
    date Date: specifica una data specifica; verrà utilizzata la data dell'host se null

    Lanci
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    setOptions

    public abstract void setOptions (TestDeviceOptions options)

    Impostare TestDeviceOptions per il dispositivo

    Parametri
    options TestDeviceOptions

    setProperty

    public abstract boolean setProperty (String propKey, 
                    String propValue)

    Imposta il valore della proprietà specificato sul dispositivo. Richiede che il privilegio di accesso come utente root di adb sia true.

    Parametri
    propKey String: la chiave di destinazione da impostare.

    propValue String: il valore della proprietà da impostare.

    Ritorni
    boolean Restituisce True se il comando setprop è andato a buon fine, False in caso contrario.

    Lanci
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    setRecovery

    public abstract void setRecovery (IDeviceRecovery recovery)

    Imposta il IDeviceRecovery da utilizzare per questo dispositivo. Deve essere impostato al primo allocamento del dispositivo.

    Parametri
    recovery IDeviceRecovery: il IDeviceRecovery

    setRecoveryMode

    public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

    Utilizzato per controllare il metodo di recupero da utilizzare quando si verifica un problema di comunicazione del dispositivo. Ti consigliamo di utilizzare questo metodo solo se necessario (ad esempio quando il framework non è disponibile e così via).

    Parametri
    mode ITestDevice.RecoveryMode: indica se la modalità "Recupero fino a solo online" deve essere attivata o meno.

    setTrackingSerial

    public abstract void setTrackingSerial (String trackingSerial)

    Per la gestione del dispositivo, monitora il numero di serie che utilizziamo per fare riferimento al dispositivo.

    Parametri
    trackingSerial String

    setUseFastbootErase

    public abstract void setUseFastbootErase (boolean useFastbootErase)

    Imposta se utilizzare l'opzione fastboot erase o fastboot format per cancellare una partizione sul dispositivo.

    Parametri
    useFastbootErase boolean: true se deve essere utilizzata l'opzione di reset di Fastboot o false se deve essere utilizzata l'opzione di formattazione di Fastboot.

    startLogcat

    public abstract void startLogcat ()

    Inizia ad acquisire l'output di logcat dal dispositivo in background.

    Non avrà alcun effetto se l'output di logcat viene già acquisito. I dati possono essere recuperati in un secondo momento tramite getLogcat.

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

    In genere, non è necessario chiamare startLogcat() e stopLogcat() all'interno di un contesto di chiamata di TF, poiché il framework TF avvia e arresta logcat.

    stopEmulatorOutput

    public abstract void stopEmulatorOutput ()

    Chiudi ed elimina l'output dell'emulatore.

    stopLogcat

    public abstract void stopLogcat ()

    Interrompi l'acquisizione dell'output di Logcat dal dispositivo ed elimina 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 alla modalità adb-over-tcp.

    Ritorni
    String il numero di serie del TCP o null se non è stato possibile cambiare dispositivo

    Lanci
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    switchToAdbUsb

    public abstract boolean switchToAdbUsb ()

    Passa il dispositivo alla modalità adb tramite USB.

    Ritorni
    boolean true se il trasferimento è andato a buon fine, false in caso contrario.

    Lanci
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    syncFiles

    public abstract boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

    Sincronizza in modo incrementale i contenuti di una directory di file locale con il dispositivo.

    Decide quali file inviare confrontando i timestamp dei file locali con i relativi equivalenti remoti. Solo i file "più recenti" o inesistenti verranno inviati al dispositivo. Pertanto, il sovraccarico dovrebbe essere relativamente ridotto 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") crea una directory /sdcard/files se non esiste già e copia in modo ricorsivo i contenuti di /tmp/files in /sdcard/files.

    Parametri
    localFileDir File: la directory dei file locale contenente i file da eseguire push in modo ricorsivo.

    deviceFilePath String: la radice del percorso file assoluto della destinazione remota. Tutte le directory nel percorso del file devono essere leggibili. Ad esempio, il trasferimento a /data/local/tmp quando adb non è root non andrà a buon fine

    Ritorni
    boolean true se i file sono stati sincronizzati correttamente. false in caso contrario.

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

    unlockDevice

    public abstract boolean unlockDevice ()

    Sblocca il dispositivo se è criptato.

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

    Ritorni
    boolean true se l'operazione è andata a buon fine o se il dispositivo non è criptato.

    Lanci
    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 ()

    Smonta debugfs.

    Lanci
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    waitForBootComplete

    public abstract boolean waitForBootComplete (long timeOut)

    Blocca fino al momento in cui non viene impostato il flag di completamento dell'avvio del dispositivo.

    Parametri
    timeOut long: tempo in millisecondi di attesa per l'impostazione del flag

    Ritorni
    boolean true se il flag di completamento dell'avvio del dispositivo è impostato entro il timeout

    Lanci
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    waitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable ()

    Attende che il dispositivo risponda e sia disponibile per i test. Utilizza il timeout predefinito.

    Ritorni
    boolean True se il dispositivo è disponibile, False se il recupero è disabilitato e non disponibile.

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

    waitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable (long waitTime)

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

    Parametri
    waitTime long: il tempo in millisecondi da attendere

    Ritorni
    boolean True se il dispositivo è disponibile, False se il recupero è disabilitato e non disponibile.

    Lanci
    DeviceNotAvailableException Se il dispositivo continua a non rispondere dopo la scadenza di waitTime.

    waitForDeviceAvailableInRecoverPath

    public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

    Parametri
    waitTime long

    Ritorni
    boolean True se il dispositivo è disponibile, False se non è disponibile.

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

    waitForDeviceBootloader

    public abstract void waitForDeviceBootloader ()

    Blocca fino a quando il dispositivo non è visibile tramite fastboot. Utilizza il timeout predefinito.

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

    waitForDeviceInRecovery

    public abstract boolean waitForDeviceInRecovery (long waitTime)

    Impedisce al dispositivo di trovarsi nello stato "adb recovery" (tieni presente che questo è diverso da IDeviceRecovery).

    Parametri
    waitTime long: il tempo in millisecondi da attendere

    Ritorni
    boolean true se il dispositivo si avvia in modalità di recupero prima della scadenza del tempo. false altrimenti

    waitForDeviceInSideload

    public abstract boolean waitForDeviceInSideload (long waitTime)

    Blocca il dispositivo in stato "sideload adb"

    Parametri
    waitTime long: il tempo in millisecondi da attendere

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

    waitForDeviceNotAvailable

    public abstract boolean waitForDeviceNotAvailable (long waitTime)

    Blocca il dispositivo in modo che non sia disponibile, ad esempio non sia presente in adb

    Parametri
    waitTime long: il tempo in millisecondi da attendere

    Ritorni
    boolean true se il dispositivo non è disponibile prima della scadenza del tempo. false altrimenti

    waitForDeviceOnline

    public abstract void waitForDeviceOnline ()

    Blocca fino a quando il dispositivo non è visibile tramite adb. Utilizza il timeout predefinito

    Tieni presente che il dispositivo potrebbe non rispondere necessariamente ai comandi al termine dell'operazione. Utilizza invece waitForDeviceAvailable().

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

    waitForDeviceOnline

    public abstract void waitForDeviceOnline (long waitTime)

    Blocca fino a quando il dispositivo non è visibile tramite adb.

    Tieni presente che il dispositivo potrebbe non rispondere necessariamente ai comandi al termine dell'operazione. Utilizza invece waitForDeviceAvailable().

    Parametri
    waitTime long: il tempo in millisecondi da attendere

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

    waitForDeviceShell

    public abstract boolean waitForDeviceShell (long waitTime)

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

    Parametri
    waitTime long: il tempo in millisecondi da attendere

    Ritorni
    boolean true se il dispositivo risponde prima del termine del periodo waitTime.