INativeDevice
public interface INativeDevice
com.android.tradefed.device.INativeDevice |
Fornisce un'API affidabile e di livello leggermente superiore a un IDevice
ddmlib.
Riepilogo
Costanti | |
---|---|
int | UNKNOWN_API_LEVEL Valore predefinito quando non è possibile rilevare il livello API |
Metodi pubblici | |
---|---|
abstract boolean | checkApiLevelAgainstNextRelease (int strictMinLevel) Controlla se una funzionalità è attualmente supportata o meno dato un livello minimo supportato. |
abstract void | clearLogcat () Elimina tutti i dati logcat accumulati. |
abstract void | deleteFile (String deviceFilePath) Metodo di supporto per eliminare un file o una directory sul dispositivo. |
abstract boolean | deviceSoftRestarted ( ProcessInfo prevSystemServerProcess) Metodo di supporto per verificare se il dispositivo è stato riavviato gradualmente confrontando l'attuale system_server con il precedente system_server |
abstract boolean | deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit) Metodo di supporto per verificare se il dispositivo è stato riavviato gradualmente dall'ora UTC dall'epoca dal dispositivo e dal relativo |
abstract boolean | disableAdbRoot () Disattiva adb root. |
abstract boolean | doesFileExist (String deviceFilePath) Metodo di supporto per determinare se esiste un file sul dispositivo. |
abstract boolean | enableAdbRoot () Attiva adb root. |
abstract String | executeAdbCommand (long timeout, String... commandArgs) Metodo di supporto che esegue un comando adb come comando di sistema con un timeout specificato. |
abstract String | executeAdbCommand (String... commandArgs) Metodo di supporto che esegue un comando adb come comando di sistema. |
abstract String | executeAdbCommand (long timeout, envMap, String... commandArgs) executeAdbCommand (long timeout, envMap, String... commandArgs) Metodo di supporto che esegue un comando adb come comando di sistema con un timeout specificato. |
abstract CommandResult | executeFastbootCommand (long timeout, String... commandArgs) Metodo di supporto che esegue un comando fastboot come comando di sistema. |
abstract CommandResult | executeFastbootCommand (String... commandArgs) Metodo di supporto che esegue un comando fastboot come comando di sistema con un timeout predefinito di 2 minuti. |
abstract CommandResult | executeLongFastbootCommand (String... commandArgs) Metodo di supporto che esegue un comando fastboot di lunga durata come comando di sistema. |
abstract CommandResult | executeLongFastbootCommand ( envVarMap, String... commandArgs) executeLongFastbootCommand ( envVarMap, String... commandArgs) Metodo di supporto che esegue un comando fastboot di lunga durata come comando di sistema con variabili di ambiente di sistema. |
abstract String | executeShellCommand (String command) Metodo helper che esegue un comando shell adb e restituisce l'output come |
abstract void | executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) Esegue un comando della shell adb, con più parametri per controllare il comportamento del comando. |
abstract void | executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) Esegue un comando della shell adb, con più parametri per controllare il comportamento del comando. |
abstract void | executeShellCommand (String command, IShellOutputReceiver receiver) Esegue il comando della shell adb specificato, riprovando più volte se il comando fallisce. |
abstract CommandResult | executeShellV2Command (String command) Metodo di supporto che esegue un comando della shell adb e restituisce i risultati come |
abstract CommandResult | executeShellV2Command (String command, OutputStream pipeToOutput) Metodo di supporto che esegue un comando della shell adb e restituisce i risultati come |
abstract CommandResult | executeShellV2Command (String command, File pipeAsInput) Metodo di supporto che esegue un comando della shell adb e restituisce i risultati come |
abstract CommandResult | executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Esegue un comando della shell adb, con più parametri per controllare il comportamento del comando. |
abstract CommandResult | executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit) Esegue un comando della shell adb, con più parametri per controllare il comportamento del comando. |
abstract CommandResult | executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Esegue un comando della shell adb, con più parametri per controllare il comportamento del comando. |
abstract CommandResult | executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Esegue un comando della shell adb, con più parametri per controllare il comportamento del comando. |
abstract CommandResult | fastbootWipePartition (String partition) Metodo di supporto che cancella una partizione per il dispositivo. |
abstract int | getApiLevel () Ottieni il livello API del dispositivo. |
abstract String | getBasebandVersion () Metodo pratico per ottenere la versione in banda base (radio) di questo dispositivo. |
abstract Integer | getBattery () Restituisce il livello corrente della batteria di un dispositivo o Null se il livello della batteria non è disponibile. |
abstract boolean | getBooleanProperty (String name, boolean defaultValue) Restituisce il valore booleano della proprietà specificata. |
abstract | getBootHistory () Il metodo di supporto raccoglie la mappa della cronologia di avvio con l'ora di avvio e il motivo dell'avvio. |
abstract | getBootHistorySince (long utcEpochTime, TimeUnit timeUnit) Il metodo di supporto raccoglie la mappa della cronologia di avvio con l'ora di avvio e il motivo dell'avvio dal momento specificato dall'epoca dal dispositivo e dall'unità di tempo specificata. |
abstract String | getBootloaderVersion () Metodo conveniente per ottenere la versione bootloader di questo dispositivo. |
abstract String | getBuildAlias () Recupera l'alias della build attualmente in esecuzione sul dispositivo. |
abstract String | getBuildFlavor () Recupera la versione di build per il dispositivo. |
abstract String | getBuildId () Recupera la build attualmente in esecuzione sul dispositivo. |
abstract String | getBuildSigningKeys () Restituisce il tipo di chiave utilizzato per firmare l'immagine del dispositivo In genere i dispositivi Android possono essere firmati con chiavi di test (come in AOSP) o chiavi di rilascio (controllate dai singoli produttori di dispositivi) |
abstract DeviceDescriptor | getCachedDeviceDescriptor () Restituisce un |
abstract DeviceDescriptor | getCachedDeviceDescriptor (boolean shortDescriptor) Restituisce un |
abstract String[] | getChildren (String deviceFilePath) Alternativa all'utilizzo |
abstract AbstractConnection | getConnection () Restituisce la connessione associata al dispositivo. |
abstract String | getDeviceClass () Ottieni la classe del dispositivo. |
abstract long | getDeviceDate () Restituisce la data del dispositivo in millisecondi dall'epoca. |
abstract DeviceDescriptor | getDeviceDescriptor () Restituisce un |
abstract DeviceDescriptor | getDeviceDescriptor (boolean shortDescriptor) Restituisce un |
abstract TestDeviceState | getDeviceState () Ottieni lo stato del dispositivo. |
abstract long | getDeviceTimeOffset (Date date) Aiutante per ottenere la differenza oraria tra il dispositivo e un determinato |
abstract InputStreamSource | getEmulatorOutput () Ottieni il flusso dell'emulatore stdout e stderr |
abstract long | getExternalStoreFreeSpace () Metodo di supporto per determinare la quantità di spazio libero nella memoria esterna del dispositivo. |
abstract String | getFastbootProductType () Metodo pratico per ottenere il tipo di prodotto di questo dispositivo quando è in modalità di avvio rapido. |
abstract String | getFastbootProductVariant () Metodo pratico per ottenere il tipo di prodotto di questo dispositivo quando è in modalità di avvio rapido. |
abstract String | getFastbootSerialNumber () Restituisce il numero di serie della modalità fastboot. |
abstract String | getFastbootVariable (String variableName) Recupera il valore della variabile fastboot specificato dal dispositivo. |
abstract IFileEntry | getFileEntry (String path) Recupera un riferimento a un file remoto sul dispositivo. |
abstract IDevice | getIDevice () Restituisce un riferimento |
abstract long | getIntProperty (String name, long defaultValue) Restituisce il valore intero della proprietà specificata dal dispositivo. |
abstract long | getLastExpectedRebootTimeMillis () Restituisce l'ultima volta che le API Tradefed hanno attivato un riavvio in millisecondi da EPOCH restituito da |
abstract int | getLaunchApiLevel () Ottieni il primo livello API avviato del dispositivo. |
abstract InputStreamSource | getLogcat () Acquisisce un flusso di snapshot dei dati logcat. |
abstract InputStreamSource | getLogcat (int maxBytes) Acquisisce un flusso di snapshot degli ultimi |
abstract InputStreamSource | getLogcatDump () Ottieni un dump del logcat corrente per il dispositivo. |
abstract InputStreamSource | getLogcatSince (long date) Acquisisce un flusso di snapshot dei dati logcat acquisiti a partire dalla data fornita. |
abstract String | getMountPoint (String mountName) Restituisce un punto di montaggio. |
abstract ITestDevice.MountPointInfo | getMountPointInfo (String mountpoint) Restituisce un |
abstract | getMountPointInfo () Restituisce una versione analizzata delle informazioni in /proc/mounts sul dispositivo |
abstract long | getPartitionFreeSpace (String partition) Metodo di supporto per determinare la quantità di spazio libero sulla partizione del dispositivo. |
abstract ProcessInfo | getProcessByName (String processName) Il metodo helper esegue il comando "pidof" e "stat" e restituisce l'oggetto |
abstract String | getProcessPid (String process) Restituisce il pid del servizio oppure null se qualcosa è andato storto. |
abstract String | getProductType () Metodo pratico per ottenere il tipo di prodotto di questo dispositivo. |
abstract String | getProductVariant () Metodo conveniente per ottenere la variante di prodotto di questo dispositivo. |
abstract String | getProperty (String name) Recupera il valore della proprietà specificato dal dispositivo. |
abstract ITestDevice.RecoveryMode | getRecoveryMode () Ottieni la modalità di ripristino corrente utilizzata per il dispositivo. |
abstract String | getSerialNumber () Metodo pratico per ottenere il numero di serie di questo dispositivo. |
abstract | getTombstones () Recupera e restituisce l'elenco delle lapidi dai dispositivi. |
abstract long | getTotalMemory () Restituisce la dimensione totale della memoria fisica in byte o -1 in caso di errore interno |
abstract boolean | getUseFastbootErase () Scopri se utilizzare la cancellazione rapida o il formato di avvio rapido per cancellare una partizione sul dispositivo. |
abstract boolean | isAdbRoot () |
abstract boolean | isAdbTcp () |
abstract boolean | isAppEnumerationSupported () Controlla se la piattaforma sul dispositivo supporta l'enumerazione delle app |
abstract boolean | isBypassLowTargetSdkBlockSupported () Controlla se la piattaforma sul dispositivo supporta il bypass del blocco SDK con target basso nelle installazioni di app |
abstract boolean | isDebugfsMounted () Controlla se debugfs è montato. |
abstract boolean | isDeviceEncrypted () Restituisce se il dispositivo è crittografato. |
abstract boolean | isDirectory (String deviceFilePath) Restituisce True se il percorso sul dispositivo è una directory, false altrimenti. |
abstract boolean | isEncryptionSupported () Restituisce se la crittografia è supportata sul dispositivo. |
abstract boolean | isExecutable (String fullPath) Restituisce True se il percorso del file sul dispositivo è un file eseguibile, false altrimenti. |
abstract boolean | isHeadless () Restituisce vero se il dispositivo è senza testa (senza schermo), falso altrimenti. |
abstract boolean | isRuntimePermissionSupported () Controlla se la piattaforma sul dispositivo supporta la concessione delle autorizzazioni di runtime |
abstract boolean | isStateBootloaderOrFastbootd () Restituisce true se il dispositivo è in |
abstract boolean | logAnrs ( ITestLogger logger) Raccoglie e registra gli ANR dal dispositivo. |
abstract void | logOnDevice (String tag, Log.LogLevel level, String format, Object... args) Registra un messaggio nel logcat del dispositivo. |
abstract void | mountDebugfs () Monta debugf. |
abstract void | nonBlockingReboot () Emette un comando per riavviare il dispositivo e ritorna al termine del comando e quando il dispositivo non è più visibile ad adb. |
abstract void | postBootSetup () Eseguire le istruzioni per configurare il dispositivo per testarlo dopo ogni avvio. |
default void | postInvocationTearDown () Questo metodo è deprecato. Utilizzare invece |
abstract void | postInvocationTearDown (Throwable invocationException) Passaggi aggiuntivi per la pulizia richiesta specifica del dispositivo che verranno eseguiti al termine della chiamata. |
default void | preInvocationSetup ( IBuildInfo info, MultiMap <String, String> attributes) Passaggi aggiuntivi per la configurazione richiesta specifica del dispositivo che verranno eseguiti sul dispositivo prima del flusso di chiamata. |
abstract boolean | pullDir (String deviceFilePath, File localDir) Estrae ricorsivamente il contenuto della directory dal dispositivo. |
abstract File | pullFile (String remoteFilePath, int userId) Recupera un file dal dispositivo, lo archivia in un |
abstract File | pullFile (String remoteFilePath) Recupera un file dal dispositivo, lo archivia in un |
abstract boolean | pullFile (String remoteFilePath, File localFile) Recupera un file dal dispositivo. |
abstract boolean | pullFile (String remoteFilePath, File localFile, int userId) Recupera un file dal dispositivo. |
abstract String | pullFileContents (String remoteFilePath) Recupera un file dal dispositivo e restituisce il contenuto. |
abstract File | pullFileFromExternal (String remoteFilePath) Un metodo pratico per recuperare un file dalla memoria esterna del dispositivo, memorizzarlo in un |
abstract boolean | pushDir (File localDir, String deviceFilePath, excludedDirectories) pushDir (File localDir, String deviceFilePath, excludedDirectories) Invia ricorsivamente i contenuti della directory al dispositivo escludendo alcune directory filtrate. |
abstract boolean | pushDir (File localDir, String deviceFilePath) Invia ricorsivamente il contenuto della directory al dispositivo. |
abstract boolean | pushFile (File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded) Variante di |
abstract boolean | pushFile (File localFile, String deviceFilePath) Invia un file al dispositivo. |
abstract boolean | pushString (String contents, String deviceFilePath) Invia il file creato da una stringa al dispositivo |
abstract void | reboot () Riavvia il dispositivo in modalità adb. |
abstract void | reboot (String reason) Riavvia il dispositivo in modalità adb con |
abstract void | rebootIntoBootloader () Riavvia il dispositivo in modalità bootloader. |
abstract void | rebootIntoFastbootd () Riavvia il dispositivo in modalità fastbootd. |
abstract void | rebootIntoRecovery () Riavvia il dispositivo in modalità di ripristino adb. |
abstract void | rebootIntoSideload (boolean autoReboot) Riavvia il dispositivo in modalità sideload adb (nota che questa è una modalità speciale in fase di ripristino) Si blocca finché il dispositivo non entra in modalità sideload |
abstract void | rebootIntoSideload () Riavvia il dispositivo in modalità sideload adb (nota che questa è una modalità speciale in fase di ripristino) Si blocca finché il dispositivo non entra in modalità sideload |
abstract void | rebootUntilOnline () Un'alternativa a |
abstract void | rebootUntilOnline (String reason) Un'alternativa a |
abstract void | rebootUserspace () Riavvia solo la parte dello spazio utente del dispositivo. |
abstract void | rebootUserspaceUntilOnline () Un'alternativa a |
abstract void | remountSystemReadOnly () Rendi di sola lettura la partizione di sistema sul dispositivo. |
abstract void | remountSystemWritable () Rendere scrivibile la partizione di sistema sul dispositivo. |
abstract void | remountVendorReadOnly () Rendi di sola lettura la partizione del fornitore sul dispositivo. |
abstract void | remountVendorWritable () Rendere scrivibile la partizione del fornitore sul dispositivo. |
abstract boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners) Metodo pratico per eseguire |
abstract boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) Esegue test della strumentazione e fornisce il ripristino del dispositivo. |
abstract boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) Uguale a |
abstract boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners) Uguale a |
abstract void | setDate (Date date) Imposta la data sul dispositivo Nota: l'impostazione della data sul dispositivo richiede root |
abstract void | setOptions ( TestDeviceOptions options) Imposta |
abstract boolean | setProperty (String propKey, String propValue) Imposta il valore della proprietà specificata sul dispositivo. |
abstract void | setRecovery ( IDeviceRecovery recovery) Imposta |
abstract void | setRecoveryMode ( ITestDevice.RecoveryMode mode) Imposta la modalità di ripristino corrente da utilizzare per il dispositivo. |
abstract void | setUseFastbootErase (boolean useFastbootErase) Imposta se utilizzare la cancellazione rapida o il formato di avvio rapido per cancellare una partizione sul dispositivo. |
abstract void | startLogcat () Inizia ad acquisire l'output di logcat dal dispositivo in background. |
abstract void | stopEmulatorOutput () Chiudi ed elimina l'output dell'emulatore. |
abstract void | stopLogcat () Interrompe l'acquisizione dell'output logcat dal dispositivo ed elimina i dati logcat attualmente salvati. |
abstract String | switchToAdbTcp () Passa il dispositivo alla modalità adb-over-tcp. |
abstract boolean | switchToAdbUsb () Passa il dispositivo alla modalità adb tramite USB. |
abstract boolean | syncFiles (File localFileDir, String deviceFilePath) Sincronizza in modo incrementale il contenuto di una directory di file locale sul dispositivo. |
abstract boolean | unlockDevice () Sblocca il dispositivo se il dispositivo è in uno stato crittografato. |
abstract void | unmountDebugfs () Smonta debugf. |
abstract boolean | waitForBootComplete (long timeOut) Si blocca finché non viene impostato il flag di avvio completo del dispositivo. |
abstract boolean | waitForDeviceAvailable () Attende che il dispositivo risponda e sia disponibile per il test. |
abstract boolean | waitForDeviceAvailable (long waitTime) Attende che il dispositivo risponda e sia disponibile per il test. |
abstract boolean | waitForDeviceAvailableInRecoverPath (long waitTime) Attende che il dispositivo sia reattivo e disponibile senza considerare il percorso di ripristino. |
abstract void | waitForDeviceBootloader () Si blocca finché il dispositivo non è visibile tramite fastboot. |
abstract boolean | waitForDeviceInRecovery (long waitTime) Blocchi affinché il dispositivo si trovi nello stato 'adb recovery' (nota che questo è distinto da |
abstract boolean | waitForDeviceInSideload (long waitTime) Blocchi affinché il dispositivo si trovi nello stato "adb sideload". |
abstract boolean | waitForDeviceNotAvailable (long waitTime) I blocchi affinché il dispositivo non siano disponibili, ovvero mancanti da adb |
abstract void | waitForDeviceOnline () Si blocca finché il dispositivo non è visibile tramite adb. |
abstract void | waitForDeviceOnline (long waitTime) Si blocca finché il dispositivo non è visibile tramite adb. |
abstract boolean | waitForDeviceShell (long waitTime) Attende che il dispositivo risponda a un comando base della shell adb. |
Costanti
SCONOSCIUTO_API_LEVEL
public static final int UNKNOWN_API_LEVEL
Valore predefinito quando non è possibile rilevare il livello API
Valore costante: -1 (0xffffffff)
Metodi pubblici
checkApiLevelAgainstNextRelease
public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
Controlla se una funzionalità è attualmente supportata o meno dato un livello minimo supportato. Questo metodo tiene conto delle funzionalità non ancora rilasciate, prima che il livello API venga aumentato.
Parametri | |
---|---|
strictMinLevel | int : il livello minimo possibile rigoroso che supporta la funzionalità. |
ritorna | |
---|---|
boolean | Vero se il livello è supportato. Falso altrimenti. |
Lancia | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
clearLogcat
public abstract void clearLogcat ()
Elimina tutti i dati logcat accumulati.
Ciò è utile nei casi in cui si desidera garantireITestDevice#getLogcat()
restituisca solo i dati di registro prodotti dopo un certo punto (ad esempio dopo aver eseguito il flashing di una nuova build di dispositivo e così via). cancella il file
public abstract void deleteFile (String deviceFilePath)
Metodo di supporto per eliminare un file o una directory sul dispositivo.
Parametri | |
---|---|
deviceFilePath | String : il percorso assoluto del file sul dispositivo. |
Lancia | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
dispositivoSoftRiavviato
public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
Metodo di supporto per verificare se il dispositivo è stato riavviato gradualmente confrontando l'attuale system_server con il precedente system_server ProcessInfo
. Utilizzare getProcessByName(String)
per ottenere ProcessInfo
.
Parametri | |
---|---|
prevSystemServerProcess | ProcessInfo : il precedente processo system_server ProcessInfo . |
ritorna | |
---|---|
boolean | true se il dispositivo è stato riavviato gradualmente |
Lancia | |
---|---|
RuntimeException | se il dispositivo ha un motivo di avvio anomalo |
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
dispositivoSoftRestartedSince
public abstract boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
Metodo di supporto per verificare se il dispositivo è stato riavviato gradualmente dall'ora UTC dall'epoca dal dispositivo e dal relativo ERROR(/TimeUnit)
. Soft-Restart si riferisce a system_server riavviato al di fuori di un riavvio hardware del dispositivo (ad esempio: riavvio richiesto). Il dispositivo corrente utcEpochTime in Milliseccond può essere ottenuto con il metodo getDeviceDate()
.
Parametri | |
---|---|
utcEpochTime | long : il tempo del dispositivo in secondi dall'epoca. |
timeUnit | TimeUnit : l'unità di tempo TimeUnit per il dato utcEpochTime. |
ritorna | |
---|---|
boolean | true se il dispositivo è stato riavviato gradualmente |
Lancia | |
---|---|
RuntimeException | se il dispositivo ha un motivo di avvio anomalo |
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
disabilitaAdbRoot
public abstract boolean disableAdbRoot ()
Disattiva adb root.
La disabilitazione di adb root potrebbe causare la disconnessione del dispositivo da adb. Questo metodo si bloccherà finché il dispositivo non sarà disponibile.ritorna | |
---|---|
boolean | true in caso di successo. |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
faFileExist
public abstract boolean doesFileExist (String deviceFilePath)
Metodo di supporto per determinare se esiste un file sul dispositivo.
Parametri | |
---|---|
deviceFilePath | String : il percorso assoluto del file sul dispositivo da controllare |
ritorna | |
---|---|
boolean | true se il file esiste, false altrimenti. |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
abilitaAdbRoot
public abstract boolean enableAdbRoot ()
Attiva adb root. Se l'impostazione "enable-root" è "false", registrerà un messaggio e restituirà senza abilitare root.
L'abilitazione di adb root potrebbe causare la disconnessione del dispositivo da adb. Questo metodo si bloccherà finché il dispositivo non sarà disponibile.ritorna | |
---|---|
boolean | true in caso di successo. |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
eseguireAdbCommand
public abstract String executeAdbCommand (long timeout, String... commandArgs)
Metodo di supporto che esegue un comando adb come comando di sistema con un timeout specificato.
executeShellCommand(String)
dovrebbe essere utilizzato invece ove possibile, poiché tale metodo fornisce un migliore rilevamento degli errori e prestazioni migliori.
Parametri | |
---|---|
timeout | long : il tempo in millisecondi prima che il dispositivo venga considerato non risponde, 0L per nessun timeout |
commandArgs | String : il comando adb e gli argomenti da eseguire |
ritorna | |
---|---|
String | lo stdout dal comando. null se l'esecuzione del comando non è riuscita. |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
eseguireAdbCommand
public abstract String executeAdbCommand (String... commandArgs)
Metodo di supporto che esegue un comando adb come comando di sistema.
executeShellCommand(String)
dovrebbe essere utilizzato invece ove possibile, poiché tale metodo fornisce un migliore rilevamento degli errori e prestazioni migliori.Parametri | |
---|---|
commandArgs | String : il comando adb e gli argomenti da eseguire |
ritorna | |
---|---|
String | lo stdout dal comando. null se l'esecuzione del comando non è riuscita. |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
eseguireAdbCommand
public abstract String executeAdbCommand (long timeout,envMap, String... commandArgs)
Metodo di supporto che esegue un comando adb come comando di sistema con un timeout specificato.
executeShellCommand(String)
dovrebbe essere utilizzato invece ove possibile, poiché tale metodo fornisce un migliore rilevamento degli errori e prestazioni migliori.
Parametri | |
---|---|
timeout | long : il tempo in millisecondi prima che il dispositivo venga considerato non risponde, 0L per nessun timeout |
envMap | |
commandArgs | String : il comando adb e gli argomenti da eseguire |
ritorna | |
---|---|
String | lo stdout dal comando. null se l'esecuzione del comando non è riuscita. |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
eseguire il comando Fastboot
public abstract CommandResult executeFastbootCommand (long timeout, String... commandArgs)
Metodo di supporto che esegue un comando fastboot come comando di sistema.
Previsto per l'uso quando il dispositivo è già in modalità di avvio rapido.Parametri | |
---|---|
timeout | long : il tempo in millisecondi prima della scadenza del comando |
commandArgs | String : il comando fastboot e gli argomenti da eseguire |
ritorna | |
---|---|
CommandResult | il CommandResult contenente l'output del comando |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
eseguire il comando Fastboot
public abstract CommandResult executeFastbootCommand (String... commandArgs)
Metodo di supporto che esegue un comando fastboot come comando di sistema con un timeout predefinito di 2 minuti.
Previsto per l'uso quando il dispositivo è già in modalità di avvio rapido.
Parametri | |
---|---|
commandArgs | String : il comando fastboot e gli argomenti da eseguire |
ritorna | |
---|---|
CommandResult | il CommandResult contenente l'output del comando |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
eseguire il comando Long Fastboot
public abstract CommandResult executeLongFastbootCommand (String... commandArgs)
Metodo di supporto che esegue un comando fastboot di lunga durata come comando di sistema.
IdenticoexecuteFastbootCommand(String)
tranne che utilizza un timeout più lungo.Parametri | |
---|---|
commandArgs | String : il comando fastboot e gli argomenti da eseguire |
ritorna | |
---|---|
CommandResult | il CommandResult contenente l'output del comando |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
eseguire il comando Long Fastboot
public abstract CommandResult executeLongFastbootCommand (envVarMap, String... commandArgs)
Metodo di supporto che esegue un comando fastboot di lunga durata come comando di sistema con variabili di ambiente di sistema.
Identico executeFastbootCommand(String)
tranne che utilizza un timeout più lungo.
Parametri | |
---|---|
envVarMap | |
commandArgs | String : il comando fastboot e gli argomenti da eseguire |
ritorna | |
---|---|
CommandResult | il CommandResult contenente l'output del comando |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
eseguireShellCommand
public abstract String executeShellCommand (String command)
Metodo helper che esegue un comando shell adb e restituisce l'output come String
.
Parametri | |
---|---|
command | String : il comando della shell adb da eseguire |
ritorna | |
---|---|
String | l'output della shell |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
eseguireShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Esegue un comando della shell adb, con più parametri per controllare il comportamento del comando.
Parametri | |
---|---|
command | String : il comando della shell adb da eseguire |
receiver | IShellOutputReceiver : IShellOutputReceiver a cui indirizzare l'output della shell. |
maxTimeToOutputShellResponse | long : il periodo di tempo massimo durante il quale il comando può non emettere alcuna risposta; unità come specificato in timeUnit |
timeUnit | TimeUnit : unità per maxTimeToOutputShellResponse |
retryAttempts | int : il numero massimo di volte per riprovare il comando se fallisce a causa di un'eccezione. DeviceNotResponsiveException verrà generata se retryAttempts vengono eseguiti senza successo. |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
Guarda anche:
eseguireShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Esegue un comando della shell adb, con più parametri per controllare il comportamento del comando.
Parametri | |
---|---|
command | String : il comando della shell adb da eseguire |
receiver | IShellOutputReceiver : IShellOutputReceiver a cui indirizzare l'output della shell. |
maxTimeoutForCommand | long : il timeout massimo per il completamento del comando; unità come specificato in timeUnit |
maxTimeToOutputShellResponse | long : il periodo di tempo massimo durante il quale il comando può non emettere alcuna risposta; unità come specificato in timeUnit |
timeUnit | TimeUnit : unità per maxTimeToOutputShellResponse |
retryAttempts | int : il numero massimo di volte per riprovare il comando se fallisce a causa di un'eccezione. DeviceNotResponsiveException verrà generata se retryAttempts vengono eseguiti senza successo. |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
Guarda anche:
eseguireShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver)
Esegue il comando della shell adb specificato, riprovando più volte se il comando fallisce.
Una forma più semplice diexecuteShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
con valori predefiniti.Parametri | |
---|---|
command | String : il comando della shell adb da eseguire |
receiver | IShellOutputReceiver : IShellOutputReceiver a cui indirizzare l'output della shell. |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
eseguire il comando ShellV2
public abstract CommandResult executeShellV2Command (String command)
Metodo di supporto che esegue un comando della shell adb e restituisce i risultati come CommandResult
correttamente popolato con l'output dello stato del comando, stdout e stderr.
Parametri | |
---|---|
command | String : il comando che deve essere eseguito. |
ritorna | |
---|---|
CommandResult | Il risultato in CommandResult . |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
eseguire il comando ShellV2
public abstract CommandResult executeShellV2Command (String command, OutputStream pipeToOutput)
Metodo di supporto che esegue un comando della shell adb e restituisce i risultati come CommandResult
popolato correttamente con l'output dello stato del comando e stderr. stdout è indirizzato al flusso specificato.
Parametri | |
---|---|
command | String : il comando che deve essere eseguito. |
pipeToOutput | OutputStream : ERROR(/OutputStream) in cui l'output std verrà reindirizzato o null. |
ritorna | |
---|---|
CommandResult | Il risultato in CommandResult . |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
eseguire il comando ShellV2
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput)
Metodo di supporto che esegue un comando della shell adb e restituisce i risultati come CommandResult
correttamente popolato con l'output dello stato del comando, stdout e stderr.
Parametri | |
---|---|
command | String : il comando che deve essere eseguito. |
pipeAsInput | File : un ERROR(/File) che verrà inviato come input al comando o null. |
ritorna | |
---|---|
CommandResult | Il risultato in CommandResult . |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
eseguire il comando ShellV2
public abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Esegue un comando della shell adb, con più parametri per controllare il comportamento del comando.
Parametri | |
---|---|
command | String : il comando della shell adb da eseguire |
maxTimeoutForCommand | long : il timeout massimo per il completamento del comando; unità come specificato in timeUnit |
timeUnit | TimeUnit : unità per maxTimeToOutputShellResponse |
retryAttempts | int : il numero massimo di volte per riprovare il comando se fallisce a causa di un'eccezione. DeviceNotResponsiveException verrà generata se retryAttempts vengono eseguiti senza successo. |
ritorna | |
---|---|
CommandResult |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
Guarda anche:
eseguire il comando ShellV2
public abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit)
Esegue un comando della shell adb, con più parametri per controllare il comportamento del comando.
Parametri | |
---|---|
command | String : il comando della shell adb da eseguire |
maxTimeoutForCommand | long : il timeout massimo per il completamento del comando; unità come specificato in timeUnit |
timeUnit | TimeUnit : unità per maxTimeToOutputShellResponse |
ritorna | |
---|---|
CommandResult |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
Guarda anche:
eseguire il comando ShellV2
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Esegue un comando della shell adb, con più parametri per controllare il comportamento del comando.
Parametri | |
---|---|
command | String : il comando della shell adb da eseguire |
pipeAsInput | File : un ERROR(/File) che verrà inviato come input al comando o null. |
pipeToOutput | OutputStream : ERROR(/OutputStream) in cui l'output std verrà reindirizzato o null. |
maxTimeoutForCommand | long : il timeout massimo per il completamento del comando; unità come specificato in timeUnit |
timeUnit | TimeUnit : unità per maxTimeToOutputShellResponse |
retryAttempts | int : il numero massimo di volte per riprovare il comando se fallisce a causa di un'eccezione. DeviceNotResponsiveException verrà generata se retryAttempts vengono eseguiti senza successo. |
ritorna | |
---|---|
CommandResult |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
Guarda anche:
eseguire il comando ShellV2
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Esegue un comando della shell adb, con più parametri per controllare il comportamento del comando.
Parametri | |
---|---|
command | String : il comando della shell adb da eseguire |
pipeAsInput | File : un ERROR(/File) che verrà inviato come input al comando o null. |
pipeToOutput | OutputStream : ERROR(/OutputStream) in cui l'output std verrà reindirizzato o null. |
pipeToError | OutputStream : ERROR(/OutputStream) dove verrà reindirizzato l'errore std o null. |
maxTimeoutForCommand | long : il timeout massimo per il completamento del comando; unità come specificato in timeUnit |
timeUnit | TimeUnit : unità per maxTimeToOutputShellResponse |
retryAttempts | int : il numero massimo di volte per riprovare il comando se fallisce a causa di un'eccezione. DeviceNotResponsiveException verrà generata se retryAttempts vengono eseguiti senza successo. |
ritorna | |
---|---|
CommandResult |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
Guarda anche:
fastbootWipePartition
public abstract CommandResult fastbootWipePartition (String partition)
Metodo di supporto che cancella una partizione per il dispositivo.
SegetUseFastbootErase()
è true
, verrà utilizzata la cancellazione rapida per cancellare la partizione. Il dispositivo deve quindi creare un filesystem al successivo avvio del dispositivo. Altrimenti, viene utilizzato il formato fastboot che creerà un nuovo filesystem sul dispositivo. Previsto per l'uso quando il dispositivo è già in modalità di avvio rapido.Parametri | |
---|---|
partition | String : la partizione da cancellare |
ritorna | |
---|---|
CommandResult | il CommandResult contenente l'output del comando |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
getApiLevel
public abstract int getApiLevel ()
Ottieni il livello API del dispositivo. Il valore predefinito è UNKNOWN_API_LEVEL
.
ritorna | |
---|---|
int | un numero intero che indica il livello API del dispositivo |
Lancia | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBasebandVersion
public abstract String getBasebandVersion ()
Metodo pratico per ottenere la versione in banda base (radio) di questo dispositivo. Ottenere la versione radio è specifico del dispositivo, quindi potrebbe non restituire le informazioni corrette per tutti i dispositivi. Questo metodo si basa sulla proprietà gsm.version.baseband per restituire le informazioni sulla versione corretta. Questo non è accurato per alcuni dispositivi CDMA e la versione restituita qui potrebbe non corrispondere alla versione riportata da fastboot e potrebbe non restituire la versione per la radio CDMA. TL;DR questo metodo segnala una versione accurata solo se la proprietà gsm.version.baseband è uguale alla versione restituita da fastboot getvar version-baseband
.
ritorna | |
---|---|
String | la versione della banda base String o null se non può essere determinata (il dispositivo non ha radio o la stringa della versione non può essere letta) |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
getBattery
public abstract Integer getBattery ()
Restituisce il livello corrente della batteria di un dispositivo o Null se il livello della batteria non è disponibile.
ritorna | |
---|---|
Integer |
getBooleanProperty
public abstract boolean getBooleanProperty (String name, boolean defaultValue)
Restituisce il valore booleano della proprietà specificata.
Parametri | |
---|---|
name | String : il nome della proprietà |
defaultValue | boolean : valore predefinito da restituire se la proprietà è vuota o non esiste. |
ritorna | |
---|---|
boolean | true se la proprietà ha valore "1" , "y" , "yes" , "on" o "true" , false se la proprietà ha valore "0" , "n" , "no" , "off" , "false" o defaultValue in caso contrario. |
Lancia | |
---|---|
DeviceNotAvailableException |
getBootHistory
public abstractgetBootHistory ()
Il metodo di supporto raccoglie la mappa della cronologia di avvio con l'ora di avvio e il motivo dell'avvio.
ritorna | |
---|---|
Mappa del tempo di avvio (ora UTC in secondi dall'epoca) e motivo dell'avvio |
Lancia | |
---|---|
DeviceNotAvailableException |
getBootHistorySince
public abstractgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
Il metodo di supporto raccoglie la mappa della cronologia di avvio con l'ora di avvio e il motivo dell'avvio dal momento specificato dall'epoca dal dispositivo e dall'unità di tempo specificata. Il dispositivo corrente utcEpochTime in Millisecond può essere ottenuto con il metodo getDeviceDate()
.
Parametri | |
---|---|
utcEpochTime | long : il tempo trascorso dal dispositivo da Epoch. |
timeUnit | TimeUnit : l'unità di tempo TimeUnit . |
ritorna | |
---|---|
Mappa del tempo di avvio (ora UTC in secondi dall'epoca) e motivo dell'avvio |
Lancia | |
---|---|
DeviceNotAvailableException |
getBootloaderVersion
public abstract String getBootloaderVersion ()
Metodo conveniente per ottenere la versione bootloader di questo dispositivo.
Tenterà di recuperare la versione del bootloader dallo stato attuale del dispositivo. (ovvero, se il dispositivo è in modalità fastboot, tenterà di recuperare la versione da fastboot)ritorna | |
---|---|
String | la versione del bootloader String o null se non è possibile trovarla |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
getBuildAlias
public abstract String getBuildAlias ()
Recupera l'alias della build attualmente in esecuzione sul dispositivo.
L'alias di build è solitamente una stringa più leggibile dell'ID build (in genere un numero per le build Nexus). Ad esempio, la versione finale di Android 4.2 ha l'alias build JDQ39 e l'ID build 573038
ritorna | |
---|---|
String | l'alias di build o ricorrere all'ID di build se non è possibile recuperarlo |
Lancia | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBuildFlavor
public abstract String getBuildFlavor ()
Recupera la versione di build per il dispositivo.
ritorna | |
---|---|
String | il sapore di build o null se non è stato possibile recuperarlo |
Lancia | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBuildId
public abstract String getBuildId ()
Recupera la build attualmente in esecuzione sul dispositivo.
ritorna | |
---|---|
String | l'ID build o IBuildInfo#UNKNOWN_BUILD_ID se non è stato possibile recuperarlo |
Lancia | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBuildSigningKeys
public abstract String getBuildSigningKeys ()
Restituisce il tipo di chiave utilizzato per firmare l'immagine del dispositivo
In genere i dispositivi Android possono essere firmati con chiavi di test (come in AOSP) o chiavi di rilascio (controllate dai singoli produttori di dispositivi)
ritorna | |
---|---|
String | La chiave di firma se trovata, null altrimenti. |
Lancia | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getCachedDeviceDescriptor
public abstract DeviceDescriptor getCachedDeviceDescriptor ()
Restituisce un DeviceDescriptor
memorizzato nella cache se il dispositivo è allocato, altrimenti restituisce il DeviceDescriptor
corrente.
ritorna | |
---|---|
DeviceDescriptor |
getCachedDeviceDescriptor
public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
Restituisce un DeviceDescriptor
memorizzato nella cache se il dispositivo è allocato, altrimenti restituisce il DeviceDescriptor
corrente.
Parametri | |
---|---|
shortDescriptor | boolean : se limitare o meno il descrittore alle informazioni minime |
ritorna | |
---|---|
DeviceDescriptor |
getChildren
public abstract String[] getChildren (String deviceFilePath)
Alternativa all'utilizzo IFileEntry
che a volte non funziona a causa delle autorizzazioni.
Parametri | |
---|---|
deviceFilePath | String : è il percorso sul dispositivo dove effettuare la ricerca |
ritorna | |
---|---|
String[] | Matrice di stringhe contenenti tutti i file in un percorso sul dispositivo. |
Lancia | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getConnection
public abstract AbstractConnection getConnection ()
Restituisce la connessione associata al dispositivo.
ritorna | |
---|---|
AbstractConnection |
getDeviceClass
public abstract String getDeviceClass ()
Ottieni la classe del dispositivo.
ritorna | |
---|---|
String | la classe del dispositivo String . |
getDeviceDate
public abstract long getDeviceDate ()
Restituisce la data del dispositivo in millisecondi dall'epoca.
ritorna | |
---|---|
long | la data del dispositivo in formato epoca. |
Lancia | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor ()
Restituisce un DeviceDescriptor
dalle informazioni sul dispositivo per ottenere informazioni su di esso senza passare l'oggetto dispositivo effettivo.
ritorna | |
---|---|
DeviceDescriptor |
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
Restituisce un DeviceDescriptor
dalle informazioni sul dispositivo per ottenere informazioni su di esso senza passare l'oggetto dispositivo effettivo.
Parametri | |
---|---|
shortDescriptor | boolean : se limitare o meno il descrittore alle informazioni minime |
ritorna | |
---|---|
DeviceDescriptor |
getDeviceState
public abstract TestDeviceState getDeviceState ()
Ottieni lo stato del dispositivo.
ritorna | |
---|---|
TestDeviceState |
getDeviceTimeOffset
public abstract long getDeviceTimeOffset (Date date)
Aiutante per ottenere la differenza oraria tra il dispositivo e un determinato ERROR(/Date)
. Utilizza il tempo Epoch internamente.
Parametri | |
---|---|
date | Date |
ritorna | |
---|---|
long | la differenza in millisecondi |
Lancia | |
---|---|
DeviceNotAvailableException |
getEmulatorOutput
public abstract InputStreamSource getEmulatorOutput ()
Ottieni il flusso dell'emulatore stdout e stderr
ritorna | |
---|---|
InputStreamSource | uscita dell'emulatore |
getExternalStoreFreeSpace
public abstract long getExternalStoreFreeSpace ()
Metodo di supporto per determinare la quantità di spazio libero nella memoria esterna del dispositivo.
ritorna | |
---|---|
long | la quantità di spazio libero in KB |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
getFastbootProductType
public abstract String getFastbootProductType ()
Metodo pratico per ottenere il tipo di prodotto di questo dispositivo quando è in modalità di avvio rapido.
Questo metodo dovrebbe essere utilizzato solo se il dispositivo deve essere in avvio rapido. In questo caso è una variante un po' più sicura rispetto al metodo genericogetProductType()
, poiché ITestDevice saprà ripristinare il dispositivo in avvio rapido se il dispositivo si trova in uno stato errato o non risponde.ritorna | |
---|---|
String | il nome del tipo di prodotto String o null se non è possibile determinarlo |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
getFastbootProductVariant
public abstract String getFastbootProductVariant ()
Metodo pratico per ottenere il tipo di prodotto di questo dispositivo quando è in modalità di avvio rapido.
Questo metodo dovrebbe essere utilizzato solo se il dispositivo deve essere in avvio rapido. In questo caso è una variante un po' più sicura rispetto al metodo genericogetProductType()
, poiché ITestDevice saprà ripristinare il dispositivo in avvio rapido se il dispositivo si trova in uno stato errato o non risponde.ritorna | |
---|---|
String | il nome del tipo di prodotto String o null se non è possibile determinarlo |
Lancia | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
getFastbootSerialNumber
public abstract String getFastbootSerialNumber ()
Restituisce il numero di serie della modalità fastboot.
ritorna | |
---|---|
String |
getFastbootVariable
public abstract String getFastbootVariable (String variableName)
Recupera il valore della variabile fastboot specificato dal dispositivo.
Parametri | |
---|---|
variableName | String : il nome della variabile |
ritorna | |
---|---|
String | il valore della proprietà o null se non esiste |
Lancia | |
---|---|
| Eccezione operazione non supportata |
DeviceNotAvailableException |
getFileEntry
public abstract IFileEntry getFileEntry (String path)
Recupera un riferimento a un file remoto sul dispositivo.
Parametri | |
---|---|
path | String : il percorso del file da recuperare. Può essere un percorso assoluto o un percorso relativo a "/". (cioè è supportata sia la sintassi "/system" che "system") |
ritorna | |
---|---|
IFileEntry | IFileEntry o null se non è possibile trovare il file nel path specificato |
Lancia | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getIDevice
public abstract IDevice getIDevice ()
Restituisce un riferimento IDevice
ddmlib associato.
IDevice
può essere allocato da DDMS ogni volta che il dispositivo si disconnette e si riconnette da adb. Pertanto i chiamanti non dovrebbero mantenere un riferimento a IDevice
, poiché tale riferimento potrebbe diventare obsoleto.ritorna | |
---|---|
IDevice | l' IDevice |
getIntProperty
public abstract long getIntProperty (String name, long defaultValue)
Restituisce il valore intero della proprietà specificata dal dispositivo.
Parametri | |
---|---|
name | String : il nome della proprietà |
defaultValue | long : valore predefinito da restituire se la proprietà è vuota o non esiste. |
ritorna | |
---|---|
long | Il valore della proprietà o defaultValue se la proprietà è vuota, non esiste o non ha un valore intero. |
Lancia | |
---|---|
DeviceNotAvailableException |
getLastexpectedRebooTimeMillis
public abstract long getLastExpectedRebootTimeMillis ()
Restituisce l'ultima volta che le API FEDFED hanno innescato un riavvio in millisecondi da quando Epoch è tornato da System.currentTimeMillis()
.
ritorna | |
---|---|
long |
getlaunchapilevel
public abstract int getLaunchApiLevel ()
Ottieni il primo livello API lanciato dal dispositivo. Predefiniti su UNKNOWN_API_LEVEL
.
ritorna | |
---|---|
int | un numero intero che indica il primo livello di dispositivo avviato |
Lancia | |
---|---|
| com.android.tradefed.device.devicenotavailableException |
DeviceNotAvailableException |
getlogcat
public abstract InputStreamSource getLogcat ()
Afferra un flusso di istantanee dei dati LogCat.
Funziona in due modalità:
TestDeviceOptions.getMaxLogcatDataSize()
byte del contenuto corrente della cattura di Logcat in backgroundritorna | |
---|---|
InputStreamSource |
getlogcat
public abstract InputStreamSource getLogcat (int maxBytes)
Afferra un flusso di istantanee degli ultimi maxBytes
dei dati LogCat catturati.
Utile per i casi in cui si desidera catturare le snapshot frequenti dei dati di Logcat acquisiti senza incorrere nella penalità di spazio del disco potenzialmente grande di ottenere l'intera istantanea getLogcat()
.
Parametri | |
---|---|
maxBytes | int : la quantità massima di dati da restituire. Dovrebbe essere una quantità che può adattarsi comodamente alla memoria |
ritorna | |
---|---|
InputStreamSource |
getlogcatdump
public abstract InputStreamSource getLogcatDump ()
Ottieni un dump del logcat corrente per il dispositivo. A differenza di getLogcat()
, questo metodo restituirà sempre un dump statico del logcat.
Ha lo svantaggio che nulla verrà restituito se il dispositivo non è raggiungibile.
ritorna | |
---|---|
InputStreamSource | Un InputStreamSource dei dati LogCAT. Viene restituito un flusso vuoto se non cattura i dati di Logcat. |
getlogcatsince
public abstract InputStreamSource getLogcatSince (long date)
Afferra un flusso di snapshot di dati di logcat acquisiti a partire dalla data fornita. Il tempo sul dispositivo deve essere utilizzato getDeviceDate()
.
Parametri | |
---|---|
date | long : in millisecondi dal formato epocale di quando iniziare l'istantanea fino al presente. (può essere ottenuto utilizzando "Data +%S") |
ritorna | |
---|---|
InputStreamSource |
getmountpoint
public abstract String getMountPoint (String mountName)
Restituisce un punto di montaggio.
Interroga il dispositivo direttamente se le informazioni memorizzate nella cache inIDevice
non sono disponibili. TODO: sposta questo comportamento su IDevice#getMountPoint(String)
Parametri | |
---|---|
mountName | String : il nome del punto di montaggio |
ritorna | |
---|---|
String | il punto di montaggio o null |
Guarda anche:
getMountPointInfo
public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
Restituisce un MountPointInfo
corrispondente al percorso MountPoint specificato o null
se quel percorso non ha nulla montato o altrimenti non appare in /proc /monta come un mountpoint.
Parametri | |
---|---|
mountpoint | String |
ritorna | |
---|---|
ITestDevice.MountPointInfo | Un ERROR(/List) di MountPointInfo contenente le informazioni in "/proc/mount" |
Lancia | |
---|---|
DeviceNotAvailableException |
Guarda anche:
getMountPointInfo
public abstractgetMountPointInfo ()
Restituisce una versione analizzata delle informazioni in /proc /montes sul dispositivo
ritorna | |
---|---|
Un ERROR(/List) di MountPointInfo contenente le informazioni in "/proc/mount" |
Lancia | |
---|---|
DeviceNotAvailableException |
getpartitionfrespace
public abstract long getPartitionFreeSpace (String partition)
Metodo helper per determinare la quantità di spazio libero sulla partizione del dispositivo.
Parametri | |
---|---|
partition | String |
ritorna | |
---|---|
long | La quantità di spazio libero in KB |
Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. |
getprocessbyname
public abstract ProcessInfo getProcessByName (String processName)
Il metodo helper esegue il comando "PIDOF" e "STAT" e restituisce l'oggetto ProcessInfo
con PID e il tempo di inizio del processo del processo dato.
Parametri | |
---|---|
processName | String : la stringa di nome Proces. |
ritorna | |
---|---|
ProcessInfo | ProcessInfo di un determinato processo di processo |
Lancia | |
---|---|
DeviceNotAvailableException |
getProcessPid
public abstract String getProcessPid (String process)
Restituisce il PID del servizio o nullo se qualcosa è andato storto.
Parametri | |
---|---|
process | String : la stringa di nome Proces. |
ritorna | |
---|---|
String |
Lancia | |
---|---|
DeviceNotAvailableException |
GetProducTType
public abstract String getProductType ()
Metodo di convenienza per ottenere il tipo di prodotto di questo dispositivo.
Questo metodo funzionerà se il dispositivo è in modalità ADB o Fastboot.ritorna | |
---|---|
String | Il nome del tipo di prodotto String . Non sarà nullo |
Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata o se non è possibile determinare il tipo di prodotto |
getProductVariant
public abstract String getProductVariant ()
Metodo di convenienza per ottenere la variante del prodotto di questo dispositivo.
Questo metodo funzionerà se il dispositivo è in modalità ADB o Fastboot.ritorna | |
---|---|
String | il nome variante del prodotto String o null se non può essere determinato |
Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. |
getproperty
public abstract String getProperty (String name)
Recupera il valore della proprietà dato dal dispositivo.
Parametri | |
---|---|
name | String : il nome della proprietà |
ritorna | |
---|---|
String | il valore della proprietà o null se non esiste |
Lancia | |
---|---|
| com.android.tradefed.device.devicenotavailableException |
DeviceNotAvailableException |
getRecoverymode
public abstract ITestDevice.RecoveryMode getRecoveryMode ()
Ottieni la modalità di ripristino corrente utilizzata per il dispositivo.
ritorna | |
---|---|
ITestDevice.RecoveryMode | La modalità di ripristino corrente utilizzata per il dispositivo. |
getherialnumber
public abstract String getSerialNumber ()
Metodo di convenienza per ottenere il numero di serie di questo dispositivo.
ritorna | |
---|---|
String | il numero di serie String |
GetTomb Stones
public abstractgetTombstones ()
Fetch e restituire l'elenco delle pietre tombali dai dispositivi. Richiede radice.
Il metodo è il miglior sforzo, quindi se una lapide non viene tirata per qualsiasi motivo, mancherà dall'elenco. Solo un DeviceNotAvailableException
terminerà presto il metodo.
ritorna | |
---|---|
Un elenco di file di tomba, vuoto se nessuna tomba. |
Lancia | |
---|---|
DeviceNotAvailableException |
Guarda anche:
gettotalmemory
public abstract long getTotalMemory ()
Restituisce la dimensione totale della memoria fisica in byte o -1 in caso di errore interno
ritorna | |
---|---|
long |
getusefastbooterase
public abstract boolean getUseFastbootErase ()
Ottieni se utilizzare Fastboot Cancella o Fastboot Formato per pulire una partizione sul dispositivo.
ritorna | |
---|---|
boolean | true se verrà utilizzato la cancellazione di Fastboot o false se verrà utilizzato il formato Fastboot. |
Guarda anche:
Isadbroot
public abstract boolean isAdbRoot ()
ritorna | |
---|---|
boolean | true se il dispositivo ha attualmente la root ADB, false altrimenti. |
Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. |
ISADBTCP
public abstract boolean isAdbTcp ()
ritorna | |
---|---|
boolean | true se il dispositivo è collegato a ADB-over-TCP, false altrimenti. |
ISappenumerations supportato
public abstract boolean isAppEnumerationSupported ()
Controlla se la piattaforma sull'enumerazione dell'app supporta il dispositivo
ritorna | |
---|---|
boolean | Vero se l'enumerazione dell'app è supportata, false altrimenti |
Lancia | |
---|---|
| com.android.tradefed.device.devicenotavailableException |
DeviceNotAvailableException |
ISBYPASLOWTARGETSDKBLOCKSUPPORT
public abstract boolean isBypassLowTargetSdkBlockSupported ()
Controllare se la piattaforma sul dispositivo supporta il bypassing Blocco SDK target basso sulle installazioni di app
ritorna | |
---|---|
boolean | Vero se il blocco SDK bersaglio a basso taglio è supportato, falso altrimenti |
Lancia | |
---|---|
| com.android.tradefed.device.devicenotavailableException |
DeviceNotAvailableException |
isdebugfsmount
public abstract boolean isDebugfsMounted ()
Controlla se Debugfs è montato.
ritorna | |
---|---|
boolean | true se Debugfs è montato |
Lancia | |
---|---|
| com.android.tradefed.device.devicenotavailableException |
DeviceNotAvailableException |
isdeviceencrypted
public abstract boolean isDeviceEncrypted ()
Restituisce se il dispositivo è crittografato.
ritorna | |
---|---|
boolean | true se il dispositivo è crittografato. |
Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. |
isdirectory
public abstract boolean isDirectory (String deviceFilePath)
Restituisce true se il percorso sul dispositivo è una directory, false altrimenti.
Parametri | |
---|---|
deviceFilePath | String |
ritorna | |
---|---|
boolean |
Lancia | |
---|---|
| com.android.tradefed.device.devicenotavailableException |
DeviceNotAvailableException |
è supportato
public abstract boolean isEncryptionSupported ()
Restituisce se la crittografia è supportata sul dispositivo.
ritorna | |
---|---|
boolean | true se il dispositivo supporta la crittografia. |
Lancia | |
---|---|
| com.android.tradefed.device.devicenotavailableException |
DeviceNotAvailableException |
isEcutable
public abstract boolean isExecutable (String fullPath)
Restituisce vero se il percorso del file sul dispositivo è un file eseguibile, falso altrimenti.
Parametri | |
---|---|
fullPath | String |
ritorna | |
---|---|
boolean |
Lancia | |
---|---|
| com.android.tradefed.device.devicenotavailableException |
DeviceNotAvailableException |
isheadless
public abstract boolean isHeadless ()
Restituisce true se il dispositivo è senza testa (nessuna schermata), falso altrimenti.
ritorna | |
---|---|
boolean |
Lancia | |
---|---|
DeviceNotAvailableException |
isruntimepermissions supportato
public abstract boolean isRuntimePermissionSupported ()
Controlla se la piattaforma sul dispositivo supporta la concessione dell'autorizzazione di runtime
ritorna | |
---|---|
boolean | Vero se l'autorizzazione di runtime è supportata, false altrimenti. |
Lancia | |
---|---|
| com.android.tradefed.device.devicenotavailableException |
DeviceNotAvailableException |
ISSTATEBOOTLOOTHARDERORFASTBOOTD
public abstract boolean isStateBootloaderOrFastbootd ()
Restituisce vero se il dispositivo è in TestDeviceState#FASTBOOT
o TestDeviceState.FASTBOOTD
.
ritorna | |
---|---|
boolean |
Loganrs
public abstract boolean logAnrs (ITestLogger logger)
Raccogli e registri gli anRS dal dispositivo.
Parametri | |
---|---|
logger | ITestLogger : un ITestLogger per registrare gli anrs. |
ritorna | |
---|---|
boolean | Vero se la registrazione ha avuto successo, falso altrimenti. |
Lancia | |
---|---|
DeviceNotAvailableException |
Logondevice
public abstract void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)
Registra un messaggio nel logcat del dispositivo. Questa è una chiamata sicura che non lancerà anche se la registrazione fallisce.
Parametri | |
---|---|
tag | String : il tag in cui registriamo il nostro messaggio nel logcat. |
level | Log.LogLevel : il livello di debug del messaggio nel logcat. |
format | String : il formato del messaggio. |
args | Object : l'args da sostituire tramite String.Format (). |
Mountdebugfs
public abstract void mountDebugfs ()
Mount Debugfs.
Lancia | |
---|---|
| com.android.tradefed.device.devicenotavailableException |
DeviceNotAvailableException |
non bloccante
public abstract void nonBlockingReboot ()
Emette un comando per riavviare il dispositivo e restituisce il comando completo e quando il dispositivo non è più visibile all'ADB.
Lancia | |
---|---|
| com.android.tradefed.device.devicenotavailableException |
DeviceNotAvailableException |
PostbootSetUp
public abstract void postBootSetup ()
Eseguire le istruzioni per configurare il dispositivo per il test dopo ogni avvio.
Dovrebbe essere chiamato dopo che il dispositivo è completamente avviato/disponibile In circostanze normali questo metodo non deve essere chiamato esplicitamente, poiché le implementazioni dovrebbero eseguire automaticamente questi passaggi durante l'esecuzione di un riavvio. Dove potrebbe essere necessario chiamare è quando il dispositivo si riavvia a causa di altri eventi (ad es. Quando è stato completato un comando di aggiornamento rapido)Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. |
PostInvocationTeardown
public void postInvocationTearDown ()
Questo metodo è deprecato.
Usa invece postInvocationTearDown(Throwable)
.
Passaggi aggiuntivi per il dispositivo specifico richiesto Cleans che verrà eseguito dopo aver effettuato l'invocazione.
PostInvocationTeardown
public abstract void postInvocationTearDown (Throwable invocationException)
Passaggi aggiuntivi per il dispositivo specifico richiesto Cleans che verrà eseguito dopo aver effettuato l'invocazione.
Parametri | |
---|---|
invocationException | Throwable : se presente, l'ultima eccezione sollevata dall'errore di invocazione. |
preinvocationsetup
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
Passaggi aggiuntivi per il dispositivo specifico Impostazione richiesta che verrà eseguita sul dispositivo prima del flusso di invocazione.
Parametri | |
---|---|
info | IBuildInfo : l' IBuildInfo del dispositivo. |
attributes | MultiMap : gli attributi memorizzati nel contesto di invocazione |
Lancia | |
---|---|
| com.android.tradefed.targetprep.targetsetUperror |
| com.android.tradefed.device.devicenotavailableException |
DeviceNotAvailableException | |
TargetSetupError |
pulldir
public abstract boolean pullDir (String deviceFilePath, File localDir)
Tirare in modo ricorsivo il contenuto della directory dal dispositivo.
Parametri | |
---|---|
deviceFilePath | String : il percorso del file assoluto della sorgente remota |
localDir | File : la directory locale per attirare i file in |
ritorna | |
---|---|
boolean | true se il file è stato tirato correttamente. false altrimenti. |
Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. |
Pullfile
public abstract File pullFile (String remoteFilePath, int userId)
Recupera un dispositivo file off, lo memorizza in un ERROR(/File)
e restituisce quel File
.
Parametri | |
---|---|
remoteFilePath | String : il percorso assoluto da file sul dispositivo. |
userId | int : l'ID utente da trarre da |
ritorna | |
---|---|
File | Un ERROR(/File) contenente il contenuto del file del dispositivo o null se la copia non è riuscita per qualsiasi motivo (inclusi i problemi con il filesystem host) |
Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. |
Pullfile
public abstract File pullFile (String remoteFilePath)
Recupera un dispositivo file off, lo memorizza in un ERROR(/File)
e restituisce quel File
.
Parametri | |
---|---|
remoteFilePath | String : il percorso assoluto da file sul dispositivo. |
ritorna | |
---|---|
File | Un ERROR(/File) contenente il contenuto del file del dispositivo o null se la copia non è riuscita per qualsiasi motivo (inclusi i problemi con il filesystem host) |
Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. |
Pullfile
public abstract boolean pullFile (String remoteFilePath, File localFile)
Recupera un dispositivo file off.
Parametri | |
---|---|
remoteFilePath | String : il percorso assoluto da file sul dispositivo. |
localFile | File : il file locale per archiviare i contenuti in. Se non vuoto, i contenuti verranno sostituiti. |
ritorna | |
---|---|
boolean | true se il file è stato recuperato correttamente. false altrimenti. |
Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. |
Pullfile
public abstract boolean pullFile (String remoteFilePath, File localFile, int userId)
Recupera un dispositivo file off.
Parametri | |
---|---|
remoteFilePath | String : il percorso assoluto da file sul dispositivo. |
localFile | File : il file locale per archiviare i contenuti in. Se non vuoto, i contenuti verranno sostituiti. |
userId | int : l'ID utente da trarre da |
ritorna | |
---|---|
boolean | true se il file è stato recuperato correttamente. false altrimenti. |
Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. |
PullfileContents
public abstract String pullFileContents (String remoteFilePath)
Recupera un dispositivo file off e restituisce il contenuto.
Parametri | |
---|---|
remoteFilePath | String : il percorso assoluto da file sul dispositivo. |
ritorna | |
---|---|
String | Una String contenente il contenuto del file del dispositivo o null se la copia non è riuscita per qualsiasi motivo (inclusi i problemi con il filesystem host) |
Lancia | |
---|---|
DeviceNotAvailableException |
Pullfilefromexternal
public abstract File pullFileFromExternal (String remoteFilePath)
Un metodo di convenienza per recuperare un file dall'archiviazione esterna del dispositivo, lo memorizza in un ERROR(/File)
e restituire un riferimento a quel File
.
Parametri | |
---|---|
remoteFilePath | String : il percorso del file sul dispositivo, relativo al monte di archiviazione esterno del dispositivo |
ritorna | |
---|---|
File | Un ERROR(/File) contenente il contenuto del file del dispositivo o null se la copia non è riuscita per qualsiasi motivo (inclusi i problemi con il filesystem host) |
Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. |
Pushdir
public abstract boolean pushDir (File localDir, String deviceFilePath,excludedDirectories)
Spingere ricorsivamente i contenuti della directory al dispositivo escludendo alcune directory che vengono filtrate.
Parametri | |
---|---|
localDir | File : la directory locale da spingere |
deviceFilePath | String : il percorso del file assoluto della destinazione remota |
excludedDirectories |
ritorna | |
---|---|
boolean | true se il file è stato spinto correttamente. false altrimenti. |
Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. |
Pushdir
public abstract boolean pushDir (File localDir, String deviceFilePath)
Spingere ricorsivamente i contenuti della directory al dispositivo.
Parametri | |
---|---|
localDir | File : la directory locale da spingere |
deviceFilePath | String : il percorso del file assoluto della destinazione remota |
ritorna | |
---|---|
boolean | true se il file è stato spinto correttamente. false altrimenti. |
Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. |
Pushfile
public abstract boolean pushFile (File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)
Variante di pushFile(File, String)
che può opzionalmente considerare la valutazione della necessità del provider di contenuti.
Parametri | |
---|---|
localFile | File : il file locale da spingere |
deviceFilePath | String : il percorso del file assoluto di destinazione remoto |
evaluateContentProviderNeeded | boolean : se verificare se abbiamo bisogno del fornitore di contenuti |
ritorna | |
---|---|
boolean | true se il file è stato spinto correttamente. false altrimenti. |
Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. |
Pushfile
public abstract boolean pushFile (File localFile, String deviceFilePath)
Spingere un file sul dispositivo. Per impostazione predefinita utilizzando un fornitore di contenuti.
Parametri | |
---|---|
localFile | File : il file locale da spingere |
deviceFilePath | String : il percorso del file assoluto di destinazione remoto |
ritorna | |
---|---|
boolean | true se il file è stato spinto correttamente. false altrimenti. |
Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. |
spingendo
public abstract boolean pushString (String contents, String deviceFilePath)
Push File creato da una stringa a dispositivo
Parametri | |
---|---|
contents | String : il contenuto del file da spingere |
deviceFilePath | String : il percorso del file assoluto di destinazione remoto |
ritorna | |
---|---|
boolean | true se la stringa è stata spinta correttamente. false altrimenti. |
Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. |
riavviare
public abstract void reboot ()
Riavvia il dispositivo in modalità ADB.
Blocchi fino a quando il dispositivo non diventa disponibile.Lancia | |
---|---|
DeviceNotAvailableException | Se il dispositivo non è disponibile dopo il riavvio |
riavviare
public abstract void reboot (String reason)
Riavvia il dispositivo in modalità ADB con una determinata reason
per essere persistito attraverso il riavvio.
Blocchi fino a quando il dispositivo non diventa disponibile.
L'ultima ragione di riavvio può essere ottenuta interrogando sys.boot.reason
Propety.
Parametri | |
---|---|
reason | String : un motivo di questo riavvio o null se non viene specificato alcun motivo. |
Lancia | |
---|---|
DeviceNotAvailableException | Se il dispositivo non è disponibile dopo il riavvio |
RebootIntOBooTloader
public abstract void rebootIntoBootloader ()
Riavvia il dispositivo in modalità bootloader.
Blocca fino a quando il dispositivo è in modalità bootloader.Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. |
rebootIntOfastBootd
public abstract void rebootIntoFastbootd ()
Riavvia il dispositivo in modalità FastBootd.
Blocchi fino a quando il dispositivo è in modalità FastBootd.
Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. |
rebootIntoTecovery
public abstract void rebootIntoRecovery ()
Riavvia il dispositivo in modalità di ripristino ADB.
Blocca fino a quando il dispositivo non entra nel recuperoLancia | |
---|---|
DeviceNotAvailableException | Se il dispositivo non è disponibile dopo il riavvio |
rebootIntosideload
public abstract void rebootIntoSideload (boolean autoReboot)
Riavvia il dispositivo in modalità Sideload ADB (si noti che questa è una modalità speciale in recupero)
Blocca fino a quando il dispositivo non entra in modalità sideload
Parametri | |
---|---|
autoReboot | boolean : se riavviare automaticamente il dispositivo dopo sideload |
Lancia | |
---|---|
DeviceNotAvailableException | Se il dispositivo non è in cordatura dopo il riavvio |
rebootIntosideload
public abstract void rebootIntoSideload ()
Riavvia il dispositivo in modalità Sideload ADB (si noti che questa è una modalità speciale in recupero)
Blocca fino a quando il dispositivo non entra in modalità sideload
Lancia | |
---|---|
DeviceNotAvailableException | Se il dispositivo non è in cordatura dopo il riavvio |
RebootunTilonline
public abstract void rebootUntilOnline ()
Un alternativo al reboot()
che blocca solo fino a quando il dispositivo è online, cioè visibile all'ADB.
Lancia | |
---|---|
DeviceNotAvailableException | Se il dispositivo non è disponibile dopo il riavvio |
RebootunTilonline
public abstract void rebootUntilOnline (String reason)
Un alternativo al reboot()
che blocca solo fino a quando il dispositivo è online, cioè visibile all'ADB.
Parametri | |
---|---|
reason | String : un motivo di questo riavvio o null se non viene specificato alcun motivo. |
Lancia | |
---|---|
DeviceNotAvailableException | Se il dispositivo non è disponibile dopo il riavvio |
Guarda anche:
rebootuserspace
public abstract void rebootUserspace ()
Riavvia solo parte degli utenti parte del dispositivo.
Blocchi fino a quando il dispositivo non diventa disponibile.
AVVERTIMENTO. Il riavvio degli utenti è attualmente in fase di sviluppo attivo, utilizzarlo a proprio rischio.
Lancia | |
---|---|
DeviceNotAvailableException | Se il dispositivo non è disponibile dopo il riavvio |
RebootuserspaceUnTilonline
public abstract void rebootUserspaceUntilOnline ()
Un alternativo a rebootUserspace()
() che blocca solo fino a quando il dispositivo è online, cioè visibile ad ADB.
Lancia | |
---|---|
DeviceNotAvailableException | Se il dispositivo non è disponibile dopo il riavvio |
RemountSystemReadonly
public abstract void remountSystemReadOnly ()
Rendi la partizione di sistema sul dispositivo di sola lettura. Può riavviare il dispositivo.
Lancia | |
---|---|
| com.android.tradefed.device.devicenotavailableException |
DeviceNotAvailableException |
RemountSystemWritable
public abstract void remountSystemWritable ()
Rendi la partizione di sistema sul dispositivo scrivibile. Può riavviare il dispositivo.
Lancia | |
---|---|
| com.android.tradefed.device.devicenotavailableException |
DeviceNotAvailableException |
RemountvendoReadonly
public abstract void remountVendorReadOnly ()
Rendi la partizione del fornitore sul dispositivo di sola lettura. Può riavviare il dispositivo.
Lancia | |
---|---|
| com.android.tradefed.device.devicenotavailableException |
DeviceNotAvailableException |
RemountvendorWritable
public abstract void remountVendorWritable ()
Rendi la partizione del fornitore sul dispositivo scrivibile. Può riavviare il dispositivo.
Lancia | |
---|---|
| com.android.tradefed.device.devicenotavailableException |
DeviceNotAvailableException |
RuninStrumentationTests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Metodo di convenienza per eseguire ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
con uno o più ascoltatori passati come parametri.
Parametri | |
---|---|
runner | IRemoteAndroidTestRunner : The IRemoteAndroidTestRunner che esegue i test |
listeners | ITestLifeCycleReceiver : The Test Risultati Listener (S) |
ritorna | |
---|---|
boolean | true se il comando di prova completato. false se non è riuscito a completare, ma il recupero è riuscito |
Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. IE Comando Test non è riuscito a completare e il recupero non è riuscito. |
RuninStrumentationTests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Esegue test di strumentazione e fornisce il recupero del dispositivo.
Se la connessione con il dispositivo viene persa prima del completamento del test e il recupero abbia successo, tutti gli ascoltatori saranno informati di TestRunfaild e "False" verranno restituiti. Il comando di test non verrà eseguito. Viene lasciato ai chiamanti per riprovare se necessario.
Se la connessione con il dispositivo viene persa prima del completamento del test e il recupero fallisce, tutti gli ascoltatori saranno informati di TestRunfaild e DevicenoTavailableException verrà lanciato.
Parametri | |
---|---|
runner | IRemoteAndroidTestRunner : The IRemoteAndroidTestRunner che esegue i test |
listeners |
ritorna | |
---|---|
boolean | true se il comando di prova completato. false se non è riuscito a completare a causa dell'eccezione della comunicazione del dispositivo, ma il recupero è riuscito |
Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. IE Comando Test non è riuscito a completare e il recupero non è riuscito. |
RuninStrumentationTestSasuser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
Come ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))
Ma esegue il test per l'utente dato.
Parametri | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners |
ritorna | |
---|---|
boolean |
Lancia | |
---|---|
DeviceNotAvailableException |
RuninStrumentationTestSasuser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Come ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)
ma esegue il test per un determinato utente.
Parametri | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners | ITestLifeCycleReceiver |
ritorna | |
---|---|
boolean |
Lancia | |
---|---|
DeviceNotAvailableException |
impostare la data
public abstract void setDate (Date date)
Imposta la data sul dispositivo
Nota: la data di impostazione sul dispositivo richiede root
Parametri | |
---|---|
date | Date : specificare una data particolare; Utilizzerà la data host se null |
Lancia | |
---|---|
| com.android.tradefed.device.devicenotavailableException |
DeviceNotAvailableException |
setoptions
public abstract void setOptions (TestDeviceOptions options)
Imposta TestDeviceOptions
per il dispositivo
Parametri | |
---|---|
options | TestDeviceOptions |
SetProperty
public abstract boolean setProperty (String propKey, String propValue)
Imposta il valore della proprietà dato sul dispositivo. Richiede che la radice ADB sia vera.
Parametri | |
---|---|
propKey | String : la chiave mirata da impostare. |
propValue | String : il valore della proprietà da impostare. |
ritorna | |
---|---|
boolean | Restituisce True se il comando setProp ha avuto successo, falso altrimenti. |
Lancia | |
---|---|
| com.android.tradefed.device.devicenotavailableException |
DeviceNotAvailableException |
SetRecovery
public abstract void setRecovery (IDeviceRecovery recovery)
Imposta su IDeviceRecovery
su questo dispositivo. Dovrebbe essere impostato quando il dispositivo viene assegnato per la prima volta.
Parametri | |
---|---|
recovery | IDeviceRecovery : The IDeviceRecovery |
setRecoverymode
public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)
Impostare la modalità di ripristino corrente da utilizzare per il dispositivo.
Utilizzato per controllare quale metodo di recupero utilizzare quando si incontra un problema di comunicazione del dispositivo. Si consiglia di utilizzare questo metodo solo con parsimonia quando necessario (ad esempio, quando il framework è inattivo, ecc.Parametri | |
---|---|
mode | ITestDevice.RecoveryMode : la modalità "Ripristina fino a quando online" dovrebbe essere attiva o meno. |
SetUeSeSfastBooterase
public abstract void setUseFastbootErase (boolean useFastbootErase)
Impostare se utilizzare Fastboot Cancella o Fastboot Formato per pulire una partizione sul dispositivo.
Parametri | |
---|---|
useFastbootErase | boolean : true se la cancellazione di Fastboot deve essere utilizzata o false se è necessario utilizzare un formato di stivale veloce. |
Guarda anche:
startlogcat
public abstract void startLogcat ()
Avvia l'acquisizione dell'output di Logcat dal dispositivo in background.
Non avrà alcun effetto se l'output di Logcat è già stato catturato. I dati possono essere successivamente recuperati tramite getLogcat. Quando il dispositivo non è più in uso, deve essere chiamatostopLogcat()
. startLogcat()
e stopLogcat()
normalmente non devono essere chiamati quando all'interno di un contesto di invocazione TF, poiché il framework TF inizierà e interromperà Logcat. stopemularOutput
public abstract void stopEmulatorOutput ()
Chiudere ed eliminare l'output dell'emulatore.
StopLogcat
public abstract void stopLogcat ()
Interrompere l'acquisizione di output di logcat dal dispositivo e scartare i dati di logcat attualmente salvati.
Non avrà alcun effetto se l'output di Logcat non viene acquisito.SwitchToadBtcp
public abstract String switchToAdbTcp ()
Passa il dispositivo in modalità ADB-over-TCP.
ritorna | |
---|---|
String | Il numero di serie TCP o null se il dispositivo non poteva essere commutato |
Lancia | |
---|---|
| com.android.tradefed.device.devicenotavailableException |
DeviceNotAvailableException |
SwitchToadBusb
public abstract boolean switchToAdbUsb ()
Passa il dispositivo su ADB in modalità USB.
ritorna | |
---|---|
boolean | true se Switch ha avuto successo, false altrimenti. |
Lancia | |
---|---|
| com.android.tradefed.device.devicenotavailableException |
DeviceNotAvailableException |
SyncFiles
public abstract boolean syncFiles (File localFileDir, String deviceFilePath)
Sincronizza in modo incrementale il contenuto di una directory di file locale al dispositivo.
Decide quali file spingono confrontando i timestamp dei file locali con i loro equivalenti remoti. Solo i file "più nuovi" o inesistenti verranno spinti sul dispositivo. Pertanto, le spese generali dovrebbero essere relativamente piccole se il file impostato sul dispositivo è già aggiornato. I file nascosti (con nomi che iniziano con ".") Verranno ignorati. Esempio di utilizzo: syncFiles ("/tmp/files", "/sdcard") creerà la directory a/sdcard/file se non esiste già e spingere ricorsivamente il contenuto/tmp/files su/sdcard/files.Parametri | |
---|---|
localFileDir | File : la directory dei file locali contenente file per spingere in modo ricorsivo. |
deviceFilePath | String : il root del percorso del file assoluto di destinazione remoto. Tutte le directory nel percorso del file tos devono essere leggibili. cioè spingere a/data/locale/tmp quando l'ADB non è root fallirà |
ritorna | |
---|---|
boolean | true se i file sono stati sincronizzati correttamente. false altrimenti. |
Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. |
UnlockDevice
public abstract boolean unlockDevice ()
Sblocca il dispositivo se il dispositivo è in uno stato crittografato.
Questo metodo può riavviare il framework ma non chiameràpostBootSetup()
. Pertanto, il dispositivo potrebbe non essere completamente pronto per essere testato al ritorno di questo metodo.ritorna | |
---|---|
boolean | true in caso di successo o se il dispositivo non è crittografato. |
Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. |
UnsupportedOperationException | Se la crittografia non è supportata sul dispositivo. |
unmountDebugfs
public abstract void unmountDebugfs ()
Debugfs non montare.
Lancia | |
---|---|
| com.android.tradefed.device.devicenotavailableException |
DeviceNotAvailableException |
WaitTorBootComplete
public abstract boolean waitForBootComplete (long timeOut)
Blocchi fino a quando il flag completo del dispositivo non è impostato.
Parametri | |
---|---|
timeOut | long : tempo negli msec per attendere che la bandiera venga impostata |
ritorna | |
---|---|
boolean | Vero se il flag completo di avvio del dispositivo è impostato entro il timeout |
Lancia | |
---|---|
| com.android.tradefed.device.devicenotavailableException |
DeviceNotAvailableException |
waitfordeviceavailable
public abstract boolean waitForDeviceAvailable ()
Aspetta che il dispositivo sia reattivo e disponibile per i test. Utilizza il timeout predefinito.
ritorna | |
---|---|
boolean | Vero se è disponibile un dispositivo, false se il ripristino è disabilitato e non disponibile. |
Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. |
waitfordeviceavailable
public abstract boolean waitForDeviceAvailable (long waitTime)
Aspetta che il dispositivo sia reattivo e disponibile per i test.
Parametri | |
---|---|
waitTime | long : il tempo in MS da aspettare |
ritorna | |
---|---|
boolean | Vero se è disponibile un dispositivo, false se il ripristino è disabilitato e non disponibile. |
Lancia | |
---|---|
DeviceNotAvailableException | Se il dispositivo non risponde ancora dopo la scadenza. |
waitfordeviceavailableInRecoverPath
public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Aspetta che il dispositivo sia reattivo e disponibile senza considerare il percorso di recupero.
Parametri | |
---|---|
waitTime | long |
ritorna | |
---|---|
boolean | Vero se il dispositivo è disponibile, falso se non disponibile. |
Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. |
waitFordevicebootloader
public abstract void waitForDeviceBootloader ()
Blocchi fino a quando il dispositivo è visibile tramite Fastboot. Usa il timeout predefinito.
Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. |
waitfordeviceinrecovery
public abstract boolean waitForDeviceInRecovery (long waitTime)
Blocchi che il dispositivo sia nello stato "ADB Recovery" (si noti che è distinto da IDeviceRecovery
).
Parametri | |
---|---|
waitTime | long : il tempo in MS da aspettare |
ritorna | |
---|---|
boolean | true se il dispositivo si avvia nel recupero prima della scadenza del tempo. false altrimenti |
WaitFordeViceInsideload
public abstract boolean waitForDeviceInSideload (long waitTime)
Blocchi che il dispositivo sia nello stato "ADB Sideload"
Parametri | |
---|---|
waitTime | long : il tempo in MS da aspettare |
ritorna | |
---|---|
boolean | true se il dispositivo si avvia in Sideload prima della scadenza del tempo. false altrimenti |
waitfordevicenotavailabile
public abstract boolean waitForDeviceNotAvailable (long waitTime)
Blocchi che il dispositivo non sia disponibile, cioè mancante da ADB
Parametri | |
---|---|
waitTime | long : il tempo in MS da aspettare |
ritorna | |
---|---|
boolean | true se il dispositivo non diventa disponibile prima della scadenza del tempo. false altrimenti |
waitfordeviceonline
public abstract void waitForDeviceOnline ()
Blocchi fino a quando il dispositivo è visibile tramite ADB. Utilizza il timeout predefinito
Nota che il dispositivo potrebbe non essere necessariamente sensibile ai comandi al completamento. Usa invecewaitForDeviceAvailable()
.Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. |
waitfordeviceonline
public abstract void waitForDeviceOnline (long waitTime)
Blocchi fino a quando il dispositivo è visibile tramite ADB.
Nota che il dispositivo potrebbe non essere necessariamente sensibile ai comandi al completamento. Usa invecewaitForDeviceAvailable()
.Parametri | |
---|---|
waitTime | long : il tempo in MS da aspettare |
Lancia | |
---|---|
DeviceNotAvailableException | Se la connessione con il dispositivo viene persa e non può essere recuperata. |
WaitFordeVicesHell
public abstract boolean waitForDeviceShell (long waitTime)
Aspetta che il dispositivo sia reattivo a un comando di base Shell di base.
Parametri | |
---|---|
waitTime | long : il tempo in MS da aspettare |
ritorna | |
---|---|
boolean | true se il dispositivo diventa reattivo prima che trascorra waitTime . |