Dispositivo nativo

public interface INativeDevice

com.android.tradefed.device.INativeDevice


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

Consente di ripetere i comandi del dispositivo per un numero di comandi configurabile e fornisce un'interfaccia di ripristino per i dispositivi che non rispondono.

Riepilogo

Costanti

int UNKNOWN_API_LEVEL

Valore predefinito se non è possibile rilevare il livello API

Metodi pubblici

abstract boolean checkApiLevelAgainstNextRelease(int strictMinLevel)

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

abstract void clearLogcat()

Elimina tutti i dati logcat accumulati.

abstract void deleteFile(String deviceFilePath)

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

abstract 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 temporaneamente, confrontando l'attuale system_server con il precedente sistema system_server ProcessInfo.

abstract boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

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

abstract boolean disableAdbRoot()

Disattiva adb root.

abstract boolean doesFileExist(String deviceFilePath)

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

abstract boolean enableAdbRoot()

Attiva root ADB.

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

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

abstract String executeAdbCommand(String... commandArgs)

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

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

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

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

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

abstract CommandResult executeFastbootCommand(String... commandArgs)

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

abstract CommandResult executeLongFastbootCommand(String... commandArgs)

Metodo helper che esegue un comando fastboot a lunga esecuzione come comando di sistema.

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

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

abstract String executeShellCommand(String command)

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

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

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

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

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

abstract void executeShellCommand(String command, IShellOutputReceiver receiver)

Esegue il comando della shell adb specificato, riprovando più volte in caso di errore.

abstract CommandResult executeShellV2Command(String command)

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

abstract CommandResult executeShellV2Command(String command, OutputStream pipeToOutput)

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

abstract CommandResult executeShellV2Command(String command, File pipeAsInput)

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

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

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

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

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

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

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

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

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

abstract CommandResult fastbootWipePartition(String partition)

Metodo helper che cancella una partizione per il dispositivo.

abstract int getApiLevel()

Ottieni il livello API del dispositivo.

abstract String getBasebandVersion()

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

abstract Integer getBattery()

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

abstract boolean getBooleanProperty(String name, boolean defaultValue)

Restituisce il valore booleano della proprietà specificata.

abstract getBootHistory()

Il metodo helper raccoglie la mappa della cronologia di avvio con data e ora e motivo dell'avvio.

abstract getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)

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

abstract String getBootloaderVersion()

Metodo pratico per recuperare la versione bootloader del dispositivo.

abstract String getBuildAlias()

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

abstract String getBuildFlavor()

Recupera la versione di build per il dispositivo.

abstract String getBuildId()

Recupera la build attualmente in esecuzione sul dispositivo.

abstract String getBuildSigningKeys()

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

In genere, i dispositivi Android potrebbero essere firmati con token di test (come in AOSP) o tasti di rilascio (controllati dai singoli produttori di dispositivi)

abstract DeviceDescriptor getCachedDeviceDescriptor()

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

abstract DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

Restituisce un valore DeviceDescriptor memorizzato nella cache se il dispositivo viene allocato, altrimenti restituisce il valore 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()

Ottieni la classe del dispositivo.

abstract long getDeviceDate()

Restituisce la data del dispositivo in millisecondi dall'epoca.

abstract DeviceDescriptor getDeviceDescriptor()

Restituisci un DeviceDescriptor dalle informazioni del dispositivo per avere informazioni al riguardo senza trasmettere l'oggetto effettivo del dispositivo.

abstract DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

Restituisci un DeviceDescriptor dalle informazioni del dispositivo per avere informazioni al riguardo senza trasmettere l'oggetto effettivo del dispositivo.

abstract TestDeviceState getDeviceState()

Ottieni lo stato del dispositivo.

abstract long getDeviceTimeOffset(Date date)

Assistente per rilevare la differenza di tempo tra il dispositivo e un determinato ERROR(/Date).

abstract InputStreamSource getEmulatorOutput()

recupera il flusso di stdout e stderr dell'emulatore

abstract long getExternalStoreFreeSpace()

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

abstract String getFastbootProductType()

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

abstract String getFastbootProductVariant()

Metodo pratico per conoscere 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 all'elemento ddmlib IDevice associato.

abstract long getIntProperty(String name, long defaultValue)

Restituisce il valore intero della proprietà specificata dal dispositivo.

abstract long getLastExpectedRebootTimeMillis()

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

abstract int getLaunchApiLevel()

Ottieni il primo livello API del dispositivo.

abstract InputStreamSource getLogcat()

Acquisisce un flusso di snapshot dei dati logcat.

abstract InputStreamSource getLogcat(int maxBytes)

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

abstract InputStreamSource getLogcatDump()

Recupera il logcat attuale per il dispositivo.

abstract InputStreamSource getLogcatSince(long date)

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

abstract String getMountPoint(String mountName)

Restituisce un punto di montaggio.

abstract ITestDevice.MountPointInfo getMountPointInfo(String mountpoint)

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

abstract getMountPointInfo()

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

abstract long getPartitionFreeSpace(String partition)

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

abstract ProcessInfo getProcessByName(String processName)

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

abstract String getProcessPid(String process)

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

abstract String getProductType()

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

abstract String getProductVariant()

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

abstract String getProperty(String name)

Recupera il valore della proprietà specificato dal dispositivo.

abstract ITestDevice.RecoveryMode getRecoveryMode()

Recupera l'attuale modalità di ripristino utilizzata per il dispositivo.

abstract String getSerialNumber()

Metodo pratico per ottenere il numero di serie del dispositivo.

abstract getTombstones()

Recupera e restituisci l'elenco delle lapidi dai dispositivi.

abstract long getTotalMemory()

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

abstract boolean getUseFastbootErase()

Scopri se utilizzare il formato fastboot reset o fastboot per cancellare una partizione sul dispositivo.

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

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

abstract boolean isBypassLowTargetSdkBlockSupported()

Controlla se la piattaforma sul dispositivo supporta l'aggiramento del blocco SDK target basso sulle installazioni di app

abstract boolean isDebugfsMounted()

Controlla se il debugfs è montato.

abstract boolean isDeviceEncrypted()

Indica se il dispositivo è criptato.

abstract boolean isDirectory(String deviceFilePath)

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

abstract boolean isEncryptionSupported()

Indica se la crittografia è supportata sul dispositivo.

abstract boolean isExecutable(String fullPath)

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

abstract boolean isHeadless()

Restituisce true se il dispositivo è headless (nessuno schermo), false negli altri casi.

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 errori 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 una volta completato il comando e quando il dispositivo non è più visibile ad adb.

abstract void postBootSetup()

Segui le istruzioni per configurare il dispositivo e testarlo dopo ogni avvio.

default void postInvocationTearDown()

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

abstract void postInvocationTearDown(Throwable invocationException)

Passaggi aggiuntivi per la pulizia specifica del dispositivo che verranno eseguiti dopo il completamento della chiamata.

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

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

abstract boolean pullDir(String deviceFilePath, File localDir)

Esegui il pull ricorsivo dei contenuti della directory dal dispositivo.

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

Esegui il pull ricorsivo dei contenuti della directory dal dispositivo.

abstract File pullFile(String remoteFilePath, int userId)

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

abstract File pullFile(String remoteFilePath)

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

abstract boolean pullFile(String remoteFilePath, File localFile)

Recupera un file dal dispositivo.

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

Recupera un file dal dispositivo.

abstract String pullFileContents(String remoteFilePath)

Recupera un file dal dispositivo e restituisce i contenuti.

abstract File pullFileFromExternal(String remoteFilePath)

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

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

Esegui il push ricorsivo dei contenuti della directory sul dispositivo.

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

Esegui il push ricorsivo dei contenuti delle directory al dispositivo, escludendo alcune directory filtrate.

abstract boolean pushDir(File localDir, String deviceFilePath)

Esegui il push ricorsivo dei contenuti della directory sul dispositivo.

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

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

abstract boolean pushFile(File localFile, String deviceFilePath)

Esegui il push di un file sul dispositivo.

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

Esegui il push di un file sul dispositivo.

abstract boolean pushString(String contents, String deviceFilePath)

Esegui il push del 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 e l'reason specificato sarà mantenuto fino al 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 ripristino)

Blocco fino all'attivazione della modalità sideload sul dispositivo

abstract void rebootIntoSideload()

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

Blocco fino all'attivazione della modalità sideload sul dispositivo

abstract void rebootUntilOnline()

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

abstract void rebootUntilOnline(String reason)

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

abstract void rebootUserspace()

Riavvia solo la parte dello spazio utente del dispositivo.

abstract void rebootUserspaceUntilOnline()

Un'alternativa a rebootUserspace() ()} che viene bloccata solo finché il dispositivo non è online, cioè visibile ad ADB.

abstract void remountSystemReadOnly()

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

abstract void remountSystemWritable()

Rendi scrivibile la partizione di sistema del dispositivo.

abstract void remountVendorReadOnly()

Rendi la partizione del fornitore sul dispositivo di sola lettura.

abstract void remountVendorWritable()

Rendi scrivibile la partizione del fornitore sul dispositivo.

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

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

abstract boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)

Esegue test di strumentazione e fornisce il recupero del dispositivo.

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

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

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

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

abstract void setDate(Date date)

Imposta la data sul dispositivo

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

abstract void setOptions(TestDeviceOptions options)

Imposta TestDeviceOptions per il dispositivo

abstract boolean setProperty(String propKey, String propValue)

Imposta il valore specificato per la proprietà sul dispositivo.

abstract void setRecovery(IDeviceRecovery recovery)

Imposta il IDeviceRecovery da usare per questo dispositivo.

abstract void setRecoveryMode(ITestDevice.RecoveryMode mode)

Imposta l'attuale modalità di ripristino da usare per il dispositivo.

abstract void setUseFastbootErase(boolean useFastbootErase)

Scegli se utilizzare il formato fastboot reset o fastboot per cancellare una partizione sul dispositivo.

abstract void startLogcat()

Avvia l'acquisizione dell'output 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 alla modalità adb-over-tcp sul dispositivo.

abstract boolean switchToAdbUsb()

Passa al dispositivo in modalità ADB su 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 è in stato criptato.

abstract void unmountDebugfs()

Smonta il debugfs.

abstract boolean waitForBootComplete(long timeOut)

Si blocca finché 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 risponda e sia disponibile senza considerare il percorso di ripristino.

abstract void waitForDeviceBootloader()

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

abstract boolean waitForDeviceInRecovery(long waitTime)

Blocchi per fare in modo che il dispositivo si trovi in stato di "recupero ADb" (tieni presente che questo è diverso da IDeviceRecovery).

abstract boolean waitForDeviceInSideload(long waitTime)

Blocchi in modo che il dispositivo si trovi in stato "adb sideload"

abstract boolean waitForDeviceNotAvailable(long waitTime)

Blocchi per cui il dispositivo non è disponibile, cioè non è presente nell'ADB

abstract void waitForDeviceOnline()

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

abstract void waitForDeviceOnline(long waitTime)

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

abstract boolean waitForDeviceShell(long waitTime)

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

Costanti

LIVELLO_API_SCONOSCIUTO

public static final int UNKNOWN_API_LEVEL

Valore predefinito se non è possibile rilevare il livello API

Valore costante: -1 (0xffff)

Metodi pubblici

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Controlla se una funzionalità è attualmente supportata o meno in un livello minimamente supportato. Questo metodo tiene conto delle funzionalità non ancora rilasciate, prima dell'aumento del livello API.

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

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

Lanci
com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

CANCELLA

public abstract void clearLogcat ()

Elimina tutti i dati logcat accumulati.

Questo è utile nei casi in cui vuoi assicurarti che ITestDevice#getLogcat() restituisca solo i dati di log generati dopo un determinato momento (ad esempio dopo il flashing di una build di un nuovo 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.DeviceNotAvailableEccezione
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

Lanci
com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

dispositivoRiavvio avviato

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Metodo di supporto per verificare se il dispositivo è stato riavviato temporaneamente, confrontando l'attuale system_server con il precedente sistema system_server ProcessInfo. Usa getProcessByName(String) per ricevere ProcessInfo.

Parametri
prevSystemServerProcess ProcessInfo: il precedente processo system_server ProcessInfo.

Ritorni
boolean true se il dispositivo è stato riavviato temporaneamente

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

dispositivoSoftRiavviatoDa

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Metodo di supporto per verificare se il dispositivo è stato riavviato temporaneamente dall'ora UTC dall'epoca dal dispositivo e dal relativo ERROR(/TimeUnit). Per riavvio lento si intende system_server riavviato al di fuori di un riavvio forzato del dispositivo (ad esempio, riavvio richiesto). L'attuale utcEpochTime del dispositivo in Milliseccond può essere ottenuto con il metodo getDeviceDate().

Parametri
utcEpochTime long: tempo 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 temporaneamente

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

disattivareAdbRoot

public abstract boolean disableAdbRoot ()

Disattiva adb root.

La disattivazione di adb root può causare la disconnessione del dispositivo da adb. Questo metodo verrà bloccato finché il dispositivo non sarà disponibile.

Ritorni
boolean true in caso di esito positivo.

Lanci
DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

fileExist

public abstract boolean doesFileExist (String deviceFilePath)

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

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

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

Lanci
DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

attivaAdbRoot

public abstract boolean enableAdbRoot ()

Attiva root ADB. Se l'impostazione "enable-root" è "false", verrà registrato un messaggio e verrà restituito senza abilitare root.

L'attivazione della directory principale ADB potrebbe causare la disconnessione del dispositivo da ADB. Questo metodo verrà bloccato finché il dispositivo non sarà disponibile.

Ritorni
boolean true in caso di esito positivo.

Lanci
DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

eseguireAdbCommand

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

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

Se possibile, utilizza executeShellCommand(String), perché questo metodo offre prestazioni e rilevamento degli errori migliori.

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

commandArgs String: il comando adb e gli argomenti da eseguire

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

Lanci
DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

eseguireAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

Se possibile, utilizza executeShellCommand(String), perché questo metodo offre prestazioni e rilevamento degli errori migliori.

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

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

Lanci
DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

eseguireAdbCommand

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

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

Se possibile, utilizza executeShellCommand(String), perché questo metodo offre prestazioni e rilevamento degli errori migliori.

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

envMap : ambiente da impostare per il comando

commandArgs String: il comando adb e gli argomenti da eseguire

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

Lanci
DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

eseguireFastbootCommand

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

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

È previsto l'utilizzo quando il dispositivo è già in modalità Fastboot.

Parametri
timeout long: 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 si perde e non può essere recuperata.

eseguireFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

È previsto l'utilizzo 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 si perde e non può essere recuperata.

eseguireLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

Metodo helper che esegue un comando fastboot a lunga esecuzione come comando di sistema.

Identico a executeFastbootCommand(String), ma 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 si perde e non può essere recuperata.

eseguireLongFastbootCommand

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

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

Identico a executeFastbootCommand(String), ma 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 si perde e non può essere recuperata.

eseguireShellCommand

public abstract String executeShellCommand (String command)

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

Parametri
command String: il comando shell adb da eseguire

Ritorni
String l'output della shell

Lanci
DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

eseguireShellCommand

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

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

Parametri
command String: il comando shell adb da eseguire

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

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

timeUnit TimeUnit: unità per maxTimeToOutputShellResponse

retryAttempts int: il numero massimo di volte in cui è possibile riprovare il comando se non riesce a causa di un'eccezione. Verrà generata un'eccezione DeviceNotAdaptiveException se l'esecuzione di retryAttempts non riesce.

Lanci
DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

eseguireShellCommand

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

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

Parametri
command String: il comando shell adb da eseguire

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

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

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

timeUnit TimeUnit: unità per maxTimeToOutputShellResponse

retryAttempts int: il numero massimo di volte in cui è possibile riprovare il comando se non riesce a causa di un'eccezione. Verrà generata un'eccezione DeviceNot adattabileException se l'esecuzione di retryAttempts viene eseguita senza esito positivo.

Lanci
DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

eseguireShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Esegue il comando della shell adb specificato, riprovando più volte in caso di errore.

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

Parametri
command String: il comando shell adb da eseguire

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

Lanci
DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

eseguireShellV2Command

public abstract CommandResult executeShellV2Command (String command)

Metodo helper che esegue un comando shell adb e restituisce i risultati come CommandResult correttamente compilato 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 si perde e non può essere recuperata.

eseguireShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

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

Parametri
command String: il comando da eseguire.

pipeToOutput OutputStream: ERROR(/OutputStream) in cui verrà reindirizzato l'output standard oppure nullo.

Ritorni
CommandResult Il risultato in CommandResult.

Lanci
DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

eseguireShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

Parametri
command String: il comando da eseguire.

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

Ritorni
CommandResult Il risultato in CommandResult.

Lanci
DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

eseguireShellV2Command

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

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

Parametri
command String: il comando shell adb da eseguire

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

timeUnit TimeUnit: unità per maxTimeToOutputShellResponse

retryAttempts int: il numero massimo di volte in cui è possibile riprovare il comando se non riesce a causa di un'eccezione. Verrà generata un'eccezione DeviceNot adattabileException se l'esecuzione di retryAttempts viene eseguita senza esito positivo.

Ritorni
CommandResult

Lanci
DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

eseguireShellV2Command

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

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

Parametri
command String: il comando shell adb 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 si perde e non può essere recuperata.

eseguireShellV2Command

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

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

Parametri
command String: il comando shell adb da eseguire

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

pipeToOutput OutputStream: ERROR(/OutputStream) in cui verrà reindirizzato l'output standard oppure nullo.

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 in cui è possibile riprovare il comando se non riesce a causa di un'eccezione. Verrà generata un'eccezione DeviceNot adattabileException se l'esecuzione di retryAttempts viene eseguita senza esito positivo.

Ritorni
CommandResult

Lanci
DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

eseguireShellV2Command

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

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

Parametri
command String: il comando shell adb da eseguire

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

pipeToOutput OutputStream: ERROR(/OutputStream) in cui verrà reindirizzato l'output standard oppure nullo.

pipeToError OutputStream: ERROR(/OutputStream) dove verrà reindirizzato l'errore standard oppure nullo.

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 in cui è possibile riprovare il comando se non riesce a causa di un'eccezione. Verrà generata un'eccezione DeviceNot adattabileException se l'esecuzione di retryAttempts viene eseguita senza esito positivo.

Ritorni
CommandResult

Lanci
DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

Metodo helper che cancella una partizione per il dispositivo.

Se getUseFastbootErase() è true, la cancellazione con fastboot cancellerà la partizione. Il dispositivo deve quindi creare un file system al successivo avvio del dispositivo. In caso contrario, viene utilizzato il formato fastboot, che crea un nuovo file system sul dispositivo.

È previsto l'utilizzo 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 si perde e non può essere recuperata.

getApiLevel

public abstract int getApiLevel ()

Ottieni 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.DeviceNotAvailableEccezione
DeviceNotAvailableException

getBasebandVersion

public abstract String getBasebandVersion ()

Metodo pratico per ottenere la versione in banda di base (radio) di questo dispositivo. Il recupero della versione della radio dipende dal dispositivo, pertanto potrebbe non restituire le informazioni corrette per tutti i dispositivi. Questo metodo si basa sull'proprietà gsm.version.baseband per restituire le informazioni corrette sulla versione. Ciò non è preciso per alcuni dispositivi CDMA e la versione restituita qui potrebbe non corrispondere alla versione segnalata da fastboot e potrebbe non restituire quella per la radio CDMA. TL;DR questo metodo segnala una versione accurata solo se la proprietà gsm.version.baseband è uguale alla versione restituita da fastboot getvar version-baseband.

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

Lanci
DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

getBatteria

public abstract Integer getBattery ()

Restituisce il livello della batteria corrente 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 un valore "1", "y", "yes", "on" o "true", false se il valore della proprietà è "0", "n", "no", "off", "false" o defaultValue altrimenti.

Lanci
DeviceNotAvailableException

getBootHistory

public abstract  getBootHistory ()

Il metodo helper raccoglie la mappa della cronologia di avvio con data e ora e motivo dell'avvio.

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

Lanci
DeviceNotAvailableException

getBootHistoryDa

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

Il metodo helper raccoglie la mappa della cronologia di avvio con ora e motivo dell'avvio a partire dal tempo specificato dall'epoca dal dispositivo e dall'unità di tempo specificata. L'attuale utcEpochTime del dispositivo in millisecondi può essere ottenuto con il metodo getDeviceDate().

Parametri
utcEpochTime long: data e 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 dell'avvio

Lanci
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

Metodo pratico per recuperare la versione bootloader del dispositivo.

Si tenterà di recuperare la versione del bootloader dallo stato attuale del dispositivo. (ad esempio, se il dispositivo è in modalità fastboot, proverà a 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 si perde 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 rispetto all'ID build (di solito 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 ricorrere all'ID build se non è stato possibile recuperarlo

Lanci
com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getBuildFlavor

public abstract String getBuildFlavor ()

Recupera la versione di build per il dispositivo.

Ritorni
String versione build o nullo se non è stato possibile recuperarla

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

getBuildSigningKey

public abstract String getBuildSigningKeys ()

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

In genere, i dispositivi Android potrebbero essere firmati con token di test (come in AOSP) o tasti di rilascio (controllati dai singoli produttori di dispositivi)

Ritorni
String La chiave di firma, se trovata, nulla, in caso contrario.

Lanci
com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

Ritorni
DeviceDescriptor

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

Parametri
shortDescriptor boolean: indica se limitare o meno il descrittore al minimo indispensabile di informazioni.

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 stringa contenente l'intero file in un percorso sul dispositivo.

Lanci
com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getConnection

public abstract AbstractConnection getConnection ()

Restituisce la connessione associata al dispositivo.

Ritorni
AbstractConnection

getDeviceClass

public abstract String getDeviceClass ()

Ottieni 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 nel formato dell'epoca.

Lanci
com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

Restituisci un DeviceDescriptor dalle informazioni del dispositivo per avere informazioni al riguardo senza trasmettere l'oggetto effettivo del dispositivo.

Ritorni
DeviceDescriptor

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Restituisci un DeviceDescriptor dalle informazioni del dispositivo per avere informazioni al riguardo senza trasmettere l'oggetto effettivo del dispositivo.

Parametri
shortDescriptor boolean: indica se limitare o meno il descrittore al minimo indispensabile di informazioni.

Ritorni
DeviceDescriptor

getDeviceState

public abstract TestDeviceState getDeviceState ()

Ottieni lo stato del dispositivo.

Ritorni
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

Assistente per rilevare la differenza di tempo tra il dispositivo e un determinato ERROR(/Date). Usa internamente il tempo di epoca.

Parametri
date Date

Ritorni
long la differenza in millisecondi

Lanci
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

recupera il flusso 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 sulla memoria esterna del dispositivo.

Ritorni
long la quantità di spazio libero in kB

Lanci
DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

getFastbootProductType

public abstract String getFastbootProductType ()

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

Questo metodo deve essere utilizzato solo se il dispositivo deve essere in fastboot. È una variante un po' più sicura rispetto al metodo getProductType() generico in questo caso, perché ITestDevice sa che deve ripristinare il dispositivo in fastboot se si trova in stato non corretto o non risponde.

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

Lanci
DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

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

Questo metodo deve essere utilizzato solo se il dispositivo deve essere in fastboot. È una variante un po' più sicura rispetto al metodo getProductType() generico in questo caso, perché ITestDevice sa che deve ripristinare il dispositivo in fastboot se si trova in stato non corretto o non risponde.

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

Lanci
DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

Restituisce il numero di serie della modalità fastboot.

Ritorni
String

getFastbootVariabile

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
Eccezione non supportata
DeviceNotAvailableException

getFileEntry

public abstract IFileEntry getFileEntry (String path)

Recupera un riferimento a un file remoto sul dispositivo.

Parametri
path String: il percorso del file da recuperare. Può essere un percorso o un percorso assoluto relativo a "/". Ad esempio, è supportata sia la sintassi "/system" che la sintassi "system".

Ritorni
IFileEntry IFileEntry o null se non è possibile trovare il file all'indirizzo path specificato

Lanci
com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getIDevice

public abstract IDevice getIDevice ()

Restituisce un riferimento all'elemento ddmlib IDevice associato.

Un nuovo IDevice può essere assegnato da DCM ogni volta che il dispositivo si disconnette e si riconnette da ADB. Di conseguenza, i chiamanti non devono tenere un riferimento al IDevice, perché questo potrebbe diventare inattivo.

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

getLastAspettaRiavvioMillis

public abstract long getLastExpectedRebootTimeMillis ()

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

Ritorni
long

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

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

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

Lanci
com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getLogcat

public abstract InputStreamSource getLogcat ()

Acquisisce un flusso di snapshot dei dati logcat.

Funziona in due modalità:

  • Se il logcat è attualmente in fase di acquisizione in background, restituirà fino a TestDeviceOptions.getMaxLogcatDataSize() byte dei contenuti attuali dell'acquisizione di logcat in background
  • Altrimenti, restituirà un dump statico dei dati logcat se il dispositivo sta rispondendo

    Ritorni
    InputStreamSource

  • getLogcat

    public abstract InputStreamSource getLogcat (int maxBytes)

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

    Utile nei casi in cui vuoi acquisire spesso snapshot dei dati logcat acquisiti senza dover incorrere in una notevole riduzione dello spazio su disco derivante dall'ottenimento dell'intero snapshot getLogcat().

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

    Ritorni
    InputStreamSource

    getLogcatDump

    public abstract InputStreamSource getLogcatDump ()

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

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

    Ritorni
    InputStreamSource un InputStreamSource dei dati logcat. Se non riesce ad acquisire i dati logcat, viene restituito un flusso vuoto.

    getLogcatDal

    public abstract InputStreamSource getLogcatSince (long date)

    Acquisisce un flusso di snapshot dei dati logcat acquisiti a partire dalla data fornita. L'ora sul dispositivo deve essere usata getDeviceDate().

    Parametri
    date long: in millisecondi dal formato dell'epoca in cui iniziare lo snapshot fino a oggi. (può essere ottenuto utilizzando "data +%s")

    Ritorni
    InputStreamSource

    getMountPoint

    public abstract String getMountPoint (String mountName)

    Restituisce un punto di montaggio.

    Esegue una 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 oppure null se il percorso non ha nulla di montato o altrimenti non viene visualizzato in /proc/mounts come punto di montaggio.

    Parametri
    mountpoint String

    Ritorni
    ITestDevice.MountPointInfo Un elemento 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 elemento 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 sulla partizione del dispositivo.

    Parametri
    partition String

    Ritorni
    long la quantità di spazio libero in kB

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

    getProcessByName

    public abstract ProcessInfo getProcessByName (String processName)

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

    Parametri
    processName String: la stringa del nome dei processi.

    Ritorni
    ProcessInfo ProcessInfo di un determinato processoName

    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 dei processi.

    Ritorni
    String

    Lanci
    DeviceNotAvailableException

    getProductType

    public abstract String getProductType ()

    Metodo pratico per conoscere 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à nullo

    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 di prodotto di questo dispositivo.

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

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

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde 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.DeviceNotAvailableEccezione
    DeviceNotAvailableException

    getRecoveryMode

    public abstract ITestDevice.RecoveryMode getRecoveryMode ()

    Recupera l'attuale modalità di ripristino 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 del dispositivo.

    Ritorni
    String il numero di serie di String

    getTombstones

    public abstract  getTombstones ()

    Recupera e restituisci l'elenco delle lapidi dai dispositivi. Richiede root.

    è il miglior tentativo quindi se per qualsiasi motivo non viene eseguito l'estrazione di una tombstone, non sarà presente nell'elenco. Solo un DeviceNotAvailableException risolverà in anticipo il metodo.

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

    Lanci
    DeviceNotAvailableException

    getTotalMemory

    public abstract long getTotalMemory ()

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

    Ritorni
    long

    getUseFastbootReset

    public abstract boolean getUseFastbootErase ()

    Scopri se utilizzare il formato fastboot reset o fastboot per cancellare una partizione sul dispositivo.

    Ritorni
    boolean true se verrà usato il reset fastboot o false se verrà usato il formato fastboot.

    isAdbRoot

    public abstract boolean isAdbRoot ()

    Ritorni
    boolean true se al momento il dispositivo dispone di root ADB, altrimenti false.

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde 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 ()

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

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

    Lanci
    com.android.tradefed.device.DeviceNotAvailableEccezione
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockSupported

    public abstract boolean isBypassLowTargetSdkBlockSupported ()

    Controlla se la piattaforma sul dispositivo supporta l'aggiramento del blocco SDK target basso sulle installazioni di app

    Ritorni
    boolean True se by bypass il blocco SDK target basso è supportato, false altrimenti

    Lanci
    com.android.tradefed.device.DeviceNotAvailableEccezione
    DeviceNotAvailableException

    isDebugfsMounted

    public abstract boolean isDebugfsMounted ()

    Controlla se il debugfs è montato.

    Ritorni
    boolean true se il debugfs è montato

    Lanci
    com.android.tradefed.device.DeviceNotAvailableEccezione
    DeviceNotAvailableException

    isDeviceEncrypted

    public abstract boolean isDeviceEncrypted ()

    Indica se il dispositivo è criptato.

    Ritorni
    boolean true se il dispositivo è criptato.

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

    isDirectory

    public abstract boolean isDirectory (String deviceFilePath)

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

    Parametri
    deviceFilePath String

    Ritorni
    boolean

    Lanci
    com.android.tradefed.device.DeviceNotAvailableEccezione
    DeviceNotAvailableException

    CrittografiaSupportato

    public abstract boolean isEncryptionSupported ()

    Indica se la crittografia è supportata sul dispositivo.

    Ritorni
    boolean true, se il dispositivo supporta la crittografia.

    Lanci
    com.android.tradefed.device.DeviceNotAvailableEccezione
    DeviceNotAvailableException

    èeseguibile

    public abstract boolean isExecutable (String fullPath)

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

    Parametri
    fullPath String

    Ritorni
    boolean

    Lanci
    com.android.tradefed.device.DeviceNotAvailableEccezione
    DeviceNotAvailableException

    isHeadless

    public abstract boolean isHeadless ()

    Restituisce true se il dispositivo è headless (nessuno schermo), false negli altri casi.

    Ritorni
    boolean

    Lanci
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public abstract boolean isRuntimePermissionSupported ()

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

    Ritorni
    boolean True se le autorizzazioni di runtime sono supportate, false negli altri casi.

    Lanci
    com.android.tradefed.device.DeviceNotAvailableEccezione
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public abstract boolean isStateBootloaderOrFastbootd ()

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

    Ritorni
    boolean

    logAn

    public abstract boolean logAnrs (ITestLogger logger)

    Raccoglie e registra gli errori ANR dal dispositivo.

    Parametri
    logger ITestLogger: un ITestLogger per registrare gli errori ANR.

    Ritorni
    boolean True se il logging è riuscito, false in caso contrario.

    Lanci
    DeviceNotAvailableException

    Dispositivo di accesso

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

    Registra un messaggio nel logcat del dispositivo. Questa è una chiamata sicura che non verrà generata anche se il logging non riesce.

    Parametri
    tag String: il tag in base al quale registriamo il nostro messaggio nel logcat.

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

    format String: il formato del messaggio.

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

    mountDebugfs

    public abstract void mountDebugfs ()

    Monta debugfs.

    Lanci
    com.android.tradefed.device.DeviceNotAvailableEccezione
    DeviceNotAvailableException

    nonBlockRiavvia

    public abstract void nonBlockingReboot ()

    Emette un comando per riavviare il dispositivo e restituisce una volta completato il comando e quando il dispositivo non è più visibile ad adb.

    Lanci
    com.android.tradefed.device.DeviceNotAvailableEccezione
    DeviceNotAvailableException

    configurazione postBoot

    public abstract void postBootSetup ()

    Segui le istruzioni per configurare il dispositivo e testarlo dopo ogni avvio.

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

    In circostanze normali, non è necessario chiamare questo metodo in modo esplicito, poiché le implementazioni devono eseguire questi passaggi automaticamente quando eseguono un riavvio.

    Potrebbe essere necessario chiamare 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 si perde e non può essere recuperata.

    postInvocationTeardown

    public void postInvocationTearDown ()

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

    Passaggi aggiuntivi per la pulizia specifica del dispositivo che verranno eseguiti dopo il completamento della chiamata.

    postInvocationTeardown

    public abstract void postInvocationTearDown (Throwable invocationException)

    Passaggi aggiuntivi per la pulizia specifica del dispositivo che verranno eseguiti dopo il completamento della chiamata.

    Parametri
    invocationException Throwable: se presente, l'eccezione finale sollevata dall'errore di chiamata.

    impostazione preInvocation

    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 archiviati nel contesto di chiamata

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

    Dir pull

    public abstract boolean pullDir (String deviceFilePath, 
                    File localDir)

    Esegui il pull ricorsivo dei contenuti della directory dal dispositivo.

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

    localDir File: la directory locale in cui estrarre i file

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

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

    Dir pull

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

    Esegui il pull ricorsivo dei contenuti della directory dal dispositivo.

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

    localDir File: la directory locale in cui estrarre i file

    userId int: l'ID utente da cui eseguire il pull

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

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

    PullFile

    public abstract File pullFile (String remoteFilePath, 
                    int userId)

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

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

    userId int: l'ID utente da cui eseguire il pull

    Ritorni
    File Un elemento 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 dell'host)

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

    PullFile

    public abstract File pullFile (String remoteFilePath)

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

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

    Ritorni
    File Un elemento 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 dell'host)

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde 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 al file sul dispositivo.

    localFile File: il file locale in cui archiviare i contenuti. Se il campo 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 si perde 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 al file sul dispositivo.

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

    userId int: l'ID utente da cui eseguire il pull

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

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde 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 al file sul dispositivo.

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

    Lanci
    DeviceNotAvailableException

    pullFileDaEsterno

    public abstract File pullFileFromExternal (String remoteFilePath)

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

    Parametri
    remoteFilePath String: il percorso del file sul dispositivo, relativo al punto di montaggio della memoria esterna del dispositivo

    Ritorni
    File Un elemento 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 dell'host)

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

    Dir push

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

    Esegui il push ricorsivo dei contenuti della directory sul dispositivo.

    Parametri
    localDir File: la directory locale di cui eseguire il push

    deviceFilePath String: il percorso file assoluto della destinazione remota

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

    Ritorni
    boolean true se il push del file è stato eseguito correttamente. false in caso contrario.

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

    Dir push

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

    Esegui il push ricorsivo dei contenuti delle directory al dispositivo, escludendo alcune directory filtrate.

    Parametri
    localDir File: la directory locale di cui eseguire il push

    deviceFilePath String: il percorso file assoluto della destinazione remota

    excludedDirectories : insieme di nomi di directory escluse di cui non deve essere eseguito il push.

    Ritorni
    boolean true se il push del file è stato eseguito correttamente. false in caso contrario.

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

    Dir push

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath)

    Esegui il push ricorsivo dei contenuti della directory sul dispositivo.

    Parametri
    localDir File: la directory locale di cui eseguire il push

    deviceFilePath String: il percorso file assoluto della destinazione remota

    Ritorni
    boolean true se il push del file è stato eseguito correttamente. false in caso contrario.

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

    File push

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

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

    Parametri
    localFile File: il file locale di cui eseguire il push

    deviceFilePath String: il percorso del file assoluto di destinazione remota

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

    Ritorni
    boolean true se il push del file è stato eseguito correttamente. false in caso contrario.

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

    File push

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath)

    Esegui il push di un file sul dispositivo. Per impostazione predefinita, viene utilizzato un fornitore di contenuti.

    Parametri
    localFile File: il file locale di cui eseguire il push

    deviceFilePath String: il percorso del file assoluto di destinazione remota

    Ritorni
    boolean true se il push del file è stato eseguito correttamente. false in caso contrario.

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

    File push

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

    Esegui il push di un file sul dispositivo. Per impostazione predefinita, viene utilizzato un fornitore di contenuti.

    Parametri
    localFile File: il file locale di cui eseguire il push

    deviceFilePath String: il percorso del file assoluto di destinazione remota

    userId int: lo userId a cui eseguire il push

    Ritorni
    boolean true se il push del file è stato eseguito correttamente. false in caso contrario.

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

    Stringaspinta

    public abstract boolean pushString (String contents, 
                    String deviceFilePath)

    Esegui il push del file creato da una stringa al dispositivo

    Parametri
    contents String: i contenuti del file di cui eseguire il push

    deviceFilePath String: il percorso del file assoluto di destinazione remota

    Ritorni
    boolean true se il push della stringa è stato eseguito correttamente. false in caso contrario.

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

    fai ripartire

    public abstract void reboot ()

    Riavvia il dispositivo in modalità ADB.

    Viene bloccato finché il dispositivo non diventa disponibile.

    Lanci
    DeviceNotAvailableException se il dispositivo non è disponibile dopo il riavvio

    fai ripartire

    public abstract void reboot (String reason)

    Riavvia il dispositivo in modalità ADB e l'reason specificato sarà mantenuto fino al riavvio.

    Viene bloccato finché il dispositivo non diventa disponibile.

    Puoi ottenere il motivo dell'ultimo riavvio eseguendo una query sulla proprietà sys.boot.reason.

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

    Lanci
    DeviceNotAvailableException se il dispositivo non è disponibile dopo il riavvio

    riavvioIntoBootloader

    public abstract void rebootIntoBootloader ()

    Riavvia il dispositivo in modalità bootloader.

    Si blocca finché il dispositivo non è in modalità bootloader.

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

    riavvioIntoFastbootd

    public abstract void rebootIntoFastbootd ()

    Riavvia il dispositivo in modalità Fastbootd.

    Si blocca finché il dispositivo non è in modalità fastbootd.

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

    riavvioIntoRecovery

    public abstract void rebootIntoRecovery ()

    Riavvia il dispositivo in modalità di ripristino ADB.

    Blocca fino all'attivazione del ripristino del dispositivo

    Lanci
    DeviceNotAvailableException se il dispositivo non è disponibile dopo il riavvio

    riavvioIntoSideload

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

    Blocco fino all'attivazione della modalità sideload sul dispositivo

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

    Lanci
    DeviceNotAvailableException se il dispositivo non è in sideload dopo il riavvio

    riavvioIntoSideload

    public abstract void rebootIntoSideload ()

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

    Blocco fino all'attivazione della modalità sideload sul dispositivo

    Lanci
    DeviceNotAvailableException se il dispositivo non è in sideload dopo il riavvio

    esegui riavvioUntilOnline

    public abstract void rebootUntilOnline ()

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

    Lanci
    DeviceNotAvailableException se il dispositivo non è disponibile dopo il riavvio

    esegui riavvioUntilOnline

    public abstract void rebootUntilOnline (String reason)

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

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

    Lanci
    DeviceNotAvailableException se il dispositivo non è disponibile dopo il riavvio

    Vedi anche:

    riavvioSpazioutente

    public abstract void rebootUserspace ()

    Riavvia solo la parte dello spazio utente del dispositivo.

    Viene bloccato finché il dispositivo non diventa disponibile.

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

    Lanci
    DeviceNotAvailableException se il dispositivo non è disponibile dopo il riavvio

    riavvioSpazioUtenteUntilOnline

    public abstract void rebootUserspaceUntilOnline ()

    Un'alternativa a rebootUserspace() ()} che viene bloccata solo finché il dispositivo non è online, cioè visibile ad ADB.

    Lanci
    DeviceNotAvailableException se il dispositivo non è disponibile dopo il riavvio

    rimontaggioSistemaReadOnly

    public abstract void remountSystemReadOnly ()

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

    Lanci
    com.android.tradefed.device.DeviceNotAvailableEccezione
    DeviceNotAvailableException

    rimonta SystemWritable

    public abstract void remountSystemWritable ()

    Rendi scrivibile la partizione di sistema del dispositivo. Il dispositivo potrebbe essere riavviato.

    Lanci
    com.android.tradefed.device.DeviceNotAvailableEccezione
    DeviceNotAvailableException

    rimontaVendorReadOnly

    public abstract void remountVendorReadOnly ()

    Rendi la partizione del fornitore sul dispositivo di sola lettura. Il dispositivo potrebbe essere riavviato.

    Lanci
    com.android.tradefed.device.DeviceNotAvailableEccezione
    DeviceNotAvailableException

    rimontareVendorWritable

    public abstract void remountVendorWritable ()

    Rendi scrivibile la partizione del fornitore sul dispositivo. Il dispositivo potrebbe essere riavviato.

    Lanci
    com.android.tradefed.device.DeviceNotAvailableEccezione
    DeviceNotAvailableException

    runInstrumentationTest

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

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

    Parametri
    runner IRemoteAndroidTestRunner: il IRemoteAndroidTestRunner che esegue i test

    listeners ITestLifeCycleReceiver: i listener dei risultati del test

    Ritorni
    boolean true se il comando di test è stato completato. false se il completamento non è riuscito, ma il recupero è riuscito

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata. Ad esempio, il comando di test non è stato completato e il ripristino non è riuscito.

    runInstrumentationTest

    public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

    Esegue test di strumentazione e fornisce il recupero del dispositivo.

    Se la connessione al dispositivo viene persa prima del completamento dell'esecuzione del test e il recupero va a buon fine, tutti i listener verranno informati di testRunFailed e verrà restituito "false". Il comando di test non verrà eseguito nuovamente. I chiamanti possono riprovare se necessario.

    Se la connessione al dispositivo viene persa prima del completamento dell'esecuzione del test e il ripristino non va a buon fine, tutti i listener verranno informati di testRunFailed e verrà generato DeviceNotAvailableException.

    Parametri
    runner IRemoteAndroidTestRunner: il IRemoteAndroidTestRunner che esegue i test

    listeners : i listener dei risultati del test

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

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata. Ad esempio, il comando di test non è stato completato e il ripristino non è riuscito.

    eseguiTestInstrumentationAsUser

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

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

    Parametri
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    Ritorni
    boolean

    Lanci
    DeviceNotAvailableException

    eseguiTestInstrumentationAsUser

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

    Uguale a 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 il root

    Parametri
    date Date: specifica una data specifica; utilizzerà la data host se null

    Lanci
    com.android.tradefed.device.DeviceNotAvailableEccezione
    DeviceNotAvailableException

    impostaOpzioni

    public abstract void setOptions (TestDeviceOptions options)

    Imposta TestDeviceOptions per il dispositivo

    Parametri
    options TestDeviceOptions

    setProprietà

    public abstract boolean setProperty (String propKey, 
                    String propValue)

    Imposta il valore specificato per la proprietà sul dispositivo. Richiede che la radice ADB sia true.

    Parametri
    propKey String: la chiave da impostare.

    propValue String: il valore della proprietà da impostare.

    Ritorni
    boolean restituisce True se il comando setprop è riuscito, False in caso contrario.

    Lanci
    com.android.tradefed.device.DeviceNotAvailableEccezione
    DeviceNotAvailableException

    setRecovery

    public abstract void setRecovery (IDeviceRecovery recovery)

    Imposta il IDeviceRecovery da usare per questo dispositivo. Da impostare quando il dispositivo viene allocato per la prima volta.

    Parametri
    recovery IDeviceRecovery: IDeviceRecovery

    setRecoveryMode

    public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

    Imposta l'attuale modalità di ripristino da usare per il dispositivo.

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

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

    ImpostaUsaFastbootReset

    public abstract void setUseFastbootErase (boolean useFastbootErase)

    Scegli se utilizzare il formato fastboot reset o fastboot per cancellare una partizione sul dispositivo.

    Parametri
    useFastbootErase boolean: true se è necessario usare il reset fastboot oppure false se è necessario usare il formato fastboot.

    StartLogcat

    public abstract void startLogcat ()

    Avvia l'acquisizione dell'output logcat dal dispositivo in background.

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

    Quando il dispositivo non è più in uso, è necessario chiamare stopLogcat().

    Normalmente non è necessario chiamare startLogcat() e stopLogcat() quando si trova all'interno di un contesto di chiamata 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 logcat non viene acquisito.

    switchToAdbTcp

    public abstract String switchToAdbTcp ()

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

    Ritorni
    String Il numero di serie tcp o null se non è stato possibile cambiare il dispositivo

    Lanci
    com.android.tradefed.device.DeviceNotAvailableEccezione
    DeviceNotAvailableException

    switchToAdbUsb

    public abstract boolean switchToAdbUsb ()

    Passa al dispositivo in modalità ADB su USB.

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

    Lanci
    com.android.tradefed.device.DeviceNotAvailableEccezione
    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 di quali file eseguire il push confrontando i timestamp dei file locali con i relativi equivalenti remoti. Solo i file "più recenti" o inesistenti verranno inviati al dispositivo. Di conseguenza, l'overhead dovrebbe essere relativamente ridotto se il file impostato sul dispositivo è già aggiornato.

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

    Esempio di utilizzo: syncFiles("/tmp/files", "/sdcard") creerà una directory /sdcard/files, se non esiste già, e invierà in modo ricorsivo i contenuti di /tmp/files a /sdcard/files.

    Parametri
    localFileDir File: la directory dei file locali contenente i file di cui eseguire il push in modo ricorsivo.

    deviceFilePath String: la radice del percorso assoluto del file di destinazione remota. Tutte le directory nel percorso di file thos devono essere leggibili. Ad esempio, il push a /data/local/tmp quando adb non è root non avrà esito positivo

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

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

    sbloccaDispositivo

    public abstract boolean unlockDevice ()

    Sblocca il dispositivo se è in stato criptato.

    Questo metodo può riavviare il framework, ma non chiamerà postBootSetup(). Di conseguenza, il dispositivo potrebbe non essere completamente pronto per essere testato quando viene restituito questo metodo.

    Ritorni
    boolean true se l'operazione ha esito positivo o se il dispositivo non è criptato.

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.
    UnsupportedOperationException se la crittografia non è supportata sul dispositivo.

    unmountDebugfs

    public abstract void unmountDebugfs ()

    Smonta il debugfs.

    Lanci
    com.android.tradefed.device.DeviceNotAvailableEccezione
    DeviceNotAvailableException

    waitForBootComplete

    public abstract boolean waitForBootComplete (long timeOut)

    Si blocca finché non viene impostato il flag di completamento dell'avvio del dispositivo.

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

    Ritorni
    boolean true se il flag di avvio completato del dispositivo è impostato entro il timeout

    Lanci
    com.android.tradefed.device.DeviceNotAvailableEccezione
    DeviceNotAvailableException

    attesaPerDispositivoDisponibile

    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 ripristino è disattivato e non disponibile.

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

    attesaPerDispositivoDisponibile

    public abstract boolean waitForDeviceAvailable (long waitTime)

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

    Parametri
    waitTime long: tempo di attesa in ms

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

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

    waitForDeviceAvailableInFetchPath

    public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

    Parametri
    waitTime long

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

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

    waitForDeviceBootloader

    public abstract void waitForDeviceBootloader ()

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

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

    attesaPerDispositivoInRecovery

    public abstract boolean waitForDeviceInRecovery (long waitTime)

    Blocchi per fare in modo che il dispositivo si trovi in stato di "recupero ADb" (tieni presente che questo è diverso da IDeviceRecovery).

    Parametri
    waitTime long: tempo di attesa in ms

    Ritorni
    boolean true se il dispositivo avvia il recupero prima della scadenza del tempo. false in caso contrario

    attesaPerDispositivoInSideload

    public abstract boolean waitForDeviceInSideload (long waitTime)

    Blocchi in modo che il dispositivo si trovi in stato "adb sideload"

    Parametri
    waitTime long: tempo di attesa in ms

    Ritorni
    boolean true se il dispositivo viene avviato in sideload prima della scadenza del tempo. false in caso contrario

    attesaPerDispositivoNonDisponibile

    public abstract boolean waitForDeviceNotAvailable (long waitTime)

    Blocchi per cui il dispositivo non è disponibile, cioè non è presente nell'ADB

    Parametri
    waitTime long: tempo di attesa in ms

    Ritorni
    boolean true se il dispositivo non diventa disponibile prima della scadenza del tempo. false in caso contrario

    attesaPerDispositivoOnline

    public abstract void waitForDeviceOnline ()

    Si blocca finché il dispositivo non è visibile tramite ADB. Usa il timeout predefinito

    Tieni presente che il dispositivo potrebbe non rispondere necessariamente ai comandi al completamento. Usa invece waitForDeviceAvailable().

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

    attesaPerDispositivoOnline

    public abstract void waitForDeviceOnline (long waitTime)

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

    Tieni presente che il dispositivo potrebbe non rispondere necessariamente ai comandi al completamento. Usa invece waitForDeviceAvailable().

    Parametri
    waitTime long: tempo di attesa in ms

    Lanci
    DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

    waitForDeviceShell

    public abstract boolean waitForDeviceShell (long waitTime)

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

    Parametri
    waitTime long: tempo di attesa in ms

    Ritorni
    boolean true se il dispositivo diventa reattivo prima dello scadere di waitTime.