Questa pagina è stata tradotta dall'API Cloud Translation.

NativeDevice

public class NativeDevice
extends Object implements IConfigurationReceiver, IManagedTestDevice, ITestLoggerReceiver

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

Sottoclassi dirette note

TestDevice

Dispositivo di test Implementazione di un ITestDevice per un dispositivo Android full stack

Classi di sottoclasse 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 tramiteadb connect.
RemoteAndroidVirtualDevice	Estende il comportamento di `RemoteAndroidDevice` per un dispositivo Android full stack in esecuzione in Google Compute Engine (Gce).

Implementazione predefinita di un ITestDevice dispositivo 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 "adb ...." del sistema operativo.
`class`	`NativeDevice.AdbShellAction`
`class`	`NativeDevice.RebootDeviceAction` `ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction)` per riavviare un dispositivo.

Costanti
`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 nuovo esecuzione del comando da eseguire

Campi
`public static final String`	`DEBUGFS_PATH`
`protected static final String`	`SD_CARD`
`protected static final String`	`STORAGE_EMULATED`
`protected TestDeviceOptions`	`mOptions`
`protected final IDeviceStateMonitor`	`mStateMonitor`

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

Metodi pubblici
`void`	`batchPrefetchStartupBuildProps()` Microottimizzazione (circa 400 millisecondi) tramite il pre-caricamento di tutti i parametri di cui abbiamo bisogno anziché chiamare "adb getprop" per ciascuno.
`boolean`	`canSwitchToHeadlessSystemUser()` Restituisce se è consentito passare all'utente di sistema senza testa.
`boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` Controlla se una funzionalità è attualmente supportata in base a un livello di supporto minimo.
`boolean`	`checkConnectivity()` Verifica la connettività di rete del dispositivo.
`boolean`	`clearErrorDialogs()` Prova a chiudere le eventuali 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.
`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 attualmente non ha connettività di rete.
`boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)` Una variante di `connectToWifiNetwork(String, String)` che si connette solo se il dispositivo attualmente non ha connettività di rete.
`int`	`createUser(String name, boolean guest, boolean ephemeral)` Crea un utente con un determinato nome e i flag forniti
`int`	`createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)` Crea un utente con un determinato nome e i flag forniti
`int`	`createUser(String name)` Crea un utente con un nome e flag predefiniti pari a 0.
`int`	`createUserNoThrow(String name)` Crea un utente con un nome e flag predefiniti pari a 0.
`void`	`deleteFile(String deviceFilePath, int userId)` Metodo di supporto per eliminare un file o una directory sul dispositivo.
`void`	`deleteFile(String deviceFilePath)` Metodo di supporto per eliminare un file o una directory sul dispositivo.
`void`	`deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Rimuove il `IDeviceActionReceiver` registrato.
`boolean`	`deviceSoftRestarted(ProcessInfo prevSystemServerProcess)` Metodo di supporto per verificare se il dispositivo è stato riavviato in modo soft confrontando il sistema_server corrente con il sistema_server precedente `ProcessInfo`.
`boolean`	`deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)` Metodo di supporto per verificare se il dispositivo è stato riavviato da soft dal momento dell'ora UTC dall'epoca del dispositivo e del relativo `ERROR(/TimeUnit)`.
`boolean`	`disableAdbRoot()` Disattiva adb root.
`void`	`disableKeyguard()` Tenta di disattivare la tastiera.
`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 di supporto per determinare se il file sul dispositivo esiste per un determinato utente.
`boolean`	`doesFileExist(String deviceFilePath)` Metodo di supporto per determinare se il file sul dispositivo esiste.
`File`	`dumpHeap(String process, String devicePath)` Tenta di eseguire il dump dell'heap da system_server.
`boolean`	`enableAdbRoot()` Attiva il root adb.
`boolean`	`enableNetworkMonitor()` Attiva il monitoraggio della rete sul dispositivo.
`String`	`executeAdbCommand(long timeout, String... cmdArgs)` Metodo di supporto che esegue un comando adb come comando di sistema con un timeout specificato.
`String`	`executeAdbCommand(long timeout, envMap, String... cmdArgs)` Metodo di supporto che esegue un comando adb come comando di sistema con un timeout specificato.
`String`	`executeAdbCommand(String... cmdArgs)` Metodo di supporto che esegue un comando adb come comando di sistema.
`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 di supporto che esegue un comando fastboot come comando di sistema.
`CommandResult`	`executeLongFastbootCommand(String... cmdArgs)` Metodo di supporto che esegue un comando fastboot di lunga durata come comando di sistema.
`CommandResult`	`executeLongFastbootCommand( envVarMap, String... cmdArgs)` Metodo di supporto che esegue un comando fastboot di lunga esecuzione come comando di sistema con variabili di ambiente di sistema.
`String`	`executeShellCommand(String command)` Metodo di supporto 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, riprova più volte se il comando non va a buon fine.
`CommandResult`	`executeShellV2Command(String cmd)` Metodo di supporto 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 di supporto 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 di supporto 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.
	`getAllSettings(String namespace)` Restituisce le coppie chiave-valore dello spazio dei nomi richiesto.
`DeviceAllocationState`	`getAllocationState()` Restituisce lo stato di allocazione corrente del dispositivo
`String`	`getAndroidId(int userId)` Trova e restituisci l'android-id associato a un userId, null se non trovato.
	`getAndroidIds()` Crea una mappa degli ID Android trovati corrispondenti agli ID utente.
`int`	`getApiLevel()` Recupera il livello API del dispositivo.
`PackageInfo`	`getAppPackageInfo(String packageName)` Recupera le informazioni su un pacchetto installato sul dispositivo.
	`getAppPackageInfos()` Recupera informazioni sui pacchetti installati sul dispositivo.
`String`	`getBasebandVersion()` Metodo pratico per ottenere la versione in banda di base (radio) di questo dispositivo.
`Integer`	`getBattery()` Restituisce il livello corrente 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 di assistenza raccoglie la mappa della cronologia dell'avvio con l'ora e il motivo dell'avvio.
	`getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)` Il metodo di supporto raccoglie la mappa della cronologia dell'avvio con l'ora di avvio e il motivo dell'avvio dal momento specificato dall'epoca del dispositivo e 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 una segnalazione di bug dal dispositivo.
`String`	`getBuildAlias()` Recupera l'alias della build attualmente in esecuzione sul dispositivo.
`String`	`getBuildFlavor()` Recupera il flavor 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 valore `DeviceDescriptor` memorizzato nella cache se il dispositivo viene allocato, altrimenti restituisce il valore `DeviceDescriptor` corrente.
`DeviceDescriptor`	`getCachedDeviceDescriptor(boolean shortDescriptor)` Restituisce un valore `DeviceDescriptor` memorizzato nella cache se il dispositivo viene allocato, altrimenti restituisce il valore `DeviceDescriptor` corrente.
`String[]`	`getChildren(String path)` Alternativa all'utilizzo di `IFileEntry` che a volte non funziona a causa delle autorizzazioni.
`AbstractConnection`	`getConnection()` La connessione corrente associata al dispositivo.
`ContentProviderHandler`	`getContentProvider(int userId)` Restituisce `ContentProviderHandler` o null se non disponibile.
`DeviceFoldableState`	`getCurrentFoldableState()` Restituisce lo stato attuale del dispositivo pieghevole o null se si sono verificati problemi.
`int`	`getCurrentUser()` Restituisce l'ID dell'utente corrente in esecuzione.
`String`	`getDeviceClass()` Recupera la classe del dispositivo.
`long`	`getDeviceDate()` Restituisce la data del dispositivo in millisecondi dall'epoca.
`DeviceDescriptor`	`getDeviceDescriptor()` Restituisci un `DeviceDescriptor` dalle informazioni del dispositivo per avere informazioni al riguardo senza trasmettere l'oggetto effettivo del dispositivo.
`DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` Restituire un `DeviceDescriptor` dalle informazioni del dispositivo per ottenere informazioni su di esso senza dover passare l'oggetto del dispositivo effettivo.
`TestDeviceState`	`getDeviceState()` Recupera lo stato del dispositivo.
`long`	`getDeviceTimeOffset(Date date)` Funzione di supporto per ottenere la differenza di fuso orario tra il dispositivo e un determinato `ERROR(/Date)`.
`InputStreamSource`	`getEmulatorOutput()` Ottieni lo stream di stdout e stderr dell'emulatore
`Process`	`getEmulatorProcess()` Restituisce il valore `Process` corrispondente a questo emulatore.
`final File`	`getExecuteShellCommandLog()` Il log che contiene tutti i log di `executeShellCommand(String)`.
`long`	`getExternalStoreFreeSpace()` Metodo di supporto per determinare la quantità di spazio libero sulla memoria esterna del dispositivo.
`String`	`getFastbootPath()` Restituisce il percorso del file 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 specificato dal dispositivo.
`String`	`getFastbootVersion()` Restituisce la stringa di versione del binario fastboot in uso.
`IFileEntry`	`getFileEntry(String path)` Recupera un riferimento a un file remoto sul dispositivo.
`IFileEntry`	`getFileEntry(FileListingService.FileEntry entry)` Assistente non ufficiale per ottenere un `FileEntry` da un percorso non principale.
	`getFoldableStates()` Restituisce l'elenco degli stati del dispositivo pieghevole.
`IDevice`	`getIDevice()` Restituisce un riferimento alla libreria ddmlib `IDevice` associata.
	`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()` Restituisci un oggetto per ottenere lo stato attuale del blocco della tastiera o null se non supportato.
`long`	`getLastExpectedRebootTimeMillis()` Restituisce l'ultima volta che le API TradeFed hanno attivato un riavvio in millisecondi dall'epoca EPOCH come riportato da `System.currentTimeMillis()`.
`int`	`getLaunchApiLevel()` Ottieni il livello API del primo lancio del dispositivo.
`InputStreamSource`	`getLogcat()` Acquisisce un flusso 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 specificata.
`String`	`getMacAddress()` Restituisce l'indirizzo MAC del dispositivo, null se non riesce a eseguire la query dal dispositivo.
`Integer`	`getMainUserId()` Restituisce l'ID utente principale.
	`getMainlineModuleInfo()` Recupera le informazioni sui moduli di linea principali installati sul dispositivo.
`int`	`getMaxNumberOfRunningUsersSupported()` Ottieni il numero massimo di utenti supportati in esecuzione contemporaneamente.
`int`	`getMaxNumberOfUsersSupported()` Visualizza il numero massimo di utenti supportati.
`Process`	`getMicrodroidProcess()`
`IDeviceStateMonitor`	`getMonitor()` Restituisce il `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 il percorso non ha nulla di montato o altrimenti 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 di supporto per determinare la quantità di spazio libero nella partizione del dispositivo.
`Integer`	`getPrimaryUserId()` Restituisce l'ID utente principale.
`ProcessInfo`	`getProcessByName(String processName)` Il metodo di supporto esegue i comandi "pidof" e "stat" e restituisce l'oggetto `ProcessInfo` con il PID 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à specificato dal dispositivo.
`ITestDevice.RecoveryMode`	`getRecoveryMode()` Ottieni la modalità di ripristino corrente utilizzata per il dispositivo.
`InputStreamSource`	`getScreenshot(long displayId)` Recupera uno screenshot dall'ID display del dispositivo specificato.
`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 del dispositivo.
`String`	`getSetting(int userId, String namespace, String key)` Restituisce il valore dell'impostazione richiesta.
`String`	`getSetting(String namespace, String key)` Vedi `getSetting(int, String, String)` ed eseguita sull'utente del 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 il dispositivo non è disponibile.
	`getTombstones()` Recupera e restituisce l'elenco delle tombstone dai dispositivi.
`long`	`getTotalMemory()` Restituisce la dimensione totale della memoria fisica in byte o -1 in caso di errore interno
`String`	`getTrackingSerial()` Per la gestione del dispositivo, ottieni il numero di serie utilizzato per monitorarlo.
	`getUninstallablePackageNames()` Recupera i nomi dei pacchetti di applicazioni che possono essere disinstallati.
`boolean`	`getUseFastbootErase()` Scopri se utilizzare fastboot erase o fastboot format per cancellare una partizione sul dispositivo.
`int`	`getUserFlags(int userId)` Trova e restituisci gli indicatori di un determinato utente.
	`getUserInfos()` Recupera la Mappa di useId per `UserInfo` sul dispositivo.
`int`	`getUserSerialNumber(int userId)` Restituisce il numero di serie associato allo userId, se trovato, -10000 in tutti gli altri casi.
`IManagedTestDevice.DeviceEventResponse`	`handleAllocationEvent(DeviceEvent event)` Elabora il DeviceEvent specificato. Elabora l'evento DeviceEvent, che può o meno passare questo dispositivo a un nuovo stato di allocazione.
`boolean`	`hasFeature(String feature)` Controlla se una funzionalità è disponibile su un 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.
`void`	`invalidatePropertyCache()`
`boolean`	`isAdbRoot()`
`boolean`	`isAdbTcp()`
`boolean`	`isAppEnumerationSupported()` Verificare se la piattaforma sul dispositivo supporta l'enumerazione delle app
`boolean`	`isBypassLowTargetSdkBlockSupported()` Verificare se la piattaforma sul dispositivo supporta il bypass del blocco dell'SDK target basso per le installazioni di app
`boolean`	`isDebugfsMounted()` Controlla se debugfs è montato.
`boolean`	`isDeviceEncrypted()` Restituisce true se il dispositivo è criptato.
`boolean`	`isDirectory(String path)` Restituisce True se il percorso sul dispositivo è una directory, false altrimenti.
`boolean`	`isEnableAdbRoot()`
`boolean`	`isEncryptionSupported()` Restituisce se la crittografia è supportata sul dispositivo.
`boolean`	`isExecutable(String fullPath)` Restituisce True se il percorso del file sul dispositivo è un file eseguibile, false in caso contrario.
`boolean`	`isFastbootEnabled()` Restituire se il fastboot è disponibile per il dispositivo.
`boolean`	`isHeadless()` Restituisce true se il dispositivo è senza display (nessun schermo), false altrimenti.
`boolean`	`isHeadlessSystemUserMode()` Restituisce se il dispositivo utilizza la modalità utente di sistema headless.
`boolean`	`isMainUserPermanentAdmin()` Restituisce se l'utente principale è un amministratore permanente e non può essere eliminato o sottoposto a downgrade allo stato di utente non amministratore.
`boolean`	`isMultiUserSupported()` Determina se il multiutente è supportato.
`boolean`	`isPackageInstalled(String packageName, String userId)` Esegui una query sul dispositivo per ottenere un determinato nome di pacchetto e un determinato ID utente per verificare se il pacchetto è attualmente installato o meno per l'utente.
`boolean`	`isPackageInstalled(String packageName)` Esegui una query sul dispositivo per un determinato nome del pacchetto per verificare se è attualmente installato o meno.
`boolean`	`isRuntimePermissionSupported()` Controlla 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)` Verifica se un determinato utente è in esecuzione.
`boolean`	`isUserSecondary(int userId)` Indica se l'utente specificato è un utente secondario in base ai flag.
`boolean`	`isUserVisible(int userId)` Controlla se l'utente specificato è visibile.
`boolean`	`isUserVisibleOnDisplay(int userId, int displayId)` Controlla se l'utente specificato è visibile nella visualizzazione specificata.
`boolean`	`isVisibleBackgroundUsersOnDefaultDisplaySupported()` Restituisce se il dispositivo consente agli utenti di essere avviati in background in `ERROR(/java.android.view.Display#DEFAULT_DISPLAY)`.
`boolean`	`isVisibleBackgroundUsersSupported()` Restituisce se il dispositivo consente agli utenti di essere avviati in background.
`boolean`	`isWifiEnabled()` Verifica che il Wi-Fi sia attivo.
	`listDisplayIds()` Raccogliere l'elenco degli ID display disponibili sul dispositivo, come indicato da "dumpsys SurfaceFlinger".
	`listDisplayIdsForStartingVisibleBackgroundUsers()` Recupera l'elenco di 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 di supporto 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()` Emette un comando per riavviare il dispositivo e restituisce il comando al termine e quando il dispositivo non è più visibile ad adb.
`void`	`postAdbRootAction()` Sostituisci se il dispositivo richiede alcune azioni specifiche da eseguire dopo il root tramite adb e prima che il dispositivo sia di nuovo online.
`void`	`postAdbUnrootAction()` Sostituisci se il dispositivo richiede alcune azioni specifiche da eseguire dopo adb unroot e prima che il dispositivo sia di nuovo online.
`void`	`postBootSetup()` Segui le istruzioni per configurare il dispositivo per i test dopo ogni avvio.
`void`	`postInvocationTearDown(Throwable exception)` Passaggi aggiuntivi per la pulizia specifica del dispositivo che verranno eseguiti dopo il completamento della chiamata.
`void`	`preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)` Passaggi aggiuntivi per la configurazione richiesta specifica del dispositivo che verranno eseguiti sul dispositivo prima del flusso di chiamata.
`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 questo `File`.
`File`	`pullFile(String remoteFilePath)` Recupera un file dal dispositivo, lo memorizza in un `ERROR(/File)` temporaneo locale e restituisce questo `File`.
`boolean`	`pullFile(String remoteFilePath, File localFile, int userId)` Recupera un file dal dispositivo.
`String`	`pullFileContents(String remoteFilePath)` Recupera un file dal dispositivo e restituisce i contenuti.
`File`	`pullFileFromExternal(String remoteFilePath)` Un metodo pratico per recuperare un file dallo spazio di archiviazione esterno del dispositivo, memorizzarlo in un `ERROR(/File)`temporaneo locale e restituire un riferimento a quel `File`.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, excludedDirectories)` Esegui il push dei contenuti delle directory sul dispositivo in modo ricorsivo, escludendo alcune directory filtrate.
`boolean`	`pushDir(File localFileDir, String deviceFilePath)` Esegui il push dei contenuti della directory sul dispositivo in modo ricorsivo.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, int userId)` Esegui il push dei contenuti della directory sul dispositivo in modo ricorsivo.
`boolean`	`pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)` Variante di `pushFile(File, String)` che può eventualmente prendere in considerazione la valutazione del bisogno 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 il file creato da una stringa al dispositivo
`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à sideload adb (tieni presente che si tratta di una modalità speciale in fase di ripristino) Blocca fino a quando il dispositivo non entra in modalità sideload
`void`	`rebootIntoSideload(boolean autoReboot)` Riavvia il dispositivo in modalità sideload adb (tieni presente che si tratta di una modalità speciale in fase di recupero) Blocco fino all'attivazione della modalità sideload sul dispositivo
`void`	`rebootUntilOnline()` Un'alternativa a `reboot()` che blocca solo fino a quando il dispositivo non è online, ovvero visibile ad adb.
`void`	`rebootUntilOnline(String reason)` Un'alternativa a `reboot()` che blocca solo fino a quando 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 viene bloccata soltanto finché il dispositivo non è online, cioè visibile ad ADB.
`boolean`	`recoverDevice()` Tenta di recuperare la comunicazione con il dispositivo.
`void`	`registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Registra un `IDeviceActionReceiver` per questo dispositivo.
`void`	`remountSystemReadOnly()` Imposta la partizione di sistema sul dispositivo come di sola lettura.
`void`	`remountSystemWritable()` Rendi la partizione di sistema sul dispositivo scrivibile.
`void`	`remountVendorReadOnly()` Imposta la partizione del fornitore sul dispositivo come di sola lettura.
`void`	`remountVendorWritable()` Rendi la partizione del fornitore sul dispositivo scrivibile.
`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` altrimenti.
`void`	`removeOwners()` Rimuovi tutti i proprietari di profili dei dispositivi esistenti nel modo più semplice possibile.
`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 di utilità per eseguire `ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))` con uno o più ascoltatori passati come parametri.
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)` Esegue test di strumentazione e fornisce il recupero 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`	`setConfiguration(IConfiguration configuration)` Inserisce `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 i permessi di root
`boolean`	`setDeviceOwner(String componentName, int userId)` Imposta un componente di amministrazione del dispositivo come proprietario del dispositivo in 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`, se il 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 ms da attendere prima di avviare l'acquisizione di logcat per un dispositivo online.
`void`	`setOptions(TestDeviceOptions options)` Impostare `TestDeviceOptions` per il dispositivo
`boolean`	`setProperty(String propKey, String propValue)` Imposta il valore della proprietà specificato sul dispositivo.
`void`	`setRecovery(IDeviceRecovery recovery)` Imposta il `IDeviceRecovery` da utilizzare per questo dispositivo.
`void`	`setRecoveryMode(ITestDevice.RecoveryMode mode)` Imposta la modalità di ripristino corrente da utilizzare per il dispositivo.
`void`	`setSetting(String namespace, String key, String value)` Vedi `setSetting(int, String, String, String)` e 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, traccia il numero di serie che utilizziamo per fare riferimento al dispositivo.
`void`	`setUseFastbootErase(boolean useFastbootErase)` Imposta se utilizzare l'opzione 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`	`startUser(int userId)` Avvia un determinato utente in background se è attualmente fermo.
`boolean`	`startUser(int userId, boolean waitFlag)` Avvia un determinato utente in background se è attualmente fermo.
`boolean`	`startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)` Avvia un determinato utente in background, visibile nella visualizzazione in questione (ovvero consente all'utente di avviare attività in quella visualizzazione).
`void`	`stopEmulatorOutput()` Chiudi ed elimina l'output dell'emulatore.
`void`	`stopLogcat()` Interrompi l'acquisizione dell'output di Logcat dal dispositivo ed elimina i dati di Logcat attualmente salvati.
`boolean`	`stopUser(int userId)` Interrompe un determinato utente.
`boolean`	`stopUser(int userId, boolean waitFlag, boolean forceFlag)` Interrompere un determinato utente.
`String`	`switchToAdbTcp()` Passa il dispositivo alla modalità adb-over-tcp.
`boolean`	`switchToAdbUsb()` Passa al dispositivo in modalità ADB su USB.
`boolean`	`switchUser(int userId)` Passa a un altro ID utente 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 un report di bug e lo restituisce all'interno di un oggetto `Bugreport` per gestirlo.
`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 il debugfs.
`boolean`	`waitForBootComplete(long timeOut)` Si blocca finché non viene impostato il flag di completamento dell'avvio del dispositivo.
`boolean`	`waitForDeviceAvailable()` Attende che il dispositivo risponda e sia disponibile per i test.
`boolean`	`waitForDeviceAvailable(long waitTime)` Attende che il dispositivo risponda e sia disponibile per i test.
`boolean`	`waitForDeviceAvailableInRecoverPath(long waitTime)` Attende che il dispositivo sia reattivo e disponibile senza considerare il percorso di recupero.
`void`	`waitForDeviceBootloader()` Si blocca finché il dispositivo non è visibile tramite fastboot.
`boolean`	`waitForDeviceInRecovery(long waitTime)` Impedisce al dispositivo di trovarsi nello stato "adb recovery" (tieni presente che questo è diverso da `IDeviceRecovery`).
`boolean`	`waitForDeviceInSideload(long waitTime)` Blocca il dispositivo in stato "sideload adb"
`boolean`	`waitForDeviceNotAvailable(long waitTime)` Blocca il dispositivo in modo che non sia disponibile, ad esempio non sia presente in 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)` Genera 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 si esegue un'azione di riavvio.
`IRunUtil`	`createRunUtil()`
`void`	`doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)` Esegui un riavvio ADB.
`void`	`ensureRuntimePermissionSupported()` metodo di assistenza per lanciare un'eccezione se l'autorizzazione di runtime non è supportata
`int`	`getApiLevelSafe()`
`ITestLogger`	`getLogger()`
`IRunUtil`	`getRunUtil()` Ottieni l'istanza `RunUtil` da utilizzare.
`void`	`initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)`
`String`	`internalGetProperty(String propName, String fastbootVar, String description)` Recupera una proprietà del dispositivo, dalla cache ddmlib per impostazione predefinita, e utilizza "adb shell getprop" o "fastboot getvar" a seconda che il dispositivo sia in Fastboot o meno.
`boolean`	`isInRebootCallback()` Restituisce se i richiami 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 notifiche a `IDeviceActionReceiver` relative all'evento di fine del riavvio.
`void`	`notifyRebootStarted()` Invia notifiche a `IDeviceActionReceiver` relative all'evento di avvio del riavvio.
`boolean`	`performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)` Esegue un'azione su questo dispositivo.
`void`	`postAdbReboot()` 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-boot.
`boolean`	`pullFileInternal(String remoteFilePath, File localFile)`
`void`	`setClock(Clock clock)` Imposta l'istanza di Orologio da utilizzare.
`void`	`setMicrodroidProcess(Process process)` Contrassegna il TestDevice come microdroide e imposta il proprio ID cliente.
`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 diventi non disponibile (interrompi la segnalazione ad adb).

Costanti

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 nuovo esecuzione del comando da eseguire

Valore costante: 2 (0x00000002)

Campi

DEBUGFS_PATH

public static final String DEBUGFS_PATH

SD_CARD

protected static final String SD_CARD

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

Opzioni m

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`: il `IDeviceMonitor` per informare delle modifiche dello stato dell'allocazione. Può essere null

Metodi pubblici

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

La micro ottimizzazione (circa 400 millisecondi) mediante il precaricamento di tutti gli oggetti di cui abbiamo bisogno, anziché chiamare "adb getprop" per ciascuno. Ad esempio, il recupero di tutte le proprietà è veloce quanto il recupero di una proprietà. Funzionalità come device.getApiLevel(), checkApiLevelAgainstNextRelease e getBuildAlias chiamano tutte adb getprop sotto il cofano. Li recuperiamo con una sola chiamata e chiamiamo NativeDevice.setProperty. Anche se non lo facciamo, NativeDevice chiamerà setProperty e memorizza nella cache il risultato per chiamate future. Lo stiamo facendo un po' prima. Se il dispositivo è in modalità di recupero o se si verificano altri errori durante il recupero degli elementi, li ignoriamo.

CANNOT TRANSLATE

public boolean canSwitchToHeadlessSystemUser ()

Restituisce se è consentito passare all'utente di sistema senza testa.

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Controlla se una funzionalità è attualmente supportata o meno in un livello minimamente supportato. Questo metodo prende in considerazione le funzionalità non ancora rilasciate, prima dell'aumento del livello dell'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`

Finestra di dialogo di errore

public boolean clearErrorDialogs ()

Prova a chiudere le eventuali finestre di dialogo di errore attualmente visualizzate nell'interfaccia utente del dispositivo.

Ritorni
`boolean`	`true` se non sono presenti finestre di dialogo o se queste sono state chiuse correttamente. `false` in caso contrario.

Lanci
`DeviceNotAvailableException`

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

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

clearLogcat

public void clearLogcat ()

Elimina tutti i dati logcat accumulati.

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

connettitiaallareteWifi

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Si connette a una rete Wi-Fi.

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

Parametri
`wifiSsidToPsk`	: una mappa degli SSID Wi-Fi con le relative password.
`scanSsid`	`boolean`: indica se cercare SSID nascosti per questa rete.

Ritorni
`boolean`	`true` se la connessione alla rete Wi-Fi è andata a buon fine. `false` altrimenti

Lanci
`DeviceNotAvailableException`

connettitiaallareteWifi

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Si connette a una rete Wi-Fi.

Attiva il Wi-Fi e si blocca fino a quando non viene stabilita una connessione alla rete Wi-Fi specificata. Una volta stabilita una connessione, l'istanza proverà a ripristinare la connessione dopo ogni riavvio fino alla chiamata di ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork().

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

Ritorni
`boolean`	`true` se la connessione alla rete Wi-Fi è andata a buon fine. `false` altrimenti

Lanci
`DeviceNotAvailableException`

connettitiaallareteWifi

public boolean connectToWifiNetwork ( wifiSsidToPsk)

Si connette a una rete Wi-Fi.

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

Parametri
`wifiSsidToPsk`	: una mappa degli SSID Wi-Fi con le relative password.

Ritorni
`boolean`	`true` se la connessione alla rete Wi-Fi è andata a buon fine. `false` altrimenti

Lanci
`DeviceNotAvailableException`

connettitiaallareteWifi

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

Si connette a una rete Wi-Fi.

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

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

Ritorni
`boolean`	`true` se la connessione alla rete Wi-Fi è andata a buon fine. `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 attualmente non ha connettività di rete.

Parametri
`scanSsid`	`boolean`: se cercare SSID nascosti per questa rete

Ritorni
`boolean`	`true` se la connessione alla rete Wi-Fi è andata a buon fine. `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 dispone di connettività di rete.

Ritorni
`boolean`	`true` se la connessione alla rete Wi-Fi è andata a buon fine. `false` altrimenti

Lanci
`DeviceNotAvailableException`

createUser

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

Crea un utente con un nome e gli indicatori specificati

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 e gli indicatori specificati

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

Ritorni
`int`	ID dell'utente creato

Lanci
`DeviceNotAvailableException`

CreaUtente

public int createUser (String name)

Crea un utente con un nome e flag predefiniti pari a 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 e flag predefiniti pari a 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`

deleteFile

public void deleteFile (String deviceFilePath, 
                int userId)

Metodo di supporto 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 gli elementi

Lanci
`DeviceNotAvailableException`

deleteFile

public void deleteFile (String deviceFilePath)

Metodo di supporto per eliminare un file o una directory sul dispositivo.

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

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 temporaneamente, confrontando l'attuale sistema_server con il precedente sistema system_server ProcessInfo. Usa getProcessByName(String) per ricevere ProcessInfo.

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

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

Lanci
`DeviceNotAvailableException`

deviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Metodo di supporto per verificare se il dispositivo è stato riavviato da soft dal momento dell'ora UTC dall'epoca del dispositivo e del relativo ERROR(/TimeUnit). Con riavvio soft si intende il riavvio di system_server al di fuori di un riavvio forzato del dispositivo (ad esempio, riavvio richiesto). Il valore utcEpochTime corrente del dispositivo in millisecondi può essere ottenuto tramite 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 modo soft

Lanci
`DeviceNotAvailableException`

disableAdbRoot

public boolean disableAdbRoot ()

Disattiva il root ADB.

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

Ritorni
`boolean`	`true` se l'operazione ha esito positivo.

Lanci
`DeviceNotAvailableException`

disableKeyguard

public void disableKeyguard ()

Tenta di disattivare la tastiera.

Innanzitutto, attendi che l'invio di input sia pronto. Questo accade 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 gara. Viene quindi inviato il comando per chiudere la schermata di blocco (funziona solo su quelle non sicure)

Lanci
`DeviceNotAvailableException`

disableNetworkMonitor

public boolean disableNetworkMonitor ()

Disattiva il monitoraggio della rete sul dispositivo.

Ritorni
`boolean`	`true` se il monitoraggio viene disattivato correttamente. `false` se l'operazione non è andata a buon fine.

Lanci
`DeviceNotAvailableException`

disconnectFromWifi

public boolean disconnectFromWifi ()

Si disconnette da una rete Wi-Fi.

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

Ritorni
`boolean`	`true` se si è disconnesso correttamente dalla rete Wi-Fi. `false` se la disconnessione non è riuscita.

Lanci
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

Metodo di supporto 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 in base al quale verificare l'esistenza del file

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

Lanci
`DeviceNotAvailableException`

fileExist

public boolean doesFileExist (String deviceFilePath)

Metodo di supporto 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 eseguire il dump dell'heap da system_server. È responsabilità del chiamante eliminare il file di cui è stato eseguito il 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 località in cui le autorizzazioni lo consentano.

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

Lanci
`DeviceNotAvailableException`

enableAdbRoot

public boolean enableAdbRoot ()

Attiva il root adb. Se l'impostazione "enable-root" è "false", verrà registrato un messaggio e il metodo verrà restituito senza attivare il ruolo di root.

L'attivazione del root adb potrebbe causare la disconnessione del dispositivo da adb. Questo metodo verrà bloccato fino a quando il dispositivo non sarà disponibile.

Ritorni
`boolean`	`true` se l'operazione ha esito positivo.

Lanci
`DeviceNotAvailableException`

enableNetworkMonitor

public boolean enableNetworkMonitor ()

Attiva il monitoraggio della rete sul dispositivo.

Ritorni
`boolean`	`true` se il monitoraggio è stato attivato correttamente. `false` se non è riuscito.

Lanci
`DeviceNotAvailableException`

executeAdbCommand

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

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

Se possibile, utilizza executeShellCommand(String), perché questo metodo offre prestazioni e rilevamento degli errori migliori.

Parametri
`timeout`	`long`: il tempo in millisecondi prima che il dispositivo sia considerato non risponde, 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 di supporto che esegue un comando adb come comando di sistema con un timeout specificato.

executeShellCommand(String), ove possibile, in quanto questo metodo offre un migliore rilevamento degli errori e un rendimento migliore.

Parametri
`timeout`	`long`: tempo in millisecondi prima che il dispositivo sia considerato non risponde, 0L per nessun timeout
`envMap`	: 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), ove possibile, in quanto questo metodo offre un migliore rilevamento degli errori e un rendimento migliore.

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`

eseguireFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

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

Deve essere utilizzato quando il dispositivo è già in modalità Fastboot.

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

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

Lanci
`DeviceNotAvailableException`

eseguireFastbootCommand

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

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

Deve essere utilizzato quando il dispositivo è già in modalità Fastboot.

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

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

Lanci
`DeviceNotAvailableException`

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

Metodo di supporto che esegue un comando fastboot di lunga durata 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`	il CommandResult contenente l'output del comando

Lanci
`DeviceNotAvailableException`

executeLongFastbootCommand

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

Metodo di supporto che esegue un comando fastboot di lunga esecuzione come comando di sistema con variabili di ambiente di sistema.

Identico a executeFastbootCommand(String), ma 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`	il CommandResult contenente l'output del comando

Lanci
`DeviceNotAvailableException`

executeShellCommand

public String executeShellCommand (String command)

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

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

Ritorni
`String`	l'output della shell

Lanci
`DeviceNotAvailableException`

eseguireShellCommand

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 è autorizzato a non produrre alcuna risposta; unità specificata in `timeUnit`
`timeUnit`	`TimeUnit`: unità per `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: il numero massimo di volte per riprovare il comando se non va a buon fine a causa di un'eccezione. Verrà generata un'eccezione DeviceNot responsiveException se l'esecuzione di `retryAttempts` non riesce.

Lanci
`DeviceNotAvailableException`

eseguireShellCommand

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 valore `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 è autorizzato a non produrre alcuna risposta; unità specificata in `timeUnit`
`timeUnit`	`TimeUnit`: unità per `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: il numero massimo di volte per riprovare il comando se non va a buon fine a causa di un'eccezione. Viene generata un'eccezione DeviceNotResponsiveException se `retryAttempts` viene eseguita senza esito.

Lanci
`DeviceNotAvailableException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Esegue il comando adb shell specificato, riprova 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 della shell adb e restituisce i risultati come CommandResult correttamente compilato 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`

eseguireShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

Metodo di supporto 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 allo stream specificato.

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

Ritorni
`CommandResult`	Il risultato in `CommandResult`.

Lanci
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

Metodo di supporto 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à incanalato come input al comando o nullo.

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 shell adb da eseguire
`maxTimeoutForCommand`	`long`: il timeout massimo per il completamento del comando; unità come specificato in `timeUnit`
`timeUnit`	`TimeUnit`: unità per `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: il numero massimo di volte per riprovare il comando se non va a buon fine a causa di un'eccezione. Verrà generata un'eccezione DeviceNotAdaptiveException se l'esecuzione di `retryAttempts` viene eseguita 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 shell adb 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à incanalato come input al comando o nullo.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` in cui verrà reindirizzato l'output standard oppure nullo.
`maxTimeoutForCommand`	`long`: il timeout massimo per il completamento del comando; unità come specificato in `timeUnit`
`timeUnit`	`TimeUnit`: unità per `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: il numero massimo di volte per riprovare il comando se non va a buon fine a causa di un'eccezione. Verrà generata un'eccezione DeviceNotAdaptiveException se l'esecuzione di `retryAttempts` viene eseguita 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 oppure null.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` in cui verrà reindirizzato l'output standard oppure nullo.
`pipeToError`	`OutputStream`: `ERROR(/OutputStream)` dove verrà reindirizzato l'errore standard oppure nullo.
`maxTimeoutForCommand`	`long`: il timeout massimo per il completamento del comando; unità come specificato in `timeUnit`
`timeUnit`	`TimeUnit`: unità per `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: il numero massimo di volte per riprovare il comando se non va a buon fine a causa di un'eccezione. Verrà generata un'eccezione DeviceNotAdaptiveException se l'esecuzione di `retryAttempts` viene eseguita senza esito positivo.

Ritorni
`CommandResult`

Lanci
`DeviceNotAvailableException`

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

Metodo di supporto che cancella una partizione del dispositivo.

Se getUseFastbootErase() è true, verrà utilizzata la cancellazione di Fastboot per cancellare la partizione. Il dispositivo deve quindi creare un file system al successivo avvio del dispositivo. In caso contrario, viene utilizzato il formato fastboot, che crea un nuovo file system sul dispositivo.

Deve essere utilizzato quando il dispositivo è già in modalità Fastboot.

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

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

Lanci
`DeviceNotAvailableException`

getActiveApexes

public  getActiveApexes ()

Recupera le informazioni sugli APEX attivati sul dispositivo.

Ritorni
	Attualmente attivi sul dispositivo: `ERROR(/Set)` di `ApexInfo`

Lanci
`DeviceNotAvailableException`

getAllSettings

public  getAllSettings (String namespace)

Restituisce coppie chiave-valore dello spazio dei nomi richiesto.

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

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

Lanci
`DeviceNotAvailableException`

getAllocationState

public DeviceAllocationState getAllocationState ()

Restituisce lo stato di allocazione corrente del dispositivo

Ritorni
`DeviceAllocationState`

getAndroidId

public String getAndroidId (int userId)

Trova e restituisce l'id Android 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 corrispondenti agli ID utente. Non esiste alcuna assicurazione che ogni ID utente trovi un ID Android associato in questa funzione, pertanto alcuni ID utente potrebbero corrispondere a quelli nulli.

Ritorni
	Mappa di ID Android corrispondenti a 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 le 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` installati sul dispositivo.

Lanci
`DeviceNotAvailableException`

getBasebandVersion

public String getBasebandVersion ()

Metodo pratico per ottenere la versione in banda di base (radio) di questo dispositivo. Il recupero della versione della radio dipende dal dispositivo, pertanto 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. TL;DR questo metodo riporta la versione accurata solo se la proprietà gsm.version.baseband è uguale alla versione restituita da fastboot getvar version-baseband.

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

Lanci
`DeviceNotAvailableException`

getBattery

public Integer getBattery ()

Restituisce il livello della batteria corrente 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` in caso contrario.

Lanci
`DeviceNotAvailableException`

getBootHistory

public  getBootHistory ()

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

Ritorni
	Mappa dell'ora di avvio (ora UTC in secondi dall'epoca) e del motivo di avvio

Lanci
`DeviceNotAvailableException`

getBootHistorySince

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

Ritorni
	Mappa dell'ora di avvio (ora UTC in secondi dall'epoca) e del motivo di avvio

Lanci
`DeviceNotAvailableException`

getBootloaderVersion

public String getBootloaderVersion ()

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

Proverà a recuperare la versione del bootloader dallo stato attuale del dispositivo. (ad es. 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à garantisce che continui a funzionare su un dispositivo privo di scheda SD (o su cui non è ancora stata montata).

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

getBugreportz

public InputStreamSource getBugreportz ()

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

Supportata solo per "adb version" > 1.0.36

Ritorni
`InputStreamSource`	un `InputStreamSource` del file ZIP contenente il bugreportz, restituisci 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 dell'ID build (in genere un numero per le build Nexus). Ad esempio, la release finale di Android 4.2 ha l'alias di build JDQ39 e l'ID build 573038

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

Lanci
`DeviceNotAvailableException`

getBuildFlavor

public String getBuildFlavor ()

Recupera il flavor di build per il dispositivo.

Ritorni
`String`	versione build o nullo 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 valore DeviceDescriptor memorizzato nella cache se il dispositivo viene allocato, altrimenti restituisce il valore 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 al minimo indispensabile di informazioni.

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 stringa contenente l'intero 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 provider di contenuti.

Ritorni
`ContentProviderHandler`

Lanci
`DeviceNotAvailableException`

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

Restituisce l'attuale stato pieghevole del dispositivo o nullo se si sono verificati alcuni problemi.

Ritorni
`DeviceFoldableState`

Lanci
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

Restituisce l'ID dell'utente corrente 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 del dispositivo `String`.

getDeviceDate

public long getDeviceDate ()

Restituisce la data del dispositivo in millisecondi dall'epoca.

Ritorni
`long`	La data del dispositivo in formato epoch.

Lanci
`DeviceNotAvailableException`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

Restituisci un DeviceDescriptor dalle informazioni del dispositivo per avere informazioni al riguardo senza trasmettere l'oggetto effettivo del dispositivo.

Ritorni
`DeviceDescriptor`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

Parametri
`shortDescriptor`	`boolean`: indica se limitare o meno il descrittore al minimo indispensabile di informazioni.

Ritorni
`DeviceDescriptor`

getDeviceState

public TestDeviceState getDeviceState ()

Recupera lo stato del dispositivo.

Ritorni
`TestDeviceState`

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

Funzione di supporto per ottenere la differenza di fuso orario tra il dispositivo e un determinato ERROR(/Date). Utilizza internamente il tempo Epoch.

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 il valore Process corrispondente a questo emulatore.

Ritorni
`Process`	`Process` o `null`

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

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

Ritorni
`File`

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

Metodo di supporto per determinare la quantità di spazio libero sulla memoria esterna del dispositivo.

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

Lanci
`DeviceNotAvailableException`

getFastbootPath

public String getFastbootPath ()

Restituisce il percorso del file binario fastboot in uso. È comunque necessario che isFastbootEnabled() sia true e le funzioni fastboot siano abilitate.

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 è in modalità Fastboot. È una variante un po' più sicura rispetto al metodo getProductType() generico in questo caso, perché ITestDevice sa che deve ripristinare il dispositivo in fastboot se si trova in stato non corretto 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 può essere determinato

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 specificato 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 di versione del binario fastboot in uso. Oppure null se qualcosa va storto.

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 relativo a "/". (ad es. sono supportate sia la sintassi "/system" sia "system")

Ritorni
`IFileEntry`	`IFileEntry` o `null` se non è possibile trovare il file in `path`

Lanci
`DeviceNotAvailableException`

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

Assistente non ufficiale per ottenere un FileEntry da un percorso non principale. FIXME: ristruttura il sistema FileEntry in modo che sia disponibile da qualsiasi percorso. (anche non root).

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

Ritorni
`IFileEntry`	un FileEntryWrapper che rappresenta il FileEntry.

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

getFoldableStates

public  getFoldableStates ()

Restituisce l'elenco degli stati del dispositivo pieghevole. Può essere ottenuto con "cmd device_state Print-states".

Ritorni

Lanci
`DeviceNotAvailableException`

getIDevice

public IDevice getIDevice ()

Restituisce un riferimento alla libreria ddmlib IDevice associata.

Un nuovo IDevice potrebbe essere allocato da DDMS ogni volta che il dispositivo si scollega e si ricollega da adb. Di conseguenza, i chiamanti non devono tenere un riferimento al IDevice, perché questo potrebbe diventare inattivo.

Ritorni
`IDevice`	`IDevice`

getInstallaPackageNames

public  getInstalledPackageNames ()

Recupera i nomi dei pacchetti delle applicazioni presenti sul dispositivo.

Ritorni
	`ERROR(/Set)` dei `String` nomi dei pacchetti 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 indirizzo IP

Lanci
`DeviceNotAvailableException`

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Restituisce un oggetto per ottenere lo stato corrente della tastiera protetta o null se non supportato.

Ritorni
`KeyguardControllerState`	un `KeyguardControllerState` contenente uno snapshot dello stato della schermata di blocco e restituisce Null se la query della schermata di blocco non è supportata.

Lanci
`DeviceNotAvailableException`

getLastExpectedRebootTimeMillis

public long getLastExpectedRebootTimeMillis ()

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

Ritorni
`long`

getLaunchApiLevel

public int getLaunchApiLevel ()

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

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

Lanci
`DeviceNotAvailableException`

getLogcat

public InputStreamSource getLogcat ()

Acquisisce uno stream di snapshot dei dati di logcat.

Funziona in due modalità:

Se il logcat è attualmente in fase di acquisizione in background, restituirà fino a TestDeviceOptions.getMaxLogcatDataSize() byte dei contenuti attuali dell'acquisizione di logcat in background

Altrimenti, restituirà un dump statico dei dati logcat se il dispositivo sta rispondendo.

Ritorni
`InputStreamSource`

getLogcat

public InputStreamSource getLogcat (int maxBytes)

Acquisisce uno stream di snapshot degli ultimi maxBytes dati logcat acquisiti.

È utile nei casi in cui vuoi acquisire snapshot frequenti dei dati logcat acquisiti senza incorrere nella penalizzazione dello spazio su disco potenzialmente elevato dell'intero snapshot getLogcat().

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

Ritorni
`InputStreamSource`

getLogcatDump

public InputStreamSource getLogcatDump ()

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

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

Ritorni
`InputStreamSource`	un `InputStreamSource` dei dati di Logcat. Viene restituito uno stream vuoto se non riesce a acquisire i dati di logcat.

getLogcatSince

public InputStreamSource getLogcatSince (long date)

Acquisisce uno stream di snapshot dei dati logcat acquisiti a partire dalla data indicata. Deve essere utilizzato l'ora sul dispositivo getDeviceDate().

Parametri
`date`	`long`: in millisecondi dal formato epoch di quando iniziare lo snapshot fino al momento attuale. (può essere ottenuto utilizzando "data +%s")

Ritorni
`InputStreamSource`

getMacAddress

public String getMacAddress ()

Restituisce l'indirizzo MAC del dispositivo, null se non riesce a eseguire la query dal dispositivo.

Ritorni
`String`

getMainUserId

public Integer getMainUserId ()

Restituisce l'ID utente principale.

Ritorni
`Integer`	l'ID utente dell'utente principale, se presente, e nullo, se non esiste un utente principale.

Lanci
`DeviceNotAvailableException`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

Visualizza le informazioni sui moduli principali installati sul dispositivo.

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

Lanci
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

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

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

Lanci
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

Visualizza 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 il IDeviceStateMonitor associato al dispositivo.

Ritorni
`IDeviceStateMonitor`

getMountPoint

public String getMountPoint (String mountName)

Restituisce un punto di montaggio.

Esegue una 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 o null se non è montato nulla in quel percorso o se non viene visualizzato come punto di montaggio in /proc/mounts.

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

getPartitionFreeSpace

public long getPartitionFreeSpace (String partition)

Metodo di supporto 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'attributo userId dell'utente principale, se presente, e null se non è presente alcun utente principale.

Lanci
`DeviceNotAvailableException`

getProcessByName

public ProcessInfo getProcessByName (String processName)

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

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

Ritorni
`ProcessInfo`	ProcessInfo di un determinato processoName

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 dei processi.

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à nullo

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

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

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

getScreenshot

public InputStreamSource getScreenshot (long displayId)

Recupera uno screenshot dall'ID display del dispositivo specificato. Il formato è PNG.

DA FARE: estendere le implementazioni precedenti per supportare "format" e "rescale"

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

Ritorni
`InputStreamSource`	un `InputStreamSource` dello screenshot nel formato o `null` se lo screenshot non è riuscito.

Lanci
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format)

Acquisisce uno screenshot dal dispositivo. Ti consigliamo di utilizzare getScreenshot(format) con codifica JPEG per dimensioni inferiori

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

Ritorni
`InputStreamSource`	un `InputStreamSource` dello screenshot in 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. Ti consigliamo di utilizzare invece getScreenshot(String) con la codifica JPEG per dimensioni inferiori.

Parametri
`format`	`String`: PNG, JPEG supportato
`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 è riuscito.

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 allo spazio dei nomi:chiave di un utente. Null se non trovato.

Lanci
`DeviceNotAvailableException`

getSetting

public String getSetting (String namespace, 
                String key)

Vedi getSetting(int, String, String) ed eseguita sull'utente del 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 restituisce l'elenco delle tombstone dai dispositivi. Richiede root.

è il metodo del massimo impegno, quindi se non è possibile estrarre una tomba per qualsiasi motivo, questa non sarà presente nell'elenco. Solo un DeviceNotAvailableException termina il metodo in anticipo.

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

Lanci
`DeviceNotAvailableException`

getTotalMemory

public long getTotalMemory ()

Restituisce la dimensione totale della memoria fisica in byte o -1 in caso di errore interno

Ritorni
`long`

getTrackingSerial

public String getTrackingSerial ()

Per la gestione del dispositivo, ottieni il numero di serie utilizzato per monitorarlo.

Ritorni
`String`

getUninstallablePackageNames

public  getUninstallablePackageNames ()

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

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

Lanci
`DeviceNotAvailableException`

getUseFastbootErase

public boolean getUseFastbootErase ()

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

Ritorni
`boolean`	`true` se verrà utilizzata l'opzione di reset di Fastboot o `false` se verrà utilizzata l'opzione di formattazione di Fastboot.

Flag User

public int getUserFlags (int userId)

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

Parametri
`userId`	`int`

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

Lanci
`DeviceNotAvailableException`

getUserInfos

public  getUserInfos ()

Recupera la mappa di useId a UserInfo sul dispositivo. Se l'output dal dispositivo non è quello previsto, verrà generato DeviceRuntimeException.

Ritorni
	l'elenco di oggetti UserInfo.

Lanci
`DeviceNotAvailableException`

getUserSerialNumber

public int getUserSerialNumber (int userId)

Restituisce il numero di serie associato a userId, se trovato, -10000 in tutti gli altri casi.

Parametri
`userId`	`int`

Ritorni
`int`

Lanci
`DeviceNotAvailableException`

handleAllocationEvent

public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

Elabora il DeviceEvent specificato. Il dispositivo potrebbe essere trasferito al nuovo stato. Informerà IDeviceMonitor di eventuali transizioni di stato.

Elabora l'evento DeviceEvent, che può o meno passare questo dispositivo a un nuovo stato di allocazione.

Parametri
`event`	`DeviceEvent`

Ritorni
`IManagedTestDevice.DeviceEventResponse`

hasFeature

public boolean hasFeature (String feature)

Controlla se una funzionalità è disponibile su un dispositivo.

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

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

Lanci
`DeviceNotAvailableException`

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 extra facoltativi da passare. Per le opzioni disponibili, consulta "adb shell pm -h".

Ritorni
`String`	un `String` con un codice di errore o `null` se l'operazione è riuscita.

Lanci
`DeviceNotAvailableException`

installPackage

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

Installa un pacchetto Android sul dispositivo.

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

Parametri
`packageFile`	`File`: il file APK da installare
`reinstall`	`boolean`: `true` se è necessario eseguire una reinstallazione
`grantPermissions`	`boolean`: se tutte le autorizzazioni di runtime devono essere concesse al momento dell'installazione
`extraArgs`	`String`: argomenti extra facoltativi da passare. Vedi "adb shell pm -h" per le opzioni disponibili.

Ritorni
`String`	un `String` con un codice di errore o `null` se l'operazione è riuscita.

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 per il quale eseguire l'installazione.
`extraArgs`	`String`: argomenti extra facoltativi da passare. Vedi "adb shell pm -h" per le opzioni disponibili.

Ritorni
`String`	un `String` con un codice di errore o `null` se l'operazione è riuscita.

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: solo i casi d'uso che richiedono il controllo esplicito della concessione dell'autorizzazione di runtime al momento dell'installazione devono chiamare questa funzione.

Parametri
`packageFile`	`File`: il file APK da installare
`reinstall`	`boolean`: `true` se è necessario eseguire una reinstallazione
`grantPermissions`	`boolean`: se tutte le autorizzazioni di runtime devono essere concesse al momento dell'installazione
`userId`	`int`: l'ID utente intero per il quale eseguire l'installazione.
`extraArgs`	`String`: argomenti extra facoltativi da passare. Vedi "adb shell pm -h" per le opzioni disponibili.

Ritorni
`String`	un `String` con un codice di errore o `null` se l'operazione è riuscita.

Lanci
`DeviceNotAvailableException`

invalidaProprietàCache

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`	True se l'enumerazione dell'app è supportata, false in caso contrario

Lanci
`DeviceNotAvailableException`

isBypassLowTargetSdkBlockSupported

public boolean isBypassLowTargetSdkBlockSupported ()

Controlla se la piattaforma sul dispositivo supporta l'aggiramento del blocco SDK target basso sulle installazioni di app

Ritorni
`boolean`	True se è supportato il blocco di bypass dell'SDK target basso, 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 ()

Restituisce true 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 altrimenti.

Parametri
`path`	`String`

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isAbilitaAdbRoot

public boolean isEnableAdbRoot ()

Ritorni
`boolean`	`true` se è necessario attivare il root adb sul dispositivo

isEncryptionSupported

public boolean isEncryptionSupported ()

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

Restituire se il fastboot è disponibile per il dispositivo.

Ritorni
`boolean`

isHeadless

public boolean isHeadless ()

Restituisce true se il dispositivo è senza display (nessun schermo), false altrimenti.

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

Indica se il dispositivo utilizza la modalità utente di sistema headless.

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

Restituisce se l'utente principale è un amministratore permanente e non può essere eliminato o sottoposto a downgrade allo stato di utente non amministratore.

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isMultiUserSupported

public boolean isMultiUserSupported ()

Determina se il multiutente è supportato.

Ritorni
`boolean`	true se è supportato il multiutente, 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 è attualmente installato o meno per quell'utente.

Parametri
`packageName`	`String`: il pacchetto di cui stiamo controllando l'installazione.
`userId`	`String`: l'ID utente per il quale stiamo controllando l'installazione del pacchetto. Se nullo, verrà utilizzato lo zero dell'utente principale.

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

Lanci
`DeviceNotAvailableException`

èPacchettoInstallato

public boolean isPackageInstalled (String packageName)

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

Parametri
`packageName`	`String`

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

Lanci
`DeviceNotAvailableException`

isRuntimePermissionSupported

public boolean isRuntimePermissionSupported ()

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

Verifica se un determinato utente è in esecuzione.

Parametri
`userId`	`int`

Ritorni
`boolean`	True se l'utente è in esecuzione, false in tutti gli altri casi.

Lanci
`DeviceNotAvailableException`

èUtenteSecondario

public boolean isUserSecondary (int userId)

Indica se l'utente specificato è un utente secondario in base ai flag.

Parametri
`userId`	`int`

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

Lanci
`DeviceNotAvailableException`

isUserVisible

public boolean isUserVisible (int userId)

Controlla se l'utente specificato è visibile.

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

Parametri
`userId`	`int`

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

UtenteVisibileSuDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Controlla se l'utente specificato è visibile nella visualizzazione specificata.

Un utente "visibile" è un utente che interagisce con l'utente "umano" e quindi è in grado di avviare attività di lancio in quella visualizzazione.

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

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isVisibileBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Restituisce se il dispositivo consente agli utenti di essere avviati in background in ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

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

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

Restituisce se il dispositivo consente agli utenti di essere avviati in background.

In tal caso, puoi chiamare startVisibleBackgroundUser(int, int, boolean), trasmettendo una visualizzazione restituita da listDisplayIdsForStartingVisibleBackgroundUsers().

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isWifiEnabled

public boolean isWifiEnabled ()

Verifica che il Wi-Fi sia 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 ()

Raccogliere l'elenco degli ID display disponibili sul dispositivo, come indicato da "dumpsys SurfaceFlinger".

Ritorni
	L'elenco delle visualizzazioni. Il valore predefinito restituisce sempre il valore visualizzato predefinito 0.

Lanci
`DeviceNotAvailableException`

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

Recupera l'elenco di 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. Viene generato DeviceRuntimeException se l'output del dispositivo non è come previsto.

Ritorni
	l'elenco degli ID utente.

Lanci
`DeviceNotAvailableException`

logAnrs

public boolean logAnrs (ITestLogger logger)

Raccoglie e registra gli errori ANR dal dispositivo.

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

Ritorni
`boolean`	Vero se il logging è riuscito, falso in caso contrario.

Lanci
`DeviceNotAvailableException`

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

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

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

Ritorni
`boolean`	True se il logging è riuscito, false 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 verrà lanciata anche se il logging non va a buon fine.

Parametri
`tag`	`String`: il tag in base al quale registriamo il nostro messaggio nel 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 ()

Emette un comando per riavviare il dispositivo e restituisce il comando al termine e quando il dispositivo non è più visibile ad adb.

Lanci
`DeviceNotAvailableException`

postAdbRootAction

public void postAdbRootAction ()

Sostituisci se il dispositivo richiede alcune azioni specifiche da eseguire dopo il root tramite adb e prima che il dispositivo sia di nuovo online. L'implementazione predefinita non include azioni di aggiunta. Non è garantito che adb root sia abilitato in questa fase.

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

postAdbUnrootAction

public void postAdbUnrootAction ()

Sostituisci se il dispositivo richiede alcune azioni specifiche da eseguire dopo adb unroot e prima che il dispositivo sia di nuovo online. L'implementazione predefinita non include azioni aggiuntive. Non è garantita la disattivazione della directory principale adb in questa fase.

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

postBootSetup

public void postBootSetup ()

Segui le istruzioni per configurare il dispositivo e testarlo dopo ogni avvio.

Deve essere chiamata dopo che il dispositivo è completamente avviato/disponibile

In circostanze normali, non è necessario chiamare questo metodo in modo esplicito, poiché le implementazioni devono eseguire questi passaggi automaticamente quando eseguono un riavvio.

Potrebbe essere necessario chiamarlo quando il dispositivo si riavvia a causa di altri eventi (ad esempio al termine di un comando di aggiornamento fastboot).

Lanci
`DeviceNotAvailableException`

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

Passaggi aggiuntivi per la pulizia richiesta specifica del dispositivo che verranno eseguiti al termine dell'invocazione.

Parametri
`exception`	`Throwable`: se presente, l'eccezione finale sollevata dal fallimento dell'invocazione.

preInvocationSetup

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

Passaggi aggiuntivi per la configurazione richiesta specifica del dispositivo che verranno eseguiti sul dispositivo prima del flusso di chiamata.

Parametri
`info`	`IBuildInfo`: il `IBuildInfo` del dispositivo.
`attributes`	`MultiMap`: gli attributi memorizzati nel contesto di chiamata

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 importare i file
`userId`	`int`: l'ID utente da cui estrarre i dati

Ritorni
`boolean`	`true` se il file è stato recuperato correttamente. `false` in caso contrario.

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 importare i file

Ritorni
`boolean`	`true` se il file è stato recuperato correttamente. `false` in caso contrario.

Lanci
`DeviceNotAvailableException`

pullFile

public boolean pullFile (String remoteFilePath, 
                File localFile)

Recupera un file dal dispositivo.

Parametri
`remoteFilePath`	`String`: il percorso assoluto al 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` in caso contrario.

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 questo File.

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

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 questo 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 al 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 eseguire il pull

Ritorni
`boolean`	`true` se il file è stato recuperato correttamente. `false` in caso contrario.

Lanci
`DeviceNotAvailableException`

pullFileContents

public String pullFileContents (String remoteFilePath)

Recupera un file dal dispositivo e 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, archiviarlo in un file ERROR(/File) temporaneo locale e restituire un riferimento a quel File.

Parametri
`remoteFilePath`	`String`: il percorso del file sul dispositivo, relativo al punto di montaggio della memoria esterna del dispositivo

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)

Esegui il push dei contenuti delle directory sul dispositivo in modo ricorsivo, escludendo alcune directory filtrate.

Parametri
`localFileDir`	`File`: la directory locale da inviare tramite push
`deviceFilePath`	`String`: il percorso file assoluto della destinazione remota
`excludedDirectories`	: insieme di nomi di directory escluse che non devono essere inviate.

Ritorni
`boolean`	`true` se il file è stato inviato correttamente. `false` in caso contrario.

Lanci
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath)

Esegui il push dei contenuti della directory sul dispositivo in modo ricorsivo.

Parametri
`localFileDir`	`File`: la directory locale da inviare tramite push
`deviceFilePath`	`String`: il percorso file assoluto della destinazione remota

Ritorni
`boolean`	`true` se il file è stato inviato correttamente. `false` in caso contrario.

Lanci
`DeviceNotAvailableException`

pushDir

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

Esegui il push dei contenuti della directory sul dispositivo in modo ricorsivo.

Parametri
`localFileDir`	`File`: la directory locale da inviare tramite 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 file è stato inviato correttamente. `false` in caso contrario.

Lanci
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath, 
                boolean evaluateContentProviderNeeded)

Variante di pushFile(File, String) che può eventualmente prendere in considerazione la valutazione del bisogno 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 file è stato inviato correttamente. `false` in caso contrario.

Lanci
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath)

Invia un file al dispositivo. Per impostazione predefinita, viene utilizzato un fornitore di contenuti.

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

Ritorni
`boolean`	`true` se il file è stato inviato correttamente. `false` in caso contrario.

Lanci
`DeviceNotAvailableException`

pushFile

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

Invia un file al dispositivo. Per impostazione predefinita, viene utilizzato un fornitore di contenuti.

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

Ritorni
`boolean`	`true` se il file è stato inviato correttamente. `false` in caso contrario.

Lanci
`DeviceNotAvailableException`

pushString

public boolean pushString (String contents, 
                String remoteFilePath)

Inviare il file creato da una stringa al dispositivo

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

Ritorni
`boolean`	`true` se il push della stringa è stato eseguito correttamente. `false` in caso contrario.

Lanci
`DeviceNotAvailableException`

fai ripartire

public void reboot (String reason)

Riavvia il dispositivo in modalità ADB e l'reason specificato sarà mantenuto fino al riavvio.

Blocca fino a quando il dispositivo non diventa disponibile.

Puoi ottenere il motivo dell'ultimo riavvio eseguendo una query sulla proprietà sys.boot.reason.

Parametri
`reason`	`String`: un motivo per questo riavvio o `null` se non viene 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 finché il dispositivo non è in modalità bootloader.

Lanci
`DeviceNotAvailableException`

rebootIntoFastbootd

public void rebootIntoFastbootd ()

Riavvia il dispositivo in modalità fastbootd.

Blocca finché 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à sideload adb (tieni presente che si tratta di una modalità speciale in fase di recupero)

Blocca fino a quando il dispositivo non entra in modalità sideload

Lanci
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload (boolean autoReboot)

Riavvia il dispositivo in modalità sideload adb (tieni presente che si tratta di una modalità speciale in fase di recupero)

Blocco fino all'attivazione della modalità sideload sul dispositivo

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 fino a quando il dispositivo non è online, ovvero visibile ad adb.

Lanci
`DeviceNotAvailableException`

esegui riavvioUntilOnline

public void rebootUntilOnline (String reason)

Un'alternativa a reboot() che blocca solo fino a quando il dispositivo non è online, ovvero visibile ad adb.

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

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 nello 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 fino a quando il dispositivo non è online, ovvero visibile ad adb.

Lanci
`DeviceNotAvailableException`

ripristinoDispositivo

public boolean recoverDevice ()

Tenta di recuperare la comunicazione con il dispositivo.

Ritorni
`boolean`	True se il recupero è stato tentato e riuscito, restituisce False se il recupero è stato saltato

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 al termine di un'azione del dispositivo.

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

remountSystemReadOnly

public void remountSystemReadOnly ()

Imposta la partizione di sistema sul dispositivo come di sola lettura. Il dispositivo potrebbe riavviarsi.

Lanci
`DeviceNotAvailableException`

remountSystemWritable

public void remountSystemWritable ()

Rendi scrivibile la partizione di sistema del dispositivo. Il dispositivo potrebbe riavviarsi.

Lanci
`DeviceNotAvailableException`

rimontaVendorReadOnly

public void remountVendorReadOnly ()

Imposta la partizione del fornitore sul dispositivo come di sola lettura. Il dispositivo potrebbe riavviarsi.

Lanci
`DeviceNotAvailableException`

remountVendorWritable

public void remountVendorWritable ()

Rendi scrivibile la partizione del fornitore sul dispositivo. Il dispositivo potrebbe riavviarsi.

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

Parametri
`componentName`	`String`: amministratore del dispositivo da rimuovere.
`userId`	`int`: paese in cui risiede l'amministratore del dispositivo.

Ritorni
`boolean`	True se ha esito positivo, falso in caso contrario.

Lanci
`DeviceNotAvailableException`

removeOwners

public void removeOwners ()

Rimuovi tutti i proprietari di profili dei dispositivi esistenti nel modo più semplice possibile.

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 è stato possibile rimuovere l'utente, 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 di utilità per eseguire ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) con uno o più ascoltatori passati come parametri.

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

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

Lanci
`DeviceNotAvailableException`

runInstrumentationTest

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

Esegue test di strumentazione e fornisce il recupero del dispositivo.

Se la connessione con il dispositivo viene persa prima del completamento dell'esecuzione del test e il recupero va a buon fine, tutti gli ascoltatori verranno informati di testRunFailed e verrà restituito "false". Il comando di test non verrà eseguito di nuovo. Se necessario, è compito dei chiamanti riprovare.

Se la connessione con il dispositivo viene persa prima del completamento dell'esecuzione del test e il ripristino non va a buon fine, tutti i listener verranno informati di testRunFailed e verrà generato DeviceNotAvailableException.

Parametri
`runner`	`IRemoteAndroidTestRunner`: il `IRemoteAndroidTestRunner` che esegue i test
`listeners`	: gli ascoltatori 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 recupero è 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`

setConfiguration

public void setConfiguration (IConfiguration configuration)

Invia 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 il root

Parametri
`date`	`Date`: specifica una data specifica; utilizzerà la data host se `null`

Lanci
`DeviceNotAvailableException`

impostaProprietarioDispositivo

public boolean setDeviceOwner (String componentName, 
                int userId)

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

Parametri
`componentName`	`String`: dell'amministratore del dispositivo come proprietario.
`userId`	`int`: dell'utente in cui risiede il proprietario del dispositivo.

Ritorni
`boolean`	True se ha esito positivo, falso in caso contrario.

Lanci
`DeviceNotAvailableException`

setDeviceState

public void setDeviceState (TestDeviceState deviceState)

Aggiorna lo stato del dispositivo.

Parametri
`deviceState`	`TestDeviceState`: `TestDeviceState`

setEmulatorOutputStream

public void setEmulatorOutputStream (SizeLimitedOutputStream output)

Per l'emulatore imposta SizeLimitedOutputStream su log output

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

setEmulatorProcess

public void setEmulatorProcess (Process p)

Imposta Process, se il 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`: se fastboot è disponibile per il dispositivo

setFastbootPath

public void setFastbootPath (String fastbootPath)

Imposta il percorso del programma binario fastboot da utilizzare. È comunque necessario che isFastbootEnabled() sia true e le funzioni fastboot siano abilitate.

Parametri
`fastbootPath`	`String`

setIDevice

public void setIDevice (IDevice newDevice)

Aggiorna l'IDevice associato a questo ITestDevice.

Il nuovo dispositivo deve fare riferimento allo stesso dispositivo fisico come riferimento corrente. 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 ms da attendere prima di avviare l'acquisizione di logcat per un dispositivo online.

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

impostaOpzioni

public void setOptions (TestDeviceOptions options)

Impostare TestDeviceOptions per il dispositivo

Parametri
`options`	`TestDeviceOptions`

setProperty

public boolean setProperty (String propKey, 
                String propValue)

Imposta il valore della proprietà specificato sul dispositivo. Richiede che la radice ADB 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 è andato a buon fine, False in caso contrario.

Lanci
`DeviceNotAvailableException`

setRecovery

public void setRecovery (IDeviceRecovery recovery)

Imposta il 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 ripristino corrente da utilizzare per il dispositivo.

Utilizzato per controllare il metodo di recupero da utilizzare quando si verifica un problema di comunicazione del dispositivo. Ti consigliamo di utilizzare questo metodo solo se necessario (ad esempio quando il framework non è disponibile e così via).

Parametri
`mode`	`ITestDevice.RecoveryMode`: indica se la modalità "recupera fino a solo online" deve essere attivata o meno.

setSetting

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

Vedi setSetting(int, String, String, String) e eseguita sull'utente di sistema.

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

Lanci
`DeviceNotAvailableException`

impostazioniImpostazione

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, traccia il numero di serie che utilizziamo per fare riferimento al dispositivo.

Parametri
`trackingSerial`	`String`

setUseFastbootErase

public void setUseFastbootErase (boolean useFastbootErase)

Scegli se utilizzare il formato fastboot reset o fastboot per cancellare una partizione sul dispositivo.

Parametri
`useFastbootErase`	`boolean`: `true` se è necessario usare il reset fastboot oppure `false` se è necessario usare il formato fastboot.

startLogcat

public void startLogcat ()

Avvia l'acquisizione dell'output logcat dal dispositivo in background.

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

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

In genere, non è necessario chiamare startLogcat() e stopLogcat() all'interno di un contesto di chiamata di TF, poiché il framework TF avvia e arresta logcat.

startUser

public boolean startUser (int userId)

Avvia un determinato utente in background se è attualmente fermo. Se l'utente è già in esecuzione in background, questo metodo è un 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 fermo. Se l'utente è già in esecuzione in background, questo metodo è un NOOP. È possibile fornire un flag aggiuntivo per attendere che l'operazione abbia effetto.

Parametri
`userId`	`int`: dell'utente da avviare in background
`waitFlag`	`boolean`: attenderà che l'utente venga avviato e sbloccato.

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 nella visualizzazione in questione (ovvero consente all'utente di avviare attività in quella visualizzazione).

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 su cui iniziare a mostrare l'utente
`waitFlag`	`boolean`: il comando attenderà che l'utente venga avviato e sbloccato.

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

Lanci
`DeviceNotAvailableException`

stopEmulatorOutput

public void stopEmulatorOutput ()

Chiudi ed elimina l'output dell'emulatore.

stopLogcat

public void stopLogcat ()

Interrompi l'acquisizione dell'output di Logcat dal dispositivo ed elimina i dati di Logcat attualmente salvati.

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

stopUser

public boolean stopUser (int userId)

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

Parametri
`userId`	`int`: dell'utente di interrompere.

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

Lanci
`DeviceNotAvailableException`

stopUser

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

Interrompere un determinato utente. È possibile fornire flag aggiuntivi per attendere l'applicazione dell'operazione e forzare l'interruzione dell'utente. Impossibile interrompere l'utente corrente e quello di sistema.

Parametri
`userId`	`int`: dell'utente di interrompere.
`waitFlag`	`boolean`: il comando attenderà finché l'utente non si fermerà.
`forceFlag`	`boolean`: forza l'interruzione dell'utente.

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

Lanci
`DeviceNotAvailableException`

switchToAdbTcp

public String switchToAdbTcp ()

Passa il dispositivo alla modalità adb-over-tcp.

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

Lanci
`DeviceNotAvailableException`

switchToAdbUsb

public boolean switchToAdbUsb ()

Passa al dispositivo in modalità ADB su USB.

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

Lanci
`DeviceNotAvailableException`

cambiautente

public boolean switchUser (int userId)

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

Parametri
`userId`	`int`

Ritorni
`boolean`	True se il nuovo userId corrisponde al provider userId. Falso negli altri casi.

Lanci
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId, 
                long timeout)

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

Parametri
`userId`	`int`
`timeout`	`long`: l'attesa prima di restituire false per lo scambio utente non è riuscita.

Ritorni
`boolean`	True se il nuovo userId corrisponde al provider 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 inviare confrontando i timestamp dei file locali con i relativi equivalenti remoti. Solo i file "più recenti" o inesistenti verranno inviati al dispositivo. Pertanto, il sovraccarico dovrebbe essere relativamente ridotto se il file impostato sul dispositivo è già aggiornato.

I file nascosti (con nomi che iniziano con ".") verranno ignorati.

Esempio di utilizzo: syncFiles("/tmp/files", "/sdcard") creerà una directory /sdcard/files, se non esiste già, e invierà in modo ricorsivo i contenuti di /tmp/files a /sdcard/files.

Parametri
`localFileDir`	`File`: la directory dei file locale contenente i file da eseguire push 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 trasferimento a /data/local/tmp quando adb non è root non andrà a buon fine

Ritorni
`boolean`	`true` se i file sono stati sincronizzati correttamente. `false` in caso contrario.

Lanci
`DeviceNotAvailableException`

takeBugreport

public Bugreport takeBugreport ()

Prende un report di bug e lo restituisce all'interno di un oggetto Bugreport per gestirlo. Restituisci nullo in caso di problemi. Il file a cui si fa 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` se l'operazione è riuscita.

Lanci
`DeviceNotAvailableException`

disinstallaPacchettoPerUtente

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 per cui eseguire la disinstallazione.

Ritorni
`String`	un `String` con un codice di errore o `null` se l'operazione è riuscita.

Lanci
`DeviceNotAvailableException`

unlockDevice

public boolean unlockDevice ()

Sblocca il dispositivo se è in stato criptato.

Questo metodo potrebbe riavviare il framework, ma non chiamerà postBootSetup(). Pertanto, il dispositivo potrebbe non essere completamente pronto per essere testato al ritorno di questo metodo.

Ritorni
`boolean`	`true` se l'operazione è andata a buon fine o se il dispositivo non è criptato.

Lanci
`DeviceNotAvailableException`

unmountDebugfs

public void unmountDebugfs ()

Smonta il debugfs.

Lanci
`DeviceNotAvailableException`

waitForBootComplete

public boolean waitForBootComplete (long timeOut)

Si blocca finché non viene impostato il flag di completamento dell'avvio del dispositivo.

Parametri
`timeOut`	`long`: tempo in millisecondi di attesa per l'impostazione del flag

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 risponda e sia disponibile per i test. Utilizza il timeout predefinito.

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

Lanci
`DeviceNotAvailableException`

waitForDeviceAvailable

public boolean waitForDeviceAvailable (long waitTime)

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

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

Ritorni
`boolean`	True se il dispositivo è disponibile, False se il recupero è 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`	True se il dispositivo è disponibile, False se non è disponibile.

Lanci
`DeviceNotAvailableException`

waitForDeviceBootloader

public void waitForDeviceBootloader ()

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

Lanci
`DeviceNotAvailableException`

waitForDeviceInRecovery

public boolean waitForDeviceInRecovery (long waitTime)

Impedisce al dispositivo di trovarsi nello stato "adb recovery" (tieni presente che questo è 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)

Blocca il dispositivo in stato "sideload adb"

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

Ritorni
`boolean`	`true` se il dispositivo viene avviato 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 sia presente in adb

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

Ritorni
`boolean`	`true` se il dispositivo non diventa disponibile prima della scadenza del tempo. `false` altrimenti

waitForDeviceOnline

public void waitForDeviceOnline ()

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

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

Lanci
`DeviceNotAvailableException`

waitForDeviceOnline

public void waitForDeviceOnline (long waitTime)

Si blocca finché il dispositivo non è visibile tramite ADB.

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

Parametri
`waitTime`	`long`: tempo di attesa in ms

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 risponde prima del termine del periodo `waitTime`.

Metodi protetti

addExtraConnectionBuilderArgs

protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

Parametri
`builder`	`DefaultConnection.ConnectionBuilder`

buildAdbShellCommand

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

Genera 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`	l'elemento `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`

initializeConnection

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

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

Lanci
`DeviceNotAvailableException`
`TargetSetupError`

internalGetProperty

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

Recupera una proprietà del dispositivo, dalla cache ddmlib per impostazione predefinita, e utilizza "adb shell getprop" o "fastboot getvar" a seconda che il dispositivo sia in 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 su cui eseguire la query. Se `null`, non verrà tentata la query fastboot.
`description`	`String`: una semplice descrizione della variabile. La prima lettera deve essere maiuscola.

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

Lanci
`DeviceNotAvailableException`

isInRebootCallback

protected boolean isInRebootCallback ()

Restituisce se i richiami di riavvio sono attualmente in esecuzione o meno. Se true, tutte le API pubbliche per il riavvio devono essere disabilitate.

Ritorni
`boolean`

isNewer

protected boolean isNewer (File localFile, 
                IFileEntry entry)

Restituisce true se il file locale è più recente del file remoto. Con una precisione al minuto di IFileEntry, in caso di numero uguale, il file verrà considerato più recente.

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

Ritorni
`boolean`

notifyRebootEnded

protected void notifyRebootEnded ()

Invia una notifica a tutti gli IDeviceActionReceiver sull'evento di fine del riavvio.

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

notifyRebootStarted

protected void notifyRebootStarted ()

Invia una notifica a tutti gli IDeviceActionReceiver sull'evento di inizio del riavvio.

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

performDeviceAction

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

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

Parametri
`actionDescription`	`String`: una breve descrizione dell'azione da eseguire. Utilizzata solo a scopo di registrazione.
`action`	`NativeDevice.DeviceAction`: l'azione da eseguire
`retryAttempts`	`int`: il nuovo tentativo di esecuzione dell'azione se non riesce, ma il recupero va a buon fine

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

Lanci
`DeviceNotAvailableException`	if recovery attempt fails or max attempts done without success

postAdbRiavvia

protected void postAdbReboot ()

Possibili azioni aggiuntive che possono essere intraprese dopo un riavvio.

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

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

pullFileInternal

protected boolean pullFileInternal (String remoteFilePath, 
                File localFile)

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

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

impostaOrologio

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 ID cliente.

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`

attesaPerDispositivoNonDisponibile

protected boolean waitForDeviceNotAvailable (String operationDesc, 
                long time)

Attendi che il dispositivo non sia più disponibile (interrompi i report ad adb).

Parametri
`operationDesc`	`String`: il nome dell'operazione in attesa di disponibilità.
`time`	`long`: il tempo di attesa per l'evento non disponibile.

Ritorni
`boolean`	Vero se il dispositivo non è più disponibile.

NativeDevice

Riepilogo

Classi nidificate

Costanti

Campi

Costruttori pubblici

Metodi pubblici

Metodi protetti

Costanti

INVALID_USER_ID

MAX_HOST_DEVICE_TIME_OFFSET

MAX_RETRY_ATTEMPTS

Campi

DEBUGFS_PATH

SD_CARD

STORAGE_EMULATED

Opzioni m

mStateMonitor

Costruttori pubblici

NativeDevice

Metodi pubblici

batchPrefetchStartupBuildProps

CANNOT TRANSLATE

checkApiLevelAgainstNextRelease

checkConnectivity

Finestra di dialogo di errore

clearLastConnectedWifiNetwork

clearLogcat

connettitiaallareteWifi

connettitiaallareteWifi

connettitiaallareteWifi

connettitiaallareteWifi

connectToWifiNetworkIfNeeded

connectToWifiNetworkIfNeeded

createUser

createUser

CreaUtente

createUserNoThrow

deleteFile

deleteFile

deregisterDeviceActionReceiver

deviceSoftRestarted

deviceSoftRestartedSince

disableAdbRoot

disableKeyguard

disableNetworkMonitor

disconnectFromWifi

doesFileExist

fileExist

dumpHeap

enableAdbRoot

enableNetworkMonitor

executeAdbCommand

executeAdbCommand

executeAdbCommand

eseguireFastbootCommand

eseguireFastbootCommand

executeLongFastbootCommand

executeLongFastbootCommand

executeShellCommand

eseguireShellCommand

eseguireShellCommand

executeShellCommand

executeShellV2Command

eseguireShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

fastbootWipePartition

getActiveApexes

getAllSettings

getAllocationState

getAndroidId

getAndroidIds

getApiLevel

getAppPackageInfo

getAppPackageInfos

getBasebandVersion