INativeDevice
public interface INativeDevice
com.android.tradefed.device.INativeDevice |
Fornisce un'API affidabile e di livello leggermente superiore a un IDevice IDevice
.
Riepilogo
Costanti | |
---|---|
int | UNKNOWN_API_LEVEL Valore predefinito quando non è possibile rilevare il livello API |
Metodi pubblici | |
---|---|
abstract boolean | checkApiLevelAgainstNextRelease (int strictMinLevel) Controlla se una funzionalità è attualmente supportata o meno dato un livello minimamente supportato. |
abstract void | clearLogcat () Elimina tutti i dati logcat accumulati. |
abstract void | deleteFile (String deviceFilePath) Metodo di supporto per eliminare un file o una directory sul dispositivo. |
abstract boolean | deviceSoftRestarted ( ProcessInfo prevSystemServerProcess) Metodo di supporto per verificare se il dispositivo è stato riavviato in modo software confrontando il server_sistema corrente con il server_sistema precedente |
abstract boolean | deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit) Metodo di supporto per verificare se il dispositivo è stato riavviato in modo graduale dall'ora UTC dall'epoca dal dispositivo e dal relativo |
abstract boolean | disableAdbRoot () Disattiva adb root. |
abstract boolean | doesFileExist (String deviceFilePath) Metodo di supporto per determinare se il file esiste sul dispositivo. |
abstract boolean | enableAdbRoot () Attiva adb root. |
abstract String | executeAdbCommand (long timeout, String... commandArgs) Metodo di supporto che esegue un comando adb come comando di sistema con un timeout specificato. |
abstract String | executeAdbCommand (String... commandArgs) Metodo di supporto che esegue un comando adb come comando di sistema. |
abstract CommandResult | executeFastbootCommand (String... commandArgs) Metodo di supporto che esegue un comando di avvio rapido come comando di sistema con un timeout predefinito di 2 minuti. |
abstract CommandResult | executeFastbootCommand (long timeout, String... commandArgs) Metodo di supporto che esegue un comando di avvio rapido come comando di sistema. |
abstract CommandResult | executeLongFastbootCommand ( envVarMap, String... commandArgs) executeLongFastbootCommand ( envVarMap, String... commandArgs) Metodo di supporto che esegue un comando di avvio rapido di lunga durata come comando di sistema con variabili di ambiente di sistema. |
abstract CommandResult | executeLongFastbootCommand (String... commandArgs) Metodo di supporto che esegue un comando di avvio rapido di lunga durata come comando di sistema. |
abstract String | executeShellCommand (String command) Metodo di supporto che esegue un comando adb shell e restituisce l'output come |
abstract void | executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) Esegue un comando adb shell, con più parametri per controllare il comportamento del comando. |
abstract void | executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) Esegue un comando adb shell, con più parametri per controllare il comportamento del comando. |
abstract void | executeShellCommand (String command, IShellOutputReceiver receiver) Esegue il comando adb shell fornito, riprovando più volte se il comando non riesce. |
abstract CommandResult | executeShellV2Command (String command) Metodo di supporto che esegue un comando adb shell e restituisce i risultati come |
abstract CommandResult | executeShellV2Command (String command, OutputStream pipeToOutput) Metodo di supporto che esegue un comando adb shell e restituisce i risultati come |
abstract CommandResult | executeShellV2Command (String command, File pipeAsInput) Metodo di supporto che esegue un comando adb shell e restituisce i risultati come |
abstract CommandResult | executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Esegue un comando adb shell, con più parametri per controllare il comportamento del comando. |
abstract CommandResult | executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit) Esegue un comando adb shell, con più parametri per controllare il comportamento del comando. |
abstract CommandResult | executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Esegue un comando adb shell, con più parametri per controllare il comportamento del comando. |
abstract CommandResult | executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Esegue un comando adb shell, con più parametri per controllare il comportamento del comando. |
abstract CommandResult | fastbootWipePartition (String partition) Metodo di supporto che cancella una partizione per il dispositivo. |
abstract int | getApiLevel () Ottieni il livello API del dispositivo. |
abstract String | getBasebandVersion () Metodo pratico per ottenere la versione in banda base (radio) di questo dispositivo. |
abstract Integer | getBattery () Restituisce il livello della batteria corrente di un dispositivo o Null se il livello della batteria non è disponibile. |
abstract boolean | getBooleanProperty (String name, boolean defaultValue) Restituisce il valore booleano della proprietà data. |
abstract | getBootHistory () Il metodo di supporto raccoglie la mappa della cronologia di avvio con il tempo di avvio e il motivo di avvio. |
abstract | getBootHistorySince (long utcEpochTime, TimeUnit timeUnit) Il metodo helper raccoglie la mappa della cronologia di avvio con l'ora di avvio e il motivo di avvio dall'ora specificata dall'epoca dal dispositivo e dall'unità di tempo specificata. |
abstract String | getBootloaderVersion () Metodo pratico per ottenere la versione bootloader di questo dispositivo. |
abstract InputStreamSource | getBugreport () Recupera una segnalazione di bug dal dispositivo. |
abstract InputStreamSource | getBugreportz () Recupera un bugreportz dal dispositivo. |
abstract String | getBuildAlias () Recupera l'alias della build attualmente in esecuzione sul dispositivo. |
abstract String | getBuildFlavor () Recupera la versione di build per il dispositivo. |
abstract String | getBuildId () Recupera la build attualmente in esecuzione sul dispositivo. |
abstract String | getBuildSigningKeys () Restituisce il tipo di chiave utilizzato per firmare l'immagine del dispositivo In genere i dispositivi Android possono essere firmati con chiavi di test (come in AOSP) o chiavi di rilascio (controllate dai singoli produttori di dispositivi) |
abstract DeviceDescriptor | getCachedDeviceDescriptor () Restituisce un |
abstract DeviceDescriptor | getCachedDeviceDescriptor (boolean shortDescriptor) Restituisce un |
abstract String[] | getChildren (String deviceFilePath) Alternativa all'utilizzo di |
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) Helper per ottenere la differenza di orario tra il dispositivo e un dato |
abstract InputStreamSource | getEmulatorOutput () Ottieni il flusso dell'emulatore stdout e stderr |
abstract long | getExternalStoreFreeSpace () Metodo di supporto per determinare la quantità di spazio libero sulla memoria esterna del dispositivo. |
abstract String | getFastbootProductType () Metodo pratico per ottenere il tipo di prodotto di questo dispositivo quando è in modalità di avvio rapido. |
abstract String | getFastbootProductVariant () Metodo pratico per ottenere il tipo di prodotto di questo dispositivo quando è in modalità di avvio rapido. |
abstract String | getFastbootSerialNumber () Restituisce il numero di serie della modalità di avvio rapido. |
abstract String | getFastbootVariable (String variableName) Recupera il valore della variabile di avvio rapido specificato dal dispositivo. |
abstract IFileEntry | getFileEntry (String path) Recupera un riferimento a un file remoto sul dispositivo. |
abstract IDevice | getIDevice () Restituisce un riferimento all'IDevice |
abstract long | getIntProperty (String name, long defaultValue) Restituisce il valore intero della proprietà data dal dispositivo. |
abstract long | getLastExpectedRebootTimeMillis () Restituisce l'ultima volta che le API Tradefed hanno attivato un riavvio in millisecondi da EPOCH come restituito da |
abstract int | getLaunchApiLevel () Ottieni il primo livello API avviato del dispositivo. |
abstract InputStreamSource | getLogcat () Afferra un flusso di snapshot dei dati logcat. |
abstract InputStreamSource | getLogcat (int maxBytes) Afferra un flusso di snapshot degli ultimi |
abstract InputStreamSource | getLogcatDump () Ottieni un dump del logcat corrente per il dispositivo. |
abstract InputStreamSource | getLogcatSince (long date) Afferra un flusso di snapshot dei dati logcat acquisiti a partire dalla data fornita. |
abstract String | getMountPoint (String mountName) Restituisce un punto di montaggio. |
abstract ITestDevice.MountPointInfo | getMountPointInfo (String mountpoint) Restituisce un |
abstract | getMountPointInfo () Restituisce una versione analizzata delle informazioni in /proc/mounts sul dispositivo |
abstract long | getPartitionFreeSpace (String partition) Metodo di supporto per determinare la quantità di spazio libero sulla partizione del dispositivo. |
abstract ProcessInfo | getProcessByName (String processName) Il metodo di supporto esegue il comando "pidof" e "stat" e restituisce l'oggetto |
abstract String | getProcessPid (String process) Restituisce il pid del servizio o null se qualcosa è andato storto. |
abstract String | getProductType () Metodo pratico per ottenere il tipo di prodotto di questo dispositivo. |
abstract String | getProductVariant () Metodo pratico per ottenere la variante di prodotto di questo dispositivo. |
abstract String | getProperty (String name) Recupera il valore della proprietà specificato dal dispositivo. |
abstract ITestDevice.RecoveryMode | getRecoveryMode () Ottieni la modalità di ripristino corrente utilizzata per il dispositivo. |
abstract String | getSerialNumber () Metodo pratico per ottenere il numero di serie di questo dispositivo. |
abstract | getTombstones () Recupera e restituisci l'elenco delle lapidi dai dispositivi. |
abstract long | getTotalMemory () Restituisce la dimensione totale della memoria fisica in byte o -1 in caso di errore interno |
abstract boolean | getUseFastbootErase () Scopri se utilizzare la cancellazione rapida o il formato di avvio rapido per cancellare una partizione sul dispositivo. |
abstract boolean | isAdbRoot () |
abstract boolean | isAdbTcp () |
abstract boolean | isAppEnumerationSupported () Verifica se la piattaforma sul dispositivo supporta l'enumerazione delle app |
abstract boolean | isDeviceEncrypted () Restituisce se il dispositivo è crittografato. |
abstract boolean | isDirectory (String deviceFilePath) Restituisce True se il percorso sul dispositivo è una directory, false in caso contrario. |
abstract boolean | isEncryptionSupported () Restituisce se la crittografia è supportata sul dispositivo. |
abstract boolean | isExecutable (String fullPath) Restituisce True se il percorso del file sul dispositivo è un file eseguibile, false in caso contrario. |
abstract boolean | isHeadless () Restituisce true se il dispositivo è headless (senza schermo), false in caso contrario. |
abstract boolean | isRuntimePermissionSupported () Verifica se la piattaforma sul dispositivo supporta la concessione di autorizzazioni di runtime |
abstract boolean | isStateBootloaderOrFastbootd () Restituisce true se il dispositivo è in |
abstract boolean | logAnrs ( ITestLogger logger) Raccoglie e registra gli ANR dal dispositivo. |
abstract boolean | logBugreport (String dataName, ITestLogger listener) Metodo di supporto per prendere una segnalazione di bug e registrarla ai giornalisti. |
abstract void | logOnDevice (String tag, Log.LogLevel level, String format, Object... args) Registra un messaggio nel logcat del dispositivo. |
abstract void | nonBlockingReboot () Emette un comando per riavviare il dispositivo e ritorna al comando completo e quando il dispositivo non è più visibile ad adb. |
abstract void | postBootSetup () Eseguire le istruzioni per configurare il dispositivo per testarlo dopo ogni avvio. |
default void | postInvocationTearDown () Questo metodo è deprecato. Usa |
abstract void | postInvocationTearDown (Throwable invocationException) Passaggi aggiuntivi per la pulizia specifica del dispositivo richiesta che verrà eseguita al termine della chiamata. |
default void | preInvocationSetup ( IBuildInfo info, MultiMap <String, String> attributes) Passaggi aggiuntivi per la configurazione richiesta specifica del dispositivo che verrà eseguita sul dispositivo prima del flusso di chiamata. |
abstract boolean | pullDir (String deviceFilePath, File localDir) Estrarre ricorsivamente il contenuto della directory dal dispositivo. |
abstract File | pullFile (String remoteFilePath, int userId) Recupera un file dal dispositivo, lo archivia in un |
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 ne restituisce il contenuto. |
abstract File | pullFileFromExternal (String remoteFilePath) Un metodo pratico per recuperare un file dalla memoria esterna del dispositivo, archiviarlo in un |
abstract boolean | pushDir (File localDir, String deviceFilePath, excludedDirectories) pushDir (File localDir, String deviceFilePath, excludedDirectories) Invia ricorsivamente il contenuto della directory al dispositivo escludendo alcune directory filtrate. |
abstract boolean | pushDir (File localDir, String deviceFilePath) Invia ricorsivamente il contenuto della directory al dispositivo. |
abstract boolean | pushFile (File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded) Variante di |
abstract boolean | pushFile (File localFile, String deviceFilePath) Invia un file al dispositivo. |
abstract boolean | pushString (String contents, String deviceFilePath) File push creato da una stringa al dispositivo |
abstract void | reboot () Riavvia il dispositivo in modalità adb. |
abstract void | reboot (String reason) Riavvia il dispositivo in modalità adb con un determinato |
abstract void | rebootIntoBootloader () Riavvia il dispositivo in modalità bootloader. |
abstract void | rebootIntoFastbootd () Riavvia il dispositivo in modalità di avvio rapido. |
abstract void | rebootIntoRecovery () Riavvia il dispositivo in modalità di ripristino adb. |
abstract void | rebootIntoSideload (boolean autoReboot) Riavvia il dispositivo in modalità adb sideload (notare che questa è una modalità speciale in fase di ripristino) Si blocca fino a quando il dispositivo non entra in modalità sideload |
abstract void | rebootIntoSideload () Riavvia il dispositivo in modalità adb sideload (notare che questa è una modalità speciale in fase di ripristino) Si blocca fino a quando il dispositivo non entra in modalità sideload |
abstract void | rebootUntilOnline () Un'alternativa a |
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 | remountSystemWritable () Rendi scrivibile la partizione di sistema sul dispositivo. |
abstract void | remountVendorWritable () Rendi scrivibile la partizione del fornitore sul dispositivo. |
abstract boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners) Metodo pratico per eseguire |
abstract boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) Esegue i test della strumentazione e fornisce il ripristino del dispositivo. |
abstract boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners) Uguale a |
abstract boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) Come |
abstract void | setDate (Date date) Imposta la data sul dispositivo Nota: l'impostazione della data sul dispositivo richiede il root |
abstract void | setOptions ( TestDeviceOptions options) Impostare |
abstract boolean | setProperty (String propKey, String propValue) Imposta il valore della proprietà specificato 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 a catturare l'output logcat dal dispositivo in background. |
abstract void | stopEmulatorOutput () Chiudi ed elimina l'output dell'emulatore. |
abstract void | stopLogcat () Interrompi l'acquisizione dell'output logcat dal dispositivo ed elimina i dati logcat attualmente salvati. |
abstract String | switchToAdbTcp () Passa il dispositivo alla modalità adb-over-tcp. |
abstract boolean | switchToAdbUsb () Passa al dispositivo in modalità adb su USB. |
abstract boolean | syncFiles (File localFileDir, String deviceFilePath) Sincronizza in modo incrementale il contenuto di una directory di file locale sul dispositivo. |
abstract Bugreport | takeBugreport () Prendi un bugreport e lo restituisce all'interno di un oggetto |
abstract boolean | unlockDevice () Sblocca il dispositivo se il dispositivo è in uno stato crittografato. |
abstract boolean | waitForBootComplete (long timeOut) Si blocca fino a quando non viene impostato il flag di avvio completo del dispositivo. |
abstract boolean | waitForDeviceAvailable () Attende che il dispositivo sia reattivo e disponibile per il test. |
abstract boolean | waitForDeviceAvailable (long waitTime) Attende che il dispositivo sia reattivo e disponibile per il test. |
abstract void | waitForDeviceBootloader () Si blocca fino a quando il dispositivo non è visibile tramite avvio rapido. |
abstract boolean | waitForDeviceInRecovery (long waitTime) Blocca il dispositivo in modo che si trovi nello stato di "ripristino adb" (nota che questo è distinto da |
abstract boolean | waitForDeviceInSideload (long waitTime) Blocca il dispositivo in modo che sia nello stato 'adb sideload' |
abstract boolean | waitForDeviceNotAvailable (long waitTime) Blocca il dispositivo per non essere disponibile ovvero mancante da adb |
abstract void | waitForDeviceOnline () Si blocca fino a quando il dispositivo non è visibile tramite adb. |
abstract void | waitForDeviceOnline (long waitTime) Si blocca fino a quando il dispositivo non è visibile tramite adb. |
abstract boolean | waitForDeviceShell (long waitTime) Attende che il dispositivo risponda a un comando di base della shell adb. |
Costanti
UNKNOWN_API_LEVEL
public static final int UNKNOWN_API_LEVEL
Valore predefinito quando non è possibile rilevare il livello API
Valore costante: -1 (0xffffffff)
Metodi pubblici
checkApiLevelAgainstNextRelease
public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
Controlla se una funzionalità è attualmente supportata o meno dato un livello minimamente supportato. Questo metodo tiene conto delle funzionalità non ancora rilasciate, prima che il livello dell'API venga innalzato.
Parametri | |
---|---|
strictMinLevel | int : il livello minimo possibile stretto che supporta la funzione. |
ritorna | |
---|---|
boolean | Vero se il livello è supportato. Falso altrimenti. |
Tiri | |
---|---|
DeviceNotAvailableException |
clearLogcat
public abstract void clearLogcat ()
Elimina tutti i dati logcat accumulati.
Ciò è utile nei casi in cui si desidera garantire cheITestDevice#getLogcat()
restituisca solo i dati di registro prodotti dopo un determinato punto (ad esempio dopo il flashing di una nuova build del dispositivo, ecc.). cancella il file
public abstract void deleteFile (String deviceFilePath)
Metodo di supporto per eliminare un file o una directory sul dispositivo.
Parametri | |
---|---|
deviceFilePath | String : il percorso assoluto del file sul dispositivo. |
Tiri | |
---|---|
DeviceNotAvailableException |
deviceSoftRestarted
public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
Metodo di supporto per verificare se il dispositivo è stato riavviato in modo software confrontando il server_sistema corrente con il server_sistema precedente ProcessInfo
. Usa getProcessByName(String)
per ottenere ProcessInfo
.
Parametri | |
---|---|
prevSystemServerProcess | ProcessInfo : il precedente processo system_server ProcessInfo . |
ritorna | |
---|---|
boolean | true se il dispositivo è stato riavviato in modo graduale |
Tiri | |
---|---|
RuntimeException | se il dispositivo ha un motivo di avvio anomalo |
DeviceNotAvailableException |
deviceSoftRestartedSince
public abstract boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
Metodo di supporto per verificare se il dispositivo è stato riavviato in modo graduale dall'ora UTC dall'epoca dal dispositivo e dal relativo ERROR(/TimeUnit)
. Soft-Restart si riferisce a system_server riavviato al di fuori di un riavvio forzato del dispositivo (ad esempio: riavvio richiesto). Il dispositivo corrente utcEpochTime in Milliseccond può essere ottenuto con il metodo getDeviceDate()
.
Parametri | |
---|---|
utcEpochTime | long : il tempo del dispositivo in secondi dall'epoca. |
timeUnit | TimeUnit : l'unità di tempo TimeUnit per il dato utcEpochTime. |
ritorna | |
---|---|
boolean | true se il dispositivo è stato riavviato in modo graduale |
Tiri | |
---|---|
RuntimeException | se il dispositivo ha un motivo di avvio anomalo |
DeviceNotAvailableException |
disabilitareAdbRoot
public abstract boolean disableAdbRoot ()
Disattiva adb root.
La disabilitazione di adb root potrebbe causare la disconnessione del dispositivo da adb. Questo metodo si bloccherà finché il dispositivo non sarà disponibile.ritorna | |
---|---|
boolean | true caso di successo. |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
faFileExist
public abstract boolean doesFileExist (String deviceFilePath)
Metodo di supporto per determinare se il file esiste sul dispositivo.
Parametri | |
---|---|
deviceFilePath | String : il percorso assoluto del file sul dispositivo da controllare |
ritorna | |
---|---|
boolean | true se il file esiste, false in caso contrario. |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
enableAdbRoot
public abstract boolean enableAdbRoot ()
Attiva adb root. Se l'impostazione "enable-root" è "false", registrerà un messaggio e tornerà senza abilitare root.
L'abilitazione di adb root potrebbe causare la disconnessione del dispositivo da adb. Questo metodo si bloccherà finché il dispositivo non sarà disponibile.ritorna | |
---|---|
boolean | true caso di successo. |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
esegui AdbCommand
public abstract String executeAdbCommand (long timeout, String... commandArgs)
Metodo di supporto che esegue un comando adb come comando di sistema con un timeout specificato.
executeShellCommand(String)
dovrebbe invece essere usato ove possibile, poiché questo metodo offre prestazioni e rilevamento degli errori migliori.
Parametri | |
---|---|
timeout | long : il tempo in millisecondi prima che il dispositivo sia considerato non rispondente, 0L per nessun timeout |
commandArgs | String : il comando adb e gli argomenti da eseguire |
ritorna | |
---|---|
String | lo stdout dal comando. null se il comando non è stato eseguito. |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
esegui AdbCommand
public abstract String executeAdbCommand (String... commandArgs)
Metodo di supporto che esegue un comando adb come comando di sistema.
executeShellCommand(String)
dovrebbe invece essere usato ove possibile, poiché questo metodo offre prestazioni e rilevamento degli errori migliori.Parametri | |
---|---|
commandArgs | String : il comando adb e gli argomenti da eseguire |
ritorna | |
---|---|
String | lo stdout dal comando. null se il comando non è stato eseguito. |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
esegui FastbootCommand
public abstract CommandResult executeFastbootCommand (String... commandArgs)
Metodo di supporto che esegue un comando di avvio rapido come comando di sistema con un timeout predefinito di 2 minuti.
Dovrebbe essere utilizzato quando il dispositivo è già in modalità di avvio rapido.Parametri | |
---|---|
commandArgs | String : il comando fastboot e gli argomenti da eseguire |
ritorna | |
---|---|
CommandResult | CommandResult contenente l'output del comando |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
esegui FastbootCommand
public abstract CommandResult executeFastbootCommand (long timeout, String... commandArgs)
Metodo di supporto che esegue un comando di avvio rapido come comando di sistema.
Dovrebbe essere utilizzato quando il dispositivo è già in modalità di avvio rapido.Parametri | |
---|---|
timeout | long : il tempo in millisecondi prima della scadenza del comando |
commandArgs | String : il comando fastboot e gli argomenti da eseguire |
ritorna | |
---|---|
CommandResult | CommandResult contenente l'output del comando |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
executeLongFastbootCommand
public abstract CommandResult executeLongFastbootCommand (envVarMap, String... commandArgs)
Metodo di supporto che esegue un comando di avvio rapido di lunga durata come comando di sistema con variabili di ambiente di sistema.
Identico a executeFastbootCommand(String)
tranne per l'utilizzo di un timeout più lungo.
Parametri | |
---|---|
envVarMap | |
commandArgs | String : il comando fastboot e gli argomenti da eseguire |
ritorna | |
---|---|
CommandResult | CommandResult contenente l'output del comando |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
executeLongFastbootCommand
public abstract CommandResult executeLongFastbootCommand (String... commandArgs)
Metodo di supporto che esegue un comando di avvio rapido di lunga durata come comando di sistema.
Identico aexecuteFastbootCommand(String)
tranne per l'utilizzo di un timeout più lungo.Parametri | |
---|---|
commandArgs | String : il comando fastboot e gli argomenti da eseguire |
ritorna | |
---|---|
CommandResult | CommandResult contenente l'output del comando |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
eseguiShellCommand
public abstract String executeShellCommand (String command)
Metodo di supporto che esegue un comando adb shell e restituisce l'output come String
.
Parametri | |
---|---|
command | String : il comando adb shell da eseguire |
ritorna | |
---|---|
String | l'output della shell |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
eseguiShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.
Parametri | |
---|---|
command | String : il comando adb shell da eseguire |
receiver | IShellOutputReceiver : IShellOutputReceiver a cui indirizzare l'output della shell. |
maxTimeToOutputShellResponse | long : il tempo massimo durante il quale il comando può non produrre alcuna risposta; unità come specificato in timeUnit |
timeUnit | TimeUnit : unità per maxTimeToOutputShellResponse |
retryAttempts | int : il numero massimo di volte per ripetere il comando se non riesce a causa di un'eccezione. DeviceNotResponsiveException verrà generata se retryAttempts viene eseguito senza successo. |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
Guarda anche:
eseguiShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.
Parametri | |
---|---|
command | String : il comando adb shell da eseguire |
receiver | IShellOutputReceiver : IShellOutputReceiver a cui indirizzare l'output della shell. |
maxTimeoutForCommand | long : il timeout massimo per il completamento del comando; unità come specificato in timeUnit |
maxTimeToOutputShellResponse | long : il tempo massimo durante il quale il comando può non produrre alcuna risposta; unità come specificato in timeUnit |
timeUnit | TimeUnit : unità per maxTimeToOutputShellResponse |
retryAttempts | int : il numero massimo di volte per ripetere il comando se non riesce a causa di un'eccezione. DeviceNotResponsiveException verrà generata se retryAttempts viene eseguito senza successo. |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
Guarda anche:
eseguiShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver)
Esegue il comando adb shell fornito, riprovando più volte se il comando non riesce.
Una forma più semplice diexecuteShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
con valori predefiniti.Parametri | |
---|---|
command | String : il comando adb shell da eseguire |
receiver | IShellOutputReceiver : IShellOutputReceiver a cui indirizzare l'output della shell. |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
eseguiShellV2Command
public abstract CommandResult executeShellV2Command (String command)
Metodo di supporto che esegue un comando adb shell e restituisce i risultati come CommandResult
correttamente popolato con l'output dello stato del comando, stdout e stderr.
Parametri | |
---|---|
command | String : il comando da eseguire. |
ritorna | |
---|---|
CommandResult | Il risultato in CommandResult . |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
eseguiShellV2Command
public abstract CommandResult executeShellV2Command (String command, OutputStream pipeToOutput)
Metodo di supporto che esegue un comando adb shell e restituisce i risultati come CommandResult
correttamente popolato con l'output dello stato del comando e stderr. stdout è indirizzato al flusso specificato.
Parametri | |
---|---|
command | String : il comando da eseguire. |
pipeToOutput | OutputStream : ERROR(/OutputStream) dove l'output std verrà reindirizzato o null. |
ritorna | |
---|---|
CommandResult | Il risultato in CommandResult . |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
eseguiShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput)
Metodo di supporto che esegue un comando adb shell e restituisce i risultati come CommandResult
correttamente popolato con l'output dello stato del comando, stdout e stderr.
Parametri | |
---|---|
command | String : il comando da eseguire. |
pipeAsInput | File : un ERROR(/File) che verrà inviato tramite pipe come input al comando o null. |
ritorna | |
---|---|
CommandResult | Il risultato in CommandResult . |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
eseguiShellV2Command
public abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.
Parametri | |
---|---|
command | String : il comando adb shell da eseguire |
maxTimeoutForCommand | long : il timeout massimo per il completamento del comando; unità come specificato in timeUnit |
timeUnit | TimeUnit : unità per maxTimeToOutputShellResponse |
retryAttempts | int : il numero massimo di volte per ripetere il comando se non riesce a causa di un'eccezione. DeviceNotResponsiveException verrà generata se retryAttempts viene eseguito senza successo. |
ritorna | |
---|---|
CommandResult |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
Guarda anche:
eseguiShellV2Command
public abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit)
Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.
Parametri | |
---|---|
command | String : il comando adb shell da eseguire |
maxTimeoutForCommand | long : il timeout massimo per il completamento del comando; unità come specificato in timeUnit |
timeUnit | TimeUnit : unità per maxTimeToOutputShellResponse |
ritorna | |
---|---|
CommandResult |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
Guarda anche:
eseguiShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.
Parametri | |
---|---|
command | String : il comando adb shell da eseguire |
pipeAsInput | File : un ERROR(/File) che verrà inviato tramite pipe come input al comando o null. |
pipeToOutput | OutputStream : ERROR(/OutputStream) dove l'output std verrà reindirizzato o null. |
maxTimeoutForCommand | long : il timeout massimo per il completamento del comando; unità come specificato in timeUnit |
timeUnit | TimeUnit : unità per maxTimeToOutputShellResponse |
retryAttempts | int : il numero massimo di volte per ripetere il comando se non riesce a causa di un'eccezione. DeviceNotResponsiveException verrà generata se retryAttempts viene eseguito senza successo. |
ritorna | |
---|---|
CommandResult |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
Guarda anche:
eseguiShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.
Parametri | |
---|---|
command | String : il comando adb shell da eseguire |
pipeAsInput | File : un ERROR(/File) che verrà inviato tramite pipe come input al comando o null. |
pipeToOutput | OutputStream : ERROR(/OutputStream) dove l'output std verrà reindirizzato o null. |
pipeToError | OutputStream : ERROR(/OutputStream) dove l'errore std verrà reindirizzato o null. |
maxTimeoutForCommand | long : il timeout massimo per il completamento del comando; unità come specificato in timeUnit |
timeUnit | TimeUnit : unità per maxTimeToOutputShellResponse |
retryAttempts | int : il numero massimo di volte per ripetere il comando se non riesce a causa di un'eccezione. DeviceNotResponsiveException verrà generata se retryAttempts viene eseguito senza successo. |
ritorna | |
---|---|
CommandResult |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
Guarda anche:
fastbootWipePartition
public abstract CommandResult fastbootWipePartition (String partition)
Metodo di supporto che cancella una partizione per il dispositivo.
SegetUseFastbootErase()
è true
, per cancellare la partizione verrà utilizzato fastboot erase. Il dispositivo deve quindi creare un filesystem al successivo avvio del dispositivo. In caso contrario, viene utilizzato il formato di avvio rapido che creerà un nuovo filesystem sul dispositivo. Dovrebbe essere utilizzato quando il dispositivo è già in modalità di avvio rapido.Parametri | |
---|---|
partition | String : la partizione da cancellare |
ritorna | |
---|---|
CommandResult | CommandResult contenente l'output del comando |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
getApiLevel
public abstract int getApiLevel ()
Ottieni il livello API del dispositivo. Il valore predefinito UNKNOWN_API_LEVEL
.
ritorna | |
---|---|
int | un numero intero che indica il livello API del dispositivo |
Tiri | |
---|---|
DeviceNotAvailableException |
getBasebandVersion
public abstract String getBasebandVersion ()
Metodo pratico per ottenere la versione in banda base (radio) di questo dispositivo. Ottenere la versione radio è specifica del dispositivo, quindi potrebbe non restituire le informazioni corrette per tutti i dispositivi. Questo metodo si basa sulla proprietà gsm.version.baseband per restituire le informazioni sulla versione corretta. Questo non è accurato per alcuni dispositivi CDMA e la versione qui restituita potrebbe non corrispondere alla versione riportata da fastboot e potrebbe non restituire la versione per la radio CDMA. TL;DR questo metodo riporta una versione accurata solo se la proprietà gsm.version.baseband è la stessa della versione restituita da fastboot getvar version-baseband
.
ritorna | |
---|---|
String | la versione String baseband o null se non può essere determinata (il dispositivo non ha radio o la stringa della versione non può essere letta) |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
prendi la batteria
public abstract Integer getBattery ()
Restituisce il livello della batteria corrente di un dispositivo o Null se il livello della batteria non è disponibile.
ritorna | |
---|---|
Integer |
getBooleanProperty
public abstract boolean getBooleanProperty (String name, boolean defaultValue)
Restituisce il valore booleano della proprietà data.
Parametri | |
---|---|
name | String : il nome della proprietà |
defaultValue | boolean : valore predefinito da restituire se la proprietà è vuota o non esiste. |
ritorna | |
---|---|
boolean | true se la proprietà ha valore "1" , "y" , "yes" , "on" o "true" , false se la proprietà ha valore "0" , "n" , "no" , "off" , "false" o defaultValue contrario. |
Tiri | |
---|---|
DeviceNotAvailableException |
getBootHistory
public abstractgetBootHistory ()
Il metodo di supporto raccoglie la mappa della cronologia di avvio con il tempo di avvio e il motivo di avvio.
ritorna | |
---|---|
Mappa del tempo di avvio (ora UTC in secondi da Epoch) e motivo di avvio |
Tiri | |
---|---|
DeviceNotAvailableException |
getBootHistoryDa
public abstractgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
Il metodo helper raccoglie la mappa della cronologia di avvio con l'ora di avvio e il motivo di avvio dall'ora specificata dall'epoca dal dispositivo e dall'unità di tempo specificata. Il dispositivo corrente utcEpochTime in Millisecond può essere ottenuto con il metodo getDeviceDate()
.
Parametri | |
---|---|
utcEpochTime | long : il tempo del dispositivo da Epoch. |
timeUnit | TimeUnit : l'unità di tempo TimeUnit . |
ritorna | |
---|---|
Mappa del tempo di avvio (ora UTC in secondi da Epoch) e motivo di avvio |
Tiri | |
---|---|
DeviceNotAvailableException |
getBootloaderVersion
public abstract String getBootloaderVersion ()
Metodo pratico per ottenere la versione bootloader di questo dispositivo.
Tenterà di recuperare la versione del bootloader dallo stato corrente del dispositivo. (ad esempio, se il dispositivo è in modalità di avvio rapido, tenterà di recuperare la versione da avvio rapido)ritorna | |
---|---|
String | la versione del bootloader String o null se non può essere trovata |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
getBugreport
public abstract InputStreamSource getBugreport ()
Recupera una segnalazione di bug dal dispositivo.
L'implementazione di questo è garantita per continuare a funzionare su un dispositivo senza una sdcard (o dove la sdcard non è ancora montata).ritorna | |
---|---|
InputStreamSource | Un InputStreamSource che produrrà i contenuti della segnalazione di bug su richiesta. In caso di errore, InputStreamSource produrrà un ERROR(/InputStream) vuoto. |
getBugreportz
public abstract InputStreamSource getBugreportz ()
Recupera un bugreportz dal dispositivo. Il bugreport in formato zip contiene il bugreport principale e altri file di registro utili per il debug.
Supportato solo per 'versione adb' > 1.0.36ritorna | |
---|---|
InputStreamSource | un InputStreamSource del file zip contenente il bugreportz, restituisce null in caso di errore. |
getBuildAlias
public abstract String getBuildAlias ()
Recupera l'alias della build attualmente in esecuzione sul dispositivo.
L'alias di build è solitamente una stringa più leggibile rispetto all'id build (in genere un numero per le build di Nexus). Ad esempio, la versione finale di Android 4.2 ha l'alias di build JDQ39 e l'ID build 573038
ritorna | |
---|---|
String | l'alias build o fallback per build id se non è stato possibile recuperarlo |
Tiri | |
---|---|
DeviceNotAvailableException |
getBuildFlavor
public abstract String getBuildFlavor ()
Recupera la versione di build per il dispositivo.
ritorna | |
---|---|
String | la versione di build o null se non è stato possibile recuperarla |
Tiri | |
---|---|
DeviceNotAvailableException |
getBuildId
public abstract String getBuildId ()
Recupera la build attualmente in esecuzione sul dispositivo.
ritorna | |
---|---|
String | l'id build o IBuildInfo#UNKNOWN_BUILD_ID se non è stato possibile recuperarlo |
Tiri | |
---|---|
DeviceNotAvailableException |
getBuildSigningKeys
public abstract String getBuildSigningKeys ()
Restituisce il tipo di chiave utilizzato per firmare l'immagine del dispositivo
In genere i dispositivi Android possono essere firmati con chiavi di test (come in AOSP) o chiavi di rilascio (controllate dai singoli produttori di dispositivi)
ritorna | |
---|---|
String | La chiave di firma se trovata, null in caso contrario. |
Tiri | |
---|---|
DeviceNotAvailableException |
getCachedDeviceDescriptor
public abstract DeviceDescriptor getCachedDeviceDescriptor ()
Restituisce un DeviceDescriptor
memorizzato nella cache se il dispositivo è allocato, altrimenti restituisce il DeviceDescriptor
corrente.
ritorna | |
---|---|
DeviceDescriptor |
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 a informazioni minime |
ritorna | |
---|---|
DeviceDescriptor |
ottenereChildren
public abstract String[] getChildren (String deviceFilePath)
Alternativa all'utilizzo di IFileEntry
che a volte non funziona a causa delle autorizzazioni.
Parametri | |
---|---|
deviceFilePath | String : è il percorso sul dispositivo dove effettuare la ricerca |
ritorna | |
---|---|
String[] | Matrice di stringhe contenente tutto il file in un percorso sul dispositivo. |
Tiri | |
---|---|
DeviceNotAvailableException |
getDeviceClass
public abstract String getDeviceClass ()
Ottieni la classe del dispositivo.
ritorna | |
---|---|
String | la classe del dispositivo String . |
getDeviceDate
public abstract long getDeviceDate ()
Restituisce la data del dispositivo in millisecondi dall'epoca.
ritorna | |
---|---|
long | la data del dispositivo in formato epoch. |
Tiri | |
---|---|
DeviceNotAvailableException |
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor ()
Restituisce un DeviceDescriptor
dalle informazioni sul dispositivo per ottenere informazioni su di esso senza passare l'oggetto dispositivo effettivo.
ritorna | |
---|---|
DeviceDescriptor |
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 a informazioni minime |
ritorna | |
---|---|
DeviceDescriptor |
getDeviceState
public abstract TestDeviceState getDeviceState ()
Ottieni lo stato del dispositivo.
ritorna | |
---|---|
TestDeviceState |
getDeviceTimeOffset
public abstract long getDeviceTimeOffset (Date date)
Helper per ottenere la differenza di orario tra il dispositivo e un dato ERROR(/Date)
. Usa Epoch Time internamente.
Parametri | |
---|---|
date | Date |
ritorna | |
---|---|
long | la differenza in millisecondi |
Tiri | |
---|---|
DeviceNotAvailableException |
getEmulatorOutput
public abstract InputStreamSource getEmulatorOutput ()
Ottieni il flusso dell'emulatore stdout e stderr
ritorna | |
---|---|
InputStreamSource | uscita dell'emulatore |
getExternalStoreFreeSpace
public abstract long getExternalStoreFreeSpace ()
Metodo di supporto per determinare la quantità di spazio libero sulla memoria esterna del dispositivo.
ritorna | |
---|---|
long | la quantità di spazio libero in KB |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
getFastbootProductType
public abstract String getFastbootProductType ()
Metodo pratico per ottenere il tipo di prodotto di questo dispositivo quando è in modalità di avvio rapido.
Questo metodo dovrebbe essere utilizzato solo se il dispositivo deve essere in avvio rapido. In questo caso è una variante un po' più sicura rispetto al metodogetProductType()
generico, perché ITestDevice saprà di ripristinare il dispositivo in avvio rapido se il dispositivo è in uno stato errato o non risponde.ritorna | |
---|---|
String | il nome del tipo di prodotto String o null se non può essere determinato |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
getFastbootProductVariant
public abstract String getFastbootProductVariant ()
Metodo pratico per ottenere il tipo di prodotto di questo dispositivo quando è in modalità di avvio rapido.
Questo metodo dovrebbe essere utilizzato solo se il dispositivo deve essere in avvio rapido. In questo caso è una variante un po' più sicura rispetto al metodogetProductType()
generico, perché ITestDevice saprà di ripristinare il dispositivo in avvio rapido se il dispositivo è in uno stato errato o non risponde.ritorna | |
---|---|
String | il nome del tipo di prodotto String o null se non può essere determinato |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
getFastbootSerialNumber
public abstract String getFastbootSerialNumber ()
Restituisce il numero di serie della modalità di avvio rapido.
ritorna | |
---|---|
String |
getFastbootVariable
public abstract String getFastbootVariable (String variableName)
Recupera il valore della variabile di avvio rapido specificato dal dispositivo.
Parametri | |
---|---|
variableName | String : il nome della variabile |
ritorna | |
---|---|
String | il valore della proprietà o null se non esiste |
Tiri | |
---|---|
| UnsupportedOperationException |
DeviceNotAvailableException |
getFileEntry
public abstract IFileEntry getFileEntry (String path)
Recupera un riferimento a un file remoto sul dispositivo.
Parametri | |
---|---|
path | String : il percorso del file da recuperare. Può essere un percorso assoluto o relativo a '/'. (cioè sono supportate sia la sintassi "/system" che "system") |
ritorna | |
---|---|
IFileEntry | l' IFileEntry o null se non è possibile trovare il file nel path specificato |
Tiri | |
---|---|
DeviceNotAvailableException |
getIDevice
public abstract IDevice getIDevice ()
Restituisce un riferimento all'IDevice IDevice
associato.
IDevice
può essere allocato da DDMS ogni volta che il dispositivo si disconnette e si riconnette da adb. Pertanto i chiamanti non dovrebbero mantenere un riferimento a IDevice
, perché quel riferimento potrebbe diventare obsoleto.ritorna | |
---|---|
IDevice | il IDevice |
getIntProperty
public abstract long getIntProperty (String name, long defaultValue)
Restituisce il valore intero della proprietà data dal dispositivo.
Parametri | |
---|---|
name | String : il nome della proprietà |
defaultValue | long : valore predefinito da restituire se la proprietà è vuota o non esiste. |
ritorna | |
---|---|
long | il valore della proprietà o defaultValue se la proprietà è vuota, non esiste o non ha un valore intero. |
Tiri | |
---|---|
DeviceNotAvailableException |
getLastExpectedRebootTimeMillis
public abstract long getLastExpectedRebootTimeMillis ()
Restituisce l'ultima volta che le API Tradefed hanno attivato un riavvio in millisecondi da EPOCH come restituito da System.currentTimeMillis()
.
ritorna | |
---|---|
long |
getLaunchApiLevel
public abstract int getLaunchApiLevel ()
Ottieni il primo livello API avviato del dispositivo. Il valore predefinito UNKNOWN_API_LEVEL
.
ritorna | |
---|---|
int | un numero intero che indica il primo livello API avviato del dispositivo |
Tiri | |
---|---|
DeviceNotAvailableException |
getLogcat
public abstract InputStreamSource getLogcat ()
Afferra un flusso di snapshot dei dati logcat.
Funziona in due modalità:
TestDeviceOptions.getMaxLogcatDataSize()
byte del contenuto corrente dell'acquisizione logcat in backgroundritorna | |
---|---|
InputStreamSource |
getLogcat
public abstract InputStreamSource getLogcat (int maxBytes)
Afferra un flusso di snapshot degli ultimi maxBytes
di dati logcat acquisiti.
Utile nei casi in cui si desidera acquisire istantanee frequenti dei dati logcat acquisiti senza incorrere nella penalizzazione di spazio su disco potenzialmente grande per ottenere l'intera snapshot getLogcat()
.
Parametri | |
---|---|
maxBytes | int : la quantità massima di dati da restituire. Dovrebbe essere una quantità che può stare comodamente in memoria |
ritorna | |
---|---|
InputStreamSource |
getLogcatDump
public abstract InputStreamSource getLogcatDump ()
Ottieni un dump del logcat corrente per il dispositivo. A differenza getLogcat()
, questo metodo restituirà sempre un dump statico del logcat.
Ha lo svantaggio che nulla verrà restituito se il dispositivo non è raggiungibile.
ritorna | |
---|---|
InputStreamSource | un InputStreamSource dei dati logcat. Viene restituito un flusso vuoto se l'acquisizione dei dati logcat non riesce. |
getLogcatSince
public abstract InputStreamSource getLogcatSince (long date)
Afferra un flusso di snapshot dei dati logcat acquisiti a partire dalla data fornita. È necessario utilizzare l'ora sul dispositivo getDeviceDate()
.
Parametri | |
---|---|
date | long : in millisecondi dal formato epoch di quando avviare lo snapshot fino al presente. (può essere ottenuto usando 'date +%s') |
ritorna | |
---|---|
InputStreamSource |
getMountPoint
public abstract String getMountPoint (String mountName)
Restituisce un punto di montaggio.
Interroga direttamente il dispositivo se le informazioni memorizzate nella cache inIDevice
non sono disponibili. DA FARE: 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 del punto di montaggio specificato o null
se il percorso non ha nulla montato o altrimenti non viene visualizzato in /proc/mounts come punto di montaggio.
Parametri | |
---|---|
mountpoint | String |
ritorna | |
---|---|
ITestDevice.MountPointInfo | Un ERROR(/List) di MountPointInfo contenente le informazioni in "/proc/mounts" |
Tiri | |
---|---|
DeviceNotAvailableException |
Guarda anche:
getMountPointInfo
public abstractgetMountPointInfo ()
Restituisce una versione analizzata delle informazioni in /proc/mounts sul dispositivo
ritorna | |
---|---|
Un ERROR(/List) di MountPointInfo contenente le informazioni in "/proc/mounts" |
Tiri | |
---|---|
DeviceNotAvailableException |
getPartitionFreeSpace
public abstract long getPartitionFreeSpace (String partition)
Metodo di supporto per determinare la quantità di spazio libero sulla partizione del dispositivo.
Parametri | |
---|---|
partition | String |
ritorna | |
---|---|
long | la quantità di spazio libero in KB |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
getProcessByName
public abstract ProcessInfo getProcessByName (String processName)
Il metodo di supporto esegue il comando "pidof" e "stat" e restituisce l'oggetto ProcessInfo
con il PID e l'ora di inizio del processo del processo specificato.
Parametri | |
---|---|
processName | String : il nome del processo String. |
ritorna | |
---|---|
ProcessInfo | ProcessInfo di processName specificato |
Tiri | |
---|---|
DeviceNotAvailableException |
getProcessPid
public abstract String getProcessPid (String process)
Restituisce il pid del servizio o null se qualcosa è andato storto.
Parametri | |
---|---|
process | String : il nome del processo String. |
ritorna | |
---|---|
String |
Tiri | |
---|---|
DeviceNotAvailableException |
getProductType
public abstract String getProductType ()
Metodo pratico 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 |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata o se non è possibile determinare il tipo di prodotto |
getProductVariant
public abstract String getProductVariant ()
Metodo pratico per ottenere la variante di prodotto di questo dispositivo.
Questo metodo funzionerà se il dispositivo è in modalità adb o fastboot.ritorna | |
---|---|
String | il nome della variante di prodotto String o null se non può essere determinato |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
getProperty
public abstract String getProperty (String name)
Recupera il valore della proprietà specificato dal dispositivo.
Parametri | |
---|---|
name | String : il nome della proprietà |
ritorna | |
---|---|
String | il valore della proprietà o null se non esiste |
Tiri | |
---|---|
DeviceNotAvailableException |
get RecoveryMode
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. |
getSerialNumber
public abstract String getSerialNumber ()
Metodo pratico per ottenere il numero di serie di questo dispositivo.
ritorna | |
---|---|
String | il numero di serie della String |
getTombstones
public abstractgetTombstones ()
Recupera e restituisci l'elenco delle lapidi dai dispositivi. Richiede radice.
il metodo è il massimo sforzo, quindi se una lapide non viene estratta per qualsiasi motivo, mancherà dall'elenco. Solo un DeviceNotAvailableException
terminerà anticipatamente il metodo.
ritorna | |
---|---|
Un elenco di file tombstone, vuoto se non presente. |
Tiri | |
---|---|
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 ()
Scopri se utilizzare la cancellazione rapida o il formato di avvio rapido per cancellare una partizione sul dispositivo.
ritorna | |
---|---|
boolean | true se verrà utilizzata la cancellazione di avvio rapido o false se verrà utilizzato il formato di avvio rapido. |
Guarda anche:
isAdbRoot
public abstract boolean isAdbRoot ()
ritorna | |
---|---|
boolean | true se il dispositivo ha attualmente adb root, false in caso contrario. |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
isAdbTcp
public abstract boolean isAdbTcp ()
ritorna | |
---|---|
boolean | true se il dispositivo è connesso ad adb-over-tcp, false in caso contrario. |
isAppEnumerationSupported
public abstract boolean isAppEnumerationSupported ()
Verifica se la piattaforma sul dispositivo supporta l'enumerazione delle app
ritorna | |
---|---|
boolean | True se l'enumerazione dell'app è supportata, false in caso contrario |
Tiri | |
---|---|
DeviceNotAvailableException |
isDeviceEncrypted
public abstract boolean isDeviceEncrypted ()
Restituisce se il dispositivo è crittografato.
ritorna | |
---|---|
boolean | true se il dispositivo è crittografato. |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
isDirectory
public abstract boolean isDirectory (String deviceFilePath)
Restituisce True se il percorso sul dispositivo è una directory, false in caso contrario.
Parametri | |
---|---|
deviceFilePath | String |
ritorna | |
---|---|
boolean |
Tiri | |
---|---|
DeviceNotAvailableException |
isEncryptionSupported
public abstract boolean isEncryptionSupported ()
Restituisce se la crittografia è supportata sul dispositivo.
ritorna | |
---|---|
boolean | true se il dispositivo supporta la crittografia. |
Tiri | |
---|---|
DeviceNotAvailableException |
isExecutable
public abstract boolean isExecutable (String fullPath)
Restituisce True se il percorso del file sul dispositivo è un file eseguibile, false in caso contrario.
Parametri | |
---|---|
fullPath | String |
ritorna | |
---|---|
boolean |
Tiri | |
---|---|
DeviceNotAvailableException |
è senza testa
public abstract boolean isHeadless ()
Restituisce true se il dispositivo è headless (senza schermo), false in caso contrario.
ritorna | |
---|---|
boolean |
Tiri | |
---|---|
DeviceNotAvailableException |
isRuntimePermissionSupported
public abstract boolean isRuntimePermissionSupported ()
Verifica se la piattaforma sul dispositivo supporta la concessione di autorizzazioni di runtime
ritorna | |
---|---|
boolean | True se sono supportate le autorizzazioni di runtime, false in caso contrario. |
Tiri | |
---|---|
DeviceNotAvailableException |
isStateBootloaderOrFastbootd
public abstract boolean isStateBootloaderOrFastbootd ()
Restituisce true se il dispositivo è in TestDeviceState#FASTBOOT
o TestDeviceState.FASTBOOTD
.
ritorna | |
---|---|
boolean |
logAnrs
public abstract boolean logAnrs (ITestLogger logger)
Raccoglie e registra gli ANR dal dispositivo.
Parametri | |
---|---|
logger | ITestLogger : un ITestLogger per registrare gli ANR. |
ritorna | |
---|---|
boolean | True se la registrazione ha avuto esito positivo, false in caso contrario. |
Tiri | |
---|---|
DeviceNotAvailableException |
logBugreport
public abstract boolean logBugreport (String dataName, ITestLogger listener)
Metodo di supporto per prendere una segnalazione di bug e registrarla ai giornalisti.
Parametri | |
---|---|
dataName | String : nome con cui verrà segnalato il bugreport. |
listener | ITestLogger : un ITestLogger per registrare il bugreport. |
ritorna | |
---|---|
boolean | True se la registrazione ha avuto esito positivo, false in caso contrario. |
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 verrà lanciata anche se la registrazione non riesce.
Parametri | |
---|---|
tag | String : il tag sotto il quale registriamo il nostro messaggio nel logcat. |
level | Log.LogLevel : il livello di debug del messaggio nel logcat. |
format | String : il formato del messaggio. |
args | Object : gli argomenti da sostituire tramite String.format(). |
nonBlockingReboot
public abstract void nonBlockingReboot ()
Emette un comando per riavviare il dispositivo e ritorna al comando completo e quando il dispositivo non è più visibile ad adb.
Tiri | |
---|---|
DeviceNotAvailableException |
postBootSetup
public abstract void postBootSetup ()
Eseguire le istruzioni per configurare il dispositivo per testarlo dopo ogni avvio.
Dovrebbe essere chiamato dopo che il dispositivo è completamente avviato/disponibile In circostanze normali non è necessario chiamare questo metodo in modo esplicito, poiché le implementazioni dovrebbero eseguire questi passaggi automaticamente quando si esegue un riavvio. Il punto in cui potrebbe essere necessario chiamarlo è quando il dispositivo si riavvia a causa di altri eventi (ad esempio quando un comando di aggiornamento fastboot è stato completato)Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
postInvocationTearDown
public void postInvocationTearDown ()
Questo metodo è deprecato.
Usa postInvocationTearDown(Throwable)
.
Passaggi aggiuntivi per la pulizia specifica del dispositivo richiesta che verrà eseguita al termine della chiamata.
postInvocationTearDown
public abstract void postInvocationTearDown (Throwable invocationException)
Passaggi aggiuntivi per la pulizia specifica del dispositivo richiesta che verrà eseguita al termine della chiamata.
Parametri | |
---|---|
invocationException | Throwable : se presente, l'ultima eccezione generata dall'errore di invocazione. |
preInvocationSetup
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
Passaggi aggiuntivi per la configurazione richiesta specifica del dispositivo che verrà eseguita sul dispositivo prima del flusso di chiamata.
Parametri | |
---|---|
info | IBuildInfo : IBuildInfo del dispositivo. |
attributes | MultiMap : gli attributi archiviati nel contesto di chiamata |
Tiri | |
---|---|
| com.android.tradefed.targetprep.TargetSetupError |
DeviceNotAvailableException | |
TargetSetupError |
pullDir
public abstract boolean pullDir (String deviceFilePath, File localDir)
Estrarre ricorsivamente il contenuto della directory dal dispositivo.
Parametri | |
---|---|
deviceFilePath | String : il percorso del file assoluto della sorgente remota |
localDir | File : la directory locale in cui estrarre i file |
ritorna | |
---|---|
boolean | true se il file è stato estratto correttamente. false altrimenti. |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
pullFile
public abstract File pullFile (String remoteFilePath, int userId)
Recupera un file dal dispositivo, lo archivia in un ERROR(/File)
temporaneo locale e lo restituisce File
.
Parametri | |
---|---|
remoteFilePath | String : il percorso assoluto del file sul dispositivo. |
userId | int : l'ID utente da cui estrarre |
ritorna | |
---|---|
File | Un ERROR(/File) contenente il contenuto del file del dispositivo, o null se la copia non è riuscita per qualsiasi motivo (inclusi problemi con il file system host) |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
pullFile
public abstract File pullFile (String remoteFilePath)
Recupera un file dal dispositivo, lo archivia in un ERROR(/File)
temporaneo locale e lo restituisce File
.
Parametri | |
---|---|
remoteFilePath | String : il percorso assoluto del 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 problemi con il file system host) |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
pullFile
public abstract boolean pullFile (String remoteFilePath, File localFile)
Recupera un file dal dispositivo.
Parametri | |
---|---|
remoteFilePath | String : il percorso assoluto del file sul dispositivo. |
localFile | File : il file locale in cui archiviare i contenuti. Se non è vuoto, i contenuti verranno sostituiti. |
ritorna | |
---|---|
boolean | true se il file è stato recuperato correttamente. false altrimenti. |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
pullFile
public abstract boolean pullFile (String remoteFilePath, File localFile, int userId)
Recupera un file dal dispositivo.
Parametri | |
---|---|
remoteFilePath | String : il percorso assoluto del file sul dispositivo. |
localFile | File : il file locale in cui archiviare i contenuti. Se non è vuoto, i contenuti verranno sostituiti. |
userId | int : l'ID utente da cui estrarre |
ritorna | |
---|---|
boolean | true se il file è stato recuperato correttamente. false altrimenti. |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
pullFileContents
public abstract String pullFileContents (String remoteFilePath)
Recupera un file dal dispositivo e ne restituisce il contenuto.
Parametri | |
---|---|
remoteFilePath | String : il percorso assoluto del 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 problemi con il file system host) |
Tiri | |
---|---|
DeviceNotAvailableException |
pullFileFromExternal
public abstract File pullFileFromExternal (String remoteFilePath)
Un metodo pratico per recuperare un file dalla memoria esterna del dispositivo, archiviarlo in un ERROR(/File)
temporaneo locale e restituire un riferimento a quel File
.
Parametri | |
---|---|
remoteFilePath | String : il percorso del file sul dispositivo, relativo al punto di montaggio della memoria esterna 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 problemi con il file system host) |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
pushDir
public abstract boolean pushDir (File localDir, String deviceFilePath,excludedDirectories)
Invia ricorsivamente il contenuto della directory al dispositivo escludendo alcune directory filtrate.
Parametri | |
---|---|
localDir | File : la directory locale di cui eseguire il push |
deviceFilePath | String : il percorso del file assoluto della destinazione remota |
excludedDirectories |
ritorna | |
---|---|
boolean | true se il file è stato inviato correttamente. false altrimenti. |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
pushDir
public abstract boolean pushDir (File localDir, String deviceFilePath)
Invia ricorsivamente il contenuto della directory al dispositivo.
Parametri | |
---|---|
localDir | File : la directory locale di cui eseguire il push |
deviceFilePath | String : il percorso del file assoluto della destinazione remota |
ritorna | |
---|---|
boolean | true se il file è stato inviato correttamente. false altrimenti. |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
pushFile
public abstract boolean pushFile (File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)
Variante di pushFile(File, String)
che può facoltativamente valutare la necessità del provider di contenuti.
Parametri | |
---|---|
localFile | File : il file locale da inviare |
deviceFilePath | String : il percorso del file assoluto della destinazione remota |
evaluateContentProviderNeeded | boolean : se verificare se abbiamo bisogno del provider di contenuti |
ritorna | |
---|---|
boolean | true se il file è stato inviato correttamente. false altrimenti. |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
pushFile
public abstract boolean pushFile (File localFile, String deviceFilePath)
Invia un file al dispositivo. Per impostazione predefinita, utilizzando un provider di contenuti.
Parametri | |
---|---|
localFile | File : il file locale da inviare |
deviceFilePath | String : il percorso del file assoluto della destinazione remota |
ritorna | |
---|---|
boolean | true se il file è stato inviato correttamente. false altrimenti. |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
pushString
public abstract boolean pushString (String contents, String deviceFilePath)
File push creato da una stringa al dispositivo
Parametri | |
---|---|
contents | String : il contenuto del file da inviare |
deviceFilePath | String : il percorso del file assoluto della destinazione remota |
ritorna | |
---|---|
boolean | true se la stringa è stata inviata correttamente. false altrimenti. |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
riavviare
public abstract void reboot ()
Riavvia il dispositivo in modalità adb.
Si blocca fino a quando il dispositivo non diventa disponibile.Tiri | |
---|---|
DeviceNotAvailableException | se il dispositivo non è disponibile dopo il riavvio |
riavviare
public abstract void reboot (String reason)
Riavvia il dispositivo in modalità adb con un determinato reason
per cui persistere durante il riavvio.
Si blocca fino a quando il dispositivo non diventa disponibile.
Il motivo dell'ultimo riavvio può essere ottenuto interrogando sys.boot.reason
.
Parametri | |
---|---|
reason | String : un motivo per questo riavvio o null se non viene specificato alcun motivo. |
Tiri | |
---|---|
DeviceNotAvailableException | se il dispositivo non è disponibile dopo il riavvio |
riavviareIntoBootloader
public abstract void rebootIntoBootloader ()
Riavvia il dispositivo in modalità bootloader.
Si blocca finché il dispositivo non è in modalità bootloader.Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
rebootIntoFastbootd
public abstract void rebootIntoFastbootd ()
Riavvia il dispositivo in modalità di avvio rapido.
Si blocca finché il dispositivo non è in modalità di avvio rapido.
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
riavviareIntoRecovery
public abstract void rebootIntoRecovery ()
Riavvia il dispositivo in modalità di ripristino adb.
Si blocca fino a quando il dispositivo non entra in ripristinoTiri | |
---|---|
DeviceNotAvailableException | se il dispositivo non è disponibile dopo il riavvio |
riavviareIntoSideload
public abstract void rebootIntoSideload (boolean autoReboot)
Riavvia il dispositivo in modalità adb sideload (notare che questa è una modalità speciale in fase di ripristino)
Si blocca fino a quando il dispositivo non entra in modalità sideload
Parametri | |
---|---|
autoReboot | boolean : se riavviare automaticamente il dispositivo dopo il sideload |
Tiri | |
---|---|
DeviceNotAvailableException | se il dispositivo non è in sideload dopo il riavvio |
riavviareIntoSideload
public abstract void rebootIntoSideload ()
Riavvia il dispositivo in modalità adb sideload (notare che questa è una modalità speciale in fase di ripristino)
Si blocca fino a quando il dispositivo non entra in modalità sideload
Tiri | |
---|---|
DeviceNotAvailableException | se il dispositivo non è in sideload dopo il riavvio |
riavvia fino a Online
public abstract void rebootUntilOnline ()
Un'alternativa a reboot()
che si blocca solo fino a quando il dispositivo non è online, ovvero visibile ad adb.
Tiri | |
---|---|
DeviceNotAvailableException | se il dispositivo non è disponibile dopo il riavvio |
riavvia fino a Online
public abstract void rebootUntilOnline (String reason)
Un'alternativa a reboot()
che si blocca solo fino a quando il dispositivo non è online, ovvero visibile ad adb.
Parametri | |
---|---|
reason | String : un motivo per questo riavvio o null se non viene specificato alcun motivo. |
Tiri | |
---|---|
DeviceNotAvailableException | se il dispositivo non è disponibile dopo il riavvio |
Guarda anche:
rebootUserspace
public abstract void rebootUserspace ()
Riavvia solo la parte dello spazio utente del dispositivo.
Si blocca fino a quando il dispositivo non diventa disponibile.
AVVERTIMENTO. Il riavvio dello spazio utente è attualmente in fase di sviluppo attivo, utilizzalo a tuo rischio.
Tiri | |
---|---|
DeviceNotAvailableException | se il dispositivo non è disponibile dopo il riavvio |
rebootUserspaceUntilOnline
public abstract void rebootUserspaceUntilOnline ()
Un'alternativa a rebootUserspace()
()} che si blocca solo fino a quando il dispositivo non è online, ovvero visibile ad adb.
Tiri | |
---|---|
DeviceNotAvailableException | se il dispositivo non è disponibile dopo il riavvio |
remountSystemWritable
public abstract void remountSystemWritable ()
Rendi scrivibile la partizione di sistema sul dispositivo. Può riavviare il dispositivo.
Tiri | |
---|---|
DeviceNotAvailableException |
remountVendorWritable
public abstract void remountVendorWritable ()
Rendi scrivibile la partizione del fornitore sul dispositivo. Può riavviare il dispositivo.
Tiri | |
---|---|
DeviceNotAvailableException |
eseguire test di strumentazione
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Metodo pratico per eseguire ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
con uno o più listener passati come parametri.
Parametri | |
---|---|
runner | IRemoteAndroidTestRunner : IRemoteAndroidTestRunner che esegue i test |
listeners | ITestLifeCycleReceiver : gli ascoltatori dei risultati del test |
ritorna | |
---|---|
boolean | true se il comando di test è stato completato. false se il completamento non è riuscito, ma il ripristino è riuscito |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. cioè il comando di test non è stato completato e il ripristino non è riuscito. |
eseguire test di strumentazione
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Esegue i test della strumentazione e fornisce il ripristino del dispositivo.
Se la connessione con il dispositivo viene persa prima del completamento dell'esecuzione del test e il ripristino ha esito positivo, tutti i listener verranno informati di testRunFailed e verrà restituito "false". Il comando di test non verrà eseguito nuovamente. È lasciato ai chiamanti di riprovare se necessario.
Se la connessione con il dispositivo viene persa prima del completamento dell'esecuzione del test e il ripristino non riesce, tutti i listener verranno informati di testRunFailed e verrà generata DeviceNotAvailableException.
Parametri | |
---|---|
runner | IRemoteAndroidTestRunner : IRemoteAndroidTestRunner che esegue i test |
listeners |
ritorna | |
---|---|
boolean | true se il comando di test è stato completato. false se il completamento non è riuscito a causa di un'eccezione di comunicazione del dispositivo, ma il ripristino è riuscito |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. cioè il comando di test non è stato completato e il ripristino non è riuscito. |
runInstrumentationTestsAsUser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Uguale a ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)
ma esegue il test per un determinato utente.
Parametri | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners | ITestLifeCycleReceiver |
ritorna | |
---|---|
boolean |
Tiri | |
---|---|
DeviceNotAvailableException |
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 |
Tiri | |
---|---|
DeviceNotAvailableException |
impostare la data
public abstract void setDate (Date date)
Imposta la data sul dispositivo
Nota: l'impostazione della data sul dispositivo richiede il root
Parametri | |
---|---|
date | Date : specificare una data particolare; utilizzerà la data dell'host se null |
Tiri | |
---|---|
DeviceNotAvailableException |
setOptions
public abstract void setOptions (TestDeviceOptions options)
Impostare TestDeviceOptions
per il dispositivo
Parametri | |
---|---|
options | TestDeviceOptions |
setProperty
public abstract boolean setProperty (String propKey, String propValue)
Imposta il valore della proprietà specificato sul dispositivo. Richiede adb root è vero.
Parametri | |
---|---|
propKey | String : la chiave da impostare. |
propValue | String : il valore della proprietà da impostare. |
ritorna | |
---|---|
boolean | restituisce True se il comando setprop ha avuto successo, False in caso contrario. |
Tiri | |
---|---|
DeviceNotAvailableException |
setRecupero
public abstract void setRecovery (IDeviceRecovery recovery)
Imposta IDeviceRecovery
da utilizzare per questo dispositivo. Dovrebbe essere impostato quando il dispositivo viene assegnato per la prima volta.
Parametri | |
---|---|
recovery | IDeviceRecovery : IDeviceRecovery |
imposta la modalità di ripristino
public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)
Imposta la modalità di ripristino corrente da utilizzare per il dispositivo.
Utilizzato per controllare quale metodo di ripristino utilizzare quando si verifica un problema di comunicazione del dispositivo. Si consiglia di utilizzare questo metodo con parsimonia solo quando necessario (ad esempio, quando il framework è inattivo, eccParametri | |
---|---|
mode | ITestDevice.RecoveryMode : se la modalità "Recupera solo online" deve essere attiva o meno. |
setUseFastbootErase
public abstract void setUseFastbootErase (boolean useFastbootErase)
Imposta se utilizzare la cancellazione rapida o il formato di avvio rapido per cancellare una partizione sul dispositivo.
Parametri | |
---|---|
useFastbootErase | boolean : true se è necessario utilizzare la cancellazione di avvio rapido o false se è necessario utilizzare il formato di avvio rapido. |
Guarda anche:
startLogcat
public abstract void startLogcat ()
Inizia a catturare l'output logcat dal dispositivo in background.
Non avrà alcun effetto se l'output di logcat è già stato acquisito. I dati possono essere recuperati in seguito tramite getLogcat. Quando il dispositivo non è più in uso, è necessario chiamarestopLogcat()
. startLogcat()
e stopLogcat()
normalmente non devono essere chiamati quando si è all'interno di un contesto di chiamata TF, poiché il framework TF avvierà e arresterà logcat.stopEmulatorOutput
public abstract void stopEmulatorOutput ()
Chiudi ed elimina l'output dell'emulatore.
stopLogcat
public abstract void stopLogcat ()
Interrompi l'acquisizione dell'output logcat dal dispositivo ed elimina i dati logcat attualmente salvati.
Non avrà alcun effetto se l'output di logcat non viene acquisito.switchToAdbTcp
public abstract String switchToAdbTcp ()
Passa il dispositivo alla modalità adb-over-tcp.
ritorna | |
---|---|
String | il numero di serie TCP o null se il dispositivo non può essere cambiato |
Tiri | |
---|---|
DeviceNotAvailableException |
switchToAdbUsb
public abstract boolean switchToAdbUsb ()
Passa al dispositivo in modalità adb su USB.
ritorna | |
---|---|
boolean | true se l'operazione ha avuto esito positivo, false in caso contrario. |
Tiri | |
---|---|
DeviceNotAvailableException |
syncFiles
public abstract boolean syncFiles (File localFileDir, String deviceFilePath)
Sincronizza in modo incrementale il contenuto di una directory di file locale sul dispositivo.
Decide quali file inviare tramite push confrontando i timestamp dei file locali con i loro equivalenti remoti. Solo i file "più recenti" o inesistenti verranno inviati al dispositivo. Pertanto, l'overhead dovrebbe essere relativamente piccolo 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à una directory /sdcard/files se non esiste già e invierà ricorsivamente il contenuto di /tmp/files a /sdcard/files.Parametri | |
---|---|
localFileDir | File : la directory del file locale contenente i file da inviare ricorsivamente. |
deviceFilePath | String : la radice del percorso del file assoluto della destinazione remota. Tutte le directory nel percorso del file devono essere leggibili. cioè il push su /data/local/tmp quando adb non è root fallirà |
ritorna | |
---|---|
boolean | true se i file sono stati sincronizzati correttamente. false altrimenti. |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
prendi Bugreport
public abstract Bugreport takeBugreport ()
Prendi un bugreport e lo restituisce all'interno di un oggetto Bugreport
per gestirlo. Restituzione nulla in caso di emissione.
Bugreport#close()
.ritorna | |
---|---|
Bugreport |
sbloccareDispositivo
public abstract boolean unlockDevice ()
Sblocca il dispositivo se il dispositivo è in uno stato crittografato.
Questo metodo potrebbe riavviare il framework ma non chiameràpostBootSetup()
. Pertanto, il dispositivo potrebbe non essere completamente pronto per essere testato quando viene restituito questo metodo.ritorna | |
---|---|
boolean | true se ha esito positivo o se il dispositivo non è crittografato. |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
UnsupportedOperationException | se la crittografia non è supportata sul dispositivo. |
waitForBootComplete
public abstract boolean waitForBootComplete (long timeOut)
Si blocca fino a quando non viene impostato il flag di avvio completo del dispositivo.
Parametri | |
---|---|
timeOut | long : tempo in msec di attesa per l'impostazione del flag |
ritorna | |
---|---|
boolean | true se il flag di avvio completo del dispositivo è impostato entro il timeout |
Tiri | |
---|---|
DeviceNotAvailableException |
waitForDeviceDisponibile
public abstract boolean waitForDeviceAvailable ()
Attende che il dispositivo sia reattivo e disponibile per il test. Utilizza il timeout predefinito.
ritorna | |
---|---|
boolean | Vero se il dispositivo è disponibile, Falso se il ripristino è disabilitato e non disponibile. |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
waitForDeviceDisponibile
public abstract boolean waitForDeviceAvailable (long waitTime)
Attende che il dispositivo sia reattivo e disponibile per il test.
Parametri | |
---|---|
waitTime | long : il tempo di attesa in ms |
ritorna | |
---|---|
boolean | Vero se il dispositivo è disponibile, Falso se il ripristino è disabilitato e non disponibile. |
Tiri | |
---|---|
DeviceNotAvailableException | se il dispositivo continua a non rispondere dopo la scadenza di waitTime. |
waitForDeviceBootloader
public abstract void waitForDeviceBootloader ()
Si blocca fino a quando il dispositivo non è visibile tramite avvio rapido. Usa il timeout predefinito.
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
waitForDeviceInRecovery
public abstract boolean waitForDeviceInRecovery (long waitTime)
Blocca il dispositivo in modo che si trovi nello stato di "ripristino adb" (nota che questo è distinto da IDeviceRecovery
).
Parametri | |
---|---|
waitTime | long : il tempo di attesa in ms |
ritorna | |
---|---|
boolean | true se il dispositivo si avvia in recovery prima della scadenza del tempo. false altrimenti |
waitForDeviceInSideload
public abstract boolean waitForDeviceInSideload (long waitTime)
Blocca il dispositivo in modo che sia nello stato 'adb sideload'
Parametri | |
---|---|
waitTime | long : il tempo di attesa in ms |
ritorna | |
---|---|
boolean | true se il dispositivo si avvia in sideload prima della scadenza del tempo. false altrimenti |
waitForDeviceNotAvailable
public abstract boolean waitForDeviceNotAvailable (long waitTime)
Blocca il dispositivo per non essere disponibile ovvero mancante da adb
Parametri | |
---|---|
waitTime | long : il tempo di attesa in ms |
ritorna | |
---|---|
boolean | true se il dispositivo diventa non disponibile prima della scadenza del tempo. false altrimenti |
waitForDeviceOnline
public abstract void waitForDeviceOnline ()
Si blocca fino a quando il dispositivo non è visibile tramite adb. Utilizza il timeout predefinito
Nota che il dispositivo potrebbe non rispondere necessariamente ai comandi al completamento. Utilizzare invecewaitForDeviceAvailable()
.Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
waitForDeviceOnline
public abstract void waitForDeviceOnline (long waitTime)
Si blocca fino a quando il dispositivo non è visibile tramite adb.
Nota che il dispositivo potrebbe non rispondere necessariamente ai comandi al completamento. Utilizzare invecewaitForDeviceAvailable()
.Parametri | |
---|---|
waitTime | long : il tempo di attesa in ms |
Tiri | |
---|---|
DeviceNotAvailableException | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
waitForDeviceShell
public abstract boolean waitForDeviceShell (long waitTime)
Attende che il dispositivo risponda a un comando di base della shell adb.
Parametri | |
---|---|
waitTime | long : il tempo di attesa in ms |
ritorna | |
---|---|
boolean | true se il dispositivo diventa reattivo prima waitTime tempo di attesa. |