A partire dal 2026, per allinearci al nostro modello di sviluppo stabile del trunk e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per la creazione e il contributo ad AOSP, consigliamo di utilizzare android-latest-release anziché aosp-main. Il ramo del manifest android-latest-release farà sempre riferimento alla release più recente inviata ad AOSP. Per saperne di più, vedi Modifiche ad AOSP.

INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice

Sottoclassi indirette note

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 ddmlib `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 da remoto tramite un'istanza Tradefed all'interno della VM.
NativeDevice	Implementazione predefinita di `ITestDevice` Dispositivi Android non full-stack.
NestedRemoteDevice	Rappresentazione del dispositivo in esecuzione all'interno di una VM Cuttlefish remota.
RemoteAndroidDevice	Implementazione di un `ITestDevice` per un dispositivo Android full stack connesso tramite adb connect.
RemoteAndroidVirtualDevice	Estende il comportamento di `RemoteAndroidDevice` per un dispositivo Android full-stack in esecuzione in Google Compute Engine (GCE).
TestDevice	Implementazione di un `ITestDevice` per un dispositivo Android full-stack

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

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

Riepilogo

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

Metodi pubblici
`abstract boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` Controlla se una funzionalità è attualmente supportata in base a un livello minimo supportato.
`abstract void`	`clearLogcat()` Elimina tutti i dati logcat accumulati.
`abstract void`	`deleteFile(String deviceFilePath)` Metodo helper per eliminare un file o una directory sul dispositivo.
`abstract void`	`deleteFile(String deviceFilePath, int userId)` Metodo helper per eliminare un file o una directory sul dispositivo.
`abstract boolean`	`deviceSoftRestarted(ProcessInfo prevSystemServerProcess)` Metodo helper per verificare se il dispositivo è stato riavviato in modalità soft confrontando l'attuale system_server con il precedente system_server `ProcessInfo`.
`abstract boolean`	`deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)` Metodo helper per verificare se il dispositivo è stato riavviato in modalità soft dall'ora UTC dall'epoca del dispositivo e dal relativo `ERROR(/TimeUnit)`.
`abstract boolean`	`disableAdbRoot()` Disattiva adb root.
`abstract boolean`	`doesFileExist(String deviceFilePath)` Metodo helper per determinare se il file sul dispositivo esiste.
`abstract boolean`	`enableAdbRoot()` Attiva adb root.
`abstract String`	`executeAdbCommand(long timeout, String... commandArgs)` Metodo helper che esegue un comando adb come comando di sistema con un timeout specificato.
`abstract String`	`executeAdbCommand(String... commandArgs)` Metodo helper che esegue un comando adb come comando di sistema.
`abstract String`	`executeAdbCommand(long timeout, envMap, String... commandArgs)` Metodo helper che esegue un comando adb come comando di sistema con un timeout specificato.
`abstract CommandResult`	`executeAdbV2Command(long timeout, envMap, String... commandArgs)` Metodo helper che esegue un comando adb come comando di sistema con un timeout specificato.
`abstract CommandResult`	`executeAdbV2Command(String... commandArgs)` Metodo helper che esegue un comando adb come comando di sistema.
`abstract CommandResult`	`executeAdbV2Command(long timeout, String... commandArgs)` Metodo helper che esegue un comando adb come comando di sistema con un timeout specificato.
`abstract CommandResult`	`executeFastbootCommand(long timeout, String... commandArgs)` Metodo helper che esegue un comando fastboot come comando di sistema.
`abstract CommandResult`	`executeFastbootCommand(String... commandArgs)` Metodo helper che esegue un comando fastboot come comando di sistema con un timeout predefinito di 2 minuti.
`abstract CommandResult`	`executeLongFastbootCommand(String... commandArgs)` Metodo helper che esegue un comando fastboot a esecuzione prolungata come comando di sistema.
`abstract CommandResult`	`executeLongFastbootCommand( envVarMap, String... commandArgs)` Metodo helper che esegue un comando fastboot a esecuzione prolungata come comando di sistema con variabili di ambiente di sistema.
`abstract String`	`executeShellCommand(String command)` Metodo helper che esegue un comando adb shell e restituisce l'output come `String`.
`abstract void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.
`abstract void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.
`abstract void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` Esegue il comando adb shell specificato, riprovando più volte se il comando non va a buon fine.
`abstract CommandResult`	`executeShellV2Command(String command)` Metodo helper che esegue un comando adb shell e restituisce i risultati come `CommandResult` compilato correttamente con l'output dello stato del comando, stdout e stderr.
`abstract CommandResult`	`executeShellV2Command(String command, OutputStream pipeToOutput)` Metodo helper che esegue un comando adb shell e restituisce i risultati come `CommandResult` compilato correttamente con l'output dello stato del comando e stderr.
`abstract CommandResult`	`executeShellV2Command(String command, File pipeAsInput)` Metodo helper che esegue un comando adb shell e restituisce i risultati come `CommandResult` compilato correttamente con l'output dello stato del comando, stdout e stderr.
`abstract CommandResult`	`executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.
`abstract CommandResult`	`executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit)` Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.
`abstract CommandResult`	`executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.
`abstract CommandResult`	`executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.
`abstract CommandResult`	`fastbootWipePartition(String partition)` Metodo helper che cancella una partizione per il dispositivo.
`abstract int`	`getApiLevel()` Recupera il livello API del dispositivo.
`abstract String`	`getBasebandVersion()` Metodo pratico per ottenere la versione della banda di base (radio) di questo dispositivo.
`abstract Integer`	`getBattery()` Restituisce il livello attuale della batteria di un dispositivo o Null se il livello della batteria non è disponibile.
`abstract boolean`	`getBooleanProperty(String name, boolean defaultValue)` Restituisce il valore booleano della proprietà specificata.
`abstract`	`getBootHistory()` Il metodo helper raccoglie la mappa della cronologia di avvio con l'ora e il motivo dell'avvio.
`abstract`	`getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)` Il metodo helper raccoglie la mappa della cronologia di avvio con l'ora e il motivo dell'avvio dall'epoca specificata dall'unità di tempo specificata.
`abstract String`	`getBootloaderVersion()` Metodo pratico per ottenere la versione del bootloader di questo dispositivo.
`abstract String`	`getBuildAlias()` Recupera l'alias della build attualmente in esecuzione sul dispositivo.
`abstract String`	`getBuildFlavor()` Recupera la variante di build per il dispositivo.
`abstract String`	`getBuildId()` Recupera la build attualmente in esecuzione sul dispositivo.
`abstract String`	`getBuildSigningKeys()` Restituisce il tipo di chiave utilizzato per firmare l'immagine del dispositivo In genere, i dispositivi Android possono essere firmati con chiavi di test (come in AOSP) o chiavi di rilascio (controllate dai singoli produttori di dispositivi)
`abstract DeviceDescriptor`	`getCachedDeviceDescriptor()` Restituisce un `DeviceDescriptor` memorizzato nella cache se il dispositivo è allocato, altrimenti restituisce il `DeviceDescriptor` corrente.
`abstract DeviceDescriptor`	`getCachedDeviceDescriptor(boolean shortDescriptor)` Restituisce un `DeviceDescriptor` memorizzato nella cache se il dispositivo è allocato, altrimenti restituisce il `DeviceDescriptor` corrente.
`abstract String[]`	`getChildren(String deviceFilePath)` Alternativa all'utilizzo di `IFileEntry`, che a volte non funziona a causa delle autorizzazioni.
`abstract AbstractConnection`	`getConnection()` Restituisce la connessione associata al dispositivo.
`abstract String`	`getDeviceClass()` Recupera la classe del dispositivo.
`abstract long`	`getDeviceDate()` Restituisce la data del dispositivo in millisecondi trascorsi da epoca.
`abstract DeviceDescriptor`	`getDeviceDescriptor()` Restituisce un `DeviceDescriptor` dalle informazioni del dispositivo per ottenere informazioni su di esso senza passare l'oggetto dispositivo effettivo.
`abstract DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` Restituisce un `DeviceDescriptor` dalle informazioni del dispositivo per ottenere informazioni su di esso senza passare l'oggetto dispositivo effettivo.
`abstract TestDeviceState`	`getDeviceState()` Recupera lo stato del dispositivo.
`abstract long`	`getDeviceTimeOffset(Date date)` Helper per ottenere la differenza di tempo tra il dispositivo e un determinato `ERROR(/Date)`.
`abstract InputStreamSource`	`getEmulatorOutput()` Ottieni il flusso di stdout e stderr dell'emulatore
`abstract long`	`getExternalStoreFreeSpace()` Metodo helper per determinare la quantità di spazio libero nell'archiviazione esterna del dispositivo.
`abstract String`	`getFastbootProductType()` Metodo pratico per ottenere il tipo di prodotto di questo dispositivo quando è in modalità fastboot.
`abstract String`	`getFastbootProductVariant()` Metodo pratico per ottenere il tipo di prodotto di questo dispositivo quando è in modalità fastboot.
`abstract String`	`getFastbootSerialNumber()` Restituisce il numero di serie della modalità fastboot.
`abstract String`	`getFastbootVariable(String variableName)` Recupera il valore della variabile fastboot specificata dal dispositivo.
`abstract IFileEntry`	`getFileEntry(String path)` Recupera un riferimento a un file remoto sul dispositivo.
`abstract IDevice`	`getIDevice()` Restituisce un riferimento alla libreria ddmlib associata `IDevice`.
`abstract long`	`getIntProperty(String name, long defaultValue)` Restituisce il valore intero della proprietà specificata dal dispositivo.
`abstract long`	`getLastExpectedRebootTimeMillis()` Restituisce l'ultima volta che le API Tradefed hanno attivato un riavvio in millisecondi dall'epoca come restituito da `System.currentTimeMillis()`.
`abstract int`	`getLaunchApiLevel()` Ottieni il primo livello API avviato del dispositivo.
`abstract InputStreamSource`	`getLogcat()` Acquisisce uno stream di snapshot dei dati logcat.
`abstract InputStreamSource`	`getLogcat(int maxBytes)` Acquisisce un flusso di snapshot degli ultimi `maxBytes` di dati logcat acquisiti.
`abstract InputStreamSource`	`getLogcatDump()` Ottieni un dump del logcat corrente per il dispositivo.
`abstract InputStreamSource`	`getLogcatSince(long date)` Acquisisce un flusso di snapshot dei dati logcat acquisiti a partire dalla data fornita.
`abstract String`	`getMountPoint(String mountName)` Restituisce un punto di montaggio.
`abstract ITestDevice.MountPointInfo`	`getMountPointInfo(String mountpoint)` Restituisce un `MountPointInfo` corrispondente al percorso del punto di montaggio specificato oppure `null` se a questo percorso non è montato nulla o se 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 helper per determinare la quantità di spazio libero nella partizione del dispositivo.
`abstract ProcessInfo`	`getProcessByName(String processName)` Il metodo helper esegue i comandi "pidof" e "stat" e restituisce l'oggetto `ProcessInfo` con l'ID processo e l'ora di inizio del processo specificato.
`abstract String`	`getProcessPid(String process)` Restituisce il PID del servizio o null se si è verificato un problema.
`abstract String`	`getProductType()` Metodo pratico per ottenere il tipo di prodotto di questo dispositivo.
`abstract String`	`getProductVariant()` Metodo pratico per ottenere la variante del prodotto di questo dispositivo.
`abstract String`	`getProperty(String name)` Recupera il valore della proprietà specificata dal dispositivo.
`abstract ITestDevice.RecoveryMode`	`getRecoveryMode()` Recupera 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 dei segnali di chiusura dai dispositivi.
`abstract long`	`getTotalMemory()` Restituisce le dimensioni totali della memoria fisica in byte o -1 in caso di errore interno
`default String`	`getTrackingSerial()` Per la gestione dei dispositivi, recupera il numero di serie utilizzato per monitorare il dispositivo.
`abstract boolean`	`getUseFastbootErase()` Ottieni informazioni sull'utilizzo di fastboot erase o fastboot format per cancellare una partizione sul dispositivo.
`abstract boolean`	`isAdbRoot()`
`abstract boolean`	`isAdbTcp()`
`abstract boolean`	`isAppEnumerationSupported()` Controllare se la piattaforma sul dispositivo supporta l'enumerazione delle app
`abstract boolean`	`isBypassLowTargetSdkBlockSupported()` Controllare se la piattaforma sul dispositivo supporta l'aggiramento del blocco dell'SDK di destinazione basso durante le installazioni di app
`abstract boolean`	`isDebugfsMounted()` Controlla se debugfs è montato.
`abstract boolean`	`isDeviceEncrypted()` Indica se il dispositivo è criptato.
`abstract boolean`	`isDirectory(String deviceFilePath)` Restituisce True se il percorso sul dispositivo è una directory, false in caso contrario.
`abstract boolean`	`isEncryptionSupported()` Indica se la crittografia è supportata sul dispositivo.
`abstract boolean`	`isExecutable(String fullPath)` Restituisce True se il percorso del file sul dispositivo è un file eseguibile, altrimenti restituisce False.
`abstract boolean`	`isHeadless()` Restituisce true se il dispositivo è headless (senza schermo), false in caso contrario.
`abstract boolean`	`isRuntimePermissionSupported()` Controllare se la piattaforma sul dispositivo supporta la concessione delle autorizzazioni di runtime
`abstract boolean`	`isStateBootloaderOrFastbootd()` Restituisce true se il dispositivo è in `TestDeviceState.FASTBOOT` o `TestDeviceState.FASTBOOTD`.
`abstract boolean`	`logAnrs(ITestLogger logger)` Raccoglie e registra gli ANR dal dispositivo.
`abstract void`	`logOnDevice(String tag, Log.LogLevel level, String format, Object... args)` Registra un messaggio nel logcat del dispositivo.
`abstract void`	`mountDebugfs()` Monta debugfs.
`abstract void`	`nonBlockingReboot()` Esegue un comando per riavviare il dispositivo e restituisce un risultato al termine del comando e quando il dispositivo non è più visibile ad ADB.
`abstract void`	`postBootSetup()` Esegui le istruzioni per configurare il dispositivo per il test dopo ogni avvio.
`default void`	`postInvocationTearDown()` Questo metodo è obsoleto. Utilizza invece `postInvocationTearDown(Throwable)`.
`abstract void`	`postInvocationTearDown(Throwable invocationException)` Passaggi aggiuntivi per la pulizia richiesta specifica del dispositivo che verranno eseguiti dopo l'invocazione.
`default void`	`preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)` Passaggi aggiuntivi per la configurazione obbligatoria specifica del dispositivo che verrà eseguita sul dispositivo prima del flusso di invocazione.
`abstract boolean`	`pullDir(String deviceFilePath, File localDir)` Estrai in modo ricorsivo i contenuti della directory dal dispositivo.
`abstract boolean`	`pullDir(String deviceFilePath, File localDir, int userId)` Estrai in modo ricorsivo i contenuti della directory dal dispositivo.
`abstract File`	`pullFile(String remoteFilePath, int userId)` Recupera un file dal dispositivo, lo memorizza in un `ERROR(/File)` temporaneo locale e restituisce `File`.
`abstract File`	`pullFile(String remoteFilePath)` Recupera un file dal dispositivo, lo memorizza in un `ERROR(/File)` temporaneo locale e 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 i contenuti.
`abstract File`	`pullFileFromExternal(String remoteFilePath)` Un metodo pratico per recuperare un file dalla memoria esterna del dispositivo, memorizzarlo in un `ERROR(/File)` temporaneo locale e restituire un riferimento a questo `File`.
`abstract boolean`	`pushDir(File localDir, String deviceFilePath, int userId)` Esegue il push ricorsivo dei contenuti della directory sul dispositivo.
`abstract boolean`	`pushDir(File localDir, String deviceFilePath, excludedDirectories)` Trasferisci in modo ricorsivo i contenuti della directory al dispositivo escludendo alcune directory filtrate.
`abstract boolean`	`pushDir(File localDir, String deviceFilePath)` Esegue il push ricorsivo dei contenuti della directory sul dispositivo.
`abstract boolean`	`pushFile(File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)` Variante di `pushFile(File, String)` che può facoltativamente considerare la necessità per il fornitore di contenuti.
`abstract boolean`	`pushFile(File localFile, String deviceFilePath)` Invia un file al dispositivo.
`abstract boolean`	`pushFile(File localFile, String deviceFilePath, int userId)` Invia un file al dispositivo.
`abstract boolean`	`pushString(String contents, String deviceFilePath)` Inviare al dispositivo il file creato da una stringa
`abstract void`	`reboot()` Riavvia il dispositivo in modalità ADB.
`abstract void`	`reboot(String reason)` Riavvia il dispositivo in modalità ADB con il valore `reason` specificato da mantenere dopo il riavvio.
`abstract void`	`rebootIntoBootloader()` Riavvia il dispositivo in modalità bootloader.
`abstract void`	`rebootIntoFastbootd()` Riavvia il dispositivo in modalità fastbootd.
`abstract void`	`rebootIntoRecovery()` Riavvia il dispositivo in modalità di ripristino ADB.
`abstract void`	`rebootIntoSideload(boolean autoReboot)` Riavvia il dispositivo in modalità di caricamento laterale ADB (tieni presente che si tratta di una modalità speciale in modalità di ripristino) Blocca fino a quando il dispositivo non entra in modalità di caricamento laterale
`abstract void`	`rebootIntoSideload()` Riavvia il dispositivo in modalità di caricamento laterale ADB (tieni presente che si tratta di una modalità speciale in modalità di ripristino) Blocca fino a quando il dispositivo non entra in modalità di caricamento laterale
`abstract void`	`rebootUntilOnline()` Un'alternativa a `reboot()` che blocca solo finché il dispositivo non è online, ovvero visibile ad ADB.
`abstract void`	`rebootUntilOnline(String reason)` Un'alternativa a `reboot()` che blocca solo finché il dispositivo non è online, ovvero visibile ad ADB.
`abstract void`	`rebootUserspace()` Riavvia solo la parte dello spazio utente del dispositivo.
`abstract void`	`rebootUserspaceUntilOnline()` Un'alternativa a `rebootUserspace()` ()} che blocca solo finché il dispositivo non è online, ovvero visibile ad ADB.
`abstract void`	`remountSystemReadOnly()` Rendi di sola lettura la partizione di sistema sul dispositivo.
`abstract void`	`remountSystemWritable()` Rendi scrivibile la partizione di sistema sul dispositivo.
`abstract void`	`remountVendorReadOnly()` Rendi di sola lettura la partizione del fornitore 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)` Esegue test di instrumentazione e fornisce il ripristino del dispositivo.
`abstract boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners)` Come `ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection))`, ma esegue il test per l'utente specificato.
`abstract boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)` Come `ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)`, ma esegue il test per un determinato utente.
`abstract void`	`setDate(Date date)` Imposta la data sul dispositivo Nota: l'impostazione della data sul dispositivo richiede l'accesso root
`abstract void`	`setOptions(TestDeviceOptions options)` Imposta `TestDeviceOptions` per il dispositivo
`abstract boolean`	`setProperty(String propKey, String propValue)` Imposta il valore della proprietà specificata sul dispositivo.
`abstract void`	`setRecovery(IDeviceRecovery recovery)` Imposta `IDeviceRecovery` da utilizzare per questo dispositivo.
`abstract void`	`setRecoveryMode(ITestDevice.RecoveryMode mode)` Imposta la modalità di recupero attuale da utilizzare per il dispositivo.
`abstract void`	`setTrackingSerial(String trackingSerial)` Ai fini della gestione dei dispositivi, monitora il numero di serie che utilizziamo per fare riferimento al dispositivo.
`abstract void`	`setUseFastbootErase(boolean useFastbootErase)` Imposta se utilizzare fastboot erase o fastboot format per cancellare una partizione sul dispositivo.
`abstract void`	`startLogcat()` Inizia ad acquisire l'output di logcat dal dispositivo in background.
`abstract boolean`	`startTradeInModeTesting(int timeoutMs)` Attiva la modalità di test per il programma di permuta.
`abstract void`	`stopEmulatorOutput()` Chiudi ed elimina l'output dell'emulatore.
`abstract void`	`stopLogcat()` Interrompe l'acquisizione dell'output di Logcat dal dispositivo e ignora i dati di Logcat attualmente salvati.
`abstract void`	`stopTradeInModeTesting()` Interrompi il test della modalità permuta.
`abstract String`	`switchToAdbTcp()` Passa alla modalità adb-over-tcp.
`abstract boolean`	`switchToAdbUsb()` Passa alla modalità adb su USB.
`abstract boolean`	`syncFiles(File localFileDir, String deviceFilePath)` Sincronizza in modo incrementale i contenuti di una directory di file locale con il dispositivo.
`abstract boolean`	`unlockDevice()` Sblocca il dispositivo se è criptato.
`abstract void`	`unmountDebugfs()` Smonta debugfs.
`abstract boolean`	`waitForBootComplete(long timeOut)` Blocca fino a quando non viene impostato il flag di completamento dell'avvio del dispositivo.
`abstract boolean`	`waitForDeviceAvailable()` Attende che il dispositivo sia reattivo e disponibile per i test.
`abstract boolean`	`waitForDeviceAvailable(long waitTime)` Attende che il dispositivo sia reattivo e disponibile per i test.
`abstract boolean`	`waitForDeviceAvailableInRecoverPath(long waitTime)` Attende che il dispositivo sia reattivo e disponibile senza considerare il percorso di recupero.
`abstract void`	`waitForDeviceBootloader()` Blocca fino a quando il dispositivo non è visibile tramite fastboot.
`abstract boolean`	`waitForDeviceInRecovery(long waitTime)` Blocca lo stato "adb recovery" del dispositivo (tieni presente che è diverso da `IDeviceRecovery`).
`abstract boolean`	`waitForDeviceInSideload(long waitTime)` Blocchi per il dispositivo nello stato "adb sideload"
`abstract boolean`	`waitForDeviceNotAvailable(long waitTime)` Blocchi per il dispositivo che non è disponibile, ad esempio mancante da ADB
`abstract void`	`waitForDeviceOnline()` Blocca fino a quando il dispositivo non è visibile tramite adb.
`abstract void`	`waitForDeviceOnline(long waitTime)` Blocca fino a quando il dispositivo non è visibile tramite adb.
`abstract boolean`	`waitForDeviceShell(long waitTime)` Attende che il dispositivo risponda a un comando di base della shell ADB.

Costanti

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

Valore predefinito quando non è possibile rilevare il livello API

Valore costante: -1 (0xffffffff)

Metodi pubblici

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Controlla se una funzionalità è attualmente supportata in base a un livello minimo supportato. Questo metodo tiene conto delle funzionalità non ancora rilasciate, prima che venga aumentato il livello API.

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

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

clearLogcat

public abstract void clearLogcat ()

Elimina tutti i dati logcat accumulati.

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

deleteFile

public abstract void deleteFile (String deviceFilePath)

Metodo helper per eliminare un file o una directory sul dispositivo.

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

deleteFile

public abstract void deleteFile (String deviceFilePath, 
                int userId)

Metodo helper per eliminare un file o una directory sul dispositivo.

Parametri
`deviceFilePath`	`String`: il percorso assoluto del file sul dispositivo.
`userId`	`int`: l'ID utente da cui eliminare

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

deviceSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Metodo helper per verificare se il dispositivo è stato riavviato in modalità soft confrontando l'attuale system_server con il precedente system_server ProcessInfo. Usa getProcessByName(String) per ottenere ProcessInfo.

Parametri
`prevSystemServerProcess`	`ProcessInfo`: il processo system_server precedente `ProcessInfo`.

Ritorni
`boolean`	`true` se il dispositivo è stato riavviato in modalità soft

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

deviceSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Metodo helper per verificare se il dispositivo è stato riavviato in modalità soft dall'ora UTC dall'epoca del dispositivo e dal relativo ERROR(/TimeUnit). Il riavvio soft si riferisce al riavvio di system_server al di fuori di un riavvio forzato del dispositivo (ad esempio, riavvio richiesto). L'ora utcEpochTime attuale del dispositivo in millisecondi può essere ottenuta con il metodo getDeviceDate().

Parametri
`utcEpochTime`	`long`: l'ora del dispositivo in secondi dall'epoca.
`timeUnit`	`TimeUnit`: l'unità di tempo `TimeUnit` per il valore utcEpochTime specificato.

Ritorni
`boolean`	`true` se il dispositivo è stato riavviato in modalità soft

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

disableAdbRoot

public abstract boolean disableAdbRoot ()

Disattiva l'accesso root adb.

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

Ritorni
`boolean`	`true` se l'operazione va a buon fine.

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

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath)

Metodo helper per determinare se il file sul dispositivo esiste.

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

Ritorni
`boolean`	`true` se il file esiste, `false` altrimenti.

Lanci
`DeviceNotAvailableException`	se la connessione con il dispositivo viene interrotta e non può essere recuperata.

enableAdbRoot

public abstract boolean enableAdbRoot ()

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

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

Ritorni
`boolean`	`true` se l'operazione va a buon fine.

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

executeAdbCommand

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

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

executeShellCommand(String) deve essere utilizzato al suo posto ove possibile, in quanto questo metodo offre un rilevamento degli errori e un rendimento migliori.

Parametri
`timeout`	`long`: il tempo in millisecondi prima che il dispositivo venga considerato non reattivo, 0L per nessun timeout
`commandArgs`	`String`: il comando adb e gli argomenti da eseguire

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

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

executeAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

executeShellCommand(String) deve essere utilizzato al suo posto ove possibile, in quanto questo metodo offre un rilevamento degli errori e un rendimento migliori.

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

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

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

executeAdbCommand

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

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

executeShellCommand(String) deve essere utilizzato al suo posto ove possibile, in quanto questo metodo offre un rilevamento degli errori e un rendimento migliori.

Parametri
`timeout`	`long`: il tempo in millisecondi prima che il dispositivo venga considerato non reattivo, 0L per nessun timeout
`envMap`	: l'ambiente da impostare per il comando
`commandArgs`	`String`: il comando adb e gli argomenti da eseguire

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

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

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (long timeout, 
                 envMap, 
                String... commandArgs)

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

executeShellCommand(String) deve essere utilizzato al suo posto ove possibile, in quanto questo metodo offre un rilevamento degli errori e un rendimento migliori.

Parametri
`timeout`	`long`: il tempo in millisecondi prima che il dispositivo venga considerato non reattivo, 0L per nessun timeout
`envMap`	: l'ambiente da impostare per il comando
`commandArgs`	`String`: il comando adb e gli argomenti da eseguire

Ritorni
`CommandResult`	CommandResult contenente l'output del comando.

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

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (String... commandArgs)

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

executeShellCommand(String) deve essere utilizzato al suo posto ove possibile, in quanto questo metodo offre un rilevamento degli errori e un rendimento migliori.

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

Ritorni
`CommandResult`	CommandResult contenente l'output del comando.

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

executeAdbV2Command

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

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

executeShellCommand(String) deve essere utilizzato al suo posto ove possibile, in quanto questo metodo offre un rilevamento degli errori e un rendimento migliori.

Parametri
`timeout`	`long`: il tempo in millisecondi prima che il dispositivo venga considerato non reattivo, 0L per nessun timeout
`commandArgs`	`String`: il comando adb e gli argomenti da eseguire

Ritorni
`CommandResult`	CommandResult contenente l'output del comando.

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

executeFastbootCommand

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

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

Previsto per l'uso quando il dispositivo è già in modalità fastboot.

Parametri
`timeout`	`long`: il tempo in millisecondi prima della scadenza del comando
`commandArgs`	`String`: il comando fastboot e gli argomenti da eseguire

Ritorni
`CommandResult`	CommandResult contenente l'output del comando

Lanci
`DeviceNotAvailableException`	se la connessione con il dispositivo viene interrotta e non può essere recuperata.

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

Previsto per l'uso quando il dispositivo è già in modalità fastboot.

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

Ritorni
`CommandResult`	CommandResult contenente l'output del comando

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

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

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

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

Ritorni
`CommandResult`	CommandResult contenente l'output del comando

Lanci
`DeviceNotAvailableException`	se la connessione con il dispositivo viene interrotta e non può essere recuperata.

executeLongFastbootCommand

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

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

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

Parametri
`envVarMap`	: le variabili di ambiente di sistema con cui viene eseguito il comando fastboot
`commandArgs`	`String`: il comando fastboot e gli argomenti da eseguire

Ritorni
`CommandResult`	CommandResult contenente l'output del comando

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

executeShellCommand

public abstract String executeShellCommand (String command)

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

Parametri
`command`	`String`: il comando adb shell da eseguire

Ritorni
`String`	l'output della shell

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

executeShellCommand

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

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

Parametri
`command`	`String`: il comando adb shell da eseguire
`receiver`	`IShellOutputReceiver`: il `IShellOutputReceiver` a cui indirizzare l'output della shell.
`maxTimeToOutputShellResponse`	`long`: il periodo di tempo massimo durante il quale il comando non può generare alcuna risposta; unità come specificato in `timeUnit`
`timeUnit`	`TimeUnit`: unità per `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: il numero massimo di tentativi di ripetizione del comando in caso di errore dovuto a un'eccezione. DeviceNotResponsiveException verrà generata se `retryAttempts` vengono eseguite senza esito positivo.

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

Vedi anche:

executeShellCommand

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

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

Parametri
`command`	`String`: il comando adb shell da eseguire
`receiver`	`IShellOutputReceiver`: il `IShellOutputReceiver` a cui indirizzare l'output della shell.
`maxTimeoutForCommand`	`long`: il timeout massimo per il completamento del comando; unità come specificato in `timeUnit`
`maxTimeToOutputShellResponse`	`long`: il periodo di tempo massimo durante il quale il comando non può produrre alcuna risposta; unità come specificato in `timeUnit`
`timeUnit`	`TimeUnit`: unità per `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: il numero massimo di tentativi di ripetizione del comando in caso di errore dovuto a un'eccezione. DeviceNotResponsiveException verrà generata se `retryAttempts` vengono eseguite senza esito positivo.

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

Vedi anche:

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

Parametri
`command`	`String`: il comando adb shell da eseguire
`receiver`	`IShellOutputReceiver`: il `IShellOutputReceiver` a cui indirizzare l'output della shell.

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command)

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

Parametri
`command`	`String`: il comando da eseguire.

Ritorni
`CommandResult`	Il risultato in `CommandResult`.

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

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

Parametri
`command`	`String`: il comando da eseguire.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` in cui verrà reindirizzato l'output standard o null.

Ritorni
`CommandResult`	Il risultato in `CommandResult`.

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

Parametri
`command`	`String`: il comando da eseguire.
`pipeAsInput`	`File`: un `ERROR(/File)` che verrà inviato come input al comando o null.

Ritorni
`CommandResult`	Il risultato in `CommandResult`.

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                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 tentativi di ripetizione del comando in caso di errore dovuto a un'eccezione. DeviceNotResponsiveException verrà generata se `retryAttempts` vengono eseguite senza esito positivo.

Ritorni
`CommandResult`

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

Vedi anche:

executeShellV2Command

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

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

Parametri
`command`	`String`: il comando adb shell da eseguire
`maxTimeoutForCommand`	`long`: il timeout massimo per il completamento del comando; unità come specificato in `timeUnit`
`timeUnit`	`TimeUnit`: unità per `maxTimeToOutputShellResponse`

Ritorni
`CommandResult`

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

Vedi anche:

executeShellV2Command

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

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

Parametri
`command`	`String`: il comando adb shell da eseguire
`pipeAsInput`	`File`: un `ERROR(/File)` che verrà inviato come input al comando o null.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` in cui verrà reindirizzato l'output standard o null.
`maxTimeoutForCommand`	`long`: il timeout massimo per il completamento del comando; unità come specificato in `timeUnit`
`timeUnit`	`TimeUnit`: unità per `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: il numero massimo di tentativi di ripetizione del comando in caso di errore dovuto a un'eccezione. DeviceNotResponsiveException verrà generata se `retryAttempts` vengono eseguite senza esito positivo.

Ritorni
`CommandResult`

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

Vedi anche:

executeShellV2Command

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

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

Parametri
`command`	`String`: il comando adb shell da eseguire
`pipeAsInput`	`File`: un `ERROR(/File)` che verrà inviato come input al comando o null.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` in cui verrà reindirizzato l'output standard o null.
`pipeToError`	`OutputStream`: `ERROR(/OutputStream)` in cui verrà reindirizzato l'errore standard o null.
`maxTimeoutForCommand`	`long`: il timeout massimo per il completamento del comando; unità come specificato in `timeUnit`
`timeUnit`	`TimeUnit`: unità per `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: il numero massimo di tentativi di ripetizione del comando in caso di errore dovuto a un'eccezione. DeviceNotResponsiveException verrà generata se `retryAttempts` vengono eseguite senza esito positivo.

Ritorni
`CommandResult`

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

Vedi anche:

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

Metodo helper che cancella una partizione per il dispositivo.

Se getUseFastbootErase() è true, verrà utilizzato fastboot erase per cancellare la partizione. La volta successiva che il dispositivo si avvia, deve creare un file system. In caso contrario, viene utilizzato il formato fastboot, che creerà un nuovo filesystem sul dispositivo.

Previsto per l'uso quando il dispositivo è già in modalità fastboot.

Parametri
`partition`	`String`: la partizione da cancellare

Ritorni
`CommandResult`	CommandResult contenente l'output del comando

Lanci
`DeviceNotAvailableException`	se la connessione con il dispositivo viene interrotta e non può essere recuperata.

getApiLevel

public abstract int getApiLevel ()

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

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBasebandVersion

public abstract String getBasebandVersion ()

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

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

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

getBattery

public abstract Integer getBattery ()

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

Ritorni
`Integer`

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

Restituisce il valore booleano della proprietà specificata.

Parametri
`name`	`String`: il nome della proprietà
`defaultValue`	`boolean`: valore predefinito da restituire se la proprietà è vuota o non esiste.

Ritorni
`boolean`	`true` se la proprietà ha valore `"1"`, `"y"`, `"yes"`, `"on"` o `"true"`, `false` se la proprietà ha valore `"0"`, `"n"`, `"no"`, `"off"`, `"false"` o `defaultValue` altrimenti.

Lanci
`DeviceNotAvailableException`

getBootHistory

public abstract  getBootHistory ()

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

Ritorni
	Mappa del tempo di avvio (ora UTC in secondi dal periodo) e del motivo di avvio

Lanci
`DeviceNotAvailableException`

getBootHistorySince

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

Parametri
`utcEpochTime`	`long`: l'ora del dispositivo dall'epoca.
`timeUnit`	`TimeUnit`: l'unità di tempo `TimeUnit`.

Ritorni
	Mappa del tempo di avvio (ora UTC in secondi dal periodo) e del motivo di avvio

Lanci
`DeviceNotAvailableException`

getBootloaderVersion

public abstract String getBootloaderVersion ()

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

Verrà tentato il recupero della versione del bootloader dallo stato attuale del dispositivo. ovvero se il dispositivo è in modalità fastboot, tenterà di recuperare la versione da fastboot

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

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

getBuildAlias

public abstract String getBuildAlias ()

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

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

Ritorni
`String`	l'alias della build o l'ID build se non è stato possibile recuperarlo

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBuildFlavor

public abstract String getBuildFlavor ()

Recupera la variante di build per il dispositivo.

Ritorni
`String`	la variante di build o null se non è stato possibile recuperarla

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBuildId

public abstract String getBuildId ()

Recupera la build attualmente in esecuzione sul dispositivo.

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

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

In genere, i dispositivi Android possono essere firmati con chiavi di test (come in AOSP) o chiavi di rilascio (controllate dai singoli produttori di dispositivi)

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

Ritorni
`DeviceDescriptor`

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

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

Ritorni
`DeviceDescriptor`

getChildren

public abstract String[] getChildren (String deviceFilePath)

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

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

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getConnection

public abstract AbstractConnection getConnection ()

Restituisce la connessione associata al dispositivo.

Ritorni
`AbstractConnection`

getDeviceClass

public abstract String getDeviceClass ()

Recupera la classe del dispositivo.

Ritorni
`String`	la classe di dispositivi `String`.

getDeviceDate

public abstract long getDeviceDate ()

Restituisce la data del dispositivo in millisecondi trascorsi da epoca.

Ritorni
`long`	la data del dispositivo nel formato epoch.

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

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

Ritorni
`DeviceDescriptor`

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

Ritorni
`DeviceDescriptor`

getDeviceState

public abstract TestDeviceState getDeviceState ()

Recupera lo stato del dispositivo.

Ritorni
`TestDeviceState`

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

Helper per ottenere la differenza di tempo tra il dispositivo e un determinato ERROR(/Date). Utilizza internamente l'ora Epoch.

Parametri
`date`	`Date`

Ritorni
`long`	la differenza in millisecondi

Lanci
`DeviceNotAvailableException`

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

Ottieni il flusso di stdout e stderr dell'emulatore

Ritorni
`InputStreamSource`	output dell'emulatore

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

Metodo helper per determinare la quantità di spazio libero nell'archiviazione esterna del dispositivo.

Ritorni
`long`	La quantità di spazio libero in KB

Lanci
`DeviceNotAvailableException`	se la connessione con il dispositivo viene interrotta e non può essere recuperata.

getFastbootProductType

public abstract String getFastbootProductType ()

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

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

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

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

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

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

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

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

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

Restituisce il numero di serie della modalità fastboot.

Ritorni
`String`

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

Recupera il valore della variabile fastboot specificata dal dispositivo.

Parametri
`variableName`	`String`: il nome della variabile

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

Lanci
	UnsupportedOperationException
`DeviceNotAvailableException`

getFileEntry

public abstract IFileEntry getFileEntry (String path)

Recupera un riferimento a un file remoto sul dispositivo.

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

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getIDevice

public abstract IDevice getIDevice ()

Restituisce un riferimento alla libreria ddmlib associata IDevice.

Un nuovo IDevice potrebbe essere allocato da DDMS ogni volta che il dispositivo si disconnette e si riconnette da adb. Pertanto, i chiamanti non devono conservare un riferimento a IDevice, perché potrebbe diventare obsoleto.

Ritorni
`IDevice`	`IDevice`

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

Restituisce il valore intero della proprietà specificata dal dispositivo.

Parametri
`name`	`String`: il nome della proprietà
`defaultValue`	`long`: valore predefinito da restituire se la proprietà è vuota o non esiste.

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

Lanci
`DeviceNotAvailableException`

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

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

Ritorni
`long`

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

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

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getLogcat

public abstract InputStreamSource getLogcat ()

Acquisisce uno stream di snapshot dei dati logcat.

Funziona in due modalità:

Se logcat viene attualmente acquisito in background, restituisce fino a TestDeviceOptions.getMaxLogcatDataSize() byte dei contenuti attuali dell'acquisizione logcat in background

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

Ritorni
`InputStreamSource`

getLogcat

public abstract InputStreamSource getLogcat (int maxBytes)

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

Utile per i casi in cui vuoi acquisire snapshot frequenti dei dati logcat acquisiti senza incorrere nella penalità di spazio su disco potenzialmente elevata dell'acquisizione dell'intero snapshot getLogcat().

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

Ritorni
`InputStreamSource`

getLogcatDump

public abstract InputStreamSource getLogcatDump ()

Ottieni un dump del logcat corrente per il dispositivo. A differenza di getLogcat(), questo metodo restituisce sempre un dump statico di logcat.

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

Ritorni
`InputStreamSource`	un `InputStreamSource` dei dati di Logcat. Se non è possibile acquisire i dati logcat, viene restituito uno stream vuoto.

getLogcatSince

public abstract InputStreamSource getLogcatSince (long date)

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

Parametri
`date`	`long`: in millisecondi dal formato dell'epoca di quando iniziare lo snapshot fino al presente. (può essere ottenuto utilizzando "date +%s")

Ritorni
`InputStreamSource`

getMountPoint

public abstract String getMountPoint (String mountName)

Restituisce un punto di montaggio.

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

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

Parametri
`mountName`	`String`: il nome del punto di montaggio

Ritorni
`String`	il punto di montaggio o `null`

Vedi anche:

IDevice.getMountPoint(String)

getMountPointInfo

public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

Parametri
`mountpoint`	`String`

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

Lanci
`DeviceNotAvailableException`

Vedi anche:

getMountPointInfo()

getMountPointInfo

public abstract  getMountPointInfo ()

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

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

Lanci
`DeviceNotAvailableException`

getPartitionFreeSpace

public abstract long getPartitionFreeSpace (String partition)

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

Parametri
`partition`	`String`

Ritorni
`long`	La quantità di spazio libero in KB

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

getProcessByName

public abstract ProcessInfo getProcessByName (String processName)

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

Parametri
`processName`	`String`: la stringa del nome del processo.

Ritorni
`ProcessInfo`	ProcessInfo del processo specificato

Lanci
`DeviceNotAvailableException`

getProcessPid

public abstract String getProcessPid (String process)

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

Parametri
`process`	`String`: la stringa del nome del processo.

Ritorni
`String`

Lanci
`DeviceNotAvailableException`

getProductType

public abstract String getProductType ()

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

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

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

Lanci
`DeviceNotAvailableException`	se la connessione con il dispositivo viene persa e non può essere recuperata o se non è possibile determinare il tipo di prodotto

getProductVariant

public abstract String getProductVariant ()

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

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

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

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

getProperty

public abstract String getProperty (String name)

Recupera il valore della proprietà specificata dal dispositivo.

Parametri
`name`	`String`: il nome della proprietà

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getRecoveryMode

public abstract ITestDevice.RecoveryMode getRecoveryMode ()

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

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

getSerialNumber

public abstract String getSerialNumber ()

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

Ritorni
`String`	il numero di serie `String`

getTombstones

public abstract  getTombstones ()

Recupera e restituisci l'elenco dei tombstone dai dispositivi. Richiede il root.

Il metodo è il migliore possibile, quindi se non viene estratta una lapide per qualsiasi motivo, questa non sarà presente nell'elenco. Solo un DeviceNotAvailableException terminerà il metodo in anticipo.

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

Lanci
`DeviceNotAvailableException`

Vedi anche:

Documentazione relativa ai segnali di eliminazione

getTotalMemory

public abstract long getTotalMemory ()

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

Ritorni
`long`

getTrackingSerial

public String getTrackingSerial ()

Per la gestione dei dispositivi, recupera il numero di serie utilizzato per monitorare il dispositivo.

Ritorni
`String`

getUseFastbootErase

public abstract boolean getUseFastbootErase ()

Ottieni informazioni sull'utilizzo di fastboot erase o fastboot format per cancellare una partizione sul dispositivo.

Ritorni
`boolean`	`true` se verrà utilizzato fastboot erase o `false` se verrà utilizzato fastboot format.

Vedi anche:

fastbootWipePartition(String)

isAdbRoot

public abstract boolean isAdbRoot ()

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

Lanci
`DeviceNotAvailableException`	se la connessione con il dispositivo viene interrotta e non può essere recuperata.

isAdbTcp

public abstract boolean isAdbTcp ()

Ritorni
`boolean`	`true` se il dispositivo è connesso ad ADB su TCP, `false` altrimenti.

isAppEnumerationSupported

public abstract boolean isAppEnumerationSupported ()

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

Ritorni
`boolean`	Vero se l'enumerazione delle app è supportata, falso in caso contrario

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isBypassLowTargetSdkBlockSupported

public abstract boolean isBypassLowTargetSdkBlockSupported ()

Controllare se la piattaforma sul dispositivo supporta l'aggiramento del blocco dell'SDK di destinazione basso durante le installazioni di app

Ritorni
`boolean`	True se il blocco dell'SDK di destinazione di basso livello è supportato, false in caso contrario

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isDebugfsMounted

public abstract boolean isDebugfsMounted ()

Controlla se debugfs è montato.

Ritorni
`boolean`	`true` se debugfs è montato

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isDeviceEncrypted

public abstract boolean isDeviceEncrypted ()

Indica se il dispositivo è criptato.

Ritorni
`boolean`	`true` se il dispositivo è criptato.

Lanci
`DeviceNotAvailableException`	se la connessione con il dispositivo viene interrotta e non può essere recuperata.

isDirectory

public abstract boolean isDirectory (String deviceFilePath)

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

Parametri
`deviceFilePath`	`String`

Ritorni
`boolean`

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isEncryptionSupported

public abstract boolean isEncryptionSupported ()

Indica se la crittografia è supportata sul dispositivo.

Ritorni
`boolean`	`true` se il dispositivo supporta la crittografia.

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isExecutable

public abstract boolean isExecutable (String fullPath)

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

Parametri
`fullPath`	`String`

Ritorni
`boolean`

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isHeadless

public abstract boolean isHeadless ()

Restituisce true se il dispositivo è headless (senza schermo), false in caso contrario.

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isRuntimePermissionSupported

public abstract boolean isRuntimePermissionSupported ()

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

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isStateBootloaderOrFastbootd

public abstract boolean isStateBootloaderOrFastbootd ()

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

Ritorni
`boolean`

logAnrs

public abstract boolean logAnrs (ITestLogger logger)

Raccoglie e registra gli ANR dal dispositivo.

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

Ritorni
`boolean`	Vero se la registrazione è riuscita, falso in caso contrario.

Lanci
`DeviceNotAvailableException`

logOnDevice

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

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

Parametri
`tag`	`String`: il tag in cui registriamo il messaggio in logcat.
`level`	`Log.LogLevel`: Il livello di debug del messaggio in logcat.
`format`	`String`: Il formato del messaggio.
`args`	`Object`: gli argomenti da sostituire tramite String.format().

mountDebugfs

public abstract void mountDebugfs ()

Monta debugfs.

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

nonBlockingReboot

public abstract void nonBlockingReboot ()

Esegue un comando per riavviare il dispositivo e restituisce un risultato al termine del comando e quando il dispositivo non è più visibile ad ADB.

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

postBootSetup

public abstract void postBootSetup ()

Esegui le istruzioni per configurare il dispositivo per il test dopo ogni avvio.

Deve essere chiamato dopo l'avvio/la disponibilità completa del dispositivo

In circostanze normali, questo metodo non deve essere chiamato in modo esplicito, poiché le implementazioni devono eseguire questi passaggi automaticamente durante un riavvio.

Dove potrebbe essere necessario chiamarlo è quando il dispositivo si riavvia a causa di altri eventi (ad es. quando un comando di aggiornamento fastboot è stato completato)

Lanci
`DeviceNotAvailableException`	se la connessione con il dispositivo viene interrotta e non può essere recuperata.

postInvocationTearDown

public void postInvocationTearDown ()

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

Passaggi aggiuntivi per la pulizia richiesta specifica del dispositivo che verranno eseguiti dopo l'invocazione.

postInvocationTearDown

public abstract void postInvocationTearDown (Throwable invocationException)

Passaggi aggiuntivi per la pulizia richiesta specifica del dispositivo che verranno eseguiti dopo l'invocazione.

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

preInvocationSetup

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

Passaggi aggiuntivi per la configurazione obbligatoria specifica del dispositivo che verrà eseguita sul dispositivo prima del flusso di invocazione.

Parametri
`info`	`IBuildInfo`: Il `IBuildInfo` del dispositivo.
`attributes`	`MultiMap`: Gli attributi memorizzati nel contesto di invocazione

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

pullDir

public abstract boolean pullDir (String deviceFilePath, 
                File localDir)

Estrai in modo ricorsivo i contenuti della directory dal dispositivo.

Parametri
`deviceFilePath`	`String`: il percorso file assoluto dell'origine remota
`localDir`	`File`: la directory locale in cui inserire i file

Ritorni
`boolean`	`true` se il file è stato estratto correttamente. `false` altrimenti.

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

pullDir

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

Estrai in modo ricorsivo i contenuti della directory dal dispositivo.

Parametri
`deviceFilePath`	`String`: il percorso file assoluto dell'origine remota
`localDir`	`File`: la directory locale in cui inserire i file
`userId`	`int`: l'ID utente da cui estrarre i dati

Ritorni
`boolean`	`true` se il file è stato estratto correttamente. `false` altrimenti.

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

pullFile

public abstract File pullFile (String remoteFilePath, 
                int userId)

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

Parametri
`remoteFilePath`	`String`: il percorso assoluto del file sul dispositivo.
`userId`	`int`: l'ID utente da cui estrarre i dati

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

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

pullFile

public abstract File pullFile (String remoteFilePath)

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

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

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

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

pullFile

public abstract boolean pullFile (String remoteFilePath, 
                File localFile)

Recupera un file dal dispositivo.

Parametri
`remoteFilePath`	`String`: il percorso assoluto del file sul dispositivo.
`localFile`	`File`: il file locale in cui archiviare i contenuti. Se non è vuoto, i contenuti verranno sostituiti.

Ritorni
`boolean`	`true` se il file è stato recuperato correttamente. `false` altrimenti.

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

pullFile

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

Recupera un file dal dispositivo.

Parametri
`remoteFilePath`	`String`: il percorso assoluto del file sul dispositivo.
`localFile`	`File`: il file locale in cui archiviare i contenuti. Se non è vuoto, i contenuti verranno sostituiti.
`userId`	`int`: l'ID utente da cui estrarre i dati

Ritorni
`boolean`	`true` se il file è stato recuperato correttamente. `false` altrimenti.

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

pullFileContents

public abstract String pullFileContents (String remoteFilePath)

Recupera un file dal dispositivo e ne restituisce i contenuti.

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

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

Lanci
`DeviceNotAvailableException`

pullFileFromExternal

public abstract File pullFileFromExternal (String remoteFilePath)

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

Parametri
`remoteFilePath`	`String`: il percorso del file sul dispositivo, relativo al punto di montaggio dell'archiviazione esterna del dispositivo

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

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

pushDir

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

Esegue il push ricorsivo dei contenuti della directory sul dispositivo.

Parametri
`localDir`	`File`: la directory locale da eseguire il push
`deviceFilePath`	`String`: il percorso file assoluto della destinazione remota
`userId`	`int`: l'ID utente a cui eseguire il push

Ritorni
`boolean`	`true` se il push del file è stato eseguito correttamente. `false` altrimenti.

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

pushDir

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

Trasferisci in modo ricorsivo i contenuti della directory al dispositivo escludendo alcune directory filtrate.

Parametri
`localDir`	`File`: la directory locale da eseguire il push
`deviceFilePath`	`String`: il percorso file assoluto della destinazione remota
`excludedDirectories`	: Insieme di nomi di directory esclusi che non devono essere inviati.

Ritorni
`boolean`	`true` se il push del file è stato eseguito correttamente. `false` altrimenti.

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

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath)

Esegue il push ricorsivo dei contenuti della directory sul dispositivo.

Parametri
`localDir`	`File`: la directory locale da eseguire il push
`deviceFilePath`	`String`: il percorso file assoluto della destinazione remota

Ritorni
`boolean`	`true` se il push del file è stato eseguito correttamente. `false` altrimenti.

Lanci
`DeviceNotAvailableException`	se la connessione con il dispositivo viene interrotta e non può essere recuperata.

pushFile

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

Variante di pushFile(File, String) che può facoltativamente considerare la necessità per il fornitore di contenuti.

Parametri
`localFile`	`File`: il file locale da inviare
`deviceFilePath`	`String`: il percorso file assoluto della destinazione remota
`evaluateContentProviderNeeded`	`boolean`: se controllare se abbiamo bisogno del fornitore di contenuti

Ritorni
`boolean`	`true` se il push del file è stato eseguito correttamente. `false` altrimenti.

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

pushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath)

Invia un file al dispositivo. Per impostazione predefinita, viene utilizzato un content provider.

Parametri
`localFile`	`File`: il file locale da inviare
`deviceFilePath`	`String`: il percorso file assoluto della destinazione remota

Ritorni
`boolean`	`true` se il push del file è stato eseguito correttamente. `false` altrimenti.

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

pushFile

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

Invia un file al dispositivo. Per impostazione predefinita, viene utilizzato un content provider.

Parametri
`localFile`	`File`: il file locale da inviare
`deviceFilePath`	`String`: il percorso file assoluto della destinazione remota
`userId`	`int`: l'ID utente a cui eseguire il push

Ritorni
`boolean`	`true` se il push del file è stato eseguito correttamente. `false` altrimenti.

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

pushString

public abstract boolean pushString (String contents, 
                String deviceFilePath)

Inviare al dispositivo il file creato da una stringa

Parametri
`contents`	`String`: i contenuti del file da inviare
`deviceFilePath`	`String`: il percorso file assoluto della destinazione remota

Ritorni
`boolean`	`true` se la stringa è stata inviata correttamente. `false` altrimenti.

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

fai ripartire

public abstract void reboot ()

Riavvia il dispositivo in modalità ADB.

Blocca fino a quando il dispositivo non diventa disponibile.

Lanci
`DeviceNotAvailableException`	se il dispositivo non è disponibile dopo il riavvio

fai ripartire

public abstract void reboot (String reason)

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

Blocca fino a quando il dispositivo non diventa disponibile.

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

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

Lanci
`DeviceNotAvailableException`	se il dispositivo non è disponibile dopo il riavvio

rebootIntoBootloader

public abstract void rebootIntoBootloader ()

Riavvia il dispositivo in modalità bootloader.

Blocca fino a quando il dispositivo non è in modalità bootloader.

Lanci
`DeviceNotAvailableException`	se la connessione con il dispositivo viene interrotta e non può essere recuperata.

rebootIntoFastbootd

public abstract void rebootIntoFastbootd ()

Riavvia il dispositivo in modalità fastbootd.

Blocca fino a quando il dispositivo non è in modalità fastbootd.

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

rebootIntoRecovery

public abstract void rebootIntoRecovery ()

Riavvia il dispositivo in modalità di ripristino ADB.

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

Lanci
`DeviceNotAvailableException`	se il dispositivo non è disponibile dopo il riavvio

rebootIntoSideload

public abstract void rebootIntoSideload (boolean autoReboot)

Riavvia il dispositivo in modalità di caricamento laterale ADB (tieni presente che questa è una modalità speciale in Recovery)

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

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

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

rebootIntoSideload

public abstract void rebootIntoSideload ()

Riavvia il dispositivo in modalità di caricamento laterale ADB (tieni presente che questa è una modalità speciale in Recovery)

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

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

rebootUntilOnline

public abstract void rebootUntilOnline ()

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

Lanci
`DeviceNotAvailableException`	se il dispositivo non è disponibile dopo il riavvio

rebootUntilOnline

public abstract void rebootUntilOnline (String reason)

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

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

Lanci
`DeviceNotAvailableException`	se il dispositivo non è disponibile dopo il riavvio

Vedi anche:

reboot(String)

rebootUserspace

public abstract void rebootUserspace ()

Riavvia solo la parte dello spazio utente del dispositivo.

Blocca fino a quando il dispositivo non diventa disponibile.

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

Lanci
`DeviceNotAvailableException`	se il dispositivo non è disponibile dopo il riavvio

rebootUserspaceUntilOnline

public abstract void rebootUserspaceUntilOnline ()

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

Lanci
`DeviceNotAvailableException`	se il dispositivo non è disponibile dopo il riavvio

remountSystemReadOnly

public abstract void remountSystemReadOnly ()

Rendi di sola lettura la partizione di sistema sul dispositivo. Potrebbe riavviare il dispositivo.

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

remountSystemWritable

public abstract void remountSystemWritable ()

Rendi scrivibile la partizione di sistema sul dispositivo. Potrebbe riavviare il dispositivo.

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

remountVendorReadOnly

public abstract void remountVendorReadOnly ()

Rendi di sola lettura la partizione del fornitore sul dispositivo. Potrebbe riavviare il dispositivo.

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

remountVendorWritable

public abstract void remountVendorWritable ()

Rendi scrivibile la partizione del fornitore sul dispositivo. Potrebbe riavviare il dispositivo.

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

runInstrumentationTests

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

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

Parametri
`runner`	`IRemoteAndroidTestRunner`: il `IRemoteAndroidTestRunner` che esegue i test
`listeners`	`ITestLifeCycleReceiver`: i listener dei risultati del test

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

Lanci
`DeviceNotAvailableException`	se la connessione con il dispositivo viene persa e non può essere recuperata. Ad esempio, il comando di test non è stato completato e il recupero non è riuscito.

runInstrumentationTests

public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

Esegue test di strumentazione e fornisce il ripristino del dispositivo.

Se la connessione con il dispositivo viene persa prima del completamento dell'esecuzione del test e il recupero ha esito positivo, tutti i listener verranno informati di testRunFailed e verrà restituito "false". Il comando di test non verrà eseguito di nuovo. Spetta ai chiamanti riprovare se necessario.

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

Parametri
`runner`	`IRemoteAndroidTestRunner`: il `IRemoteAndroidTestRunner` che esegue i test
`listeners`	: i listener dei risultati del test

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

Lanci
`DeviceNotAvailableException`	se la connessione con il dispositivo viene persa e non può essere recuperata. Ad esempio, il comando di test non è stato completato e il recupero non è riuscito.

runInstrumentationTestsAsUser

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

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

Parametri
`runner`	`IRemoteAndroidTestRunner`
`userId`	`int`
`listeners`

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

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

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

Parametri
`runner`	`IRemoteAndroidTestRunner`
`userId`	`int`
`listeners`	`ITestLifeCycleReceiver`

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

setDate

public abstract void setDate (Date date)

Imposta la data sul dispositivo

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

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

setOptions

public abstract void setOptions (TestDeviceOptions options)

Imposta TestDeviceOptions per il dispositivo

Parametri
`options`	`TestDeviceOptions`

setProperty

public abstract boolean setProperty (String propKey, 
                String propValue)

Imposta il valore della proprietà specificata sul dispositivo. Richiede che adb root sia true.

Parametri
`propKey`	`String`: la chiave di destinazione da impostare.
`propValue`	`String`: il valore della proprietà da impostare.

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

setRecovery

public abstract void setRecovery (IDeviceRecovery recovery)

Imposta IDeviceRecovery da utilizzare per questo dispositivo. Deve essere impostato quando il dispositivo viene allocato per la prima volta.

Parametri
`recovery`	`IDeviceRecovery`: il `IDeviceRecovery`

setRecoveryMode

public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

Imposta la modalità di recupero attuale da utilizzare per il dispositivo.

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

Parametri
`mode`	`ITestDevice.RecoveryMode`: se la modalità "Recupera solo quando è online" deve essere attiva o meno.

setTrackingSerial

public abstract void setTrackingSerial (String trackingSerial)

Ai fini della gestione dei dispositivi, monitora il numero di serie che utilizziamo per fare riferimento al dispositivo.

Parametri
`trackingSerial`	`String`

setUseFastbootErase

public abstract void setUseFastbootErase (boolean useFastbootErase)

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

Parametri
`useFastbootErase`	`boolean`: `true` se deve essere utilizzato fastboot erase o `false` se deve essere utilizzato fastboot format.

Vedi anche:

fastbootWipePartition(String)

startLogcat

public abstract void startLogcat ()

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

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

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

startLogcat() e stopLogcat() in genere non devono essere chiamati quando all'interno di un contesto di chiamata TF, poiché il framework TF avvia e arresta logcat.

startTradeInModeTesting

public abstract boolean startTradeInModeTesting (int timeoutMs)

Attiva la modalità di test per il programma di permuta. I dati del dispositivo verranno cancellati e il dispositivo verrà riavviato.

Parametri
`timeoutMs`	`int`

Ritorni
`boolean`	Vero se l'operazione è riuscita, falso in caso contrario

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

stopEmulatorOutput

public abstract void stopEmulatorOutput ()

Chiudi ed elimina l'output dell'emulatore.

stopLogcat

public abstract void stopLogcat ()

Interrompi l'acquisizione dell'output di Logcat dal dispositivo e ignora i dati di Logcat attualmente salvati.

Non avrà alcun effetto se l'output di logcat non viene acquisito.

stopTradeInModeTesting

public abstract void stopTradeInModeTesting ()

Interrompi il test della modalità permuta. Il dispositivo verrà riavviato.

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

switchToAdbTcp

public abstract String switchToAdbTcp ()

Passa alla modalità adb-over-tcp.

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

switchToAdbUsb

public abstract boolean switchToAdbUsb ()

Passa alla modalità ADB su USB.

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

syncFiles

public abstract boolean syncFiles (File localFileDir, 
                String deviceFilePath)

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

Decide quali file eseguire il push confrontando i timestamp dei file locali con i relativi equivalenti remoti. Solo i file "più recenti" o inesistenti verranno inviati al dispositivo. Pertanto, l'overhead dovrebbe essere relativamente piccolo se il set di file 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 trasferirà in modo ricorsivo i contenuti di /tmp/files in /sdcard/files.

Parametri
`localFileDir`	`File`: la directory dei file locali contenente i file da inviare in modo ricorsivo.
`deviceFilePath`	`String`: la radice del percorso file assoluto della destinazione remota. Tutte le directory nel percorso del file devono essere leggibili. Ad esempio, il push in /data/local/tmp quando adb non è root non andrà a buon fine

Ritorni
`boolean`	`true` se i file sono stati sincronizzati correttamente. `false` altrimenti.

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

unlockDevice

public abstract boolean unlockDevice ()

Sblocca il dispositivo se è criptato.

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

Ritorni
`boolean`	`true` in caso di esito positivo o se il dispositivo non è criptato.

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

unmountDebugfs

public abstract void unmountDebugfs ()

Smonta debugfs.

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForBootComplete

public abstract boolean waitForBootComplete (long timeOut)

Blocca fino a quando non viene impostato il flag di completamento dell'avvio del dispositivo.

Parametri
`timeOut`	`long`: tempo in millisecondi da attendere prima che il flag venga impostato

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable ()

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

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

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

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable (long waitTime)

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

Parametri
`waitTime`	`long`: il tempo in millisecondi da attendere

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

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

waitForDeviceAvailableInRecoverPath

public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

Parametri
`waitTime`	`long`

Ritorni
`boolean`	Vero se il dispositivo è disponibile, falso in caso contrario.

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

waitForDeviceBootloader

public abstract void waitForDeviceBootloader ()

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

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

waitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

Blocca lo stato "adb recovery" del dispositivo (tieni presente che è diverso da IDeviceRecovery).

Parametri
`waitTime`	`long`: il tempo in millisecondi da attendere

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

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

Blocchi per il dispositivo nello stato "adb sideload"

Parametri
`waitTime`	`long`: il tempo in millisecondi da attendere

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

waitForDeviceNotAvailable

public abstract boolean waitForDeviceNotAvailable (long waitTime)

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

Parametri
`waitTime`	`long`: il tempo in millisecondi da attendere

Ritorni
`boolean`	`true` se il dispositivo non è più disponibile prima della scadenza del periodo di tempo. `false` altrimenti

waitForDeviceOnline

public abstract void waitForDeviceOnline ()

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

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

Lanci
`DeviceNotAvailableException`	se la connessione con il dispositivo viene interrotta e non può essere recuperata.

waitForDeviceOnline

public abstract void waitForDeviceOnline (long waitTime)

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

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

Parametri
`waitTime`	`long`: il tempo in millisecondi da attendere

Lanci
`DeviceNotAvailableException`	se la connessione con il dispositivo viene interrotta e non può essere recuperata.

waitForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

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

Parametri
`waitTime`	`long`: il tempo in millisecondi da attendere

Ritorni
`boolean`	`true` se il dispositivo torna a rispondere prima che trascorrano `waitTime`.