A partire dal 27 marzo 2025, ti consigliamo di utilizzare android-latest-release anziché aosp-main per compilare e contribuire ad AOSP. Per ulteriori informazioni, vedi Modifiche ad AOSP.

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

Classi di sottoclasse dirette note

TestDevice

TestDevice 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	Estensione del comportamento di `RemoteAndroidDevice` per un dispositivo Android full stack in esecuzione su 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 che il dispositivo abbia connettività di rete.
`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 nome e gli indicatori specificati
`int`	`createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)` Crea un utente con un nome e gli indicatori specificati
`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.
`DeviceInspectionResult`	`debugDeviceNotAvailable()` Ispeziona un dispositivo e restituisci informazioni dettagliate quando un dispositivo non è disponibile.
`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 il root ADB.
`void`	`disableKeyguard()` Tenta di disattivare la tastiera protetta.
`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)` Prova a 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 di supporto 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 di supporto che cancella una partizione del 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 restituisce l'id Android 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 le informazioni sui pacchetti installati sul dispositivo.
`String`	`getBasebandVersion()` Metodo pratico per ottenere la versione 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 e il motivo dell'avvio dall'ora indicata 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 un bugreportz 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 `DeviceDescriptor` memorizzato nella cache se il dispositivo è allocato, altrimenti restituisce il `DeviceDescriptor` corrente.
`DeviceDescriptor`	`getCachedDeviceDescriptor(boolean shortDescriptor)` Restituisce un `DeviceDescriptor` memorizzato nella cache se il dispositivo è allocato, altrimenti restituisce il `DeviceDescriptor` corrente.
`String[]`	`getChildren(String path)` Alternativa all'utilizzo di `IFileEntry` che a volte non funziona a causa delle autorizzazioni.
`AbstractConnection`	`getConnection()` La connessione 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()` Restituire un `DeviceDescriptor` dalle informazioni del dispositivo per ottenere informazioni su di esso senza dover passare l'oggetto del dispositivo effettivo.
`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 `executeShellCommand(String)`.
`long`	`getExternalStoreFreeSpace()` Metodo di supporto per determinare la quantità di spazio libero sullo spazio di archiviazione esterno 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 della versione del file 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()` Restituisce un oggetto per ottenere lo stato corrente della schermata di blocco 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 uno stream di snapshot dei dati di logcat.
`InputStreamSource`	`getLogcat(int maxBytes)` Acquisisce uno stream di snapshot degli ultimi `maxBytes` dati logcat acquisiti.
`InputStreamSource`	`getLogcatDump()` Ottieni un dump del logcat corrente per il dispositivo.
`InputStreamSource`	`getLogcatSince(long date)` Acquisisce uno stream di snapshot dei dati logcat acquisiti a partire dalla data indicata.
`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()` Visualizza le informazioni sui moduli 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 o `null` se non è montato nulla in quel percorso o se non viene visualizzato come punto di montaggio in /proc/mounts.
	`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)` Acquisisce uno screenshot del dispositivo specificato dall'ID visualizzazione.
`InputStreamSource`	`getScreenshot(String format)` Acquisisce uno screenshot dal dispositivo.
`InputStreamSource`	`getScreenshot(String format, boolean rescale)` Acquisisce uno screenshot dal dispositivo.
`InputStreamSource`	`getScreenshot()` Acquisisce uno screenshot dal dispositivo.
`String`	`getSerialNumber()` Metodo pratico per ottenere il numero di serie di questo dispositivo.
`String`	`getSetting(int userId, String namespace, String key)` Restituisce il valore dell'impostazione richiesta.
`String`	`getSetting(String namespace, String key)` Vedi `getSetting(int, String, String)` e eseguita sull'utente di sistema.
`String`	`getSimOperator()` Restituisce l'operatore della scheda SIM o null se non disponibile o se il dispositivo non è disponibile.
`String`	`getSimState()` Restituisce lo stato della scheda SIM o null se non è disponibile o se il dispositivo non è disponibile.
	`getTombstones()` Recupera e restituisce l'elenco delle tombstone dai dispositivi.
`long`	`getTotalMemory()` Restituisce le dimensioni totali della memoria fisica in byte o -1 in caso di errore interno
`String`	`getTrackingSerial()` Per la gestione 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 a `UserInfo` sul dispositivo.
`int`	`getUserSerialNumber(int userId)` Restituisce il numero di serie associato a 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)` Controllare 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 nelle 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, altrimenti restituisce false.
`boolean`	`isFastbootEnabled()` Restituire se il fastboot è disponibile per il dispositivo.
`boolean`	`isHeadless()` Restituisce true se il dispositivo è senza display (senza 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 un determinato nome del pacchetto e un determinato ID utente per verificare se è attualmente installato o meno per quell'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)` Restituisce se l'utente specificato è un utente secondario in base ai relativi 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 se il Wi-Fi è 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 risultato al termine del comando e quando il dispositivo non è più visibile ad adb.
`void`	`postAdbRootAction()` Sostituisci se il dispositivo richiede alcune azioni specifiche 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 richiesta specifica del dispositivo che verranno eseguiti al termine dell'invocazione.
`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 recupero) 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) Blocca fino a quando il dispositivo non entra in modalità sideload
`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 blocca solo fino a quando il dispositivo non è online, ovvero 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 con il massimo impegno.
`boolean`	`removeUser(int userId)` Rimuovere un determinato utente dal dispositivo.
`void`	`resetContentProviderSetup()` Reimposta il flag per la configurazione del fornitore di contenuti per riattivarlo.
`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)` È uguale a `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)` Invia il `IConfiguration` in uso.
`final void`	`setConnectionAvdInfo(GceAvdInfo avdInfo)`
`void`	`setDate(Date date)` Imposta la data sul dispositivo Nota: l'impostazione della data sul dispositivo richiede 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 il `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)` Per la gestione del dispositivo, monitora 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`	`startTradeInModeTesting(int timeoutMs)` Attiva la modalità di test per la permuta.
`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.
`void`	`stopTradeInModeTesting()` Interrompi i test della modalità permuta.
`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 il dispositivo alla modalità adb tramite USB.
`boolean`	`switchUser(int userId)` Passa a un altro userId con un timeout predefinito.
`boolean`	`switchUser(int userId, long timeout)` Passa a un altro userId con il timeout specificato 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 debugfs.
`boolean`	`waitForBootComplete(long timeOut)` Blocca fino al momento in cui 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()` Blocca fino a quando 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 esegui 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 di ddmlib per impostazione predefinita e passa a "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 una notifica a tutti i `IDeviceActionReceiver` sull'evento di fine del riavvio.
`void`	`notifyRebootStarted()` Invia una notifica a tutti gli `IDeviceActionReceiver` sull'evento di inizio 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 post-boot specifica.
`boolean`	`pullFileInternal(String remoteFilePath, File localFile)`
`void`	`setClock(Clock clock)` Imposta l'istanza di Orologio da utilizzare.
`void`	`setMicrodroidProcess(Process process)` Contrassegna TestDevice come microdroid e imposta il relativo 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 non sia più disponibile (interrompi i report 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

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

Costruttori pubblici

NativeDevice

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

Crea un TestDevice.

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

Metodi pubblici

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

Microottimizzazione (circa 400 millisecondi) tramite il pre-caricamento di tutte le proprietà di cui abbiamo bisogno anziché chiamare "adb getprop" per ciascuna. In altre parole, è altrettanto veloce recuperare tutte le proprietà quanto recuperarne una. Funzionalità come device.getApiLevel(), checkApiLevelAgainstNextRelease e getBuildAlias chiamano tutte adb getprop sotto il cofano. Li recuperiamo in una chiamata e chiamiamo NativeDevice.setProperty. Anche se non lo facciamo, NativeDevice chiamerà setProperty e memorizzerà nella cache il risultato per le chiamate future. Lo stiamo facendo solo un po' prima. Se il dispositivo è in modalità di recupero o se si verificano altri errori durante il recupero degli elementi, li ignoriamo.

canSwitchToHeadlessSystemUser

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 in base a un livello di supporto minimo. 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`

clearErrorDialogs

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 metodo 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 di log generati dopo un determinato punto (ad esempio dopo il flashing di una nuova build del dispositivo e così via).

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Si connette a una rete Wi-Fi.

Attiva il Wi-Fi e 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 eseguire la ricerca di SSID nascosti per questa rete.

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

Lanci
`DeviceNotAvailableException`

connectToWifiNetwork

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

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

Lanci
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk)

Si connette a una rete Wi-Fi.

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`

connectToWifiNetwork

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

Si connette a una rete Wi-Fi.

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 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, 
                boolean scanSsid)

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

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

connectToWifiNetworkIfNeeded

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

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`: abilita 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`: abilita il flag utente --guest durante la creazione
`ephemeral`	`boolean`: attiva il flag utente --ephemeral durante la creazione
`forTesting`	`boolean`: attiva il flag di test --for-testing durante la creazione

Ritorni
`int`	ID dell'utente creato

Lanci
`DeviceNotAvailableException`

createUser

public int createUser (String name)

Crea un utente con un nome 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`

debugDeviceNotAvailable

public DeviceInspectionResult debugDeviceNotAvailable ()

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

Ritorni
`DeviceInspectionResult`

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 di supporto per verificare se il dispositivo è stato riavviato in modo soft confrontando il sistema_server corrente con il sistema_server precedente ProcessInfo. Usa getProcessByName(String) per ottenere ProcessInfo.

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

Ritorni
`boolean`	`true` se il dispositivo è stato riavviato in 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 verrà bloccato fino a quando il dispositivo non sarà disponibile.

Ritorni
`boolean`	`true` se l'operazione è riuscita.

Lanci
`DeviceNotAvailableException`

disableKeyguard

public void disableKeyguard ()

Tenta di disattivare la tastiera protetta.

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 non è andato a buon fine.

Lanci
`DeviceNotAvailableException`

disconnectFromWifi

public boolean disconnectFromWifi ()

Si disconnette da una rete Wi-Fi.

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

Ritorni
`boolean`	`true` se si è disconnesso dalla rete Wi-Fi. `false` if disconnect failed.

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`

doesFileExist

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`	il `ERROR(/File)` contenente il report. Valore nullo 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 è riuscita.

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 è andato a buon fine.

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.

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

Parametri
`timeout`	`long`: il tempo in millisecondi prima che il dispositivo venga considerato non rispondente, 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`: il tempo in millisecondi prima che il dispositivo venga considerato non rispondente, 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 di supporto 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`

executeFastbootCommand

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`

executeFastbootCommand

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`: il 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), tranne per il fatto che utilizza un timeout più lungo.

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

Ritorni
`CommandResult`	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`

executeShellCommand

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

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

Parametri
`command`	`String`: il comando adb shell da eseguire
`receiver`	`IShellOutputReceiver`: il `IShellOutputReceiver` a cui indirizzare l'output della shell.
`maxTimeToOutputShellResponse`	`long`: il periodo di tempo massimo durante il quale il comando è 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 le operazioni `retryAttempts` vengono eseguite senza esito.

Lanci
`DeviceNotAvailableException`

executeShellCommand

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

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

Parametri
`command`	`String`: il comando adb shell da eseguire
`receiver`	`IShellOutputReceiver`: il `IShellOutputReceiver` a cui indirizzare l'output della shell.
`maxTimeoutForCommand`	`long`: il timeout massimo per il completamento del comando; unità come specificato in `timeUnit`
`maxTimeToOutputShellResponse`	`long`: il periodo di tempo massimo durante il quale il comando è 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 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.

Ritorni
`CommandResult`	Il risultato in `CommandResult`.

Lanci
`DeviceNotAvailableException`

executeShellV2Command

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 adb shell da eseguire
`maxTimeoutForCommand`	`long`: il timeout massimo per il completamento del comando; unità come specificato in `timeUnit`
`timeUnit`	`TimeUnit`: unità per `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: il numero massimo di volte per 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.

Ritorni
`CommandResult`

Lanci
`DeviceNotAvailableException`

executeShellV2Command

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

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

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

Ritorni
`CommandResult`

Lanci
`DeviceNotAvailableException`

executeShellV2Command

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

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

Parametri
`cmd`	`String`: il comando adb shell da eseguire
`pipeAsInput`	`File`: un `ERROR(/File)` che verrà incanalato come input al comando o nullo.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` dove verrà reindirizzato l'output standard o null.
`maxTimeoutForCommand`	`long`: il timeout massimo per il completamento del comando; unità come specificato in `timeUnit`
`timeUnit`	`TimeUnit`: unità per `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: il numero massimo di 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.

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à incanalato come input al comando o nullo.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` dove verrà reindirizzato l'output standard o null.
`pipeToError`	`OutputStream`: `ERROR(/OutputStream)` dove verrà reindirizzato l'errore standard o null.
`maxTimeoutForCommand`	`long`: il timeout massimo per il completamento del comando; unità come specificato in `timeUnit`
`timeUnit`	`TimeUnit`: unità per `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: il numero massimo di 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.

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. Al successivo riavvio, il dispositivo deve creare un file system. In caso contrario, viene utilizzato il comando fastboot format, 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
	`ERROR(/Set)` di `ApexInfo` attualmente attivati sul dispositivo

Lanci
`DeviceNotAvailableException`

getAllSettings

public  getAllSettings (String namespace)

Restituisce le 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 è garantito che a ogni ID utente sia associato un ID Android in questa funzione, pertanto alcuni ID utente potrebbero corrispondere a null.

Ritorni
	Mappa degli ID Android trovati corrispondenti agli ID utente.

Lanci
`DeviceNotAvailableException`

getApiLevel

public int getApiLevel ()

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

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

Lanci
`DeviceNotAvailableException`

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Recupera 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 banda di base (radio) di questo dispositivo. L'ottenimento della versione radio è specifica per il 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 corrente della batteria di un dispositivo o Null se il livello della batteria non è disponibile.

Ritorni
`Integer`

getBooleanProperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

Restituisce il valore booleano della proprietà specificata.

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

Ritorni
`boolean`	`true` se la proprietà ha valore `"1"`, `"y"`, `"yes"`, `"on"` o `"true"`, `false` se la proprietà ha valore `"0"`, `"n"`, `"no"`, `"off"`, `"false"` o `defaultValue` 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 e il motivo dell'avvio dall'ora indicata 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`: l'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.

Verrà tentata la restituzione della versione del bootloader dallo stato corrente 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à continuerà a funzionare su un dispositivo senza scheda SD (o in cui la scheda SD non è ancora montata).

Ritorni
`InputStreamSource`	Un `InputStreamSource` che produrrà i contenuti del report 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.

Supportato solo per "versione adb" > 1.0.36

Ritorni
`InputStreamSource`	un `InputStreamSource` del file zip contenente il bugreportz, restituisce nullo 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 l'ID build di riserva se non è stato possibile recuperarlo

Lanci
`DeviceNotAvailableException`

getBuildFlavor

public String getBuildFlavor ()

Recupera il flavor di build per il dispositivo.

Ritorni
`String`	il flavor di build o null se non è stato possibile recuperarlo

Lanci
`DeviceNotAvailableException`

getBuildId

public String getBuildId ()

Recupera la build attualmente in esecuzione sul dispositivo.

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

Lanci
`DeviceNotAvailableException`

getBuildSigningKeys

public String getBuildSigningKeys ()

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

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

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

Lanci
`DeviceNotAvailableException`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

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

Ritorni
`DeviceDescriptor`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

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

Ritorni
`DeviceDescriptor`

getChildren

public String[] getChildren (String path)

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

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

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

Lanci
`DeviceNotAvailableException`

getConnection

public AbstractConnection getConnection ()

La connessione corrente 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 lo stato attuale del dispositivo pieghevole o null se si sono verificati problemi.

Ritorni
`DeviceFoldableState`

Lanci
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

Restituisce l'ID dell'utente corrente in esecuzione. In caso di errore, restituisce -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 ()

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

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 alle informazioni minime

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 lo stream 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 executeShellCommand(String).

Ritorni
`File`

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

Metodo di supporto per determinare la quantità di spazio libero sullo spazio di archiviazione esterno 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. Per l'attivazione delle funzioni di fastboot è comunque necessario che isFastbootEnabled() sia true.

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. In questo caso è una variante un po' più sicura rispetto al metodo generico getProductType(), perché ITestDevice sa come recuperare il dispositivo in fastboot se è in uno stato errato o non risponde.

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

Lanci
`DeviceNotAvailableException`

getFastbootProductVariant

public String getFastbootProductVariant ()

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

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

Lanci
`DeviceNotAvailableException`

getFastbootSerialNumber

public String getFastbootSerialNumber ()

Restituisce il numero di serie della modalità Fastboot.

Ritorni
`String`

getFastbootVariable

public String getFastbootVariable (String variableName)

Recupera il valore della variabile fastboot 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 della versione del file 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. DA FARE: ristrutturare il sistema FileEntry in modo che sia disponibile da qualsiasi percorso. (anche non root).

Parametri
`entry`	`FileListingService.FileEntry`: un `FileEntry` non necessariamente radice 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. Pertanto, gli utenti che chiamano non devono conservare un riferimento a IDevice, poiché questo riferimento potrebbe diventare obsoleto.

Ritorni
`IDevice`	`IDevice`

getInstalledPackageNames

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 schermata di blocco 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 dall'epoca EPOCH come riportato 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 lanciato del dispositivo

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, restituisce fino a TestDeviceOptions.getMaxLogcatDataSize() byte dei contenuti correnti dell'acquisizione di logcat in background

In caso contrario, restituirà un dump statico dei dati di logcat se il dispositivo è attualmente in risposta

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 un importo che possa essere memorizzato 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 dall'epoca del momento in cui 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'attributo userId dell'utente principale, se presente, e null se non è presente alcun 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 ()

Restituisce il IDeviceStateMonitor associato al dispositivo.

Ritorni
`IDeviceStateMonitor`

getMountPoint

public String getMountPoint (String mountName)

Restituisce un punto di montaggio.

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

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

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

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

getMountPointInfo

public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

Restituisce un MountPointInfo corrispondente al percorso del punto di montaggio specificato 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 del nome processo specificato

Lanci
`DeviceNotAvailableException`

getProcessPid

public String getProcessPid (String process)

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

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

Ritorni
`String`

Lanci
`DeviceNotAvailableException`

getProductType

public String getProductType ()

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

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

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

Lanci
`DeviceNotAvailableException`

getProductVariant

public String getProductVariant ()

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

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

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

Lanci
`DeviceNotAvailableException`

getProperty

public String getProperty (String name)

Recupera il valore della proprietà 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)

Acquisisce uno screenshot del dispositivo specificato dall'ID visualizzazione. 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 in formato o `null` se lo screenshot non è andato a buon fine.

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 getScreenshot(String) con la codifica JPEG per dimensioni inferiori.

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

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

Lanci
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot ()

Acquisisce uno screenshot dal dispositivo.

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

Lanci
`DeviceNotAvailableException`

getSerialNumber

public String getSerialNumber ()

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

Ritorni
`String`	il numero di serie `String`

getSetting

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

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

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

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

Lanci
`DeviceNotAvailableException`

getSetting

public String getSetting (String namespace, 
                String key)

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

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

Ritorni
`String`

Lanci
`DeviceNotAvailableException`

getSimOperator

public String getSimOperator ()

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

Ritorni
`String`

getSimState

public String getSimState ()

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

Ritorni
`String`

getTombstones

public  getTombstones ()

Recupera e restituisce l'elenco delle tombstone dai dispositivi. Richiede i permessi di 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 le dimensioni totali 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 la cancellazione tramite fastboot o `false` se verrà utilizzato il formato tramite fastboot.

getUserFlags

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

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)

Controllare se una funzionalità è disponibile su un dispositivo.

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

Ritorni
`boolean`	Vero se l'elemento viene trovato, 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 deve essere eseguita una reinstallazione
`grantPermissions`	`boolean`: se tutte le autorizzazioni di runtime devono essere concesse al momento dell'installazione
`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`

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 cui eseguire l'installazione.
`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`

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 deve essere eseguita una reinstallazione
`grantPermissions`	`boolean`: se tutte le autorizzazioni di runtime devono essere concesse al momento dell'installazione
`userId`	`int`: l'ID utente intero per cui eseguire l'installazione.
`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`

invalidatePropertyCache

public void invalidatePropertyCache ()

isAdbRoot

public boolean isAdbRoot ()

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isAdbTcp

public boolean isAdbTcp ()

Ritorni
`boolean`

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

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

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

Lanci
`DeviceNotAvailableException`

isBypassLowTargetSdkBlockSupported

public boolean isBypassLowTargetSdkBlockSupported ()

Verificare se la piattaforma sul dispositivo supporta il bypass del blocco dell'SDK target basso nelle installazioni di app

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

isEnableAdbRoot

public boolean isEnableAdbRoot ()

Ritorni
`boolean`	`true` se è necessario attivare il privilegio di accesso come amministratore 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 (senza schermo), false altrimenti.

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

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

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 cui stiamo controllando l'installazione del pacchetto. Se è null, verrà utilizzato un valore di zero per l'utente principale.

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

Lanci
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName)

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

Parametri
`packageName`	`String`

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

Lanci
`DeviceNotAvailableException`

isRuntimePermissionSupported

public boolean isRuntimePermissionSupported ()

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`	Vero se l'utente è in esecuzione, falso in tutti gli altri casi.

Lanci
`DeviceNotAvailableException`

isUserSecondary

public boolean isUserSecondary (int userId)

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

Parametri
`userId`	`int`

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

Lanci
`DeviceNotAvailableException`

isUserVisible

public boolean isUserVisible (int userId)

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`

isUserVisibleOnDisplay

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`

isVisibleBackgroundUsersOnDefaultDisplaySupported

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 questo caso, puoi chiamare startVisibleBackgroundUser(int, int, boolean), passando un visualizzatore restituito da listDisplayIdsForStartingVisibleBackgroundUsers().

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isWifiEnabled

public boolean isWifiEnabled ()

Verifica se il Wi-Fi è attivo.

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

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

Lanci
`DeviceNotAvailableException`

listDisplayIds

public  listDisplayIds ()

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 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 il report di bug.

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

logOnDevice

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

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

Parametri
`tag`	`String`: il tag sotto il quale registriamo il 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 risultato al termine del comando e quando il dispositivo non è più visibile ad adb.

Lanci
`DeviceNotAvailableException`

postAdbRootAction

public void postAdbRootAction ()

Sostituisci se il dispositivo richiede alcune azioni specifiche 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 è garantito che adb root sia disabilitato in questa fase.

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

postBootSetup

public void postBootSetup ()

Segui le istruzioni per configurare il dispositivo per i test dopo ogni avvio.

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

In circostanze normali, questo metodo non deve essere chiamato esplicitamente, poiché le implementazioni dovrebbero eseguire questi passaggi automaticamente durante il 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 estratto 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 estratto 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 del file sul dispositivo.
`localFile`	`File`: il file locale in cui memorizzare 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 estrarre i dati

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

Lanci
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath)

Recupera un file dal dispositivo, lo memorizza in un ERROR(/File) temporaneo locale e restituisce 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 del file sul dispositivo.
`localFile`	`File`: il file locale in cui memorizzare i contenuti. Se non è vuoto, i contenuti verranno sostituiti.
`userId`	`int`: l'ID utente da cui estrarre i dati

Ritorni
`boolean`	`true` se il file è stato recuperato correttamente. `false` 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 dallo spazio di archiviazione esterno del dispositivo, memorizzarlo in un ERROR(/File)temporaneo locale e restituire un riferimento a quel File.

Parametri
`remoteFilePath`	`String`: il percorso del file sul dispositivo, rispetto al mountpoint dello spazio di archiviazione esterno 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 spingere
`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 spingere
`remoteFilePath`	`String`: il percorso file assoluto della 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 spingere
`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 la stringa è stata inviata correttamente. `false` in caso contrario.

Lanci
`DeviceNotAvailableException`

fai ripartire

public void reboot (String reason)

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

Blocca fino a quando il dispositivo non diventa disponibile.

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

Parametri
`reason`	`String`: un motivo per questo riavvio o `null` se non 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)

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

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`

rebootUntilOnline

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`

recoverDevice

public boolean recoverDevice ()

Tenta di recuperare la comunicazione con il dispositivo.

Ritorni
`boolean`	Vero 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 la partizione di sistema sul dispositivo scrivibile. Il dispositivo potrebbe riavviarsi.

Lanci
`DeviceNotAvailableException`

remountVendorReadOnly

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 la partizione del fornitore sul dispositivo scrivibile. 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`: dell'amministratore del dispositivo da rimuovere.
`userId`	`int`: paese in cui risiede l'amministratore del dispositivo.

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

Lanci
`DeviceNotAvailableException`

removeOwners

public void removeOwners ()

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

Lanci
`DeviceNotAvailableException`

removeUser

public boolean removeUser (int userId)

Rimuovere un determinato utente dal dispositivo.

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

Ritorni
`boolean`	true se è 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 riattivarlo.

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 non è stato completato, ma il recupero è riuscito

Lanci
`DeviceNotAvailableException`

runInstrumentationTests

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 recupero non va a buon fine, tutti gli ascoltatori verranno informati di testRunFailed e verrà lanciata l'eccezione 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)

È uguale a 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 i permessi di root

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

Lanci
`DeviceNotAvailableException`

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

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

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

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

Lanci
`DeviceNotAvailableException`

setDeviceState

public void setDeviceState (TestDeviceState deviceState)

Aggiorna lo stato del dispositivo.

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

setEmulatorOutputStream

public void setEmulatorOutputStream (SizeLimitedOutputStream output)

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

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

setEmulatorProcess

public void setEmulatorProcess (Process p)

Imposta Process, se il dispositivo è un emulatore.

Parametri
`p`	`Process`

setFastbootEnabled

public void setFastbootEnabled (boolean fastbootEnabled)

Imposta l'opzione Fastboot per il dispositivo. Deve essere impostato al primo allocamento del dispositivo.

Parametri
`fastbootEnabled`	`boolean`: indica se la modalità Fastboot è disponibile o meno per il dispositivo

setFastbootPath

public void setFastbootPath (String fastbootPath)

Imposta il percorso del file binario fastboot da utilizzare. Per l'attivazione delle funzioni di fastboot è comunque necessario che isFastbootEnabled() sia true.

Parametri
`fastbootPath`	`String`

setIDevice

public void setIDevice (IDevice newDevice)

Aggiorna l'IDevice associato a questo ITestDevice.

Il nuovo IDevice deve fare riferimento allo stesso dispositivo fisico del riferimento 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

setOptions

public void setOptions (TestDeviceOptions options)

Impostare il 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 il privilegio di accesso come utente root di 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 al primo allocamento del dispositivo.

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à "Recupero 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`

setSetting

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

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

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

Lanci
`DeviceNotAvailableException`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

Inserisce l'istanza ITestLogger

Parametri
`testLogger`	`ITestLogger`

setTrackingSerial

public void setTrackingSerial (String trackingSerial)

Per la gestione del dispositivo, monitora il numero di serie che utilizziamo per fare riferimento al dispositivo.

Parametri
`trackingSerial`	`String`

setUseFastbootErase

public void setUseFastbootErase (boolean useFastbootErase)

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

Parametri
`useFastbootErase`	`boolean`: `true` se deve essere utilizzata l'opzione di reset di Fastboot o `false` se deve essere utilizzata l'opzione di formattazione di Fastboot.

startLogcat

public void startLogcat ()

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

Non avrà alcun effetto se l'output di logcat viene già acquisito. 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.

startTradeInModeTesting

public boolean startTradeInModeTesting (int timeoutMs)

Attiva la modalità di test per la permuta. Il dispositivo verrà resettato e riavviato.

Parametri
`timeoutMs`	`int`

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

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

startUser

public boolean startUser (int userId)

Avvia un determinato utente in background se è attualmente 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`: il comando 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 il display è 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.

stopTradeInModeTesting

public void stopTradeInModeTesting ()

Interrompi i test della modalità permuta.

Lanci
`DeviceNotAvailableException`

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 per 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 per interrompere.
`waitFlag`	`boolean`: il comando attenderà finché l'utente non si fermerà.
`forceFlag`	`boolean`: l'utente verrà interrotto forzatamente.

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 il dispositivo alla modalità adb tramite USB.

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

Lanci
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId)

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

Parametri
`userId`	`int`

Ritorni
`boolean`	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. Tenta di disattivare la schermata di blocco dopo la modifica dell'utente.

Parametri
`userId`	`int`
`timeout`	`long`: l'attesa prima di restituire false per switch-user 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") crea una directory /sdcard/files se non esiste già e copia in modo ricorsivo i contenuti di /tmp/files in /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. Restituisce null 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`

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

Disinstalla un pacchetto Android dal dispositivo per un determinato utente.

Parametri
`packageName`	`String`: il pacchetto Android da disinstallare
`userId`	`int`: l'ID utente intero 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 è 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 debugfs.

Lanci
`DeviceNotAvailableException`

waitForBootComplete

public boolean waitForBootComplete (long timeOut)

Blocca fino al momento in cui 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`	Vero se il dispositivo è disponibile, falso se non è disponibile.

Lanci
`DeviceNotAvailableException`

waitForDeviceBootloader

public void waitForDeviceBootloader ()

Blocca fino a quando il dispositivo non è visibile tramite fastboot. Utilizza 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 si avvia in modalità 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 è 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. Utilizza invece waitForDeviceAvailable().

Lanci
`DeviceNotAvailableException`

waitForDeviceOnline

public void waitForDeviceOnline (long waitTime)

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

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

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

Lanci
`DeviceNotAvailableException`

waitForDeviceShell

public boolean waitForDeviceShell (long waitTime)

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

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

Ritorni
`boolean`	`true` se il dispositivo 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`	`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 di assistenza per lanciare 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 di ddmlib per impostazione predefinita e passa a "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`, la query fastboot non verrà tentata
`description`	`String`: una descrizione semplice della variabile. La prima lettera deve essere in maiuscolo.

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

Ritorni
`boolean`

isNewer

protected boolean isNewer (File localFile, 
                IFileEntry entry)

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

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

Ritorni
`boolean`

notifyRebootEnded

protected void notifyRebootEnded ()

Invia una notifica a tutti i IDeviceActionReceiver 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.DeviceNotAvailableException
`DeviceNotAvailableException`

performDeviceAction

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

Esegue un'azione su questo dispositivo. Tenta di recuperare il dispositivo e, facoltativamente, riprova a eseguire 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

postAdbReboot

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

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

pullFileInternal

protected boolean pullFileInternal (String remoteFilePath, 
                File localFile)

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

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

setClock

protected void setClock (Clock clock)

Imposta l'istanza di Orologio da utilizzare.

Parametri
`clock`	`Clock`

setMicrodroidProcess

protected void setMicrodroidProcess (Process process)

Contrassegna TestDevice come microdroid e imposta il relativo 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`

waitForDeviceNotAvailable

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

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

mOptions

mStateMonitor

Costruttori pubblici

NativeDevice

Metodi pubblici

batchPrefetchStartupBuildProps

canSwitchToHeadlessSystemUser

checkApiLevelAgainstNextRelease

checkConnectivity

clearErrorDialogs

clearLastConnectedWifiNetwork

clearLogcat

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetworkIfNeeded

connectToWifiNetworkIfNeeded

createUser

createUser

createUser

createUserNoThrow

debugDeviceNotAvailable

deleteFile

deleteFile

deregisterDeviceActionReceiver

deviceSoftRestarted

deviceSoftRestartedSince

disableAdbRoot

disableKeyguard

disableNetworkMonitor

disconnectFromWifi

doesFileExist

doesFileExist

dumpHeap

enableAdbRoot

enableNetworkMonitor

executeAdbCommand

executeAdbCommand

executeAdbCommand

executeFastbootCommand

executeFastbootCommand

executeLongFastbootCommand

executeLongFastbootCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

fastbootWipePartition

getActiveApexes

getAllSettings

getAllocationState

getAndroidId

getAndroidIds

getApiLevel

getAppPackageInfo

getAppPackageInfos