Questa pagina è stata tradotta dall'API Cloud Translation.

INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice

Sottoclassi indirette conosciute

IManagedTestDevice , ITestDevice , LocalAndroidVirtualDevice , ManagedRemoteDevice , NativeDevice , NestedRemoteDevice , RemoteAndroidDevice , RemoteAndroidVirtualDevice , TestDevice

IManagedTestDevice	Un ITestDevice il cui ciclo di vita è gestito.
ITestDevice	Fornisce un'API affidabile e di livello leggermente superiore a un IDevice `IDevice` .
LocalAndroidVirtualDevice	La classe per i dispositivi virtuali locali in esecuzione sull'host TradeFed.
ManagedRemoteDevice	Un dispositivo in esecuzione all'interno di una macchina virtuale che gestiamo in remoto tramite un'istanza Tradefed all'interno della VM.
Dispositivo nativo	Implementazione predefinita di un dispositivo Android `ITestDevice` non full stack.
NestedRemoteDevice	Rappresentazione del dispositivo in esecuzione all'interno di una VM Seppia remota.
Dispositivo Android remoto	Implementazione di un `ITestDevice` per un dispositivo Android full stack connesso tramite adb Connect.
Dispositivo virtuale Android remoto	Estende il comportamento di `RemoteAndroidDevice` per un dispositivo Android full stack in esecuzione in Google Compute Engine (Gce).
Dispositivo di prova	Implementazione di un `ITestDevice` per un dispositivo Android full stack

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

Riprova i comandi del dispositivo per un importo configurabile e fornisce un'interfaccia di ripristino del dispositivo per i dispositivi che non rispondono.

Riepilogo

Costanti
`int`	`UNKNOWN_API_LEVEL` Valore predefinito quando non è possibile rilevare il livello API

Metodi pubblici
`abstract boolean`	`checkApiLevelAgainstNextRelease (int strictMinLevel)` Controlla se una funzionalità è attualmente supportata o meno dato un livello 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 `ProcessInfo` .
`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)` .
`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 `String` .
`abstract void`	`executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.
`abstract void`	`executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.
`abstract void`	`executeShellCommand (String command, IShellOutputReceiver receiver)` Esegue il comando adb shell 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 `CommandResult` correttamente popolato con l'output dello stato del comando, stdout e stderr.
`abstract CommandResult`	`executeShellV2Command (String command, OutputStream pipeToOutput)` Metodo di supporto che esegue un comando adb shell e restituisce i risultati come `CommandResult` correttamente popolato con l'output dello stato del comando e stderr.
`abstract CommandResult`	`executeShellV2Command (String command, File pipeAsInput)` Metodo di supporto che esegue un comando adb shell e restituisce i risultati come `CommandResult` correttamente popolato con l'output dello stato del comando, stdout e stderr.
`abstract CommandResult`	`executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Esegue un comando 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 `DeviceDescriptor` memorizzato nella cache se il dispositivo è allocato, altrimenti restituisce il `DeviceDescriptor` corrente.
`abstract DeviceDescriptor`	`getCachedDeviceDescriptor (boolean shortDescriptor)` Restituisce un `DeviceDescriptor` memorizzato nella cache se il dispositivo è allocato, altrimenti restituisce il `DeviceDescriptor` corrente.
`abstract String[]`	`getChildren (String deviceFilePath)` Alternativa all'utilizzo di `IFileEntry` che a volte non funziona a causa delle autorizzazioni.
`abstract String`	`getDeviceClass ()` Ottieni la classe del dispositivo.
`abstract long`	`getDeviceDate ()` Restituisce la data del dispositivo in millisecondi dall'epoca.
`abstract DeviceDescriptor`	`getDeviceDescriptor ()` Restituisce un `DeviceDescriptor` dalle informazioni sul dispositivo per ottenere informazioni su di esso senza passare l'oggetto dispositivo effettivo.
`abstract DeviceDescriptor`	`getDeviceDescriptor (boolean shortDescriptor)` Restituisce un `DeviceDescriptor` dalle informazioni sul dispositivo per ottenere informazioni su di esso senza passare l'oggetto dispositivo effettivo.
`abstract TestDeviceState`	`getDeviceState ()` Ottieni lo stato del dispositivo.
`abstract long`	`getDeviceTimeOffset (Date date)` Helper per ottenere la differenza di orario tra il dispositivo e un dato `ERROR(/Date)` .
`abstract InputStreamSource`	`getEmulatorOutput ()` Ottieni il flusso dell'emulatore stdout e stderr
`abstract long`	`getExternalStoreFreeSpace ()` Metodo di supporto per determinare la quantità di spazio libero 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 `IDevice` associato.
`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 `System.currentTimeMillis()` .
`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 `maxBytes` di dati logcat acquisiti.
`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 `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.
`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 `ProcessInfo` con il PID e l'ora di inizio del processo del processo specificato.
`abstract String`	`getProcessPid (String process)` Restituisce il pid del servizio o null se 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 `TestDeviceState#FASTBOOT` o `TestDeviceState.FASTBOOTD` .
`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 `postInvocationTearDown(Throwable)` .
`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 `ERROR(/File)` temporaneo locale e lo restituisce `File` .
`abstract File`	`pullFile (String remoteFilePath)` Recupera un file dal dispositivo, lo archivia in un `ERROR(/File)` temporaneo locale e lo restituisce `File` .
`abstract boolean`	`pullFile (String remoteFilePath, File localFile)` Recupera un file dal dispositivo.
`abstract boolean`	`pullFile (String remoteFilePath, File localFile, int userId)` Recupera un file dal dispositivo.
`abstract String`	`pullFileContents (String remoteFilePath)` Recupera un file dal dispositivo e ne restituisce il contenuto.
`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` .
`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 `pushFile(File, String)` che può facoltativamente valutare la necessità del provider di contenuti.
`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 `reason` per cui persistere durante il riavvio.
`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 `reboot()` che si blocca solo fino a quando il dispositivo non è online, ovvero visibile ad adb.
`abstract void`	`rebootUntilOnline (String reason)` Un'alternativa a `reboot()` che si blocca solo fino a quando il dispositivo non è online, ovvero visibile ad adb.
`abstract void`	`rebootUserspace ()` Riavvia solo la parte dello spazio utente del dispositivo.
`abstract void`	`rebootUserspaceUntilOnline ()` Un'alternativa a `rebootUserspace()` ()} che si blocca solo fino a quando il dispositivo non è online, ovvero visibile ad adb.
`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 `ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))` con uno o più listener passati come parametri.
`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 `ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)` ma esegue il test per un determinato utente.
`abstract boolean`	`runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners)` `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.
`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 `TestDeviceOptions` per il dispositivo
`abstract boolean`	`setProperty (String propKey, String propValue)` Imposta il valore della proprietà specificato sul dispositivo.
`abstract void`	`setRecovery ( IDeviceRecovery recovery)` Imposta `IDeviceRecovery` da utilizzare per questo dispositivo.
`abstract void`	`setRecoveryMode ( ITestDevice.RecoveryMode mode)` Imposta la modalità di ripristino corrente da utilizzare per il dispositivo.
`abstract void`	`setUseFastbootErase (boolean useFastbootErase)` Imposta se utilizzare la cancellazione rapida o il formato di avvio rapido per cancellare una partizione sul dispositivo.
`abstract void`	`startLogcat ()` Inizia 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 `Bugreport` per gestirlo.
`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 `IDeviceRecovery` ).
`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 che ITestDevice#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`	: le variabili di ambiente di sistema con cui viene eseguito il comando fastboot
`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 a executeFastbootCommand(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 di executeShellCommand(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.

Se getUseFastbootErase() è 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 abstract  getBootHistory ()

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

ritorna
`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 metodo getProductType() 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.

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.

Un nuovo IDevice può essere allocato da DDMS ogni volta che il dispositivo si disconnette e si riconnette da adb. Pertanto i chiamanti non dovrebbero mantenere un riferimento a IDevice , 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à:

Se il logcat è attualmente in fase di acquisizione in background, verranno restituiti fino a TestDeviceOptions.getMaxLogcatDataSize() byte del contenuto corrente dell'acquisizione logcat in background

In caso contrario, restituirà un dump statico dei dati logcat se il dispositivo sta attualmente rispondendo

ritorna
`InputStreamSource`

getLogcat

public abstract InputStreamSource getLogcat (int maxBytes)

Afferra un flusso di 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 in IDevice 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:

IDevice.getMountPoint(String)

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

getMountPointInfo

public abstract  getMountPointInfo ()

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 abstract  getTombstones ()

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:

Documentazione sulle lapidi

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:

fastbootWipePartition(String)

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`	: Insieme di nomi di directory esclusi che non devono essere inviati.

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 ripristino

Tiri
`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:

reboot(String)

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`	: gli ascoltatori dei risultati del test

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, ecc

Parametri
`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:

fastbootWipePartition(String)

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 chiamare stopLogcat() .

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.

Il file a cui si fa riferimento nell'oggetto Bugreport deve essere pulito tramite 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 invece waitForDeviceAvailable() .

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 invece waitForDeviceAvailable() .

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.