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.

NativeDevice

public class NativeDevice
extends Object implements IConfigurationReceiver, IManagedTestDevice, ITestLoggerReceiver

java.lang.Object
↳	com.android.tradefed.device.NativeDevice

Sottoclassi dirette note

TestDevice

TestDevice Implementazione di un ITestDevice per un dispositivo Android full-stack

Sottoclassi indirette note

LocalAndroidVirtualDevice, ManagedRemoteDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice

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

Implementazione predefinita di ITestDevice Dispositivi Android non full-stack.

Riepilogo

Classi nidificate
`class`	`NativeDevice.AdbAction` Un `ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction)` per l'esecuzione di un comando del sistema operativo "adb ....".
`class`	`NativeDevice.AdbShellAction`
`class`	`NativeDevice.RebootDeviceAction` `ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction)` per riavviare un dispositivo.

Costanti
`String`	`DEBUGFS_PATH`
`int`	`INVALID_USER_ID` Valore restituito per qualsiasi ID utente non valido/non trovato: UserHandle ha definito il valore -10000
`long`	`MAX_HOST_DEVICE_TIME_OFFSET`
`int`	`MAX_RETRY_ATTEMPTS` il numero predefinito di tentativi di ripetizione del comando da eseguire
`String`	`SD_CARD`
`String`	`STORAGE_EMULATED`

Campi
`protected TestDeviceOptions`	`mOptions`
`protected final IDeviceStateMonitor`	`mStateMonitor`

Costruttori pubblici
`NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)` Crea un `TestDevice`.

Metodi pubblici
`void`	`batchPrefetchStartupBuildProps()` Micro ottimizzazione (circa 400 millisecondi) mediante il prefetching di tutte le proprietà necessarie anziché chiamare "adb getprop" per ciascuna.
`boolean`	`canSwitchToHeadlessSystemUser()` Restituisce un valore che indica se è consentito passare all'utente di sistema headless.
`boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` Controlla se una funzionalità è attualmente supportata in base a un livello minimo supportato.
`boolean`	`checkConnectivity()` Verifica che il dispositivo abbia connettività di rete.
`boolean`	`clearErrorDialogs()` Tenta di chiudere le finestre di dialogo di errore attualmente visualizzate nell'interfaccia utente del dispositivo.
`void`	`clearLastConnectedWifiNetwork()` Cancella l'ultima rete Wi-Fi connessa.
`void`	`clearLogcat()` Elimina tutti i dati logcat accumulati.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)` Si connette a una rete Wi-Fi.
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk)` Si connette a una rete Wi-Fi.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk)` Si connette a una rete Wi-Fi.f
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)` Si connette a una rete Wi-Fi.
`boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)` Una variante di `connectToWifiNetwork(String, String)` che si connette solo se il dispositivo al momento non ha connettività di rete.
`boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)` Una variante di `connectToWifiNetwork(String, String)` che si connette solo se il dispositivo al momento non ha connettività di rete.
`int`	`createUser(String name, boolean guest, boolean ephemeral)` Crea un utente con un nome specificato e i flag forniti
`int`	`createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)` Crea un utente con un nome specificato e i flag forniti
`int`	`createUser(String name)` Crea un utente con un nome specificato e flag predefiniti 0.
`int`	`createUserNoThrow(String name)` Crea un utente con un nome specificato e flag predefiniti 0.
`DeviceInspectionResult`	`debugDeviceNotAvailable()` Ispeziona un dispositivo e restituisci informazioni dettagliate quando un dispositivo non è più disponibile.
`void`	`deleteFile(String deviceFilePath, int userId)` Metodo helper per eliminare un file o una directory sul dispositivo.
`void`	`deleteFile(String deviceFilePath)` Metodo helper per eliminare un file o una directory sul dispositivo.
`void`	`deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Rimuove il `IDeviceActionReceiver` registrato.
`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`.
`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)`.
`boolean`	`disableAdbRoot()` Disattiva l'accesso root adb.
`void`	`disableKeyguard()` Tentativi di disattivare la protezione tasti.
`boolean`	`disableNetworkMonitor()` Disattiva il monitoraggio della rete sul dispositivo.
`boolean`	`disconnectFromWifi()` Si disconnette da una rete Wi-Fi.
`boolean`	`doesFileExist(String deviceFilePath, int userId)` Metodo helper per determinare se il file sul dispositivo esiste per un determinato utente.
`boolean`	`doesFileExist(String deviceFilePath)` Metodo helper per determinare se il file sul dispositivo esiste.
`File`	`dumpHeap(String process, String devicePath)` Prova a scaricare l'heap da system_server.
`boolean`	`enableAdbRoot()` Attiva adb root.
`boolean`	`enableNetworkMonitor()` Attiva il monitoraggio della rete sul dispositivo.
`String`	`executeAdbCommand(long timeout, String... cmdArgs)` Metodo helper che esegue un comando adb come comando di sistema con un timeout specificato.
`String`	`executeAdbCommand(long timeout, envMap, String... cmdArgs)` Metodo helper che esegue un comando adb come comando di sistema con un timeout specificato.
`String`	`executeAdbCommand(String... cmdArgs)` Metodo helper che esegue un comando adb come comando di sistema.
`CommandResult`	`executeAdbV2Command(String... cmdArgs)` Metodo helper che esegue un comando adb come comando di sistema.
`CommandResult`	`executeAdbV2Command(long timeout, String... cmdArgs)` Metodo helper che esegue un comando adb come comando di sistema con un timeout specificato.
`CommandResult`	`executeAdbV2Command(long timeout, envMap, String... cmdArgs)` Metodo helper che esegue un comando adb come comando di sistema con un timeout specificato.
`CommandResult`	`executeFastbootCommand(String... cmdArgs)` Metodo helper che esegue un comando fastboot come comando di sistema con un timeout predefinito di 2 minuti.
`CommandResult`	`executeFastbootCommand(long timeout, String... cmdArgs)` Metodo helper che esegue un comando fastboot come comando di sistema.
`CommandResult`	`executeLongFastbootCommand(String... cmdArgs)` Metodo helper che esegue un comando fastboot a esecuzione prolungata come comando di sistema.
`CommandResult`	`executeLongFastbootCommand( envVarMap, String... cmdArgs)` Metodo helper che esegue un comando fastboot a esecuzione prolungata come comando di sistema con variabili di ambiente di sistema.
`String`	`executeShellCommand(String command)` Metodo helper che esegue un comando adb shell e restituisce l'output come `String`.
`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.
`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.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` Esegue il comando adb shell specificato, riprovando più volte se il comando non va a buon fine.
`CommandResult`	`executeShellV2Command(String cmd)` 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.
`CommandResult`	`executeShellV2Command(String cmd, 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.
`CommandResult`	`executeShellV2Command(String cmd, 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.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)` Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Esegue un comando adb shell, con più parametri per controllare il comportamento del comando.
`CommandResult`	`executeShellV2Command(String cmd, 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.
`CommandResult`	`fastbootWipePartition(String partition)` Metodo helper che cancella una partizione per il dispositivo.
	`getActiveApexes()` Recupera le informazioni sugli APEX attivati sul dispositivo.
`String`	`getAdbPath()` Restituisce il percorso del file binario adb in uso.
	`getAllSettings(String namespace)` Restituisce le coppie chiave-valore dello spazio dei nomi richiesto.
`DeviceAllocationState`	`getAllocationState()` Restituisce lo stato di allocazione attuale del dispositivo
`String`	`getAndroidId(int userId)` Trova e restituisce l'android-id associato a un userId, null se non trovato.
	`getAndroidIds()` Crea una mappa degli ID Android trovati che corrispondono agli ID utente.
`int`	`getApiLevel()` Recupera il livello API del dispositivo.
`PackageInfo`	`getAppPackageInfo(String packageName)` Recupera informazioni su un pacchetto installato sul dispositivo.
	`getAppPackageInfos()` Recupera le informazioni sui pacchetti installati sul dispositivo.
`String`	`getBasebandVersion()` Metodo pratico per ottenere la versione della banda di base (radio) di questo dispositivo.
`Integer`	`getBattery()` Restituisce il livello attuale della batteria di un dispositivo o Null se il livello della batteria non è disponibile.
`boolean`	`getBooleanProperty(String name, boolean defaultValue)` Restituisce il valore booleano della proprietà specificata.
	`getBootHistory()` Il metodo helper raccoglie la mappa della cronologia di avvio con l'ora e il motivo dell'avvio.
	`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.
`String`	`getBootloaderVersion()` Metodo pratico per ottenere la versione del bootloader di questo dispositivo.
`InputStreamSource`	`getBugreport()` Recupera una segnalazione di bug dal dispositivo.
`InputStreamSource`	`getBugreportz()` Recupera un bugreportz dal dispositivo.
`String`	`getBuildAlias()` Recupera l'alias della build attualmente in esecuzione sul dispositivo.
`String`	`getBuildFlavor()` Recupera la variante di build per il dispositivo.
`String`	`getBuildId()` Recupera la build attualmente in esecuzione sul dispositivo.
`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)
`DeviceDescriptor`	`getCachedDeviceDescriptor()` Restituisce un `DeviceDescriptor` memorizzato nella cache se il dispositivo è allocato, altrimenti restituisce il `DeviceDescriptor` corrente.
`DeviceDescriptor`	`getCachedDeviceDescriptor(boolean shortDescriptor)` Restituisce un `DeviceDescriptor` memorizzato nella cache se il dispositivo è allocato, altrimenti restituisce il `DeviceDescriptor` corrente.
`String[]`	`getChildren(String path)` Alternativa all'utilizzo di `IFileEntry`, che a volte non funziona a causa delle autorizzazioni.
`AbstractConnection`	`getConnection()` La connessione attuale associata al dispositivo.
`ContentProviderHandler`	`getContentProvider(int userId)` Restituisce `ContentProviderHandler` o null se non disponibile.
`DeviceFoldableState`	`getCurrentFoldableState()` Restituisce lo stato attuale di piegatura del dispositivo o null se si sono verificati alcuni problemi.
`int`	`getCurrentUser()` Restituisce l'ID dell'utente attualmente in esecuzione.
`String`	`getDeviceClass()` Recupera la classe del dispositivo.
`long`	`getDeviceDate()` Restituisce la data del dispositivo in millisecondi trascorsi da epoca.
`DeviceDescriptor`	`getDeviceDescriptor()` Restituisce un `DeviceDescriptor` dalle informazioni del dispositivo per ottenere informazioni su di esso senza passare l'oggetto dispositivo effettivo.
`DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` Restituisce un `DeviceDescriptor` dalle informazioni del dispositivo per ottenere informazioni su di esso senza passare l'oggetto dispositivo effettivo.
`TestDeviceState`	`getDeviceState()` Recupera lo stato del dispositivo.
`long`	`getDeviceTimeOffset(Date date)` Helper per ottenere la differenza di tempo tra il dispositivo e un determinato `ERROR(/Date)`.
`InputStreamSource`	`getEmulatorOutput()` Ottieni il flusso di stdout e stderr dell'emulatore
`Process`	`getEmulatorProcess()` Restituisce l'`Process` corrispondente a questo emulatore.
`final File`	`getExecuteShellCommandLog()` Il log che contiene tutti i log `executeShellCommand(String)`.
`long`	`getExternalStoreFreeSpace()` Metodo helper per determinare la quantità di spazio libero nell'archiviazione esterna del dispositivo.
`String`	`getFastbootPath()` Restituisce il percorso del binario fastboot in uso.
`String`	`getFastbootProductType()` Metodo pratico per ottenere il tipo di prodotto di questo dispositivo quando è in modalità fastboot.
`String`	`getFastbootProductVariant()` Metodo pratico per ottenere il tipo di prodotto di questo dispositivo quando è in modalità fastboot.
`String`	`getFastbootSerialNumber()` Restituisce il numero di serie della modalità fastboot.
`String`	`getFastbootVariable(String variableName)` Recupera il valore della variabile fastboot specificata dal dispositivo.
`String`	`getFastbootVersion()` Restituisce la stringa della versione del binario fastboot in uso.
`IFileEntry`	`getFileEntry(String path)` Recupera un riferimento a un file remoto sul dispositivo.
`IFileEntry`	`getFileEntry(FileListingService.FileEntry entry)` Helper non ufficiale per ottenere un `FileEntry` da un percorso non root.
	`getFoldableStates()` Restituisce l'elenco degli stati di piegatura sul dispositivo.
`IDevice`	`getIDevice()` Restituisce un riferimento alla libreria ddmlib associata `IDevice`.
	`getInstalledPackageNames()` Recupera i nomi dei pacchetti delle applicazioni presenti sul dispositivo.
`long`	`getIntProperty(String name, long defaultValue)` Restituisce il valore intero della proprietà specificata dal dispositivo.
`String`	`getIpAddress()` Recupera l'indirizzo IP del dispositivo.
`KeyguardControllerState`	`getKeyguardState()` Restituisce un oggetto per ottenere lo stato attuale del keyguard o null se non è supportato.
`long`	`getLastExpectedRebootTimeMillis()` Restituisce l'ultima volta che le API Tradefed hanno attivato un riavvio in millisecondi dall'epoca come restituito da `System.currentTimeMillis()`.
`int`	`getLaunchApiLevel()` Ottieni il primo livello API avviato del dispositivo.
`InputStreamSource`	`getLogcat()` Acquisisce uno stream di snapshot dei dati logcat.
`InputStreamSource`	`getLogcat(int maxBytes)` Acquisisce un flusso di snapshot degli ultimi `maxBytes` di dati logcat acquisiti.
`InputStreamSource`	`getLogcatDump()` Ottieni un dump del logcat corrente per il dispositivo.
`InputStreamSource`	`getLogcatSince(long date)` Acquisisce un flusso di snapshot dei dati logcat acquisiti a partire dalla data fornita.
`String`	`getMacAddress()` Restituisce l'indirizzo MAC del dispositivo, null se la query dal dispositivo non va a buon fine.
`Integer`	`getMainUserId()` Restituisce l'ID utente principale.
	`getMainlineModuleInfo()` Recupera le informazioni sui moduli mainline installati sul dispositivo.
`int`	`getMaxNumberOfRunningUsersSupported()` Ottieni il numero massimo di utenti supportati in esecuzione simultanea.
`int`	`getMaxNumberOfUsersSupported()` Ottieni il numero massimo di utenti supportati.
`Process`	`getMicrodroidProcess()`
`IDeviceStateMonitor`	`getMonitor()` Restituisci l'`IDeviceStateMonitor` associato al dispositivo.
`String`	`getMountPoint(String mountName)` Restituisce un punto di montaggio.
`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.
	`getMountPointInfo()` Restituisce una versione analizzata delle informazioni in /proc/mounts sul dispositivo
`TestDeviceOptions`	`getOptions()` Recupera le opzioni di test per il dispositivo.
`long`	`getPartitionFreeSpace(String partition)` Metodo helper per determinare la quantità di spazio libero nella partizione del dispositivo.
`Integer`	`getPrimaryUserId()` Restituisce l'ID utente principale.
`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.
`String`	`getProcessPid(String process)` Restituisce il PID del servizio o null se si è verificato un problema.
`String`	`getProductType()` Metodo pratico per ottenere il tipo di prodotto di questo dispositivo.
`String`	`getProductVariant()` Metodo pratico per ottenere la variante del prodotto di questo dispositivo.
`String`	`getProperty(String name)` Recupera il valore della proprietà specificata dal dispositivo.
`ITestDevice.RecoveryMode`	`getRecoveryMode()` Recupera la modalità di ripristino corrente utilizzata per il dispositivo.
`InputStreamSource`	`getScreenshot(long displayId)` Acquisisce uno screenshot dal dispositivo dato l'ID display.
`InputStreamSource`	`getScreenshot(String format)` Acquisisce uno screenshot dal dispositivo.
`InputStreamSource`	`getScreenshot(String format, boolean rescale)` Acquisisce uno screenshot dal dispositivo.
`InputStreamSource`	`getScreenshot()` Acquisisce uno screenshot dal dispositivo.
`String`	`getSerialNumber()` Metodo pratico per ottenere il numero di serie di questo dispositivo.
`String`	`getSetting(int userId, String namespace, String key)` Restituisce il valore dell'impostazione richiesta.
`String`	`getSetting(String namespace, String key)` Consulta `getSetting(int, String, String)` ed eseguita sull'utente di sistema.
`String`	`getSimOperator()` Restituisce l'operatore della scheda SIM o null se non disponibile o se il dispositivo non è disponibile.
`String`	`getSimState()` Restituisce lo stato della scheda SIM o null se non disponibile o se il dispositivo non è disponibile.
	`getTombstones()` Recupera e restituisci l'elenco dei segnali di chiusura dai dispositivi.
`long`	`getTotalMemory()` Restituisce le dimensioni totali della memoria fisica in byte o -1 in caso di errore interno
`String`	`getTrackingSerial()` Per la gestione dei dispositivi, recupera il numero di serie utilizzato per monitorare il dispositivo.
	`getUninstallablePackageNames()` Recupera i nomi dei pacchetti dell'applicazione che possono essere disinstallati.
`boolean`	`getUseFastbootErase()` Ottieni informazioni sull'utilizzo di fastboot erase o fastboot format per cancellare una partizione sul dispositivo.
`int`	`getUserFlags(int userId)` Trova e restituisci i flag di un determinato utente.
	`getUserInfos()` Recupera la mappa di useId per `UserInfo` sul dispositivo.
`int`	`getUserSerialNumber(int userId)` Restituisce il numero di serie associato all'ID utente se trovato, -10000 in tutti gli altri casi.
`IManagedTestDevice.DeviceEventResponse`	`handleAllocationEvent(DeviceEvent event)` Elabora l'oggetto DeviceEvent specificato. Elabora DeviceEvent, che potrebbe o meno eseguire la transizione di questo dispositivo a un nuovo stato di allocazione.
`boolean`	`hasFeature(String feature)` Controllare se una funzionalità è disponibile su un dispositivo.
`void`	`initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)` Inizializza la connessione al dispositivo.
`String`	`installPackage(File packageFile, boolean reinstall, String... extraArgs)` Installa un pacchetto Android sul dispositivo.
`String`	`installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` Installa un pacchetto Android sul dispositivo.
`String`	`installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)` Installa un pacchetto Android sul dispositivo per un determinato utente.
`String`	`installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` Installa un pacchetto Android sul dispositivo per un determinato utente.
`boolean`	`installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)` Installa APK con modalità incrementale.
`void`	`invalidatePropertyCache()`
`boolean`	`isAdbRoot()`
`boolean`	`isAdbTcp()`
`boolean`	`isAppEnumerationSupported()` Controllare se la piattaforma sul dispositivo supporta l'enumerazione delle app
`boolean`	`isBypassLowTargetSdkBlockSupported()` Controllare se la piattaforma sul dispositivo supporta l'aggiramento del blocco dell'SDK di destinazione basso durante le installazioni di app
`boolean`	`isDebugfsMounted()` Controlla se debugfs è montato.
`boolean`	`isDeviceEncrypted()` Indica se il dispositivo è criptato.
`boolean`	`isDirectory(String path)` Restituisce True se il percorso sul dispositivo è una directory, false in caso contrario.
`boolean`	`isEnableAdbRoot()`
`boolean`	`isEncryptionSupported()` Indica se la crittografia è supportata sul dispositivo.
`boolean`	`isExecutable(String fullPath)` Restituisce True se il percorso del file sul dispositivo è un file eseguibile, altrimenti restituisce False.
`boolean`	`isFastbootEnabled()` Restituisce un valore se fastboot è disponibile per il dispositivo.
`boolean`	`isHeadless()` Restituisce true se il dispositivo è headless (senza schermo), false in caso contrario.
`boolean`	`isHeadlessSystemUserMode()` Indica se il dispositivo utilizza la modalità headless system user.
`boolean`	`isMainUserPermanentAdmin()` Restituisce un valore che indica se l'utente principale è un amministratore permanente e non può essere eliminato o declassato a utente non amministratore.
`boolean`	`isMultiUserSupported()` Determina se è supportato l'utilizzo di più utenti.
`boolean`	`isPackageInstalled(String packageName, String userId)` Esegui una query sul dispositivo per un determinato nome del pacchetto e un determinato ID utente per verificare se l'app è attualmente installata o meno per quell'utente.
`boolean`	`isPackageInstalled(String packageName)` Esegui una query sul dispositivo per un determinato nome di pacchetto per verificare se è attualmente installato o meno.
`boolean`	`isRuntimePermissionSupported()` Controllare se la piattaforma sul dispositivo supporta la concessione delle autorizzazioni di runtime
`boolean`	`isStateBootloaderOrFastbootd()` Restituisce true se il dispositivo è in `TestDeviceState.FASTBOOT` o `TestDeviceState.FASTBOOTD`.
`boolean`	`isUserRunning(int userId)` Controlla se un determinato utente è in esecuzione.
`boolean`	`isUserSecondary(int userId)` Restituisce un valore che indica se l'utente specificato è un utente secondario in base ai relativi flag.
`boolean`	`isUserVisible(int userId)` Verifica se l'utente specificato è visibile.
`boolean`	`isUserVisibleOnDisplay(int userId, int displayId)` Verifica se l'utente specificato è visibile nella visualizzazione indicata.
`boolean`	`isVisibleBackgroundUsersOnDefaultDisplaySupported()` Restituisce un valore che indica se il dispositivo consente agli utenti di essere avviati in modo visibile in background in `ERROR(/java.android.view.Display#DEFAULT_DISPLAY)`.
`boolean`	`isVisibleBackgroundUsersSupported()` Restituisce un valore che indica se il dispositivo consente l'avvio visibile in background.
`boolean`	`isWifiEnabled()` Verifica se il Wi-Fi è attivo.
	`listDisplayIds()` Raccogli l'elenco degli ID display disponibili sul dispositivo come riportato da "dumpsys SurfaceFlinger".
	`listDisplayIdsForStartingVisibleBackgroundUsers()` Recupera l'elenco dei display che possono essere utilizzati per `start a user visible in the background`.
	`listUsers()` Recupera l'elenco degli utenti sul dispositivo.
`boolean`	`logAnrs(ITestLogger logger)` Raccoglie e registra gli ANR dal dispositivo.
`boolean`	`logBugreport(String dataName, ITestLogger listener)` Metodo helper per acquisire una segnalazione di bug e registrarla per i reporter.
`void`	`logOnDevice(String tag, Log.LogLevel level, String format, Object... args)` Registra un messaggio nel logcat del dispositivo.
`void`	`mountDebugfs()` Monta debugfs.
`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.
`void`	`postAdbRootAction()` Esegui l'override se il dispositivo richiede alcune azioni specifiche da intraprendere dopo l'accesso root adb e prima che il dispositivo torni online.
`void`	`postAdbUnrootAction()` Esegui l'override se il dispositivo richiede alcune azioni specifiche da intraprendere dopo l'annullamento del root di ADB e prima che il dispositivo torni online.
`void`	`postBootSetup()` Esegui le istruzioni per configurare il dispositivo per il test dopo ogni avvio.
`void`	`postInvocationTearDown(Throwable exception)` Passaggi aggiuntivi per la pulizia richiesta specifica del dispositivo che verranno eseguiti dopo l'invocazione.
`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.
`boolean`	`pullDir(String deviceFilePath, File localDir, int userId)` Estrai in modo ricorsivo i contenuti della directory dal dispositivo.
`boolean`	`pullDir(String deviceFilePath, File localDir)` Estrai in modo ricorsivo i contenuti della directory dal dispositivo.
`boolean`	`pullFile(String remoteFilePath, File localFile)` Recupera un file dal dispositivo.
`File`	`pullFile(String remoteFilePath, int userId)` Recupera un file dal dispositivo, lo memorizza in un `ERROR(/File)` temporaneo locale e restituisce `File`.
`File`	`pullFile(String remoteFilePath)` Recupera un file dal dispositivo, lo memorizza in un `ERROR(/File)` temporaneo locale e restituisce `File`.
`boolean`	`pullFile(String remoteFilePath, File localFile, int userId)` Recupera un file dal dispositivo.
`String`	`pullFileContents(String remoteFilePath)` Recupera un file dal dispositivo e ne restituisce i contenuti.
`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`.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, excludedDirectories)` Trasferisci in modo ricorsivo i contenuti della directory al dispositivo escludendo alcune directory filtrate.
`boolean`	`pushDir(File localFileDir, String deviceFilePath)` Esegue il push ricorsivo dei contenuti della directory sul dispositivo.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, int userId)` Esegue il push ricorsivo dei contenuti della directory sul dispositivo.
`boolean`	`pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)` Variante di `pushFile(File, String)` che può facoltativamente considerare la necessità per il fornitore di contenuti.
`boolean`	`pushFile(File localFile, String remoteFilePath)` Invia un file al dispositivo.
`boolean`	`pushFile(File localFile, String remoteFilePath, int userId)` Invia un file al dispositivo.
`boolean`	`pushString(String contents, String remoteFilePath)` Inviare al dispositivo il file creato da una stringa
`void`	`reboot(String reason)` Riavvia il dispositivo in modalità ADB con il valore `reason` specificato da mantenere dopo il riavvio.
`void`	`reboot()` Riavvia il dispositivo in modalità ADB.
`void`	`rebootIntoBootloader()` Riavvia il dispositivo in modalità bootloader.
`void`	`rebootIntoFastbootd()` Riavvia il dispositivo in modalità fastbootd.
`void`	`rebootIntoRecovery()` Riavvia il dispositivo in modalità di ripristino ADB.
`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
`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
`void`	`rebootUntilOnline()` Un'alternativa a `reboot()` che blocca solo finché il dispositivo non è online, ovvero visibile ad ADB.
`void`	`rebootUntilOnline(String reason)` Un'alternativa a `reboot()` che blocca solo finché il dispositivo non è online, ovvero visibile ad ADB.
`void`	`rebootUserspace()` Riavvia solo la parte dello spazio utente del dispositivo.
`void`	`rebootUserspaceUntilOnline()` Un'alternativa a `rebootUserspace()` ()} che blocca solo finché il dispositivo non è online, ovvero visibile ad ADB.
`boolean`	`recoverDevice()` Tenta di ripristinare la comunicazione con il dispositivo.
`void`	`registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Registra un `IDeviceActionReceiver` per questo dispositivo.
`void`	`remountSystemReadOnly()` Rendi di sola lettura la partizione di sistema sul dispositivo.
`void`	`remountSystemWritable()` Rendi scrivibile la partizione di sistema sul dispositivo.
`void`	`remountVendorReadOnly()` Rendi di sola lettura la partizione del fornitore sul dispositivo.
`void`	`remountVendorWritable()` Rendi scrivibile la partizione del fornitore sul dispositivo.
`boolean`	`removeAdmin(String componentName, int userId)` Rimuovi l'amministratore del dispositivo specificato nell'utente specificato e restituisci `true` se l'operazione ha esito positivo, `false` in caso contrario.
`void`	`removeOwners()` Rimuovi tutti i proprietari dei profili dei dispositivi esistenti con il massimo impegno.
`boolean`	`removeUser(int userId)` Rimuovere un determinato utente dal dispositivo.
`void`	`resetContentProviderSetup()` Reimposta il flag per la configurazione del fornitore di contenuti per attivarlo di nuovo.
`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.
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)` Esegue test di strumentazione e fornisce il ripristino del dispositivo.
`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.
`boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)` Come `ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)`, ma esegue il test per un determinato utente.
`void`	`setAdbPath(String adbPath)` Imposta il percorso del file binario adb da utilizzare.
`void`	`setConfiguration(IConfiguration configuration)` Inserisce il `IConfiguration` in uso.
`final void`	`setConnectionAvdInfo(GceAvdInfo avdInfo)`
`void`	`setDate(Date date)` Imposta la data sul dispositivo Nota: l'impostazione della data sul dispositivo richiede l'accesso root
`boolean`	`setDeviceOwner(String componentName, int userId)` Imposta un componente di amministrazione del dispositivo come proprietario del dispositivo per un determinato utente.
`void`	`setDeviceState(TestDeviceState deviceState)` Aggiorna lo stato del dispositivo.
`void`	`setEmulatorOutputStream(SizeLimitedOutputStream output)` Per l'emulatore, imposta `SizeLimitedOutputStream` per registrare l'output
`void`	`setEmulatorProcess(Process p)` Imposta `Process` quando questo dispositivo è un emulatore.
`void`	`setFastbootEnabled(boolean fastbootEnabled)` Imposta l'opzione fastboot per il dispositivo.
`void`	`setFastbootPath(String fastbootPath)` Imposta il percorso del file binario fastboot da utilizzare.
`void`	`setIDevice(IDevice newDevice)` Aggiorna l'iDevice associato a questo ITestDevice.
`void`	`setLogStartDelay(int delay)` Imposta il tempo in millisecondi da attendere prima di avviare l'acquisizione di logcat per un dispositivo online.
`void`	`setOptions(TestDeviceOptions options)` Imposta `TestDeviceOptions` per il dispositivo
`boolean`	`setProperty(String propKey, String propValue)` Imposta il valore della proprietà specificata sul dispositivo.
`void`	`setRecovery(IDeviceRecovery recovery)` Imposta `IDeviceRecovery` da utilizzare per questo dispositivo.
`void`	`setRecoveryMode(ITestDevice.RecoveryMode mode)` Imposta la modalità di recupero attuale da utilizzare per il dispositivo.
`void`	`setSetting(String namespace, String key, String value)` Consulta `setSetting(int, String, String, String)` ed eseguita sull'utente di sistema.
`void`	`setSetting(int userId, String namespace, String key, String value)` Aggiungi un valore di impostazione allo spazio dei nomi di un determinato utente.
`void`	`setTestLogger(ITestLogger testLogger)` Inserisce l'istanza `ITestLogger`
`void`	`setTrackingSerial(String trackingSerial)` Ai fini della gestione dei dispositivi, monitora il numero di serie che utilizziamo per fare riferimento al dispositivo.
`void`	`setUseFastbootErase(boolean useFastbootErase)` Imposta se utilizzare fastboot erase o fastboot format per cancellare una partizione sul dispositivo.
`void`	`startLogcat()` Inizia ad acquisire l'output di logcat dal dispositivo in background.
`boolean`	`startTradeInModeTesting(int timeoutMs)` Attiva la modalità di test per il programma di permuta.
`boolean`	`startUser(int userId)` Avvia un determinato utente in background se è attualmente arrestato.
`boolean`	`startUser(int userId, boolean waitFlag)` Avvia un determinato utente in background se è attualmente arrestato.
`boolean`	`startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)` Avvia un determinato utente in background, visibile nel display specificato (ovvero, consente all'utente di avviare attività in quel display).
`void`	`stopEmulatorOutput()` Chiudi ed elimina l'output dell'emulatore.
`void`	`stopLogcat()` Interrompe l'acquisizione dell'output di Logcat dal dispositivo e ignora i dati di Logcat attualmente salvati.
`void`	`stopTradeInModeTesting()` Interrompi il test della modalità permuta.
`boolean`	`stopUser(int userId)` Interrompe un determinato utente.
`boolean`	`stopUser(int userId, boolean waitFlag, boolean forceFlag)` Interrompi un determinato utente.
`String`	`switchToAdbTcp()` Passa alla modalità adb-over-tcp.
`boolean`	`switchToAdbUsb()` Passa alla modalità adb su USB.
`boolean`	`switchUser(int userId)` Passa a un altro userId con un timeout predefinito.
`boolean`	`switchUser(int userId, long timeout)` Passa a un altro userId con il timeout fornito come scadenza.
`boolean`	`syncFiles(File localFileDir, String deviceFilePath)` Sincronizza in modo incrementale i contenuti di una directory di file locale con il dispositivo.
`Bugreport`	`takeBugreport()` Prende una segnalazione di bug e la restituisce all'interno di un oggetto `Bugreport` per gestirla.
`String`	`uninstallPackage(String packageName)` Disinstalla un pacchetto Android dal dispositivo.
`String`	`uninstallPackageForUser(String packageName, int userId)` Disinstalla un pacchetto Android dal dispositivo per un determinato utente.
`boolean`	`unlockDevice()` Sblocca il dispositivo se è criptato.
`void`	`unmountDebugfs()` Smonta debugfs.
`boolean`	`waitForBootComplete(long timeOut)` Blocca fino a quando non viene impostato il flag di completamento dell'avvio del dispositivo.
`boolean`	`waitForDeviceAvailable()` Attende che il dispositivo sia reattivo e disponibile per i test.
`boolean`	`waitForDeviceAvailable(long waitTime)` Attende che il dispositivo sia reattivo e disponibile per i test.
`boolean`	`waitForDeviceAvailableInRecoverPath(long waitTime)` Attende che il dispositivo sia reattivo e disponibile senza considerare il percorso di recupero.
`void`	`waitForDeviceBootloader()` Blocca fino a quando il dispositivo non è visibile tramite fastboot.
`void`	`waitForDeviceFastbootD()`
`boolean`	`waitForDeviceInRecovery(long waitTime)` Blocca lo stato "adb recovery" del dispositivo (tieni presente che è diverso da `IDeviceRecovery`).
`boolean`	`waitForDeviceInSideload(long waitTime)` Blocchi per il dispositivo nello stato "adb sideload"
`boolean`	`waitForDeviceNotAvailable(long waitTime)` Blocchi per il dispositivo che non è disponibile, ad esempio mancante da ADB
`void`	`waitForDeviceOnline()` Blocca fino a quando il dispositivo non è visibile tramite adb.
`void`	`waitForDeviceOnline(long waitTime)` Blocca fino a quando il dispositivo non è visibile tramite adb.
`boolean`	`waitForDeviceShell(long waitTime)` Attende che il dispositivo risponda a un comando di base della shell ADB.

Metodi protetti
`void`	`addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)`
`String[]`	`buildAdbShellCommand(String command, boolean forceExitStatusDetection)` Crea il comando del sistema operativo per la sessione e gli argomenti del comando adb shell specificati
`void`	`checkApiLevelAgainst(String feature, int strictMinLevel)`
`NativeDevice.RebootDeviceAction`	`createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)` Crea un `RebootDeviceAction` da utilizzare quando esegui un'azione di riavvio.
`IRunUtil`	`createRunUtil()`
`void`	`doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)` Esegui un riavvio ADB.
`void`	`ensureRuntimePermissionSupported()` Metodo helper per generare un'eccezione se l'autorizzazione di runtime non è supportata
`int`	`getApiLevelSafe()`
`ITestLogger`	`getLogger()`
`IRunUtil`	`getRunUtil()` Ottieni l'istanza `RunUtil` da utilizzare.
`String`	`internalGetProperty(String propName, String fastbootVar, String description)` Recupera una proprietà del dispositivo dalla cache ddmlib per impostazione predefinita e torna a `adb shell getprop` o `fastboot getvar` a seconda che il dispositivo sia in modalità Fastboot o meno.
`boolean`	`isInRebootCallback()` Restituisce un valore che indica se i callback di riavvio sono attualmente in esecuzione o meno.
`boolean`	`isNewer(File localFile, IFileEntry entry)` Restituisce `true` se il file locale è più recente del file remoto.
`void`	`notifyRebootEnded()` Invia una notifica a tutti i `IDeviceActionReceiver` in merito all'evento di fine riavvio.
`void`	`notifyRebootStarted()` Invia una notifica a tutti i `IDeviceActionReceiver` in merito all'evento di avvio del riavvio.
`boolean`	`performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)` Esegue un'azione su questo dispositivo.
`void`	`postAdbReboot(NativeDevice.RebootMode rebootMode)` Possibili azioni aggiuntive che possono essere intraprese dopo un riavvio.
`void`	`prePostBootSetup()` Consente a ogni tipo di dispositivo (AndroidNativeDevice, TestDevice) di eseguire l'override di questo metodo per una configurazione specifica post-avvio.
`boolean`	`pullFileInternal(String remoteFilePath, File localFile)`
`void`	`setClock(Clock clock)` Imposta l'istanza di Orologio da utilizzare.
`void`	`setMicrodroidProcess(Process process)` Contrassegna TestDevice come microdroid e imposta il relativo CID.
`void`	`setTestDeviceOptions( deviceOptions)`
`CommandResult`	`simpleFastbootCommand(long timeout, envVarMap, String[] fullCmd)` Esegue un semplice comando fastboot con variabili di ambiente e segnala lo stato del comando.
`CommandResult`	`simpleFastbootCommand(long timeout, String[] fullCmd)` Esegue un semplice comando fastboot e segnala lo stato del comando.
`boolean`	`waitForDeviceNotAvailable(String operationDesc, long time)` Attendi che il dispositivo non sia più disponibile (interrompi la comunicazione con adb).

Costanti

DEBUGFS_PATH

public static final String DEBUGFS_PATH

Valore costante: "/sys/kernel/debug"

INVALID_USER_ID

public static final int INVALID_USER_ID

Valore restituito per qualsiasi ID utente non valido/non trovato: UserHandle ha definito il valore -10000

Valore costante: -10000 (0xffffd8f0)

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

Valore costante: 5000 (0x0000000000001388)

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

il numero predefinito di tentativi di ripetizione del comando da eseguire

Constant Value: 2 (0x00000002)

SD_CARD

protected static final String SD_CARD

Constant Value: "/sdcard/"

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

Constant Value: "/storage/emulated/"

Campi

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

Costruttori pubblici

NativeDevice

public NativeDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

Crea un TestDevice.

Parametri
`device`	`IDevice`: il `IDevice` associato
`stateMonitor`	`IDeviceStateMonitor`: il meccanismo `IDeviceStateMonitor` da utilizzare
`allocationMonitor`	`IDeviceMonitor`: l'`IDeviceMonitor` da informare delle modifiche dello stato di allocazione. Può essere null

Metodi pubblici

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

Micro ottimizzazione (circa 400 millisecondi) mediante il prefetching di tutte le proprietà necessarie anziché chiamare "adb getprop" per ciascuna. Ovvero, recuperare tutte le proprietà è veloce quanto recuperarne una sola. Funzioni come device.getApiLevel(), checkApiLevelAgainstNextRelease e getBuildAlias chiamano `adb getprop` in background. Li recuperiamo in una sola chiamata e chiamiamo NativeDevice.setProperty. Anche se non lo facciamo, NativeDevice chiamerà setProperty e memorizzerà nella cache il risultato per le chiamate future. Lo facciamo solo un po' prima. Se il dispositivo è in modalità di ripristino o si verificano altri errori durante il recupero delle proprietà, li ignoriamo.

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

Restituisce un valore che indica se è consentito passare all'utente di sistema headless.

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

checkApiLevelAgainstNextRelease

public 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
`DeviceNotAvailableException`

checkConnectivity

public boolean checkConnectivity ()

Verifica che il dispositivo abbia connettività di rete.

Ritorni
`boolean`	`true` se il dispositivo ha una connessione di rete funzionante, `false` altrimenti.

Lanci
`DeviceNotAvailableException`

clearErrorDialogs

public boolean clearErrorDialogs ()

Tenta di chiudere le finestre di dialogo di errore attualmente visualizzate nell'interfaccia utente del dispositivo.

Ritorni
`boolean`	`true` se non erano presenti dialoghi o se sono stati cancellati correttamente. `false` altrimenti.

Lanci
`DeviceNotAvailableException`

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

Cancella l'ultima rete Wi-Fi connessa. Questo metodo deve essere chiamato all'avvio di una nuova chiamata per evitare di connettersi alla rete Wi-Fi utilizzata nel test precedente dopo i riavvii del dispositivo.

clearLogcat

public 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).

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Si connette a una rete Wi-Fi.

Attiva il Wi-Fi e blocca la connessione finché non viene stabilita una connessione corretta con una delle reti Wi-Fi fornite nella mappa wifiSsidToPsk. Una volta stabilita una connessione, l'istanza tenterà di ripristinarla dopo ogni riavvio fino a quando non viene chiamato ITestDevice.disconnectFromWifi() o ITestDevice.clearLastConnectedWifiNetwork().

Parametri
`wifiSsidToPsk`	: una mappa degli SSID Wi-Fi e delle relative password.
`scanSsid`	`boolean`: indica se eseguire la scansione degli SSID nascosti per questa rete.

Ritorni
`boolean`	`true` se la connessione alla rete Wi-Fi è stata stabilita. `false` altrimenti

Lanci
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Si connette a una rete Wi-Fi.

Attiva il Wi-Fi e blocca l'operazione finché non viene stabilita una connessione alla rete Wi-Fi specificata. Una volta stabilita una connessione, l'istanza tenterà di ripristinarla dopo ogni riavvio fino a quando non viene chiamato ITestDevice.disconnectFromWifi() o ITestDevice.clearLastConnectedWifiNetwork().

Parametri
`wifiSsid`	`String`: l'SSID Wi-Fi a cui connettersi
`wifiPsk`	`String`: passphrase PSK o null se non criptata

Ritorni
`boolean`	`true` se la connessione alla rete Wi-Fi è stata stabilita. `false` altrimenti

Lanci
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk)

Si connette a una rete Wi-Fi.

Parametri
`wifiSsidToPsk`	: una mappa degli SSID Wi-Fi e delle relative password.

Ritorni
`boolean`	`true` se la connessione alla rete Wi-Fi è stata stabilita. `false` altrimenti

Lanci
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Si connette a una rete Wi-Fi.

Parametri
`wifiSsid`	`String`: l'SSID Wi-Fi a cui connettersi
`wifiPsk`	`String`: passphrase PSK o null se non criptata
`scanSsid`	`boolean`: indica se eseguire la scansione dell'SSID nascosto per questa rete.

Ritorni
`boolean`	`true` se la connessione alla rete Wi-Fi è stata stabilita. `false` altrimenti

Lanci
`DeviceNotAvailableException`

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Una variante di connectToWifiNetwork(String, String) che si connette solo se il dispositivo al momento non ha connettività di rete.

Parametri
`scanSsid`	`boolean`: indica se eseguire la scansione dell'SSID nascosto per questa rete

Ritorni
`boolean`	`true` se la connessione alla rete Wi-Fi è stata stabilita. `false` altrimenti

Lanci
`DeviceNotAvailableException`

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Una variante di connectToWifiNetwork(String, String) che si connette solo se il dispositivo al momento non ha connettività di rete.

Ritorni
`boolean`	`true` se la connessione alla rete Wi-Fi è stata stabilita. `false` altrimenti

Lanci
`DeviceNotAvailableException`

createUser

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

Crea un utente con un nome specificato e i flag forniti

Parametri
`name`	`String`: dell'utente da creare sul dispositivo
`guest`	`boolean`: attiva il flag utente --guest durante la creazione
`ephemeral`	`boolean`: attiva il flag utente --ephemeral durante la creazione

Ritorni
`int`	ID dell'utente creato

Lanci
`DeviceNotAvailableException`

createUser

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral, 
                boolean forTesting)

Crea un utente con un nome specificato e i flag forniti

Parametri
`name`	`String`: dell'utente da creare sul dispositivo
`guest`	`boolean`: attiva il flag utente --guest durante la creazione
`ephemeral`	`boolean`: attiva il flag utente --ephemeral durante la creazione
`forTesting`	`boolean`: attiva il flag di test --for-testing durante la creazione

Ritorni
`int`	ID dell'utente creato

Lanci
`DeviceNotAvailableException`

createUser

public int createUser (String name)

Crea un utente con un nome specificato e flag predefiniti 0.

Parametri
`name`	`String`: dell'utente da creare sul dispositivo

Ritorni
`int`	l'intero per l'ID utente creato

Lanci
`DeviceNotAvailableException`

createUserNoThrow

public int createUserNoThrow (String name)

Crea un utente con un nome specificato e flag predefiniti 0.

Parametri
`name`	`String`: dell'utente da creare sul dispositivo

Ritorni
`int`	l'intero per l'ID utente creato o -1 per errore.

Lanci
`DeviceNotAvailableException`

debugDeviceNotAvailable

public DeviceInspectionResult debugDeviceNotAvailable ()

Ispeziona un dispositivo e restituisci informazioni dettagliate quando un dispositivo non è più disponibile.

Ritorni
`DeviceInspectionResult`

deleteFile

public 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
`DeviceNotAvailableException`

deleteFile

public 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
`DeviceNotAvailableException`

deregisterDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Rimuove il IDeviceActionReceiver registrato.

Parametri
`deviceActionReceiver`	`IDeviceActionReceiver`: un `IDeviceActionReceiver` che verrà rimosso.

deviceSoftRestarted

public 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
`DeviceNotAvailableException`

deviceSoftRestartedSince

public 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
`DeviceNotAvailableException`

disableAdbRoot

public 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`

disableKeyguard

public void disableKeyguard ()

Tentativi di disattivare la protezione tasti.

Innanzitutto, attendi che l'invio dell'input sia pronto. Ciò avviene all'incirca nello stesso momento in cui il dispositivo segnala BOOT_COMPLETE, apparentemente in modo asincrono, perché l'attuale implementazione del framework presenta occasionalmente una condizione di competizione. Il comando viene inviato per chiudere Keyguard (funziona solo su quelli non sicuri)

Lanci
`DeviceNotAvailableException`

disableNetworkMonitor

public boolean disableNetworkMonitor ()

Disattiva il monitoraggio della rete sul dispositivo.

Ritorni
`boolean`	`true` se il monitoraggio è disattivato correttamente. `false` se non è andato a buon fine.

Lanci
`DeviceNotAvailableException`

disconnectFromWifi

public boolean disconnectFromWifi ()

Si disconnette da una rete Wi-Fi.

Rimuove tutte le reti dall'elenco delle reti note e disattiva il Wi-Fi.

Ritorni
`boolean`	`true` se la disconnessione dalla rete Wi-Fi è andata a buon fine. `false` se la disconnessione non è riuscita.

Lanci
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

Metodo helper per determinare se il file sul dispositivo esiste per un determinato utente.

Parametri
`deviceFilePath`	`String`: il percorso assoluto del file sul dispositivo da controllare
`userId`	`int`: l'ID utente rispetto al quale controllare l'esistenza del file

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

Lanci
`DeviceNotAvailableException`

doesFileExist

public 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`

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

Prova a scaricare l'heap da system_server. È responsabilità del chiamante pulire il file di dump.

Parametri
`process`	`String`: il nome del processo del dispositivo su cui eseguire dumpheap.
`devicePath`	`String`: il percorso sul dispositivo in cui inserire il dump. Deve trattarsi di una posizione in cui le autorizzazioni lo consentono.

Ritorni
`File`	il `ERROR(/File)` contenente il report. Null se si è verificato un errore.

Lanci
`DeviceNotAvailableException`

enableAdbRoot

public 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`

enableNetworkMonitor

public boolean enableNetworkMonitor ()

Attiva il monitoraggio della rete sul dispositivo.

Ritorni
`boolean`	`true` se il monitoraggio è stato abilitato correttamente. `false` se non è andato a buon fine.

Lanci
`DeviceNotAvailableException`

executeAdbCommand

public String executeAdbCommand (long timeout, 
                String... cmdArgs)

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
`cmdArgs`	`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`

executeAdbCommand

public String executeAdbCommand (long timeout, 
                 envMap, 
                String... cmdArgs)

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
`cmdArgs`	`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`

executeAdbCommand

public String executeAdbCommand (String... cmdArgs)

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
`cmdArgs`	`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`

executeAdbV2Command

public CommandResult executeAdbV2Command (String... cmdArgs)

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
`cmdArgs`	`String`: il comando adb e gli argomenti da eseguire

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

Lanci
`DeviceNotAvailableException`

executeAdbV2Command

public CommandResult executeAdbV2Command (long timeout, 
                String... cmdArgs)

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
`cmdArgs`	`String`: il comando adb e gli argomenti da eseguire

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

Lanci
`DeviceNotAvailableException`

executeAdbV2Command

public CommandResult executeAdbV2Command (long timeout, 
                 envMap, 
                String... cmdArgs)

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
`cmdArgs`	`String`: il comando adb e gli argomenti da eseguire

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

Lanci
`DeviceNotAvailableException`

executeFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

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
`cmdArgs`	`String`: il comando fastboot e gli argomenti da eseguire

Ritorni
`CommandResult`	CommandResult contenente l'output del comando

Lanci
`DeviceNotAvailableException`

executeFastbootCommand

public CommandResult executeFastbootCommand (long timeout, 
                String... cmdArgs)

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
`cmdArgs`	`String`: il comando fastboot e gli argomenti da eseguire

Ritorni
`CommandResult`	CommandResult contenente l'output del comando

Lanci
`DeviceNotAvailableException`

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

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
`cmdArgs`	`String`: il comando fastboot e gli argomenti da eseguire

Ritorni
`CommandResult`	CommandResult contenente l'output del comando

Lanci
`DeviceNotAvailableException`

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand ( envVarMap, 
                String... cmdArgs)

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
`cmdArgs`	`String`: il comando fastboot e gli argomenti da eseguire

Ritorni
`CommandResult`	CommandResult contenente l'output del comando

Lanci
`DeviceNotAvailableException`

executeShellCommand

public 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`

executeShellCommand

public 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`

executeShellCommand

public 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`

executeShellCommand

public 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`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd)

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
`cmd`	`String`: il comando da eseguire.

Ritorni
`CommandResult`	Il risultato in `CommandResult`.

Lanci
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                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
`cmd`	`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`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                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
`cmd`	`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`

executeShellV2Command

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

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

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

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

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

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

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                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
`cmd`	`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`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                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
`cmd`	`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`

fastbootWipePartition

public 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`

getActiveApexes

public  getActiveApexes ()

Recupera le informazioni sugli APEX attivati sul dispositivo.

Ritorni
	`ERROR(/Set)` di `ApexInfo` attualmente attivate sul dispositivo

Lanci
`DeviceNotAvailableException`

getAdbPath

public String getAdbPath ()

Restituisce il percorso del file binario adb in uso.

Ritorni
`String`

getAllSettings

public  getAllSettings (String namespace)

Restituisce le coppie chiave-valore dello spazio dei nomi richiesto.

Parametri
`namespace`	`String`: deve essere uno dei seguenti valori: {"system", "secure", "global"}

Ritorni
	la mappa delle coppie chiave-valore. Null se lo spazio dei nomi non è supportato.

Lanci
`DeviceNotAvailableException`

getAllocationState

public DeviceAllocationState getAllocationState ()

Restituisce lo stato di allocazione attuale del dispositivo

Ritorni
`DeviceAllocationState`

getAndroidId

public String getAndroidId (int userId)

Trova e restituisce l'android-id associato a un userId, null se non trovato.

Parametri
`userId`	`int`

Ritorni
`String`

Lanci
`DeviceNotAvailableException`

getAndroidIds

public  getAndroidIds ()

Crea una mappa degli ID Android trovati che corrispondono agli ID utente. Non è garantito che ogni ID utente trovi un ID Android associato in questa funzione, quindi alcuni ID utente potrebbero corrispondere a null.

Ritorni
	Mappa degli ID Android trovati che corrispondono agli ID utente.

Lanci
`DeviceNotAvailableException`

getApiLevel

public 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
`DeviceNotAvailableException`

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Recupera informazioni su un pacchetto installato sul dispositivo.

Parametri
`packageName`	`String`

Ritorni
`PackageInfo`	`PackageInfo` o `null` se non è stato possibile recuperare le informazioni

Lanci
`DeviceNotAvailableException`

getAppPackageInfos

public  getAppPackageInfos ()

Recupera le informazioni sui pacchetti installati sul dispositivo.

Ritorni
	`ERROR(/List)` di `PackageInfo` installate sul dispositivo.

Lanci
`DeviceNotAvailableException`

getBasebandVersion

public 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`

getBattery

public Integer getBattery ()

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

Ritorni
`Integer`

getBooleanProperty

public 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  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  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. 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 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`

getBugreport

public InputStreamSource getBugreport ()

Recupera una segnalazione di bug dal dispositivo.

L'implementazione di questa funzionalità è garantita per continuare a funzionare su un dispositivo senza scheda SD (o in cui la scheda SD non è ancora montata).

Ritorni
`InputStreamSource`	Un `InputStreamSource` che produrrà i contenuti del report bug on demand. In caso di errore, `InputStreamSource` produrrà un `ERROR(/InputStream)` vuoto.

getBugreportz

public InputStreamSource getBugreportz ()

Recupera un bugreportz dal dispositivo. Il report bug in formato zip contiene il report bug principale e altri file di log utili per il debug.

Supportato solo per "adb version" > 1.0.36

Ritorni
`InputStreamSource`	un `InputStreamSource` del file zip contenente bugreportz, restituisce null in caso di errore.

getBuildAlias

public 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
`DeviceNotAvailableException`

getBuildFlavor

public String getBuildFlavor ()

Recupera la variante di build per il dispositivo.

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

Lanci
`DeviceNotAvailableException`

getBuildId

public 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
`DeviceNotAvailableException`

getBuildSigningKeys

public 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
`DeviceNotAvailableException`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

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

Ritorni
`DeviceDescriptor`

getCachedDeviceDescriptor

public 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 String[] getChildren (String path)

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

Parametri
`path`	`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
`DeviceNotAvailableException`

getConnection

public AbstractConnection getConnection ()

La connessione attuale associata al dispositivo.

Ritorni
`AbstractConnection`

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

Restituisce ContentProviderHandler o null se non disponibile.

Il fornitore di contenuti può essere riutilizzato se è stato creato in precedenza con lo stesso userId.

Parametri
`userId`	`int`: l'ID utente con cui inizializzare il content provider.

Ritorni
`ContentProviderHandler`

Lanci
`DeviceNotAvailableException`

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

Restituisce lo stato attuale di piegatura del dispositivo o null se si sono verificati alcuni problemi.

Ritorni
`DeviceFoldableState`

Lanci
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

Restituisce l'ID dell'utente attualmente in esecuzione. In caso di errore, restituisci -10000.

Ritorni
`int`

Lanci
`DeviceNotAvailableException`

getDeviceClass

public String getDeviceClass ()

Recupera la classe del dispositivo.

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

getDeviceDate

public long getDeviceDate ()

Restituisce la data del dispositivo in millisecondi trascorsi da epoca.

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

Lanci
`DeviceNotAvailableException`

getDeviceDescriptor

public 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 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 TestDeviceState getDeviceState ()

Recupera lo stato del dispositivo.

Ritorni
`TestDeviceState`

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

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

Parametri
`date`	`Date`

Ritorni
`long`	la differenza in millisecondi

Lanci
`DeviceNotAvailableException`

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

Ottieni il flusso di stdout e stderr dell'emulatore

Ritorni
`InputStreamSource`	output dell'emulatore

getEmulatorProcess

public Process getEmulatorProcess ()

Restituisce l'Process corrispondente a questo emulatore.

Ritorni
`Process`	`Process` o `null`

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

Il log che contiene tutti i log executeShellCommand(String).

Ritorni
`File`

getExternalStoreFreeSpace

public 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`

getFastbootPath

public String getFastbootPath ()

Restituisce il percorso del binario fastboot in uso. Richiede comunque che isFastbootEnabled() sia true per abilitare le funzioni fastboot.

Ritorni
`String`

getFastbootProductType

public 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`

getFastbootProductVariant

public 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`

getFastbootSerialNumber

public String getFastbootSerialNumber ()

Restituisce il numero di serie della modalità fastboot.

Ritorni
`String`

getFastbootVariable

public 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
`DeviceNotAvailableException`

getFastbootVersion

public String getFastbootVersion ()

Restituisce la stringa della versione del binario fastboot in uso. o null se si verifica un problema.

Ritorni
`String`

getFileEntry

public 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
`DeviceNotAvailableException`

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

Helper non ufficiale per ottenere un FileEntry da un percorso non root. FIXME: Refactor the FileEntry system to have it available from any path. (anche non root).

Parametri
`entry`	`FileListingService.FileEntry`: un `FileEntry` non necessariamente root come richiesto da Ddmlib.

Ritorni
`IFileEntry`	un FileEntryWrapper che rappresenta FileEntry.

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

getFoldableStates

public  getFoldableStates ()

Restituisce l'elenco degli stati di piegatura sul dispositivo. Può essere ottenuto con "cmd device_state print-states".

Ritorni

Lanci
`DeviceNotAvailableException`

getIDevice

public 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`

getInstalledPackageNames

public  getInstalledPackageNames ()

Recupera i nomi dei pacchetti delle applicazioni presenti sul dispositivo.

Ritorni
	`ERROR(/Set)` dei nomi di pacchetto `String` attualmente installati sul dispositivo.

Lanci
`DeviceNotAvailableException`

getIntProperty

public 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`

getIpAddress

public String getIpAddress ()

Recupera l'indirizzo IP del dispositivo.

Ritorni
`String`	l'indirizzo IP del dispositivo o `null` se il dispositivo non ha un indirizzo IP

Lanci
`DeviceNotAvailableException`

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Restituisce un oggetto per ottenere lo stato attuale del keyguard o null se non è supportato.

Ritorni
`KeyguardControllerState`	un `KeyguardControllerState` contenente uno snapshot dello stato del Keyguard e restituisce Null se la query Keyguard non è supportata.

Lanci
`DeviceNotAvailableException`

getLastExpectedRebootTimeMillis

public 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 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
`DeviceNotAvailableException`

getLogcat

public 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 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 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 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`

getMacAddress

public String getMacAddress ()

Restituisce l'indirizzo MAC del dispositivo, null se la query dal dispositivo non va a buon fine.

Ritorni
`String`

getMainUserId

public Integer getMainUserId ()

Restituisce l'ID utente principale.

Ritorni
`Integer`	l'ID utente dell'utente principale, se presente, e null se non è presente alcun utente principale.

Lanci
`DeviceNotAvailableException`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

Recupera le informazioni sui moduli mainline installati sul dispositivo.

Ritorni
	`ERROR(/Set)` dei moduli mainline `String` attualmente installati sul dispositivo.

Lanci
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

Ottieni il numero massimo di utenti supportati in esecuzione simultanea. Il valore predefinito è 0.

Ritorni
`int`	un numero intero che indica il numero di utenti in esecuzione simultanea

Lanci
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

Ottieni il numero massimo di utenti supportati. Il valore predefinito è 0.

Ritorni
`int`	un numero intero che indica il numero di utenti supportati

Lanci
`DeviceNotAvailableException`

getMicrodroidProcess

public Process getMicrodroidProcess ()

Ritorni
`Process`	Restituisce il processo della VM Microdroid. Se TestDevice non è un Microdroid, restituisce null.

getMonitor

public IDeviceStateMonitor getMonitor ()

Restituisci l'IDeviceStateMonitor associato al dispositivo.

Ritorni
`IDeviceStateMonitor`

getMountPoint

public 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`

getMountPointInfo

public 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`

getMountPointInfo

public  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`

getOptions

public TestDeviceOptions getOptions ()

Recupera le opzioni di test per il dispositivo.

Ritorni
`TestDeviceOptions`	`TestDeviceOptions` relativi al dispositivo in fase di test.

getPartitionFreeSpace

public 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`

getPrimaryUserId

public Integer getPrimaryUserId ()

Restituisce l'ID utente principale.

Ritorni
`Integer`	l'ID utente dell'utente principale, se presente, e null in caso contrario.

Lanci
`DeviceNotAvailableException`

getProcessByName

public 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 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 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`

getProductVariant

public 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`

getProperty

public 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
`DeviceNotAvailableException`

getRecoveryMode

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

getScreenshot

public InputStreamSource getScreenshot (long displayId)

Acquisisce uno screenshot dal dispositivo dato l'ID display. Il formato è PNG.

TODO: extend the implementations above to support 'format' and 'rescale'

Parametri
`displayId`	`long`: l'ID display della schermata da cui acquisire lo screenshot.

Ritorni
`InputStreamSource`	un `InputStreamSource` dello screenshot nel formato o `null` se lo screenshot non è andato a buon fine.

Lanci
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format)

Acquisisce uno screenshot dal dispositivo. Consigliamo di utilizzare getScreenshot(format) con codifica JPEG per dimensioni più ridotte

Parametri
`format`	`String`: PNG, JPEG supportati

Ritorni
`InputStreamSource`	un `InputStreamSource` dello screenshot nel formato o `null` se lo screenshot non è andato a buon fine.

Lanci
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

Acquisisce uno screenshot dal dispositivo. Consigliamo di utilizzare getScreenshot(String) con codifica JPEG per dimensioni più ridotte.

Parametri
`format`	`String`: PNG, JPEG supportati
`rescale`	`boolean`: se lo screenshot deve essere ridimensionato per ridurre le dimensioni dell'immagine risultante

Ritorni
`InputStreamSource`	un `InputStreamSource` dello screenshot nel formato o `null` se lo screenshot non è andato a buon fine.

Lanci
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot ()

Acquisisce uno screenshot dal dispositivo.

Ritorni
`InputStreamSource`	un `InputStreamSource` dello screenshot in formato PNG o `null` se lo screenshot non è andato a buon fine.

Lanci
`DeviceNotAvailableException`

getSerialNumber

public String getSerialNumber ()

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

Ritorni
`String`	il numero di serie `String`

getSetting

public String getSetting (int userId, 
                String namespace, 
                String key)

Restituisce il valore dell'impostazione richiesta. lo spazio dei nomi deve essere uno dei seguenti: {"system", "secure", "global"}

Parametri
`userId`	`int`
`namespace`	`String`
`key`	`String`

Ritorni
`String`	il valore associato a namespace:key di un utente. Null se non trovato.

Lanci
`DeviceNotAvailableException`

getSetting

public String getSetting (String namespace, 
                String key)

Consulta getSetting(int, String, String) ed eseguita sull'utente di sistema.

Parametri
`namespace`	`String`
`key`	`String`

Ritorni
`String`

Lanci
`DeviceNotAvailableException`

getSimOperator

public String getSimOperator ()

Restituisce l'operatore della scheda SIM o null se non disponibile o se il dispositivo non è disponibile.

Ritorni
`String`

getSimState

public String getSimState ()

Restituisce lo stato della scheda SIM o null se non disponibile o se il dispositivo non è disponibile.

Ritorni
`String`

getTombstones

public  getTombstones ()

Recupera e restituisci l'elenco dei segnali di chiusura 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`

getTotalMemory

public 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`

getUninstallablePackageNames

public  getUninstallablePackageNames ()

Recupera i nomi dei pacchetti dell'applicazione che possono essere disinstallati. Attualmente sono definiti come pacchetti non di sistema e pacchetti di sistema aggiornati.

Ritorni
	`ERROR(/Set)` dei nomi dei pacchetti `String` disinstallabili attualmente installati sul dispositivo.

Lanci
`DeviceNotAvailableException`

getUseFastbootErase

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

getUserFlags

public int getUserFlags (int userId)

Trova e restituisci i flag di un determinato utente. I flag sono definiti nella classe "android.content.pm.UserInfo" in Android Open Source Project.

Parametri
`userId`	`int`

Ritorni
`int`	i flag associati all'ID utente fornito, se trovato, -10000 in tutti gli altri casi.

Lanci
`DeviceNotAvailableException`

getUserInfos

public  getUserInfos ()

Recupera la mappa di useId per UserInfo sul dispositivo. Genererà DeviceRuntimeException se l'output del dispositivo non è quello previsto.

Ritorni
	l'elenco degli oggetti UserInfo.

Lanci
`DeviceNotAvailableException`

getUserSerialNumber

public int getUserSerialNumber (int userId)

Restituisce il numero di serie associato all'ID utente se trovato, -10000 in tutti gli altri casi.

Parametri
`userId`	`int`

Ritorni
`int`

Lanci
`DeviceNotAvailableException`

handleAllocationEvent

public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

Elabora l'oggetto DeviceEvent specificato. Potrebbe essere necessario impostare un nuovo stato per il dispositivo. Informerà IDeviceMonitor di eventuali transizioni di stato.

Elabora DeviceEvent, che potrebbe o meno trasferire questo dispositivo a un nuovo stato di allocazione.

Parametri
`event`	`DeviceEvent`

Ritorni
`IManagedTestDevice.DeviceEventResponse`

hasFeature

public boolean hasFeature (String feature)

Controllare se una funzionalità è disponibile su un dispositivo.

Parametri
`feature`	`String`: il cui formato deve essere "feature:" o "" direttamente.

Ritorni
`boolean`	Vero se la funzionalità viene trovata, falso in caso contrario.

Lanci
`DeviceNotAvailableException`

initializeConnection

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

Inizializza la connessione al dispositivo. Viene chiamato da preInvocationSetup, ma in rari casi potrebbe essere necessario chiamarlo separatamente durante la creazione della connessione durante la configurazione del dispositivo.

Parametri
`info`	`IBuildInfo`
`attributes`	`MultiMap`

Lanci
`DeviceNotAvailableException`
`TargetSetupError`

installPackage

public String installPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

Installa un pacchetto Android sul dispositivo.

Parametri
`packageFile`	`File`: il file apk da installare
`reinstall`	`boolean`: `true` se deve essere eseguita una reinstallazione
`extraArgs`	`String`: argomenti aggiuntivi facoltativi da passare. Per le opzioni disponibili, vedi "adb shell pm -h".

Ritorni
`String`	un `String` con un codice di errore o `null` in caso di esito positivo.

Lanci
`DeviceNotAvailableException`

installPackage

public String installPackage (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Installa un pacchetto Android sul dispositivo.

Nota: chiama questa funzione solo i casi d'uso che richiedono il controllo esplicito della concessione dell'autorizzazione runtime al momento dell'installazione.

Parametri
`packageFile`	`File`: il file apk da installare
`reinstall`	`boolean`: `true` se deve essere eseguita una reinstallazione
`grantPermissions`	`boolean`: se tutte le autorizzazioni di runtime devono essere concesse al momento dell'installazione
`extraArgs`	`String`: argomenti aggiuntivi facoltativi da passare. Per le opzioni disponibili, vedi "adb shell pm -h".

Ritorni
`String`	un `String` con un codice di errore o `null` in caso di esito positivo.

Lanci
`DeviceNotAvailableException`

installPackageForUser

public String installPackageForUser (File packageFile, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

Installa un pacchetto Android sul dispositivo per un determinato utente.

Parametri
`packageFile`	`File`: il file apk da installare
`reinstall`	`boolean`: `true` se deve essere eseguita una reinstallazione
`userId`	`int`: l'ID utente intero da installare.
`extraArgs`	`String`: argomenti aggiuntivi facoltativi da passare. Per le opzioni disponibili, vedi "adb shell pm -h".

Ritorni
`String`	un `String` con un codice di errore o `null` in caso di esito positivo.

Lanci
`DeviceNotAvailableException`

installPackageForUser

public String installPackageForUser (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

Installa un pacchetto Android sul dispositivo per un determinato utente.

Nota: chiama questa funzione solo i casi d'uso che richiedono il controllo esplicito della concessione dell'autorizzazione runtime al momento dell'installazione.

Parametri
`packageFile`	`File`: il file apk da installare
`reinstall`	`boolean`: `true` se deve essere eseguita una reinstallazione
`grantPermissions`	`boolean`: se tutte le autorizzazioni di runtime devono essere concesse al momento dell'installazione
`userId`	`int`: l'ID utente intero da installare.
`extraArgs`	`String`: argomenti aggiuntivi facoltativi da passare. Per le opzioni disponibili, vedi "adb shell pm -h".

Ritorni
`String`	un `String` con un codice di errore o `null` in caso di esito positivo.

Lanci
`DeviceNotAvailableException`

installPackageWithIncrementalMode

public boolean installPackageWithIncrementalMode (File[] apkFiles, 
                String[] extraArgs, 
                String userId)

Installa APK con modalità incrementale.

Parametri
`apkFiles`	`File`: i file APK da installare.
`extraArgs`	`String`
`userId`	`String`

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

invalidatePropertyCache

public void invalidatePropertyCache ()

isAdbRoot

public boolean isAdbRoot ()

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isAdbTcp

public boolean isAdbTcp ()

Ritorni
`boolean`

isAppEnumerationSupported

public 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
`DeviceNotAvailableException`

isBypassLowTargetSdkBlockSupported

public 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
`DeviceNotAvailableException`

isDebugfsMounted

public boolean isDebugfsMounted ()

Controlla se debugfs è montato.

Ritorni
`boolean`	`true` se debugfs è montato

Lanci
`DeviceNotAvailableException`

isDeviceEncrypted

public boolean isDeviceEncrypted ()

Indica se il dispositivo è criptato.

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

Lanci
`DeviceNotAvailableException`

isDirectory

public boolean isDirectory (String path)

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

Parametri
`path`	`String`

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isEnableAdbRoot

public boolean isEnableAdbRoot ()

Ritorni
`boolean`	`true` se l'accesso root adb deve essere abilitato sul dispositivo

isEncryptionSupported

public boolean isEncryptionSupported ()

Indica se la crittografia è supportata sul dispositivo.

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

Lanci
`DeviceNotAvailableException`

isExecutable

public 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
`DeviceNotAvailableException`

isFastbootEnabled

public boolean isFastbootEnabled ()

Restituisce un valore se fastboot è disponibile per il dispositivo.

Ritorni
`boolean`

isHeadless

public boolean isHeadless ()

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

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

Indica se il dispositivo utilizza la modalità headless system user.

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

Restituisce un valore che indica se l'utente principale è un amministratore permanente e non può essere eliminato o declassato a utente non amministratore.

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isMultiUserSupported

public boolean isMultiUserSupported ()

Determina se è supportato l'utilizzo di più utenti.

Ritorni
`boolean`	true se è supportato più utenti, false in caso contrario

Lanci
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

Esegui una query sul dispositivo per un determinato nome del pacchetto e un determinato ID utente per verificare se l'app è attualmente installata o meno per quell'utente.

Parametri
`packageName`	`String`: il pacchetto di cui stiamo verificando l'installazione.
`userId`	`String`: l'ID utente per cui stiamo verificando che il pacchetto sia installato. Se è null, verrà utilizzato zero per l'utente principale.

Ritorni
`boolean`	Vero se il pacchetto è segnalato come installato. Falso negli altri casi.

Lanci
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName)

Esegui una query sul dispositivo per un determinato nome di pacchetto per verificare se è attualmente installato o meno.

Parametri
`packageName`	`String`

Ritorni
`boolean`	Vero se il pacchetto è segnalato come installato. Falso negli altri casi.

Lanci
`DeviceNotAvailableException`

isRuntimePermissionSupported

public 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
`DeviceNotAvailableException`

isStateBootloaderOrFastbootd

public boolean isStateBootloaderOrFastbootd ()

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

Ritorni
`boolean`

isUserRunning

public boolean isUserRunning (int userId)

Controlla se un determinato utente è in esecuzione.

Parametri
`userId`	`int`

Ritorni
`boolean`	Vero se l'utente sta correndo, falso in tutti gli altri casi.

Lanci
`DeviceNotAvailableException`

isUserSecondary

public boolean isUserSecondary (int userId)

Restituisce un valore che indica se l'utente specificato è un utente secondario in base ai relativi flag.

Parametri
`userId`	`int`

Ritorni
`boolean`	true se l'utente è secondario, false in caso contrario.

Lanci
`DeviceNotAvailableException`

isUserVisible

public boolean isUserVisible (int userId)

Verifica se l'utente specificato è visibile.

Un utente "visibile" è un utente che interagisce con l'utente "umano" e quindi è in grado di avviare attività (in genere nella visualizzazione predefinita).

Parametri
`userId`	`int`

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Verifica se l'utente specificato è visibile nella visualizzazione indicata.

Un utente "visibile" è un utente che interagisce con l'utente "umano" e quindi è in grado di avviare attività di avvio in quel display.

Parametri
`userId`	`int`
`displayId`	`int`

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Restituisce un valore che indica se il dispositivo consente agli utenti di essere avviati in modo visibile in background in ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

In questo caso, puoi chiamare il numero startVisibleBackgroundUser(int, int, boolean), passando un display restituito da listDisplayIdsForStartingVisibleBackgroundUsers() (che dovrebbe includere ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

Restituisce un valore che indica se il dispositivo consente l'avvio visibile in background.

In questo caso, puoi chiamare startVisibleBackgroundUser(int, int, boolean), passando un display restituito da listDisplayIdsForStartingVisibleBackgroundUsers().

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isWifiEnabled

public boolean isWifiEnabled ()

Verifica se il Wi-Fi è attivo.

Controlla se il Wi-Fi è attivo sul dispositivo. Utile per verificare lo stato del Wi-Fi prima dei test che non devono essere eseguiti con il Wi-Fi, ad esempio i test dei dati mobili.

Ritorni
`boolean`	`true` se il Wi-Fi è attivo. `false` se disattivato

Lanci
`DeviceNotAvailableException`

listDisplayIds

public  listDisplayIds ()

Raccogli l'elenco degli ID display disponibili sul dispositivo come riportato da "dumpsys SurfaceFlinger".

Ritorni
	L'elenco dei display. Default restituisce sempre il display predefinito 0.

Lanci
`DeviceNotAvailableException`

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

Recupera l'elenco dei display che possono essere utilizzati per start a user visible in the background.

Ritorni

Lanci
`DeviceNotAvailableException`

listUsers

public  listUsers ()

Recupera l'elenco degli utenti sul dispositivo. Genererà DeviceRuntimeException se l'output del dispositivo non è quello previsto.

Ritorni
	l'elenco degli ID utente.

Lanci
`DeviceNotAvailableException`

logAnrs

public 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`

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

Metodo helper per acquisire una segnalazione di bug e registrarla per i reporter.

Parametri
`dataName`	`String`: il nome con cui verrà segnalato il report bug.
`listener`	`ITestLogger`: un `ITestLogger` per registrare la segnalazione di bug.

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

logOnDevice

public 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 void mountDebugfs ()

Monta debugfs.

Lanci
`DeviceNotAvailableException`

nonBlockingReboot

public 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
`DeviceNotAvailableException`

postAdbRootAction

public void postAdbRootAction ()

Esegui l'override se il dispositivo richiede alcune azioni specifiche da intraprendere dopo l'accesso root adb e prima che il dispositivo torni online. L'implementazione predefinita non include azioni aggiuntive. Non è garantito che adb root sia abilitato in questa fase.

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

postAdbUnrootAction

public void postAdbUnrootAction ()

Esegui l'override se il dispositivo richiede alcune azioni specifiche da intraprendere dopo l'annullamento del root di ADB e prima che il dispositivo torni online. L'implementazione predefinita non include azioni aggiuntive. Non è garantito che adb root sia disattivato in questa fase.

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

postBootSetup

public 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`

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

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

Parametri
`exception`	`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
`DeviceNotAvailableException`
`TargetSetupError`

pullDir

public 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`

pullDir

public 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`

pullFile

public 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`

pullFile

public 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`

pullFile

public 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`

pullFile

public 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`

pullFileContents

public 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 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`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                 excludedDirectories)

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

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

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath)

Esegue il push ricorsivo dei contenuti della directory sul dispositivo.

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

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                int userId)

Esegue il push ricorsivo dei contenuti della directory sul dispositivo.

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

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath, 
                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
`remoteFilePath`	`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`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath)

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

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

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

Lanci
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath, 
                int userId)

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

Parametri
`localFile`	`File`: il file locale da inviare
`remoteFilePath`	`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`

pushString

public boolean pushString (String contents, 
                String remoteFilePath)

Inviare al dispositivo il file creato da una stringa

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

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

Lanci
`DeviceNotAvailableException`

fai ripartire

public 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`

fai ripartire

public void reboot ()

Riavvia il dispositivo in modalità ADB.

Blocca fino a quando il dispositivo non diventa disponibile.

Lanci
`DeviceNotAvailableException`

rebootIntoBootloader

public void rebootIntoBootloader ()

Riavvia il dispositivo in modalità bootloader.

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

Lanci
`DeviceNotAvailableException`

rebootIntoFastbootd

public void rebootIntoFastbootd ()

Riavvia il dispositivo in modalità fastbootd.

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

Lanci
`DeviceNotAvailableException`

rebootIntoRecovery

public void rebootIntoRecovery ()

Riavvia il dispositivo in modalità di ripristino ADB.

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

Lanci
`DeviceNotAvailableException`

rebootIntoSideload

public 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

Lanci
`DeviceNotAvailableException`

rebootIntoSideload

public 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

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

Lanci
`DeviceNotAvailableException`

rebootUntilOnline

public void rebootUntilOnline ()

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

Lanci
`DeviceNotAvailableException`

rebootUntilOnline

public 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`

rebootUserspace

public 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`

rebootUserspaceUntilOnline

public void rebootUserspaceUntilOnline ()

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

Lanci
`DeviceNotAvailableException`

recoverDevice

public boolean recoverDevice ()

Tenta di ripristinare la comunicazione con il dispositivo.

Ritorni
`boolean`	Vero se il recupero è stato tentato e riuscito, restituisce False se il recupero è stato ignorato

Lanci
`DeviceNotAvailableException`	se il dispositivo non è più disponibile

registerDeviceActionReceiver

public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registra un IDeviceActionReceiver per questo dispositivo.

Tutti i IDeviceActionReceiver registrati riceveranno una notifica prima dell'inizio e dopo la fine di un'azione del dispositivo.

Parametri
`deviceActionReceiver`	`IDeviceActionReceiver`: un `IDeviceActionReceiver` che verrà registrato.

remountSystemReadOnly

public void remountSystemReadOnly ()

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

Lanci
`DeviceNotAvailableException`

remountSystemWritable

public void remountSystemWritable ()

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

Lanci
`DeviceNotAvailableException`

remountVendorReadOnly

public void remountVendorReadOnly ()

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

Lanci
`DeviceNotAvailableException`

remountVendorWritable

public void remountVendorWritable ()

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

Lanci
`DeviceNotAvailableException`

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

Rimuovi l'amministratore del dispositivo specificato nell'utente specificato e restituisci true se l'operazione ha esito positivo, false in caso contrario.

Parametri
`componentName`	`String`: dell'amministratore del dispositivo da rimuovere.
`userId`	`int`: dell'utente in cui si trova l'amministratore del dispositivo.

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

Lanci
`DeviceNotAvailableException`

removeOwners

public void removeOwners ()

Rimuovi tutti i proprietari dei profili dei dispositivi esistenti con il massimo impegno.

Lanci
`DeviceNotAvailableException`

removeUser

public boolean removeUser (int userId)

Rimuovere un determinato utente dal dispositivo.

Parametri
`userId`	`int`: dell'utente da rimuovere

Ritorni
`boolean`	true se la rimozione dell'utente è riuscita, false in caso contrario.

Lanci
`DeviceNotAvailableException`

resetContentProviderSetup

public void resetContentProviderSetup ()

Reimposta il flag per la configurazione del fornitore di contenuti per attivarlo di nuovo.

runInstrumentationTests

public 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`

runInstrumentationTests

public 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`

runInstrumentationTestsAsUser

public 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 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`

setAdbPath

public void setAdbPath (String adbPath)

Imposta il percorso del file binario adb da utilizzare.

Parametri
`adbPath`	`String`

setConfiguration

public void setConfiguration (IConfiguration configuration)

Inserisce il IConfiguration in uso.

Parametri
`configuration`	`IConfiguration`

setConnectionAvdInfo

public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

Parametri
`avdInfo`	`GceAvdInfo`

setDate

public 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
`DeviceNotAvailableException`

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

Imposta un componente di amministrazione del dispositivo come proprietario del dispositivo per un determinato utente.

Parametri
`componentName`	`String`: dell'amministratore del dispositivo per diventare il proprietario del dispositivo.
`userId`	`int`: dell'utente in cui vive il proprietario del dispositivo.

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

Lanci
`DeviceNotAvailableException`

setDeviceState

public void setDeviceState (TestDeviceState deviceState)

Aggiorna lo stato del dispositivo.

Parametri
`deviceState`	`TestDeviceState`: il `TestDeviceState`

setEmulatorOutputStream

public void setEmulatorOutputStream (SizeLimitedOutputStream output)

Per l'emulatore, imposta SizeLimitedOutputStream per registrare l'output

Parametri
`output`	`SizeLimitedOutputStream`: per registrare l'output

setEmulatorProcess

public void setEmulatorProcess (Process p)

Imposta Process quando questo dispositivo è un emulatore.

Parametri
`p`	`Process`

setFastbootEnabled

public void setFastbootEnabled (boolean fastbootEnabled)

Imposta l'opzione fastboot per il dispositivo. Deve essere impostato quando il dispositivo viene allocato per la prima volta.

Parametri
`fastbootEnabled`	`boolean`: indica se fastboot è disponibile per il dispositivo

setFastbootPath

public void setFastbootPath (String fastbootPath)

Imposta il percorso del file binario fastboot da utilizzare. Richiede comunque che isFastbootEnabled() sia true per abilitare le funzioni fastboot.

Parametri
`fastbootPath`	`String`

setIDevice

public void setIDevice (IDevice newDevice)

Aggiorna l'iDevice associato a questo ITestDevice.

Il nuovo IDevice deve fare riferimento allo stesso dispositivo fisico del riferimento attuale. Questo metodo verrà chiamato se DDMS ha allocato un nuovo IDevice

Parametri
`newDevice`	`IDevice`: il `IDevice`

setLogStartDelay

public void setLogStartDelay (int delay)

Imposta il tempo in millisecondi da attendere prima di avviare l'acquisizione di logcat per un dispositivo online.

Parametri
`delay`	`int`: il ritardo in ms

setOptions

public void setOptions (TestDeviceOptions options)

Imposta TestDeviceOptions per il dispositivo

Parametri
`options`	`TestDeviceOptions`

setProperty

public 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
`DeviceNotAvailableException`

setRecovery

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

setSetting

public void setSetting (String namespace, 
                String key, 
                String value)

Consulta setSetting(int, String, String, String) ed eseguita sull'utente di sistema.

Parametri
`namespace`	`String`
`key`	`String`
`value`	`String`

Lanci
`DeviceNotAvailableException`

setSetting

public void setSetting (int userId, 
                String namespace, 
                String key, 
                String value)

Aggiungi un valore di impostazione allo spazio dei nomi di un determinato utente. Alcune impostazioni saranno disponibili solo dopo un riavvio. lo spazio dei nomi deve essere uno dei seguenti: {"system", "secure", "global"}

Parametri
`userId`	`int`
`namespace`	`String`
`key`	`String`
`value`	`String`

Lanci
`DeviceNotAvailableException`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

Inserisce l'istanza ITestLogger

Parametri
`testLogger`	`ITestLogger`

setTrackingSerial

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

startLogcat

public 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 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`

startUser

public boolean startUser (int userId)

Avvia un determinato utente in background se è attualmente arrestato. Se l'utente è già in esecuzione in background, questo metodo è un'operazione NOOP.

Parametri
`userId`	`int`: dell'utente da avviare in background

Ritorni
`boolean`	true se l'utente è stato avviato correttamente in background.

Lanci
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

Avvia un determinato utente in background se è attualmente arrestato. Se l'utente è già in esecuzione in background, questo metodo è un'operazione NOOP. È possibile fornire un flag aggiuntivo per attendere che l'operazione abbia effetto.

Parametri
`userId`	`int`: dell'utente da avviare in background
`waitFlag`	`boolean`: il comando attenderà l'avvio e lo sblocco dell'utente.

Ritorni
`boolean`	true se l'utente è stato avviato correttamente in background.

Lanci
`DeviceNotAvailableException`

startVisibleBackgroundUser

public boolean startVisibleBackgroundUser (int userId, 
                int displayId, 
                boolean waitFlag)

Avvia un determinato utente in background, visibile nel display specificato (ovvero, consente all'utente di avviare attività in quel display).

NOTA : questo comando non verifica se l'utente esiste, se la visualizzazione è disponibile, device supports such feature e così via.

Parametri
`userId`	`int`: dell'utente da avviare in background
`displayId`	`int`: display to start user visible on
`waitFlag`	`boolean`: il comando attenderà l'avvio e lo sblocco dell'utente.

Ritorni
`boolean`	`true` se l'utente è stato avviato correttamente in background.

Lanci
`DeviceNotAvailableException`

stopEmulatorOutput

public void stopEmulatorOutput ()

Chiudi ed elimina l'output dell'emulatore.

stopLogcat

public void stopLogcat ()

Interrompe 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 void stopTradeInModeTesting ()

Interrompi il test della modalità permuta.

Lanci
`DeviceNotAvailableException`

stopUser

public boolean stopUser (int userId)

Interrompe un determinato utente. Se l'utente è già stato arrestato, questo metodo è un'operazione NOOP. Impossibile interrompere l'utente corrente e l'utente di sistema.

Parametri
`userId`	`int`: dell'utente da arrestare.

Ritorni
`boolean`	true se l'utente è stato interrotto.

Lanci
`DeviceNotAvailableException`

stopUser

public boolean stopUser (int userId, 
                boolean waitFlag, 
                boolean forceFlag)

Interrompi un determinato utente. È possibile fornire flag aggiuntivi per attendere che l'operazione abbia effetto e forzare la chiusura dell'utente. Impossibile interrompere l'utente corrente e l'utente di sistema.

Parametri
`userId`	`int`: dell'utente da arrestare.
`waitFlag`	`boolean`: il comando attende che l'utente si fermi.
`forceFlag`	`boolean`: forzerà l'interruzione dell'utente.

Ritorni
`boolean`	true se l'utente è stato interrotto.

Lanci
`DeviceNotAvailableException`

switchToAdbTcp

public String switchToAdbTcp ()

Passa alla modalità adb-over-tcp.

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

Lanci
`DeviceNotAvailableException`

switchToAdbUsb

public boolean switchToAdbUsb ()

Passa alla modalità adb su USB.

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

Lanci
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId)

Passa a un altro userId con un timeout predefinito. switchUser(int, long).

Parametri
`userId`	`int`

Ritorni
`boolean`	Vero se il nuovo userId corrisponde al fornitore di userId. Falso negli altri casi.

Lanci
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId, 
                long timeout)

Passa a un altro userId con il timeout fornito come scadenza. Tentativo di disattivare il keyguard dopo la modifica dell'utente.

Parametri
`userId`	`int`
`timeout`	`long`: per attendere prima di restituire false per il cambio utente non riuscito.

Ritorni
`boolean`	Vero se il nuovo userId corrisponde al fornitore di userId. Falso negli altri casi.

Lanci
`DeviceNotAvailableException`

syncFiles

public 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`

takeBugreport

public Bugreport takeBugreport ()

Prende una segnalazione di bug e la restituisce all'interno di un oggetto Bugreport per gestirla. Restituisce null in caso di problemi. Il file a cui viene fatto riferimento nell'oggetto Bugreport deve essere pulito tramite Bugreport.close().

Ritorni
`Bugreport`

uninstallPackage

public String uninstallPackage (String packageName)

Disinstalla un pacchetto Android dal dispositivo.

Parametri
`packageName`	`String`: il pacchetto Android da disinstallare

Ritorni
`String`	un `String` con un codice di errore o `null` in caso di esito positivo.

Lanci
`DeviceNotAvailableException`

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

Disinstalla un pacchetto Android dal dispositivo per un determinato utente.

Parametri
`packageName`	`String`: il pacchetto Android da disinstallare
`userId`	`int`: l'ID utente intero da disinstallare.

Ritorni
`String`	un `String` con un codice di errore o `null` in caso di esito positivo.

Lanci
`DeviceNotAvailableException`

unlockDevice

public 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`

unmountDebugfs

public void unmountDebugfs ()

Smonta debugfs.

Lanci
`DeviceNotAvailableException`

waitForBootComplete

public 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
`DeviceNotAvailableException`

waitForDeviceAvailable

public 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`

waitForDeviceAvailable

public 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`

waitForDeviceAvailableInRecoverPath

public 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`

waitForDeviceBootloader

public void waitForDeviceBootloader ()

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

Lanci
`DeviceNotAvailableException`

waitForDeviceFastbootD

public void waitForDeviceFastbootD ()

Lanci
`DeviceNotAvailableException`

waitForDeviceInRecovery

public 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 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 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 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`

waitForDeviceOnline

public 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`

waitForDeviceShell

public 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`.

Metodi protetti

addExtraConnectionBuilderArgs

protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

Parametri
`builder`	`DefaultConnection.ConnectionBuilder`

buildAdbShellCommand

protected String[] buildAdbShellCommand (String command, 
                boolean forceExitStatusDetection)

Crea il comando del sistema operativo per la sessione e gli argomenti del comando adb shell specificati

Parametri
`command`	`String`
`forceExitStatusDetection`	`boolean`

Ritorni
`String[]`

checkApiLevelAgainst

protected void checkApiLevelAgainst (String feature, 
                int strictMinLevel)

Parametri
`feature`	`String`
`strictMinLevel`	`int`

createRebootDeviceAction

protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, 
                String reason)

Crea un RebootDeviceAction da utilizzare quando esegui un'azione di riavvio.

Parametri
`rebootMode`	`NativeDevice.RebootMode`: una modalità di questo riavvio.
`reason`	`String`: per questo riavvio.

Ritorni
`NativeDevice.RebootDeviceAction`	il `RebootDeviceAction` creato.

createRunUtil

protected IRunUtil createRunUtil ()

Ritorni
`IRunUtil`

doAdbReboot

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

Esegui un riavvio ADB.

Parametri
`rebootMode`	`NativeDevice.RebootMode`: una modalità di questo riavvio.
`reason`	`String`: per questo riavvio.

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

ensureRuntimePermissionSupported

protected void ensureRuntimePermissionSupported ()

metodo helper per generare un'eccezione se l'autorizzazione di runtime non è supportata

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

getApiLevelSafe

protected int getApiLevelSafe ()

Ritorni
`int`

getLogger

protected ITestLogger getLogger ()

Ritorni
`ITestLogger`

getRunUtil

protected IRunUtil getRunUtil ()

Ottieni l'istanza RunUtil da utilizzare.

Ritorni
`IRunUtil`

internalGetProperty

protected String internalGetProperty (String propName, 
                String fastbootVar, 
                String description)

Recupera una proprietà del dispositivo dalla cache ddmlib per impostazione predefinita e torna a `adb shell getprop` o `fastboot getvar` a seconda che il dispositivo sia in modalità Fastboot o meno.

Parametri
`propName`	`String`: il nome della proprietà del dispositivo restituito da `adb shell getprop`
`fastbootVar`	`String`: Il nome della variabile fastboot equivalente da interrogare. Se `null`, il tentativo di query fastboot non verrà eseguito
`description`	`String`: una semplice descrizione della variabile. La prima lettera deve essere maiuscola.

Ritorni
`String`	Una stringa, possibilmente `null` o vuota, contenente il valore della proprietà specificata

Lanci
`DeviceNotAvailableException`

isInRebootCallback

protected boolean isInRebootCallback ()

Restituisce un valore che indica se i callback di riavvio sono attualmente in esecuzione o meno. Tutte le API pubbliche per il riavvio devono essere disattivate se è vero.

Ritorni
`boolean`

isNewer

protected boolean isNewer (File localFile, 
                IFileEntry entry)

Restituisce true se il file locale è più recente del file remoto. IFileEntry essendo accurate al minuto, in caso di orari uguali, il file verrà considerato più recente.

Parametri
`localFile`	`File`
`entry`	`IFileEntry`

Ritorni
`boolean`

notifyRebootEnded

protected void notifyRebootEnded ()

Invia una notifica a tutti i IDeviceActionReceiver in merito all'evento di fine riavvio.

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

notifyRebootStarted

protected void notifyRebootStarted ()

Invia una notifica a tutti i IDeviceActionReceiver in merito all'evento di avvio del riavvio.

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

performDeviceAction

protected boolean performDeviceAction (String actionDescription, 
                NativeDevice.DeviceAction action, 
                int retryAttempts)

Esegue un'azione su questo dispositivo. Tenta di recuperare il dispositivo e, se l'azione non va a buon fine, riprova a eseguire il comando.

Parametri
`actionDescription`	`String`: una breve descrizione dell'azione da eseguire. Utilizzata solo a scopo di logging.
`action`	`NativeDevice.DeviceAction`: l'azione da eseguire
`retryAttempts`	`int`: i tentativi di ripetizione dell'azione in caso di errore, ma il recupero ha esito positivo

Ritorni
`boolean`	`true` se l'azione è stata eseguita correttamente

Lanci
`DeviceNotAvailableException`	se il tentativo di recupero non va a buon fine o sono stati eseguiti il numero massimo di tentativi senza successo

postAdbReboot

protected void postAdbReboot (NativeDevice.RebootMode rebootMode)

Possibili azioni aggiuntive che possono essere intraprese dopo un riavvio.

Parametri
`rebootMode`	`NativeDevice.RebootMode`

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

prePostBootSetup

protected void prePostBootSetup ()

Consente a ogni tipo di dispositivo (AndroidNativeDevice, TestDevice) di eseguire l'override di questo metodo per una configurazione specifica post-avvio.

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

pullFileInternal

protected boolean pullFileInternal (String remoteFilePath, 
                File localFile)

Parametri
`remoteFilePath`	`String`
`localFile`	`File`

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

setClock

protected void setClock (Clock clock)

Imposta l'istanza di Orologio da utilizzare.

Parametri
`clock`	`Clock`

setMicrodroidProcess

protected void setMicrodroidProcess (Process process)

Contrassegna TestDevice come microdroid e imposta il relativo CID.

Parametri
`process`	`Process`: Processo della VM Microdroid.

setTestDeviceOptions

protected void setTestDeviceOptions ( deviceOptions)

Parametri
`deviceOptions`

simpleFastbootCommand

protected CommandResult simpleFastbootCommand (long timeout, 
                 envVarMap, 
                String[] fullCmd)

Esegue un semplice comando fastboot con variabili di ambiente e segnala lo stato del comando.

Parametri
`timeout`	`long`
`envVarMap`
`fullCmd`	`String`

Ritorni
`CommandResult`

simpleFastbootCommand

protected CommandResult simpleFastbootCommand (long timeout, 
                String[] fullCmd)

Esegue un semplice comando fastboot e segnala lo stato del comando.

Parametri
`timeout`	`long`
`fullCmd`	`String`

Ritorni
`CommandResult`

waitForDeviceNotAvailable

protected boolean waitForDeviceNotAvailable (String operationDesc, 
                long time)

Attendi che il dispositivo non sia più disponibile (interrompi la comunicazione con adb).

Parametri
`operationDesc`	`String`: il nome dell'operazione in attesa di non essere disponibile.
`time`	`long`: Il tempo di attesa prima che si verifichi l'indisponibilità.

Ritorni
`boolean`	Vero se il dispositivo è diventato non disponibile.

NativeDevice

Riepilogo

Classi nidificate

Costanti

Campi

Costruttori pubblici

Metodi pubblici

Metodi protetti

Costanti

DEBUGFS_PATH

INVALID_USER_ID

MAX_HOST_DEVICE_TIME_OFFSET

MAX_RETRY_ATTEMPTS

SD_CARD

STORAGE_EMULATED

Campi

mOptions

mStateMonitor

Costruttori pubblici

NativeDevice

Metodi pubblici

batchPrefetchStartupBuildProps

canSwitchToHeadlessSystemUser

checkApiLevelAgainstNextRelease

checkConnectivity

clearErrorDialogs

clearLastConnectedWifiNetwork

clearLogcat

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetworkIfNeeded

connectToWifiNetworkIfNeeded

createUser

createUser

createUser

createUserNoThrow

debugDeviceNotAvailable

deleteFile

deleteFile

deregisterDeviceActionReceiver

deviceSoftRestarted

deviceSoftRestartedSince

disableAdbRoot

disableKeyguard

disableNetworkMonitor

disconnectFromWifi

doesFileExist

doesFileExist

dumpHeap

enableAdbRoot

enableNetworkMonitor

executeAdbCommand

executeAdbCommand

executeAdbCommand

executeAdbV2Command

executeAdbV2Command

executeAdbV2Command

executeFastbootCommand

executeFastbootCommand

executeLongFastbootCommand

executeLongFastbootCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

fastbootWipePartition

getActiveApexes

getAdbPath

getAllSettings

getAllocationState

getAndroidId