Questa pagina è stata tradotta dall'API Cloud Translation.

Dispositivo nativo

public class NativeDevice
extends Object implements IManagedTestDevice, IConfigurationReceiver, ITestLoggerReceiver

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

Sottoclassi dirette note

Dispositivo di test

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

Sottoclassi indirette note

LocalAndroidVirtualDevice, ManagedRemoteDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice

LocalAndroidVirtualDevice	La classe per i dispositivi virtuali locali in esecuzione sull'host TradeFed.
ManagedRemoteDevice	Un dispositivo in esecuzione all'interno di una macchina virtuale da noi gestita da remoto tramite un'istanza Tradefed all'interno della VM.
NestedRemoteDevice	Rappresentazione del dispositivo in esecuzione all'interno di una VM Cuttlefish remota.
DispositivoAndroidRemote	Implementazione di un `ITestDevice` per un dispositivo Android full stack connesso tramite ADB Connect.
RemoteAndroidVirtualDevice	Estende il comportamento di `RemoteAndroidDevice` per un dispositivo Android full stack in esecuzione in Google Compute Engine (Gce).

Implementazione predefinita di ITestDevice dispositivi Android non full stack.

Riepilogo

Classi nidificate
`class`	`NativeDevice.AdbAction` Un `ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction)` per l'esecuzione di un comando "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 un 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 esecuzione dei nuovi comandi

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()` Micro ottimizzazione (circa 400 millisecondi) mediante il precaricamento di tutti gli oggetti di cui abbiamo bisogno anziché chiamare "adb getprop" per ciascuno.
`boolean`	`canSwitchToHeadlessSystemUser()` Indica se è consentito passare all'utente SYSTEM headless.
`boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` Controlla se una funzionalità è attualmente supportata o meno in un livello minimamente supportato.
`boolean`	`checkConnectivity()` Verifica la connettività di rete del dispositivo.
`boolean`	`clearErrorDialogs()` Prova a chiudere le eventuali finestre di dialogo di errore attualmente visualizzate nell'interfaccia utente del dispositivo.
`void`	`clearLastConnectedWifiNetwork()` Cancella l'ultima rete Wi-Fi connessa.
`void`	`clearLogcat()` Elimina tutti i dati logcat accumulati.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)` Si connette a una rete Wi-Fi.
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk)` Si connette a una rete Wi-Fi.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk)` Si connette a una rete Wi-Fi network.f
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)` Si connette a una rete Wi-Fi.
`boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)` Una variante di `connectToWifiNetwork(String, String)` che si connette solo se il dispositivo al momento non dispone di connettività di rete.
`boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)` Una variante di `connectToWifiNetwork(String, String)` che si connette solo se il dispositivo al momento non dispone di connettività di rete.
`int`	`createUser(String name, boolean guest, boolean ephemeral)` Crea un utente con un determinato nome e i flag forniti
`int`	`createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)` Crea un utente con un determinato nome e i flag forniti
`int`	`createUser(String name)` Crea un utente con un determinato nome e flag predefiniti pari a 0.
`int`	`createUserNoThrow(String name)` Crea un utente con un determinato nome e flag predefiniti pari a 0.
`void`	`deleteFile(String deviceFilePath, int userId)` Metodo di supporto per eliminare un file o una directory sul dispositivo.
`void`	`deleteFile(String deviceFilePath)` Metodo di supporto per eliminare un file o una directory sul dispositivo.
`void`	`deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Rimuove la registrazione di `IDeviceActionReceiver`.
`boolean`	`deviceSoftRestarted(ProcessInfo prevSystemServerProcess)` Metodo di supporto per verificare se il dispositivo è stato riavviato temporaneamente, confrontando l'attuale system_server con il precedente sistema system_server `ProcessInfo`.
`boolean`	`deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)` Metodo di supporto per verificare se il dispositivo è stato riavviato temporaneamente dall'ora UTC dall'epoca dal dispositivo e dal relativo `ERROR(/TimeUnit)`.
`boolean`	`disableAdbRoot()` Disattiva adb root.
`void`	`disableKeyguard()` Tenta di disattivare il blocco della tastiera.
`boolean`	`disableNetworkMonitor()` Disattiva il monitoraggio della rete sul dispositivo.
`boolean`	`disconnectFromWifi()` Si disconnette da una rete Wi-Fi.
`boolean`	`doesFileExist(String deviceFilePath, int userId)` Metodo di supporto per determinare se esiste un file sul dispositivo per un determinato utente.
`boolean`	`doesFileExist(String deviceFilePath)` Metodo di supporto per determinare se il file esiste sul dispositivo.
`File`	`dumpHeap(String process, String devicePath)` Tenta di eseguire il dump dell'heap da system_server.
`boolean`	`enableAdbRoot()` Attiva root ADB.
`boolean`	`enableNetworkMonitor()` Abilita il monitoraggio della rete sul dispositivo.
`String`	`executeAdbCommand(long timeout, String... cmdArgs)` Metodo helper che esegue un comando adb come comando di sistema con un timeout specificato.
`String`	`executeAdbCommand(long timeout, envMap, String... cmdArgs)` Metodo helper che esegue un comando adb come comando di sistema con un timeout specificato.
`String`	`executeAdbCommand(String... cmdArgs)` Metodo helper che esegue un comando adb come comando di sistema.
`CommandResult`	`executeFastbootCommand(String... cmdArgs)` Metodo helper che esegue un comando fastboot come comando di sistema con un timeout predefinito di 2 minuti.
`CommandResult`	`executeFastbootCommand(long timeout, String... cmdArgs)` Metodo helper che esegue un comando fastboot come comando di sistema.
`CommandResult`	`executeLongFastbootCommand(String... cmdArgs)` Metodo helper che esegue un comando fastboot a lunga esecuzione come comando di sistema.
`CommandResult`	`executeLongFastbootCommand( envVarMap, String... cmdArgs)` Metodo helper che esegue un comando fastboot a lunga esecuzione come comando di sistema con variabili di ambiente di sistema.
`String`	`executeShellCommand(String command)` Metodo helper che esegue un comando shell adb e restituisce l'output come `String`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Esegue un comando della shell adb, 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 della shell adb, con più parametri per controllare il comportamento del comando.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` Esegue il comando della shell adb specificato, riprovando più volte in caso di errore.
`CommandResult`	`executeShellV2Command(String cmd)` Metodo helper che esegue un comando shell adb e restituisce i risultati come `CommandResult` correttamente compilato con l'output dello stato del comando, stdout e stderr.
`CommandResult`	`executeShellV2Command(String cmd, OutputStream pipeToOutput)` Metodo helper che esegue un comando della shell adb e restituisce i risultati come `CommandResult` correttamente compilato con l'output dello stato del comando e il comando stderr.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput)` Metodo helper che esegue un comando della shell adb e restituisce i risultati come `CommandResult` correttamente compilato con l'output dello stato del comando, stdout e stderr.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Esegue un comando della shell adb, con più parametri per controllare il comportamento del comando.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)` Esegue un comando della shell adb, 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 della shell adb, 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 della shell adb, con più parametri per controllare il comportamento del comando.
`CommandResult`	`fastbootWipePartition(String partition)` Metodo helper che cancella una partizione per il dispositivo.
	`getActiveApexes()` Recupera le informazioni sugli APEX attivati sul dispositivo.
	`getAllSettings(String namespace)` Restituisce coppie chiave-valore dello spazio dei nomi richiesto.
`DeviceAllocationState`	`getAllocationState()` Restituisce lo stato di allocazione attuale del dispositivo
`String`	`getAndroidId(int userId)` Trova e restituisci l'android-id associato a un userId, null se non trovato.
	`getAndroidIds()` Crea una mappa degli ID Android trovati con ID utente corrispondenti.
`int`	`getApiLevel()` Ottieni il livello API del dispositivo.
`PackageInfo`	`getAppPackageInfo(String packageName)` Recupera informazioni su un pacchetto installato sul dispositivo.
	`getAppPackageInfos()` Recupera informazioni sui pacchetti installati sul dispositivo.
`String`	`getBasebandVersion()` Metodo pratico per ottenere la versione in banda di base (radio) di questo dispositivo.
`Integer`	`getBattery()` Restituisce il livello della batteria corrente di un dispositivo o Null se il livello della batteria non è disponibile.
`boolean`	`getBooleanProperty(String name, boolean defaultValue)` Restituisce il valore booleano della proprietà specificata.
	`getBootHistory()` Il metodo helper raccoglie la mappa della cronologia di avvio con data e ora e motivo dell'avvio.
	`getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)` Il metodo helper raccoglie la mappa della cronologia di avvio con ora e motivo dell'avvio a partire dal tempo specificato dall'epoca dal dispositivo e dall'unità di tempo specificata.
`String`	`getBootloaderVersion()` Metodo pratico per recuperare la versione bootloader del dispositivo.
`InputStreamSource`	`getBugreport()` Recupera una segnalazione di bug dal dispositivo.
`InputStreamSource`	`getBugreportz()` Recupera una segnalazione di bug dal dispositivo.
`String`	`getBuildAlias()` Recupera l'alias della build attualmente in esecuzione sul dispositivo.
`String`	`getBuildFlavor()` Recupera la versione 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 potrebbero essere firmati con token di test (come in AOSP) o tasti di rilascio (controllati dai singoli produttori di dispositivi)
`DeviceDescriptor`	`getCachedDeviceDescriptor()` Restituisce un valore `DeviceDescriptor` memorizzato nella cache se il dispositivo viene allocato, altrimenti restituisce il valore `DeviceDescriptor` corrente.
`DeviceDescriptor`	`getCachedDeviceDescriptor(boolean shortDescriptor)` Restituisce un valore `DeviceDescriptor` memorizzato nella cache se il dispositivo viene allocato, altrimenti restituisce il valore `DeviceDescriptor` corrente.
`String[]`	`getChildren(String path)` Alternativa all'utilizzo di `IFileEntry` che a volte non funziona a causa delle autorizzazioni.
`AbstractConnection`	`getConnection()` La connessione attuale associata al dispositivo.
`ContentProviderHandler`	`getContentProvider(int userId)` Restituisce `ContentProviderHandler` o null se non disponibile.
`DeviceFoldableState`	`getCurrentFoldableState()` Restituisce l'attuale stato pieghevole del dispositivo o nullo se si sono verificati alcuni problemi.
`int`	`getCurrentUser()` Restituisce l'ID dell'utente corrente in esecuzione.
`String`	`getDeviceClass()` Ottieni la classe del dispositivo.
`long`	`getDeviceDate()` Restituisce la data del dispositivo in millisecondi dall'epoca.
`DeviceDescriptor`	`getDeviceDescriptor()` Restituisci un `DeviceDescriptor` dalle informazioni del dispositivo per avere informazioni al riguardo senza trasmettere l'oggetto effettivo del dispositivo.
`DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` Restituisci un `DeviceDescriptor` dalle informazioni del dispositivo per avere informazioni al riguardo senza trasmettere l'oggetto effettivo del dispositivo.
`TestDeviceState`	`getDeviceState()` Ottieni lo stato del dispositivo.
`long`	`getDeviceTimeOffset(Date date)` Assistente per rilevare la differenza di tempo tra il dispositivo e un determinato `ERROR(/Date)`.
`InputStreamSource`	`getEmulatorOutput()` recupera il flusso di stdout e stderr dell'emulatore
`Process`	`getEmulatorProcess()` Restituisce il valore `Process` corrispondente a questo emulatore.
`final File`	`getExecuteShellCommandLog()` Il log che contiene tutti i log di `executeShellCommand(String)`.
`long`	`getExternalStoreFreeSpace()` Metodo di supporto per determinare la quantità di spazio libero sulla memoria esterna del dispositivo.
`String`	`getFastbootPath()` Restituisce il percorso del programma binario fastboot utilizzato.
`String`	`getFastbootProductType()` Metodo pratico per conoscere il tipo di prodotto di questo dispositivo quando è in modalità Fastboot.
`String`	`getFastbootProductVariant()` Metodo pratico per conoscere il tipo di prodotto di questo dispositivo quando è in modalità Fastboot.
`String`	`getFastbootSerialNumber()` Restituisce il numero di serie della modalità fastboot.
`String`	`getFastbootVariable(String variableName)` Recupera il valore della variabile fastboot specificato dal dispositivo.
`String`	`getFastbootVersion()` Restituisce la stringa di versione del binario fastboot in uso.
`IFileEntry`	`getFileEntry(String path)` Recupera un riferimento a un file remoto sul dispositivo.
`IFileEntry`	`getFileEntry(FileListingService.FileEntry entry)` Supporto non ufficiale per ottenere un `FileEntry` da un percorso non principale.
	`getFoldableStates()` Restituisce l'elenco di stati pieghevoli sul dispositivo.
`IDevice`	`getIDevice()` Restituisce un riferimento all'elemento ddmlib `IDevice` associato.
	`getInstalledPackageNames()` Recupera i nomi dei pacchetti dell'applicazione presenti sul dispositivo.
`long`	`getIntProperty(String name, long defaultValue)` Restituisce il valore intero della proprietà specificata dal dispositivo.
`String`	`getIpAddress()` Recupera l'indirizzo IP del dispositivo.
`KeyguardControllerState`	`getKeyguardState()` Restituisci un oggetto per ottenere lo stato attuale del blocco della tastiera o null se non supportato.
`long`	`getLastExpectedRebootTimeMillis()` Restituisce l'ultima volta che le API Tradefed hanno attivato un riavvio in millisecondi da EPOCH, come restituito da `System.currentTimeMillis()`.
`int`	`getLaunchApiLevel()` Ottieni il primo livello API del dispositivo.
`InputStreamSource`	`getLogcat()` Acquisisce un flusso di snapshot dei dati logcat.
`InputStreamSource`	`getLogcat(int maxBytes)` Acquisisce un flusso di snapshot degli ultimi `maxBytes` di dati logcat acquisiti.
`InputStreamSource`	`getLogcatDump()` Recupera il logcat attuale per il dispositivo.
`InputStreamSource`	`getLogcatSince(long date)` Acquisisce un flusso di snapshot dei dati logcat acquisiti a partire dalla data fornita.
`String`	`getMacAddress()` Restituisce l'indirizzo MAC del dispositivo, nullo se la query dal dispositivo non riesce.
`Integer`	`getMainUserId()` Restituisce l'ID utente principale.
	`getMainlineModuleInfo()` Recupera le informazioni sui moduli di linea principali installati sul dispositivo.
`int`	`getMaxNumberOfRunningUsersSupported()` Ottieni il numero massimo di utenti supportati in esecuzione contemporaneamente.
`int`	`getMaxNumberOfUsersSupported()` Ottieni il numero massimo di utenti supportati.
`Process`	`getMicrodroidProcess()`
`IDeviceStateMonitor`	`getMonitor()` Restituisci il `IDeviceStateMonitor` associato al dispositivo.
`String`	`getMountPoint(String mountName)` Restituisce un punto di montaggio.
`ITestDevice.MountPointInfo`	`getMountPointInfo(String mountpoint)` Restituisce un `MountPointInfo` corrispondente al percorso del punto di montaggio specificato oppure `null` se il percorso non ha nulla di montato o altrimenti non viene visualizzato in /proc/mounts come punto di montaggio.
	`getMountPointInfo()` Restituisce una versione analizzata delle informazioni in /proc/mounts sul dispositivo
`TestDeviceOptions`	`getOptions()` Recupera le opzioni di test per il dispositivo.
`long`	`getPartitionFreeSpace(String partition)` Metodo di supporto per determinare la quantità di spazio libero sulla partizione del dispositivo.
`Integer`	`getPrimaryUserId()` Restituisce l'ID utente principale.
`ProcessInfo`	`getProcessByName(String processName)` Il metodo helper esegue i comandi "pidof" e "stat" e restituisce l'oggetto `ProcessInfo` con il PID e l'ora di inizio del processo del processo specificato.
`String`	`getProcessPid(String process)` Restituisce il PID del servizio o null se si è verificato un problema.
`String`	`getProductType()` Metodo pratico per conoscere il tipo di prodotto di questo dispositivo.
`String`	`getProductVariant()` Metodo pratico per ottenere la variante di prodotto di questo dispositivo.
`String`	`getProperty(String name)` Recupera il valore della proprietà specificato dal dispositivo.
`ITestDevice.RecoveryMode`	`getRecoveryMode()` Recupera l'attuale modalità di ripristino utilizzata per il dispositivo.
`InputStreamSource`	`getScreenshot(String format)` Acquisisce uno screenshot dal dispositivo.
`InputStreamSource`	`getScreenshot(long displayId)` Recupera uno screenshot dall'ID display del dispositivo specificato.
`InputStreamSource`	`getScreenshot(String format, boolean rescale)` Acquisisce uno screenshot dal dispositivo.
`InputStreamSource`	`getScreenshot()` Acquisisce uno screenshot dal dispositivo.
`String`	`getSerialNumber()` Metodo pratico per ottenere il numero di serie del dispositivo.
`String`	`getSetting(int userId, String namespace, String key)` Restituisce il valore dell'impostazione richiesta.
`String`	`getSetting(String namespace, String key)` Vedi `getSetting(int, String, String)` ed eseguita sull'utente del sistema.
`String`	`getSimOperator()` Restituisci l'operatore della scheda SIM o null se non è disponibile o se il dispositivo non è disponibile.
`String`	`getSimState()` Restituisce lo stato della scheda SIM o null se non è disponibile o il dispositivo non è disponibile.
	`getTombstones()` Recupera e restituisci l'elenco delle lapidi dai dispositivi.
`long`	`getTotalMemory()` Restituisce la dimensione totale della memoria fisica in byte o -1 in caso di errore interno
	`getUninstallablePackageNames()` Recupera i nomi dei pacchetti dell'applicazione che possono essere disinstallati.
`boolean`	`getUseFastbootErase()` Scopri se utilizzare il formato fastboot reset o fastboot per cancellare una partizione sul dispositivo.
`int`	`getUserFlags(int userId)` Trova e restituisci i flag di un determinato utente.
	`getUserInfos()` Recupera la mappa di useId per `UserInfo` sul dispositivo.
`int`	`getUserSerialNumber(int userId)` Restituisce il numero di serie associato allo userId, se trovato, -10000 in tutti gli altri casi.
`IManagedTestDevice.DeviceEventResponse`	`handleAllocationEvent(DeviceEvent event)` Elabora l'elemento DeviceEvent specificato. Elaborare DeviceEvent, che può o meno eseguire la transizione di questo dispositivo a un nuovo stato di allocazione.
`boolean`	`hasFeature(String feature)` Controlla se una funzionalità è disponibile su un dispositivo.
`String`	`installPackage(File packageFile, boolean reinstall, String... extraArgs)` Installa un pacchetto Android sul dispositivo.
`String`	`installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` Installa un pacchetto Android sul dispositivo.
`String`	`installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)` Installa un pacchetto Android sul dispositivo di un determinato utente.
`String`	`installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` Installa un pacchetto Android sul dispositivo di un determinato utente.
`void`	`invalidatePropertyCache()`
`boolean`	`isAdbRoot()`
`boolean`	`isAdbTcp()`
`boolean`	`isAppEnumerationSupported()` Controllare se la piattaforma sul dispositivo supporta l'enumerazione delle app
`boolean`	`isBypassLowTargetSdkBlockSupported()` Controlla se la piattaforma sul dispositivo supporta l'aggiramento del blocco SDK target basso sulle installazioni di app
`boolean`	`isDebugfsMounted()` Controlla se il debugfs è montato.
`boolean`	`isDeviceEncrypted()` Indica se il dispositivo è criptato.
`boolean`	`isDirectory(String path)` Restituisce True se il percorso sul dispositivo è una directory, false in caso contrario.
`boolean`	`isEnableAdbRoot()`
`boolean`	`isEncryptionSupported()` Indica se la crittografia è supportata sul dispositivo.
`boolean`	`isExecutable(String fullPath)` Restituisce True se il percorso del file sul dispositivo è un file eseguibile, false in caso contrario.
`boolean`	`isFastbootEnabled()` Restituire se fastboot è disponibile per il dispositivo.
`boolean`	`isHeadless()` Restituisce true se il dispositivo è headless (nessuno schermo), false negli altri casi.
`boolean`	`isHeadlessSystemUserMode()` Indica se il dispositivo utilizza la modalità utente di sistema headless.
`boolean`	`isMainUserPermanentAdmin()` Indica se l'utente principale è un amministratore permanente e non può essere eliminato o sottoposto a downgrade a uno stato non amministratore.
`boolean`	`isMultiUserSupported()` Determina se la funzionalità multiutente è supportata.
`boolean`	`isPackageInstalled(String packageName, String userId)` Esegui una query sul dispositivo per ottenere un determinato nome di pacchetto e un determinato ID utente per verificare se il pacchetto è attualmente installato o meno per l'utente.
`boolean`	`isPackageInstalled(String packageName)` Esegui una query sul dispositivo per trovare un determinato nome di pacchetto per verificare se il pacchetto è 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)` Verificare se un determinato utente è in esecuzione.
`boolean`	`isUserSecondary(int userId)` Indica se l'utente specificato è un utente secondario in base ai flag.
`boolean`	`isUserVisible(int userId)` Controlla se l'utente specificato è visibile.
`boolean`	`isUserVisibleOnDisplay(int userId, int displayId)` Controlla se l'utente è visibile sul display specificato.
`boolean`	`isVisibleBackgroundUsersOnDefaultDisplaySupported()` Indica se il dispositivo consente agli utenti di essere avviati visibili in background in `ERROR(/java.android.view.Display#DEFAULT_DISPLAY)`.
`boolean`	`isVisibleBackgroundUsersSupported()` Indica se il dispositivo consente agli utenti di essere avviati visibili in background.
`boolean`	`isWifiEnabled()` Verifica che il Wi-Fi sia attivo.
	`listDisplayIds()` Raccogli l'elenco degli ID dei display disponibili sul dispositivo segnalato 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 di utenti presenti sul dispositivo.
`boolean`	`logAnrs(ITestLogger logger)` Raccoglie e registra gli errori ANR dal dispositivo.
`boolean`	`logBugreport(String dataName, ITestLogger listener)` Metodo di supporto per inviare una segnalazione di bug e registrarla agli autori di segnalazioni.
`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 una volta completato il comando e quando il dispositivo non è più visibile ad adb.
`void`	`postAdbRootAction()` Esegui l'override se il dispositivo ha bisogno di alcune azioni specifiche dopo la root adb e prima che il dispositivo ritorni online.
`void`	`postAdbUnrootAction()` Esegui l'override se il dispositivo richiede l'esecuzione di alcune azioni specifiche dopo l'unroot dell'adb e prima che sia di nuovo online.
`void`	`postBootSetup()` Segui le istruzioni per configurare il dispositivo e testarlo dopo ogni avvio.
`void`	`postInvocationTearDown(Throwable exception)` Passaggi aggiuntivi per la pulizia specifica del dispositivo che verranno eseguiti dopo il completamento della chiamata.
`void`	`preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)` Passaggi aggiuntivi per la configurazione richiesta specifica del dispositivo che verranno eseguiti sul dispositivo prima del flusso di chiamata.
`boolean`	`pullDir(String deviceFilePath, File localDir, int userId)` Esegui il pull ricorsivo dei contenuti della directory dal dispositivo.
`boolean`	`pullDir(String deviceFilePath, File localDir)` Esegui il pull ricorsivo dei 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 archivia in un `ERROR(/File)` temporaneo locale e restituisce quel `File`.
`File`	`pullFile(String remoteFilePath)` Recupera un file dal dispositivo, lo archivia in un `ERROR(/File)` temporaneo locale e restituisce quel `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 dalla memoria esterna del dispositivo, archiviarlo in un file `ERROR(/File)` temporaneo locale e restituire un riferimento a quel `File`.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, excludedDirectories)` Esegui il push ricorsivo dei contenuti delle directory al dispositivo, escludendo alcune directory filtrate.
`boolean`	`pushDir(File localFileDir, String deviceFilePath)` Esegui il push ricorsivo dei contenuti della directory sul dispositivo.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, int userId)` Esegui il push ricorsivo dei contenuti della directory sul dispositivo.
`boolean`	`pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)` Variante di `pushFile(File, String)` che può facoltativamente valutare la necessità del fornitore di contenuti.
`boolean`	`pushFile(File localFile, String remoteFilePath)` Esegui il push di un file sul dispositivo.
`boolean`	`pushFile(File localFile, String remoteFilePath, int userId)` Esegui il push di un file sul dispositivo.
`boolean`	`pushString(String contents, String remoteFilePath)` Esegui il push del file creato da una stringa al dispositivo
`void`	`reboot(String reason)` Riavvia il dispositivo in modalità ADB e l'`reason` specificato sarà mantenuto fino al riavvio.
`void`	`reboot()` Riavvia il dispositivo in modalità ADB.
`void`	`rebootIntoBootloader()` Riavvia il dispositivo in modalità bootloader.
`void`	`rebootIntoFastbootd()` Riavvia il dispositivo in modalità Fastbootd.
`void`	`rebootIntoRecovery()` Riavvia il dispositivo in modalità di ripristino ADB.
`void`	`rebootIntoSideload()` Riavvia il dispositivo in modalità sideload adb (tieni presente che si tratta di una modalità speciale in fase di ripristino) Blocco fino all'attivazione della modalità sideload sul dispositivo
`void`	`rebootIntoSideload(boolean autoReboot)` Riavvia il dispositivo in modalità sideload adb (tieni presente che si tratta di una modalità speciale in fase di ripristino) Blocco fino all'attivazione della modalità sideload sul dispositivo
`void`	`rebootUntilOnline()` Un'alternativa a `reboot()` che si blocca solo finché il dispositivo non è online, cioè visibile ad ADB.
`void`	`rebootUntilOnline(String reason)` Un'alternativa a `reboot()` che si blocca solo finché il dispositivo non è online, cioè visibile ad ADB.
`void`	`rebootUserspace()` Riavvia solo la parte dello spazio utente del dispositivo.
`void`	`rebootUserspaceUntilOnline()` Un'alternativa a `rebootUserspace()` ()} che viene bloccata solo finché il dispositivo non è online, cioè visibile ad ADB.
`boolean`	`recoverDevice()` Tenta di recuperare la comunicazione del 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 scrivibile la partizione di sistema del dispositivo.
`void`	`remountVendorReadOnly()` Rendi la partizione del fornitore sul dispositivo di sola lettura.
`void`	`remountVendorWritable()` Rendi scrivibile la partizione del fornitore sul dispositivo.
`boolean`	`removeAdmin(String componentName, int userId)` Rimuovi l'amministratore del dispositivo specificato per l'utente e restituisci `true` se l'operazione ha esito positivo, `false` in caso contrario.
`void`	`removeOwners()` Rimuovi tutti i proprietari esistenti di profili del dispositivo con il massimo impegno.
`boolean`	`removeUser(int userId)` Rimuovere un determinato utente dal dispositivo.
`void`	`resetContentProviderSetup()` Reimposta il flag per la configurazione del fornitore di contenuti per attivarlo di nuovo.
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)` Metodo pratico per eseguire `ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))` con uno o più listener passati come parametri.
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)` Esegue test di strumentazione e fornisce il 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)` Uguale a `ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)`, ma esegue il test per un determinato utente.
`void`	`setConfiguration(IConfiguration configuration)` Inserisce `IConfiguration` in uso.
`final void`	`setConnectionAvdInfo(GceAvdInfo avdInfo)`
`void`	`setDate(Date date)` Imposta la data sul dispositivo Nota: l'impostazione della data sul dispositivo richiede il 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` su log output
`void`	`setEmulatorProcess(Process p)` Consente di impostare `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 programma binario fastboot da utilizzare.
`void`	`setIDevice(IDevice newDevice)` Aggiorna l'IDevice associato a questo ITestDevice.
`void`	`setLogStartDelay(int delay)` Imposta il tempo di attesa in ms prima di avviare l'acquisizione di logcat per un dispositivo online.
`void`	`setOptions(TestDeviceOptions options)` Imposta `TestDeviceOptions` per il dispositivo
`boolean`	`setProperty(String propKey, String propValue)` Imposta il valore specificato per la proprietà sul dispositivo.
`void`	`setRecovery(IDeviceRecovery recovery)` Imposta il `IDeviceRecovery` da usare per questo dispositivo.
`void`	`setRecoveryMode(ITestDevice.RecoveryMode mode)` Imposta l'attuale modalità di ripristino da usare per il dispositivo.
`void`	`setSetting(String namespace, String key, String value)` Vedi `setSetting(int, String, String, String)` ed eseguita sull'utente del 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`	`setUseFastbootErase(boolean useFastbootErase)` Scegli se utilizzare il formato fastboot reset o fastboot per cancellare una partizione sul dispositivo.
`void`	`startLogcat()` Avvia l'acquisizione dell'output logcat dal dispositivo in background.
`boolean`	`startUser(int userId)` Avvia un determinato utente in background se al momento è arrestato.
`boolean`	`startUser(int userId, boolean waitFlag)` Avvia un determinato utente in background se al momento è arrestato.
`boolean`	`startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)` Avvia un determinato utente in background, visibile sul display specificato (ad esempio, consentendo all'utente di avviare attività in quel display).
`void`	`stopEmulatorOutput()` Chiudi ed elimina l'output dell'emulatore.
`void`	`stopLogcat()` Interrompi l'acquisizione dell'output di logcat dal dispositivo ed elimina i dati di logcat attualmente salvati.
`boolean`	`stopUser(int userId)` Arresta un determinato utente.
`boolean`	`stopUser(int userId, boolean waitFlag, boolean forceFlag)` Interrompere un determinato utente.
`String`	`switchToAdbTcp()` Passa alla modalità adb-over-tcp sul dispositivo.
`boolean`	`switchToAdbUsb()` Passa al dispositivo in modalità ADB su USB.
`boolean`	`switchUser(int userId)` Passa a un altro userId con un timeout predefinito.
`boolean`	`switchUser(int userId, long timeout)` Passa a un altro userId con il timeout fornito come scadenza.
`boolean`	`syncFiles(File localFileDir, String deviceFilePath)` Sincronizza in modo incrementale i contenuti di una directory di file locale con il dispositivo.
`Bugreport`	`takeBugreport()` Prendi una segnalazione di bug e restituila all'interno di un oggetto `Bugreport` per gestirla.
`String`	`uninstallPackage(String packageName)` Disinstalla un pacchetto Android dal dispositivo.
`String`	`uninstallPackageForUser(String packageName, int userId)` Disinstalla un pacchetto Android dal dispositivo per un determinato utente.
`boolean`	`unlockDevice()` Sblocca il dispositivo se è in stato criptato.
`void`	`unmountDebugfs()` Smonta il debugfs.
`boolean`	`waitForBootComplete(long timeOut)` Si blocca finché non viene impostato il flag di completamento dell'avvio del dispositivo.
`boolean`	`waitForDeviceAvailable()` Attende che il dispositivo risponda e sia disponibile per i test.
`boolean`	`waitForDeviceAvailable(long waitTime)` Attende che il dispositivo risponda e sia disponibile per i test.
`boolean`	`waitForDeviceAvailableInRecoverPath(long waitTime)` Attende che il dispositivo risponda e sia disponibile senza considerare il percorso di ripristino.
`void`	`waitForDeviceBootloader()` Si blocca finché il dispositivo non è visibile tramite fastboot.
`boolean`	`waitForDeviceInRecovery(long waitTime)` Blocchi per fare in modo che il dispositivo si trovi in stato di "recupero ADb" (tieni presente che questo è diverso da `IDeviceRecovery`).
`boolean`	`waitForDeviceInSideload(long waitTime)` Blocchi in modo che il dispositivo si trovi in stato "adb sideload"
`boolean`	`waitForDeviceNotAvailable(long waitTime)` Blocchi per cui il dispositivo non è disponibile, cioè non è presente nell'ADB
`void`	`waitForDeviceOnline()` Si blocca finché il dispositivo non è visibile tramite ADB.
`void`	`waitForDeviceOnline(long waitTime)` Si blocca finché il dispositivo non è visibile tramite ADB.
`boolean`	`waitForDeviceShell(long waitTime)` Attende che il dispositivo risponda a un comando shell adb di base.

Metodi protetti
`void`	`addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)`
`String[]`	`buildAdbShellCommand(String command, boolean forceExitStatusDetection)` Crea il comando del sistema operativo per la sessione e gli argomenti della shell adb specificati
`void`	`checkApiLevelAgainst(String feature, int strictMinLevel)`
`NativeDevice.RebootDeviceAction`	`createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)` Crea un `RebootDeviceAction` da utilizzare quando si esegue un'azione di riavvio.
`IRunUtil`	`createRunUtil()`
`void`	`doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)` Esegui un riavvio ADB.
`void`	`ensureRuntimePermissionSupported()` metodo helper per generare un'eccezione se l'autorizzazione di runtime non è supportata
`int`	`getApiLevelSafe()`
`ITestLogger`	`getLogger()`
`IRunUtil`	`getRunUtil()` Ottieni l'istanza `RunUtil` da utilizzare.
`void`	`initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)`
`String`	`internalGetProperty(String propName, String fastbootVar, String description)` Recupera una proprietà del dispositivo, dalla cache ddmlib per impostazione predefinita, e utilizza "adb shell getprop" o "fastboot getvar" a seconda che il dispositivo sia in Fastboot o meno.
`boolean`	`isInRebootCallback()` Indica se i callback di riavvio sono attualmente in esecuzione o meno.
`boolean`	`isNewer(File localFile, IFileEntry entry)` Restituisci `true` se il file locale è più recente del file remoto.
`void`	`notifyRebootEnded()` Invia notifiche a `IDeviceActionReceiver` relative all'evento di fine del riavvio.
`void`	`notifyRebootStarted()` Invia notifiche a tutti i `IDeviceActionReceiver` circa l'evento di avvio del riavvio.
`boolean`	`performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)` Esegue un'azione su questo dispositivo.
`void`	`postAdbReboot()` Eventuali azioni aggiuntive che è possibile eseguire dopo un riavvio.
`void`	`prePostBootSetup()` Consente a ogni tipo di dispositivo (Android NativeDevice, TestDevice) di eseguire l'override di questo metodo per una specifica configurazione post-avvio.
`boolean`	`pullFileInternal(String remoteFilePath, File localFile)`
`void`	`setClock(Clock clock)` Imposta l'istanza di orologio da utilizzare.
`void`	`setMicrodroidProcess(Process process)` Contrassegna il TestDevice come microdroide e imposta il 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 diventi non disponibile (interrompi la segnalazione ad adb).

Costanti

ID_UTENTE_NON_VALIDO

public static final int INVALID_USER_ID

Valore restituito per un 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 esecuzione dei nuovi comandi

Valore costante: 2 (0x00000002)

Campi

PERCORSO_DEBUGFS

public static final String DEBUGFS_PATH

SCHEDA_SD

protected static final String SD_CARD

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

Opzioni m

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

Costruttori pubblici

Dispositivo nativo

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

Crea un TestDevice.

Parametri
`device`	`IDevice`: il valore `IDevice` associato
`stateMonitor`	`IDeviceStateMonitor`: il meccanismo `IDeviceStateMonitor` da utilizzare
`allocationMonitor`	`IDeviceMonitor`: il `IDeviceMonitor` per informare le modifiche dello stato di allocazione. Può essere nullo

Metodi pubblici

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

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

CANNOT TRANSLATE

public boolean canSwitchToHeadlessSystemUser ()

Indica se è consentito passare all'utente SYSTEM headless.

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Controlla se una funzionalità è attualmente supportata o meno in un livello minimamente supportato. Questo metodo tiene conto delle funzionalità non ancora rilasciate, prima dell'aumento del livello API.

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

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

Lanci
`DeviceNotAvailableException`

checkConnectivity

public boolean checkConnectivity ()

Verifica la connettività di rete del dispositivo.

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

Lanci
`DeviceNotAvailableException`

Finestra di dialogo di errore

public boolean clearErrorDialogs ()

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

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

Lanci
`DeviceNotAvailableException`

cancellaUltimaReteWifiConnessa

public void clearLastConnectedWifiNetwork ()

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

CANCELLA

public void clearLogcat ()

Elimina tutti i dati logcat accumulati.

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

connettitiaallareteWifi

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Si connette a una rete Wi-Fi.

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

Parametri
`wifiSsidToPsk`	: una mappa degli SSID delle reti Wi-Fi alle password.
`scanSsid`	`boolean`: indica se cercare gli SSID nascosti per questa rete.

Ritorni
`boolean`	`true` in caso di connessione alla rete Wi-Fi. `false` altrimenti

Lanci
`DeviceNotAvailableException`

connettitiaallareteWifi

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Si connette a una rete Wi-Fi.

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

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

Ritorni
`boolean`	`true` in caso di connessione alla rete Wi-Fi. `false` altrimenti

Lanci
`DeviceNotAvailableException`

connettitiaallareteWifi

public boolean connectToWifiNetwork ( wifiSsidToPsk)

Si connette a una rete Wi-Fi.

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

Parametri
`wifiSsidToPsk`	: una mappa degli SSID delle reti Wi-Fi alle password.

Ritorni
`boolean`	`true` in caso di connessione alla rete Wi-Fi. `false` altrimenti

Lanci
`DeviceNotAvailableException`

connettitiaallareteWifi

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

Si connette a una rete Wi-Fi.

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

Ritorni
`boolean`	`true` in caso di connessione alla rete Wi-Fi. `false` altrimenti

Lanci
`DeviceNotAvailableException`

connettitiAllaWifiNetworkIfNeeded

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

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

Parametri
`scanSsid`	`boolean`: se cercare l'SSID nascosto per questa rete

Ritorni
`boolean`	`true` in caso di connessione alla rete Wi-Fi. `false` altrimenti

Lanci
`DeviceNotAvailableException`

connettitiAllaWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

Ritorni
`boolean`	`true` in caso di connessione alla rete Wi-Fi. `false` altrimenti

Lanci
`DeviceNotAvailableException`

CreaUtente

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

Crea un utente con un determinato nome e i flag forniti

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

Ritorni
`int`	ID dell'utente creato

Lanci
`DeviceNotAvailableException`

CreaUtente

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

Crea un utente con un determinato nome e i flag forniti

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

Ritorni
`int`	ID dell'utente creato

Lanci
`DeviceNotAvailableException`

CreaUtente

public int createUser (String name)

Crea un utente con un determinato nome e flag predefiniti pari a 0.

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

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

Lanci
`DeviceNotAvailableException`

CreaUtenteNoThrow

public int createUserNoThrow (String name)

Crea un utente con un determinato nome e flag predefiniti pari a 0.

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

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

Lanci
`DeviceNotAvailableException`

deleteFile

public void deleteFile (String deviceFilePath, 
                int userId)

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

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

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`

annullaregistrazioneDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Rimuove la registrazione di IDeviceActionReceiver.

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

dispositivoRiavvio avviato

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Metodo di supporto per verificare se il dispositivo è stato riavviato temporaneamente, confrontando l'attuale system_server con il precedente sistema system_server ProcessInfo. Usa getProcessByName(String) per ricevere ProcessInfo.

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

Ritorni
`boolean`	`true` se il dispositivo è stato riavviato temporaneamente

Lanci
`DeviceNotAvailableException`

dispositivoSoftRiavviatoDa

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Metodo di supporto per verificare se il dispositivo è stato riavviato temporaneamente dall'ora UTC dall'epoca dal dispositivo e dal relativo ERROR(/TimeUnit). Per riavvio lento si intende system_server riavviato al di fuori di un riavvio forzato del dispositivo (ad esempio, riavvio richiesto). L'attuale utcEpochTime del dispositivo in Milliseccond può essere ottenuto con il metodo getDeviceDate().

Parametri
`utcEpochTime`	`long`: tempo 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 temporaneamente

Lanci
`DeviceNotAvailableException`

disattivareAdbRoot

public boolean disableAdbRoot ()

Disattiva adb root.

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

Ritorni
`boolean`	`true` in caso di esito positivo.

Lanci
`DeviceNotAvailableException`

disattiva KeyGuard

public void disableKeyguard ()

Tenta di disattivare il blocco della tastiera.

Prima di tutto attendi che l'invio dell'input sia pronto, questo avviene più o meno nello stesso momento in cui il dispositivo segnala BOOT_COMPLETE, apparentemente in modo asincrono, perché l'implementazione attuale del framework presenta race condizione occasionali. Successivamente, il comando viene inviato per ignorare il blocco chiave (funziona solo su quelli non sicuri)

Lanci
`DeviceNotAvailableException`

disattivareNetworkMonitor

public boolean disableNetworkMonitor ()

Disattiva il monitoraggio della rete sul dispositivo.

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

Lanci
`DeviceNotAvailableException`

disconnetti daWifi

public boolean disconnectFromWifi ()

Si disconnette da una rete Wi-Fi.

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

Ritorni
`boolean`	`true` in caso di disconnessione dalla rete Wi-Fi. `false` se la disconnessione non è riuscita.

Lanci
`DeviceNotAvailableException`

fileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

Metodo di supporto per determinare se esiste un file sul dispositivo per un determinato utente.

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

Ritorni
`boolean`	`true` se il file esiste, `false` in caso contrario.

Lanci
`DeviceNotAvailableException`

fileExist

public boolean doesFileExist (String deviceFilePath)

Metodo di supporto per determinare se il file esiste sul dispositivo.

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

Ritorni
`boolean`	`true` se il file esiste, `false` in caso contrario.

Lanci
`DeviceNotAvailableException`

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

Tenta di 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 il dump dell'heap.
`devicePath`	`String`: il percorso sul dispositivo in cui posizionare il dump. Deve essere una posizione in cui le autorizzazioni lo consentono.

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

Lanci
`DeviceNotAvailableException`

attivaAdbRoot

public boolean enableAdbRoot ()

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

L'attivazione della directory principale ADB potrebbe causare la disconnessione del dispositivo da ADB. Questo metodo verrà bloccato finché il dispositivo non sarà disponibile.

Ritorni
`boolean`	`true` in caso di esito positivo.

Lanci
`DeviceNotAvailableException`

abilitaNetworkMonitor

public boolean enableNetworkMonitor ()

Abilita il monitoraggio della rete sul dispositivo.

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

Lanci
`DeviceNotAvailableException`

eseguireAdbCommand

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

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

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

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

Ritorni
`String`	lo stdout dal comando. `null` se l'esecuzione del comando non è riuscita.

Lanci
`DeviceNotAvailableException`

eseguireAdbCommand

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

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

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

Parametri
`timeout`	`long`: tempo in millisecondi prima che il dispositivo sia considerato non risponde, 0L per nessun timeout
`envMap`	: ambiente da impostare per il comando
`cmdArgs`	`String`: il comando adb e gli argomenti da eseguire

Ritorni
`String`	lo stdout dal comando. `null` se l'esecuzione del comando non è riuscita.

Lanci
`DeviceNotAvailableException`

eseguireAdbCommand

public String executeAdbCommand (String... cmdArgs)

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

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

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

Ritorni
`String`	lo stdout dal comando. `null` se l'esecuzione del comando non è riuscita.

Lanci
`DeviceNotAvailableException`

eseguireFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

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

È previsto l'utilizzo quando il dispositivo è già in modalità Fastboot.

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

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

Lanci
`DeviceNotAvailableException`

eseguireFastbootCommand

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

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

È previsto l'utilizzo quando il dispositivo è già in modalità Fastboot.

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

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

Lanci
`DeviceNotAvailableException`

eseguireLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

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

Identico a executeFastbootCommand(String), ma 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`

eseguireLongFastbootCommand

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

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

Identico a executeFastbootCommand(String), ma utilizza un timeout più lungo.

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

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

Lanci
`DeviceNotAvailableException`

eseguireShellCommand

public String executeShellCommand (String command)

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

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

Ritorni
`String`	l'output della shell

Lanci
`DeviceNotAvailableException`

eseguireShellCommand

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

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

Parametri
`command`	`String`: il comando shell adb da eseguire
`receiver`	`IShellOutputReceiver`: il valore `IShellOutputReceiver` a cui indirizzare l'output della shell.
`maxTimeToOutputShellResponse`	`long`: il periodo di tempo massimo durante il quale il comando può non restituire alcuna risposta; unità come specificato in `timeUnit`
`timeUnit`	`TimeUnit`: unità per `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: il numero massimo di volte in cui è possibile riprovare il comando se non riesce a causa di un'eccezione. Verrà generata un'eccezione DeviceNotAdaptiveException se l'esecuzione di `retryAttempts` non riesce.

Lanci
`DeviceNotAvailableException`

eseguireShellCommand

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

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

Parametri
`command`	`String`: il comando shell adb da eseguire
`receiver`	`IShellOutputReceiver`: il valore `IShellOutputReceiver` a cui indirizzare l'output della shell.
`maxTimeoutForCommand`	`long`: il timeout massimo per il completamento del comando; unità come specificato in `timeUnit`
`maxTimeToOutputShellResponse`	`long`: il periodo di tempo massimo durante il quale il comando può non restituire alcuna risposta; unità come specificato in `timeUnit`
`timeUnit`	`TimeUnit`: unità per `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: il numero massimo di volte in cui è possibile riprovare il comando se non riesce a causa di un'eccezione. Verrà generata un'eccezione DeviceNot adattabileException se l'esecuzione di `retryAttempts` viene eseguita senza esito positivo.

Lanci
`DeviceNotAvailableException`

eseguireShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Esegue il comando della shell adb specificato, riprovando più volte in caso di errore.

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

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

Lanci
`DeviceNotAvailableException`

eseguireShellV2Command

public CommandResult executeShellV2Command (String cmd)

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

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

Ritorni
`CommandResult`	Il risultato in `CommandResult`.

Lanci
`DeviceNotAvailableException`

eseguireShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

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

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

Ritorni
`CommandResult`	Il risultato in `CommandResult`.

Lanci
`DeviceNotAvailableException`

eseguireShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

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

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

Ritorni
`CommandResult`	Il risultato in `CommandResult`.

Lanci
`DeviceNotAvailableException`

eseguireShellV2Command

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

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

Parametri
`cmd`	`String`: il comando shell adb da eseguire
`maxTimeoutForCommand`	`long`: il timeout massimo per il completamento del comando; unità come specificato in `timeUnit`
`timeUnit`	`TimeUnit`: unità per `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: il numero massimo di volte in cui è possibile riprovare il comando se non riesce a causa di un'eccezione. Verrà generata un'eccezione DeviceNot adattabileException se l'esecuzione di `retryAttempts` viene eseguita senza esito positivo.

Ritorni
`CommandResult`

Lanci
`DeviceNotAvailableException`

eseguireShellV2Command

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

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

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

Ritorni
`CommandResult`

Lanci
`DeviceNotAvailableException`

eseguireShellV2Command

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

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

Parametri
`cmd`	`String`: il comando shell adb da eseguire
`pipeAsInput`	`File`: un `ERROR(/File)` che verrà inviato come input al comando oppure null.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` in cui verrà reindirizzato l'output standard oppure nullo.
`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 in cui è possibile riprovare il comando se non riesce a causa di un'eccezione. Verrà generata un'eccezione DeviceNot adattabileException se l'esecuzione di `retryAttempts` viene eseguita senza esito positivo.

Ritorni
`CommandResult`

Lanci
`DeviceNotAvailableException`

eseguireShellV2Command

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

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

Parametri
`cmd`	`String`: il comando shell adb da eseguire
`pipeAsInput`	`File`: un `ERROR(/File)` che verrà inviato come input al comando oppure null.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` in cui verrà reindirizzato l'output standard oppure nullo.
`pipeToError`	`OutputStream`: `ERROR(/OutputStream)` dove verrà reindirizzato l'errore standard oppure nullo.
`maxTimeoutForCommand`	`long`: il timeout massimo per il completamento del comando; unità come specificato in `timeUnit`
`timeUnit`	`TimeUnit`: unità per `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: il numero massimo di volte in cui è possibile riprovare il comando se non riesce a causa di un'eccezione. Verrà generata un'eccezione DeviceNot adattabileException se l'esecuzione di `retryAttempts` viene eseguita senza esito positivo.

Ritorni
`CommandResult`

Lanci
`DeviceNotAvailableException`

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

Metodo helper che cancella una partizione per il dispositivo.

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

È previsto l'utilizzo quando il dispositivo è già in modalità Fastboot.

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

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

Lanci
`DeviceNotAvailableException`

getActiveApexes

public  getActiveApexes ()

Recupera le informazioni sugli APEX attivati sul dispositivo.

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

Lanci
`DeviceNotAvailableException`

getAllSettings

public  getAllSettings (String namespace)

Restituisce coppie chiave-valore dello spazio dei nomi richiesto.

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

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

Lanci
`DeviceNotAvailableException`

getAllocationState

public DeviceAllocationState getAllocationState ()

Restituisce lo stato di allocazione attuale del dispositivo

Ritorni
`DeviceAllocationState`

getAndroidId

public String getAndroidId (int userId)

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

Parametri
`userId`	`int`

Ritorni
`String`

Lanci
`DeviceNotAvailableException`

getAndroidId

public  getAndroidIds ()

Crea una mappa degli ID Android trovati con ID utente corrispondenti. Non esiste alcuna assicurazione che ogni ID utente trovi un ID Android associato in questa funzione, pertanto alcuni ID utente potrebbero corrispondere a quelli nulli.

Ritorni
	Mappa di ID Android corrispondenti a ID utente.

Lanci
`DeviceNotAvailableException`

getApiLevel

public int getApiLevel ()

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

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

Lanci
`DeviceNotAvailableException`

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Recupera informazioni su un pacchetto installato sul dispositivo.

Parametri
`packageName`	`String`

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

Lanci
`DeviceNotAvailableException`

getAppPackageInfos

public  getAppPackageInfos ()

Recupera informazioni sui pacchetti installati sul dispositivo.

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

Lanci
`DeviceNotAvailableException`

getBasebandVersion

public String getBasebandVersion ()

Metodo pratico per ottenere la versione in banda di base (radio) di questo dispositivo. Il recupero della versione della radio dipende dal dispositivo, pertanto potrebbe non restituire le informazioni corrette per tutti i dispositivi. Questo metodo si basa sull'proprietà gsm.version.baseband per restituire le informazioni corrette sulla versione. Ciò non è preciso per alcuni dispositivi CDMA e la versione restituita qui potrebbe non corrispondere alla versione segnalata da fastboot e potrebbe non restituire quella per la radio CDMA. TL;DR questo metodo segnala una versione accurata solo se la proprietà gsm.version.baseband è uguale alla versione restituita da fastboot getvar version-baseband.

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

Lanci
`DeviceNotAvailableException`

getBatteria

public Integer getBattery ()

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

Ritorni
`Integer`

getBooleanProperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

Restituisce il valore booleano della proprietà specificata.

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

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

Lanci
`DeviceNotAvailableException`

getBootHistory

public  getBootHistory ()

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

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

Lanci
`DeviceNotAvailableException`

getBootHistoryDa

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

Lanci
`DeviceNotAvailableException`

getBootloaderVersion

public String getBootloaderVersion ()

Metodo pratico per recuperare la versione bootloader del dispositivo.

Si tenterà di recuperare la versione del bootloader dallo stato attuale del dispositivo. (ad esempio, se il dispositivo è in modalità fastboot, proverà a recuperare la versione da fastboot)

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

Lanci
`DeviceNotAvailableException`

getBugreport

public InputStreamSource getBugreport ()

Recupera una segnalazione di bug dal dispositivo.

L'implementazione di questa funzionalità garantisce che continui a funzionare su un dispositivo privo di scheda SD (o su cui non è ancora stata montata).

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

getBugreportz

public InputStreamSource getBugreportz ()

Recupera una segnalazione di bug dal dispositivo. La segnalazione di bug in formato zip contiene la segnalazione di bug principale e altri file di log utili per il debug.

Supportata solo per "adb version" > 1.0.36

Ritorni
`InputStreamSource`	un `InputStreamSource` del file ZIP contenente il bugreportz, restituisci null in caso di errore.

getBuildAlias

public String getBuildAlias ()

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

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

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

Lanci
`DeviceNotAvailableException`

getBuildFlavor

public String getBuildFlavor ()

Recupera la versione di build per il dispositivo.

Ritorni
`String`	versione build o nullo se non è stato possibile recuperarla

Lanci
`DeviceNotAvailableException`

getBuildId

public String getBuildId ()

Recupera la build attualmente in esecuzione sul dispositivo.

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

Lanci
`DeviceNotAvailableException`

getBuildSigningKey

public String getBuildSigningKeys ()

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

In genere, i dispositivi Android potrebbero essere firmati con token di test (come in AOSP) o tasti di rilascio (controllati dai singoli produttori di dispositivi)

Ritorni
`String`	La chiave di firma, se trovata, nulla, in caso contrario.

Lanci
`DeviceNotAvailableException`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

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

Ritorni
`DeviceDescriptor`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

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

Ritorni
`DeviceDescriptor`

getChildren

public String[] getChildren (String path)

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

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

Ritorni
`String[]`	Array di stringa contenente l'intero file in un percorso sul dispositivo.

Lanci
`DeviceNotAvailableException`

getConnection

public AbstractConnection getConnection ()

La connessione attuale associata al dispositivo.

Ritorni
`AbstractConnection`

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

Restituisce ContentProviderHandler o null se non disponibile.

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

Parametri
`userId`	`int`: l'ID utente con cui inizializzare il fornitore di contenuti.

Ritorni
`ContentProviderHandler`

Lanci
`DeviceNotAvailableException`

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

Ritorni
`DeviceFoldableState`

Lanci
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

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

Ritorni
`int`

Lanci
`DeviceNotAvailableException`

getDeviceClass

public String getDeviceClass ()

Ottieni 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 nel formato dell'epoca.

Lanci
`DeviceNotAvailableException`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

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

Ritorni
`DeviceDescriptor`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

Ritorni
`DeviceDescriptor`

getDeviceState

public TestDeviceState getDeviceState ()

Ottieni lo stato del dispositivo.

Ritorni
`TestDeviceState`

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

Assistente per rilevare la differenza di tempo tra il dispositivo e un determinato ERROR(/Date). Usa internamente il tempo di epoca.

Parametri
`date`	`Date`

Ritorni
`long`	la differenza in millisecondi

Lanci
`DeviceNotAvailableException`

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

recupera il flusso di stdout e stderr dell'emulatore

Ritorni
`InputStreamSource`	output dell'emulatore

getEmulatorProcess

public Process getEmulatorProcess ()

Restituisce il valore Process corrispondente a questo emulatore.

Ritorni
`Process`	`Process` o `null`

getEseguiShellCommandLog

public final File getExecuteShellCommandLog ()

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

Ritorni
`File`

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

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

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

Lanci
`DeviceNotAvailableException`

getFastbootPath

public String getFastbootPath ()

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

Ritorni
`String`

getFastbootProductType

public String getFastbootProductType ()

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

Questo metodo deve essere utilizzato solo se il dispositivo deve essere in fastboot. È una variante un po' più sicura rispetto al metodo getProductType() generico in questo caso, perché ITestDevice sa che deve ripristinare il dispositivo in fastboot se si trova in stato non corretto o non risponde.

Ritorni
`String`	il nome del tipo di prodotto `String` o `null` se non può essere determinato

Lanci
`DeviceNotAvailableException`

getFastbootProductVariant

public String getFastbootProductVariant ()

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

Ritorni
`String`	il nome del tipo di prodotto `String` o `null` se non può essere determinato

Lanci
`DeviceNotAvailableException`

getFastbootSerialNumber

public String getFastbootSerialNumber ()

Restituisce il numero di serie della modalità fastboot.

Ritorni
`String`

getFastbootVariabile

public String getFastbootVariable (String variableName)

Recupera il valore della variabile fastboot specificato dal dispositivo.

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

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

Lanci
`DeviceNotAvailableException`

getFastbootVersion

public String getFastbootVersion ()

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

Ritorni
`String`

getFileEntry

public IFileEntry getFileEntry (String path)

Recupera un riferimento a un file remoto sul dispositivo.

Parametri
`path`	`String`: il percorso del file da recuperare. Può essere un percorso o un percorso assoluto relativo a "/". Ad esempio, è supportata sia la sintassi "/system" che la sintassi "system".

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

Lanci
`DeviceNotAvailableException`

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

Supporto non ufficiale per ottenere un FileEntry da un percorso non principale. CORREZIONE: esegui il refactoring del sistema FileEntry per renderlo disponibile da qualsiasi percorso. (anche non root).

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

Ritorni
`IFileEntry`	un FileEntryWrapper che rappresenta la voce FileEntry.

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

getFoldableStates

public  getFoldableStates ()

Restituisce l'elenco di stati pieghevoli sul dispositivo. Può essere ottenuto con "cmd device_state Print-states".

Ritorni

Lanci
`DeviceNotAvailableException`

getIDevice

public IDevice getIDevice ()

Restituisce un riferimento all'elemento ddmlib IDevice associato.

Un nuovo IDevice può essere assegnato da DCM ogni volta che il dispositivo si disconnette e si riconnette da ADB. Di conseguenza, i chiamanti non devono tenere un riferimento al IDevice, perché questo potrebbe diventare inattivo.

Ritorni
`IDevice`	`IDevice`

getInstallaPackageNames

public  getInstalledPackageNames ()

Recupera i nomi dei pacchetti dell'applicazione presenti sul dispositivo.

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

Lanci
`DeviceNotAvailableException`

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

Restituisce il valore intero della proprietà specificata dal dispositivo.

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

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

Lanci
`DeviceNotAvailableException`

getIpAddress

public String getIpAddress ()

Recupera l'indirizzo IP del dispositivo.

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

Lanci
`DeviceNotAvailableException`

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Restituisci un oggetto per ottenere lo stato attuale del blocco della tastiera o null se non supportato.

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

Lanci
`DeviceNotAvailableException`

getLastAspettaRiavvioMillis

public long getLastExpectedRebootTimeMillis ()

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

Ritorni
`long`

getLaunchApiLevel

public int getLaunchApiLevel ()

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

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

Lanci
`DeviceNotAvailableException`

getLogcat

public InputStreamSource getLogcat ()

Acquisisce un flusso di snapshot dei dati logcat.

Funziona in due modalità:

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

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

Ritorni
`InputStreamSource`

getLogcat

public InputStreamSource getLogcat (int maxBytes)

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

Utile nei casi in cui vuoi acquisire spesso snapshot dei dati logcat acquisiti senza dover incorrere in una notevole riduzione dello spazio su disco derivante dall'ottenimento dell'intero snapshot getLogcat().

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

Ritorni
`InputStreamSource`

getLogcatDump

public InputStreamSource getLogcatDump ()

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

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

Ritorni
`InputStreamSource`	un `InputStreamSource` dei dati logcat. Se non riesce ad acquisire i dati logcat, viene restituito un flusso vuoto.

getLogcatDal

public InputStreamSource getLogcatSince (long date)

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

Parametri
`date`	`long`: in millisecondi dal formato dell'epoca in cui iniziare lo snapshot fino a oggi. (può essere ottenuto utilizzando "data +%s")

Ritorni
`InputStreamSource`

getMacAddress

public String getMacAddress ()

Restituisce l'indirizzo MAC del dispositivo, nullo se la query dal dispositivo non riesce.

Ritorni
`String`

getMainUserId

public Integer getMainUserId ()

Restituisce l'ID utente principale.

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

Lanci
`DeviceNotAvailableException`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

Recupera le informazioni sui moduli di linea principali installati sul dispositivo.

Ritorni
	`ERROR(/Set)` di `String` moduli di linea 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 che eseguono contemporaneamente

Lanci
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

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

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

Lanci
`DeviceNotAvailableException`

getMicrodroidProcess

public Process getMicrodroidProcess ()

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

getMonitor

public IDeviceStateMonitor getMonitor ()

Restituisci il IDeviceStateMonitor associato al dispositivo.

Ritorni
`IDeviceStateMonitor`

getMountPoint

public String getMountPoint (String mountName)

Restituisce un punto di montaggio.

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

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

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

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

getMountPointInfo

public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

Parametri
`mountpoint`	`String`

Ritorni
`ITestDevice.MountPointInfo`	Un elemento `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 elemento `ERROR(/List)` di `MountPointInfo` contenente le informazioni in "/proc/mounts"

Lanci
`DeviceNotAvailableException`

getOpzioni

public TestDeviceOptions getOptions ()

Recupera le opzioni di test per il dispositivo.

Ritorni
`TestDeviceOptions`	`TestDeviceOptions` relativi al dispositivo sottoposto a test.

getPartitionFreeSpace

public long getPartitionFreeSpace (String partition)

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

Parametri
`partition`	`String`

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

Lanci
`DeviceNotAvailableException`

IDUtentePrincipale

public Integer getPrimaryUserId ()

Restituisce l'ID utente principale.

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

Lanci
`DeviceNotAvailableException`

getProcessByName

public ProcessInfo getProcessByName (String processName)

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

Parametri
`processName`	`String`: la stringa del nome dei processi.

Ritorni
`ProcessInfo`	ProcessInfo di un determinato processoName

Lanci
`DeviceNotAvailableException`

getProcessPid

public String getProcessPid (String process)

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

Parametri
`process`	`String`: la stringa del nome dei processi.

Ritorni
`String`

Lanci
`DeviceNotAvailableException`

getProductType

public String getProductType ()

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

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

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

Lanci
`DeviceNotAvailableException`

getProductVariant

public String getProductVariant ()

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

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

Ritorni
`String`	il nome della variante del prodotto `String` o `null` se non può essere determinato

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

Recupera l'attuale modalità di ripristino utilizzata per il dispositivo.

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

getScreenshot

public InputStreamSource getScreenshot (String format)

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

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

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

Lanci
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (long displayId)

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

DA FARE: estendi le implementazioni sopra riportate per supportare il "formato" e il "ridimensionamento"

Parametri
`displayId`	`long`: l'ID di visualizzazione dello schermo da cui recuperare lo screenshot.

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

Lanci
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

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

Lanci
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot ()

Acquisisce uno screenshot dal dispositivo.

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

Lanci
`DeviceNotAvailableException`

getSerialNumber

public String getSerialNumber ()

Metodo pratico per ottenere il numero di serie del dispositivo.

Ritorni
`String`	il numero di serie di `String`

getImpostazione

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

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

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

Ritorni
`String`	il valore associato allo spazio dei nomi:chiave di un utente. Nullo se non trovato.

Lanci
`DeviceNotAvailableException`

getImpostazione

public String getSetting (String namespace, 
                String key)

Vedi getSetting(int, String, String) ed eseguita sull'utente del sistema.

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

Ritorni
`String`

Lanci
`DeviceNotAvailableException`

getSimOperator

public String getSimOperator ()

Restituisci 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 il dispositivo non è disponibile.

Ritorni
`String`

getTombstones

public  getTombstones ()

Recupera e restituisci l'elenco delle lapidi dai dispositivi. Richiede root.

è il miglior tentativo quindi se per qualsiasi motivo non viene eseguito l'estrazione di una tombstone, non sarà presente nell'elenco. Solo un DeviceNotAvailableException risolverà in anticipo il metodo.

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

Lanci
`DeviceNotAvailableException`

getTotalMemory

public long getTotalMemory ()

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

Ritorni
`long`

getDisinstallaablePackageNames

public  getUninstallablePackageNames ()

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

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

Lanci
`DeviceNotAvailableException`

getUseFastbootReset

public boolean getUseFastbootErase ()

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

Ritorni
`boolean`	`true` se verrà usato il reset fastboot o `false` se verrà usato il formato fastboot.

Flag User

public int getUserFlags (int userId)

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

Parametri
`userId`	`int`

Ritorni
`int`	i flag associati allo userId fornito, se trovato, -10000 in tutti gli altri casi.

Lanci
`DeviceNotAvailableException`

OttieniInfoUtente

public  getUserInfos ()

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

Ritorni
	l'elenco di oggetti UserInfo.

Lanci
`DeviceNotAvailableException`

getUserSerialNumber

public int getUserSerialNumber (int userId)

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

Parametri
`userId`	`int`

Ritorni
`int`

Lanci
`DeviceNotAvailableException`

handleAllocationEvent

public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

Elabora l'elemento DeviceEvent specificato. Potrebbe passare al nuovo stato del dispositivo. Informerà IDeviceMonitor di eventuali transizioni di stato.

Elaborare DeviceEvent, che può o meno eseguire la transizione di questo dispositivo a un nuovo stato di allocazione.

Parametri
`event`	`DeviceEvent`

Ritorni
`IManagedTestDevice.DeviceEventResponse`

hasFeature

public boolean hasFeature (String feature)

Controlla se una funzionalità è disponibile su un dispositivo.

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

Ritorni
`boolean`	True se la caratteristica viene trovata, false 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 è necessario eseguire una reinstallazione
`extraArgs`	`String`: argomenti aggiuntivi facoltativi da passare. Vedi "adb shell pm -h" per le opzioni disponibili.

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

Lanci
`DeviceNotAvailableException`

installPackage

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

Installa un pacchetto Android sul dispositivo.

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

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

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

Lanci
`DeviceNotAvailableException`

installPackageForUser

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

Installa un pacchetto Android sul dispositivo di un determinato utente.

Parametri
`packageFile`	`File`: il file APK da installare
`reinstall`	`boolean`: `true` se è necessario eseguire una reinstallazione
`userId`	`int`: l'ID utente intero per il quale eseguire l'installazione.
`extraArgs`	`String`: argomenti aggiuntivi facoltativi da passare. Vedi "adb shell pm -h" per le opzioni disponibili.

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

Lanci
`DeviceNotAvailableException`

installPackageForUser

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

Installa un pacchetto Android sul dispositivo di un determinato utente.

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

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

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

Lanci
`DeviceNotAvailableException`

invalidaProprietàCache

public void invalidatePropertyCache ()

isAdbRoot

public boolean isAdbRoot ()

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isAdbTcp

public boolean isAdbTcp ()

Ritorni
`boolean`

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

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

Ritorni
`boolean`	True se l'enumerazione dell'app è supportata, false in caso contrario

Lanci
`DeviceNotAvailableException`

isBypassLowTargetSdkBlockSupported

public boolean isBypassLowTargetSdkBlockSupported ()

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

Ritorni
`boolean`	True se by bypass il blocco SDK target basso è supportato, false altrimenti

Lanci
`DeviceNotAvailableException`

isDebugfsMounted

public boolean isDebugfsMounted ()

Controlla se il debugfs è montato.

Ritorni
`boolean`	`true` se il debugfs è montato

Lanci
`DeviceNotAvailableException`

isDeviceEncrypted

public boolean isDeviceEncrypted ()

Indica se il dispositivo è criptato.

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

Lanci
`DeviceNotAvailableException`

isDirectory

public boolean isDirectory (String path)

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

Parametri
`path`	`String`

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isAbilitaAdbRoot

public boolean isEnableAdbRoot ()

Ritorni
`boolean`	`true` se ADB root deve essere attivato sul dispositivo

CrittografiaSupportato

public boolean isEncryptionSupported ()

Indica se la crittografia è supportata sul dispositivo.

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

Lanci
`DeviceNotAvailableException`

èeseguibile

public boolean isExecutable (String fullPath)

Restituisce True se il percorso del file sul dispositivo è un file eseguibile, false in caso contrario.

Parametri
`fullPath`	`String`

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isFastbootEnabled

public boolean isFastbootEnabled ()

Restituire se fastboot è disponibile per il dispositivo.

Ritorni
`boolean`

isHeadless

public boolean isHeadless ()

Restituisce true se il dispositivo è headless (nessuno schermo), false negli altri casi.

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

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

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

èAmministratorePermanenteUtentePrincipale

public boolean isMainUserPermanentAdmin ()

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

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isMultiUserSupported

public boolean isMultiUserSupported ()

Determina se la funzionalità multiutente è supportata.

Ritorni
`boolean`	true se la funzionalità multiutente è supportata, false negli altri casi

Lanci
`DeviceNotAvailableException`

èPacchettoInstallato

public boolean isPackageInstalled (String packageName, 
                String userId)

Esegui una query sul dispositivo per ottenere un determinato nome di pacchetto e un determinato ID utente per verificare se il pacchetto è attualmente installato o meno per l'utente.

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

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

Lanci
`DeviceNotAvailableException`

èPacchettoInstallato

public boolean isPackageInstalled (String packageName)

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

Parametri
`packageName`	`String`

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

Lanci
`DeviceNotAvailableException`

isRuntimePermissionSupported

public boolean isRuntimePermissionSupported ()

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

Ritorni
`boolean`	True se le autorizzazioni di runtime sono supportate, false negli altri casi.

Lanci
`DeviceNotAvailableException`

isStateBootloaderOrFastbootd

public boolean isStateBootloaderOrFastbootd ()

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

Ritorni
`boolean`

èIn esecuzioneUtente

public boolean isUserRunning (int userId)

Verificare se un determinato utente è in esecuzione.

Parametri
`userId`	`int`

Ritorni
`boolean`	True se l'utente è in esecuzione, falso negli altri casi.

Lanci
`DeviceNotAvailableException`

èUtenteSecondario

public boolean isUserSecondary (int userId)

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

Parametri
`userId`	`int`

Ritorni
`boolean`	true se l'utente è secondario, false negli altri casi.

Lanci
`DeviceNotAvailableException`

UtenteVisibile

public boolean isUserVisible (int userId)

Controlla se l'utente specificato è visibile.

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

Parametri
`userId`	`int`

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

UtenteVisibileSuDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Controlla se l'utente è visibile sul display specificato.

Un utente "visibile" è un utente che sta interagendo con l'utente "umano" e pertanto è in grado di avviare attività in quel display.

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

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isVisibileBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

In tal caso, puoi chiamare startVisibleBackgroundUser(int, int, boolean), trasmettendo una visualizzazione restituita da listDisplayIdsForStartingVisibleBackgroundUsers() (che dovrebbe includere ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

èVisibileUtentiSfondoSupportato

public boolean isVisibleBackgroundUsersSupported ()

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

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

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

isWifiEnabled

public boolean isWifiEnabled ()

Verifica che il Wi-Fi sia attivo.

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

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

Lanci
`DeviceNotAvailableException`

listDisplayId

public  listDisplayIds ()

Raccogli l'elenco degli ID dei display disponibili sul dispositivo segnalato da "dumpsys SurfaceFlinger".

Ritorni
	L'elenco delle visualizzazioni. L'impostazione predefinita restituisce sempre 0 come visualizzazione predefinita.

Lanci
`DeviceNotAvailableException`

listDisplayIdsForStartingVisibilityBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

Ritorni

Lanci
`DeviceNotAvailableException`

elencoUtenti

public  listUsers ()

Recupera l'elenco di utenti presenti sul dispositivo. Se l'output dal dispositivo non è quello previsto, verrà generato DeviceRuntimeException.

Ritorni
	l'elenco degli ID utente.

Lanci
`DeviceNotAvailableException`

logAn

public boolean logAnrs (ITestLogger logger)

Raccoglie e registra gli errori ANR dal dispositivo.

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

Ritorni
`boolean`	True se il logging è riuscito, false in caso contrario.

Lanci
`DeviceNotAvailableException`

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

Metodo di supporto per inviare una segnalazione di bug e registrarla agli autori di segnalazioni.

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

Ritorni
`boolean`	True se il logging è riuscito, false in caso contrario.

Dispositivo di accesso

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

Registra un messaggio nel logcat del dispositivo. Questa è una chiamata sicura che non verrà generata anche se il logging non riesce.

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

mountDebugfs

public void mountDebugfs ()

Monta debugfs.

Lanci
`DeviceNotAvailableException`

nonBlockRiavvia

public void nonBlockingReboot ()

Emette un comando per riavviare il dispositivo e restituisce una volta completato il comando e quando il dispositivo non è più visibile ad adb.

Lanci
`DeviceNotAvailableException`

postAdbRootAction

public void postAdbRootAction ()

Esegui l'override se il dispositivo ha bisogno di alcune azioni specifiche dopo la root adb e prima che il dispositivo ritorni online. L'implementazione predefinita non include azioni aggiuntive. Non è garantita l'attivazione di adb root in questa fase.

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

postAdbUnrootAction

public void postAdbUnrootAction ()

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

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

configurazione postBoot

public void postBootSetup ()

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

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

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

Potrebbe essere necessario chiamare 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 specifica del dispositivo che verranno eseguiti dopo il completamento della chiamata.

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

impostazione preInvocation

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 archiviati nel contesto di chiamata

Lanci
`DeviceNotAvailableException`
`TargetSetupError`

Dir pull

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

Esegui il pull ricorsivo dei contenuti della directory dal dispositivo.

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

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

Lanci
`DeviceNotAvailableException`

Dir pull

public boolean pullDir (String deviceFilePath, 
                File localDir)

Esegui il pull ricorsivo dei contenuti della directory dal dispositivo.

Parametri
`deviceFilePath`	`String`: il percorso file assoluto dell'origine remota
`localDir`	`File`: la directory locale in cui estrarre 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 al file sul dispositivo.
`localFile`	`File`: il file locale in cui archiviare i contenuti. Se il campo 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 archivia in un ERROR(/File) temporaneo locale e restituisce quel File.

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

Ritorni
`File`	Un elemento `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 dell'host)

Lanci
`DeviceNotAvailableException`

PullFile

public File pullFile (String remoteFilePath)

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

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

Ritorni
`File`	Un elemento `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 dell'host)

Lanci
`DeviceNotAvailableException`

PullFile

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

Recupera un file dal dispositivo.

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

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

Lanci
`DeviceNotAvailableException`

pullFileContents

public String pullFileContents (String remoteFilePath)

Recupera un file dal dispositivo e restituisce i contenuti.

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

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

Lanci
`DeviceNotAvailableException`

pullFileDaEsterno

public File pullFileFromExternal (String remoteFilePath)

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

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

Ritorni
`File`	Un elemento `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 dell'host)

Lanci
`DeviceNotAvailableException`

Dir push

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

Esegui il push ricorsivo dei contenuti delle directory al dispositivo, escludendo alcune directory filtrate.

Parametri
`localFileDir`	`File`: la directory locale di cui eseguire il push
`deviceFilePath`	`String`: il percorso file assoluto della destinazione remota
`excludedDirectories`	: insieme di nomi di directory escluse di cui non deve essere eseguito il push.

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

Lanci
`DeviceNotAvailableException`

Dir push

public boolean pushDir (File localFileDir, 
                String deviceFilePath)

Esegui il push ricorsivo dei contenuti della directory sul dispositivo.

Parametri
`localFileDir`	`File`: la directory locale di cui eseguire il push
`deviceFilePath`	`String`: il percorso file assoluto della destinazione remota

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

Lanci
`DeviceNotAvailableException`

Dir push

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

Esegui il push ricorsivo dei contenuti della directory sul dispositivo.

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

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

Lanci
`DeviceNotAvailableException`

File push

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

Variante di pushFile(File, String) che può facoltativamente valutare la necessità del fornitore di contenuti.

Parametri
`localFile`	`File`: il file locale di cui eseguire il push
`remoteFilePath`	`String`: il percorso del file assoluto di destinazione remota
`evaluateContentProviderNeeded`	`boolean`: se controllare se abbiamo bisogno del fornitore di contenuti

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

Lanci
`DeviceNotAvailableException`

File push

public boolean pushFile (File localFile, 
                String remoteFilePath)

Esegui il push di un file sul dispositivo. Per impostazione predefinita, viene utilizzato un fornitore di contenuti.

Parametri
`localFile`	`File`: il file locale di cui eseguire il push
`remoteFilePath`	`String`: il percorso del file assoluto di destinazione remota

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

Lanci
`DeviceNotAvailableException`

File push

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

Esegui il push di un file sul dispositivo. Per impostazione predefinita, viene utilizzato un fornitore di contenuti.

Parametri
`localFile`	`File`: il file locale di cui eseguire il push
`remoteFilePath`	`String`: il percorso del file assoluto di destinazione remota
`userId`	`int`: lo userId a cui eseguire il push

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

Lanci
`DeviceNotAvailableException`

Stringaspinta

public boolean pushString (String contents, 
                String remoteFilePath)

Esegui il push del file creato da una stringa al dispositivo

Parametri
`contents`	`String`: i contenuti del file di cui eseguire il push
`remoteFilePath`	`String`: il percorso del file assoluto di destinazione remota

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

Lanci
`DeviceNotAvailableException`

fai ripartire

public void reboot (String reason)

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

Viene bloccato finché il dispositivo non diventa disponibile.

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

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

Lanci
`DeviceNotAvailableException`

fai ripartire

public void reboot ()

Riavvia il dispositivo in modalità ADB.

Viene bloccato finché il dispositivo non diventa disponibile.

Lanci
`DeviceNotAvailableException`

riavvioIntoBootloader

public void rebootIntoBootloader ()

Riavvia il dispositivo in modalità bootloader.

Si blocca finché il dispositivo non è in modalità bootloader.

Lanci
`DeviceNotAvailableException`

riavvioIntoFastbootd

public void rebootIntoFastbootd ()

Riavvia il dispositivo in modalità Fastbootd.

Si blocca finché il dispositivo non è in modalità fastbootd.

Lanci
`DeviceNotAvailableException`

riavvioIntoRecovery

public void rebootIntoRecovery ()

Riavvia il dispositivo in modalità di ripristino ADB.

Blocca fino all'attivazione del ripristino del dispositivo

Lanci
`DeviceNotAvailableException`

riavvioIntoSideload

public void rebootIntoSideload ()

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

Blocco fino all'attivazione della modalità sideload sul dispositivo

Lanci
`DeviceNotAvailableException`

riavvioIntoSideload

public void rebootIntoSideload (boolean autoReboot)

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

Blocco fino all'attivazione della modalità sideload sul dispositivo

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

Lanci
`DeviceNotAvailableException`

esegui riavvioUntilOnline

public void rebootUntilOnline ()

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

Lanci
`DeviceNotAvailableException`

esegui riavvioUntilOnline

public void rebootUntilOnline (String reason)

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

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

Lanci
`DeviceNotAvailableException`

riavvioSpazioutente

public void rebootUserspace ()

Riavvia solo la parte dello spazio utente del dispositivo.

Viene bloccato finché il dispositivo non diventa disponibile.

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

Lanci
`DeviceNotAvailableException`

riavvioSpazioUtenteUntilOnline

public void rebootUserspaceUntilOnline ()

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

Lanci
`DeviceNotAvailableException`

ripristinoDispositivo

public boolean recoverDevice ()

Tenta di recuperare la comunicazione del dispositivo.

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

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

registriDispositivoAzioneRicevitore

public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registra un IDeviceActionReceiver per questo dispositivo.

Tutti gli utenti IDeviceActionReceiver registrati riceveranno una notifica prima e dopo l'inizio e dopo di un'azione del dispositivo.

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

rimontaggioSistemaReadOnly

public void remountSystemReadOnly ()

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

Lanci
`DeviceNotAvailableException`

rimonta SystemWritable

public void remountSystemWritable ()

Rendi scrivibile la partizione di sistema del dispositivo. Il dispositivo potrebbe essere riavviato.

Lanci
`DeviceNotAvailableException`

rimontaVendorReadOnly

public void remountVendorReadOnly ()

Rendi la partizione del fornitore sul dispositivo di sola lettura. Il dispositivo potrebbe essere riavviato.

Lanci
`DeviceNotAvailableException`

rimontareVendorWritable

public void remountVendorWritable ()

Rendi scrivibile la partizione del fornitore sul dispositivo. Il dispositivo potrebbe essere riavviato.

Lanci
`DeviceNotAvailableException`

rimuovereAmministratore

public boolean removeAdmin (String componentName, 
                int userId)

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

Parametri
`componentName`	`String`: amministratore del dispositivo da rimuovere.
`userId`	`int`: dell'utente di cui risiede l'amministratore del dispositivo.

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

Lanci
`DeviceNotAvailableException`

rimuoviProprietari

public void removeOwners ()

Rimuovi tutti i proprietari esistenti di profili del dispositivo con il massimo impegno.

Lanci
`DeviceNotAvailableException`

rimuovereUtente

public boolean removeUser (int userId)

Rimuovere un determinato utente dal dispositivo.

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

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

Lanci
`DeviceNotAvailableException`

resetContentProviderSetup

public void resetContentProviderSetup ()

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

runInstrumentationTest

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

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

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

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

Lanci
`DeviceNotAvailableException`

runInstrumentationTest

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

Esegue test di strumentazione e fornisce il recupero del dispositivo.

Se la connessione al dispositivo viene persa prima del completamento dell'esecuzione del test e il recupero va a buon fine, tutti i listener verranno informati di testRunFailed e verrà restituito "false". Il comando di test non verrà eseguito nuovamente. I chiamanti possono riprovare se necessario.

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

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

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

Lanci
`DeviceNotAvailableException`

eseguiTestInstrumentationAsUser

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`

eseguiTestInstrumentationAsUser

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

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

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

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

setConfiguration

public void setConfiguration (IConfiguration configuration)

Inserisce IConfiguration in uso.

Parametri
`configuration`	`IConfiguration`

setConnectionAvdInfo

public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

Parametri
`avdInfo`	`GceAvdInfo`

setDate

public void setDate (Date date)

Imposta la data sul dispositivo

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

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

Lanci
`DeviceNotAvailableException`

impostaProprietarioDispositivo

public boolean setDeviceOwner (String componentName, 
                int userId)

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

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

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

Lanci
`DeviceNotAvailableException`

setDeviceState

public void setDeviceState (TestDeviceState deviceState)

Aggiorna lo stato del dispositivo.

Parametri
`deviceState`	`TestDeviceState`: `TestDeviceState`

setEmulatorOutputStream

public void setEmulatorOutputStream (SizeLimitedOutputStream output)

Per l'emulatore imposta SizeLimitedOutputStream su log output

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

setEmulatorProcess

public void setEmulatorProcess (Process p)

Consente di impostare Process se il dispositivo è un emulatore.

Parametri
`p`	`Process`

setFastbootEnabled

public void setFastbootEnabled (boolean fastbootEnabled)

Imposta l'opzione fastboot per il dispositivo. Da impostare quando il dispositivo viene allocato per la prima volta.

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

setFastbootPath

public void setFastbootPath (String fastbootPath)

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

Parametri
`fastbootPath`	`String`

impostaIDispositivo

public void setIDevice (IDevice newDevice)

Aggiorna l'IDevice associato a questo ITestDevice.

Il nuovo dispositivo deve fare riferimento allo stesso dispositivo fisico come riferimento corrente. Questo metodo verrà chiamato se DCM ha allocato un nuovo IDevice

Parametri
`newDevice`	`IDevice`: `IDevice`

setLogStartDelay

public void setLogStartDelay (int delay)

Imposta il tempo di attesa in ms prima di avviare l'acquisizione di logcat per un dispositivo online.

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

impostaOpzioni

public void setOptions (TestDeviceOptions options)

Imposta TestDeviceOptions per il dispositivo

Parametri
`options`	`TestDeviceOptions`

setProprietà

public boolean setProperty (String propKey, 
                String propValue)

Imposta il valore specificato per la proprietà sul dispositivo. Richiede che la radice ADB sia true.

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

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

Lanci
`DeviceNotAvailableException`

setRecovery

public void setRecovery (IDeviceRecovery recovery)

Imposta il IDeviceRecovery da usare per questo dispositivo. Da impostare quando il dispositivo viene allocato per la prima volta.

Parametri
`recovery`	`IDeviceRecovery`: `IDeviceRecovery`

setRecoveryMode

public void setRecoveryMode (ITestDevice.RecoveryMode mode)

Imposta l'attuale modalità di ripristino da usare per il dispositivo.

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

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

impostazioniImpostazione

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

Vedi setSetting(int, String, String, String) ed eseguita sull'utente del sistema.

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

Lanci
`DeviceNotAvailableException`

impostazioniImpostazione

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

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

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

Lanci
`DeviceNotAvailableException`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

Inserisce l'istanza ITestLogger

Parametri
`testLogger`	`ITestLogger`

ImpostaUsaFastbootReset

public void setUseFastbootErase (boolean useFastbootErase)

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

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

StartLogcat

public void startLogcat ()

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

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

Quando il dispositivo non è più in uso, è necessario chiamare stopLogcat().

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

UtenteInizio

public boolean startUser (int userId)

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

Parametri
`userId`	`int`: dell'utente con cui iniziare in background

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

Lanci
`DeviceNotAvailableException`

UtenteInizio

public boolean startUser (int userId, 
                boolean waitFlag)

Avvia un determinato utente in background se al momento è arrestato. 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 con cui iniziare in background
`waitFlag`	`boolean`: attenderà che l'utente venga avviato e sbloccato.

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

Lanci
`DeviceNotAvailableException`

inizioVisibileUtenteSfondo

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

Avvia un determinato utente in background, visibile sul display specificato (ad esempio, consentendo all'utente di avviare attività in quel display).

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

Parametri
`userId`	`int`: dell'utente con cui iniziare in background
`displayId`	`int`: display su cui l'utente può essere visibile
`waitFlag`	`boolean`: attenderà che l'utente venga avviato e sbloccato.

Ritorni
`boolean`	`true` se l'utente è stato avviato correttamente visibile 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 logcat non viene acquisito.

Utente bloccato

public boolean stopUser (int userId)

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

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

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

Lanci
`DeviceNotAvailableException`

Utente bloccato

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

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

Parametri
`userId`	`int`: dell'utente da interrompere.
`waitFlag`	`boolean`: attenderà finché l'utente non verrà arrestato.
`forceFlag`	`boolean`: forza l'interruzione dell'utente.

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

Lanci
`DeviceNotAvailableException`

switchToAdbTcp

public String switchToAdbTcp ()

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

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

Lanci
`DeviceNotAvailableException`

switchToAdbUsb

public boolean switchToAdbUsb ()

Passa al dispositivo in modalità ADB su USB.

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

Lanci
`DeviceNotAvailableException`

cambiautente

public boolean switchUser (int userId)

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

Parametri
`userId`	`int`

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

Lanci
`DeviceNotAvailableException`

cambiautente

public boolean switchUser (int userId, 
                long timeout)

Passa a un altro userId con il timeout fornito come scadenza. Tentativo di disattivare il blocco della tastiera dopo che la modifica dell'utente è andata a buon fine.

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

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 di quali file eseguire il push confrontando i timestamp dei file locali con i relativi equivalenti remoti. Solo i file "più recenti" o inesistenti verranno inviati al dispositivo. Di conseguenza, l'overhead dovrebbe essere relativamente ridotto se il file impostato sul dispositivo è già aggiornato.

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

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

Parametri
`localFileDir`	`File`: la directory dei file locali contenente i file di cui eseguire il push in modo ricorsivo.
`deviceFilePath`	`String`: la radice del percorso assoluto del file di destinazione remota. Tutte le directory nel percorso di file thos devono essere leggibili. Ad esempio, il push a /data/local/tmp quando adb non è root non avrà esito positivo

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

Lanci
`DeviceNotAvailableException`

prendereBugreport

public Bugreport takeBugreport ()

Prendi una segnalazione di bug e restituila all'interno di un oggetto Bugreport per gestirla. Restituisci nullo in caso di problemi. Il file a cui viene fatto riferimento nell'oggetto Bugreport deve essere cancellato tramite Bugreport.close().

Ritorni
`Bugreport`

disinstalla il pacchetto

public String uninstallPackage (String packageName)

Disinstalla un pacchetto Android dal dispositivo.

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

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

Lanci
`DeviceNotAvailableException`

disinstallaPacchettoPerUtente

public String uninstallPackageForUser (String packageName, 
                int userId)

Disinstalla un pacchetto Android dal dispositivo per un determinato utente.

Parametri
`packageName`	`String`: il pacchetto Android da disinstallare
`userId`	`int`: l'ID utente intero per il quale eseguire la disinstallazione.

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

Lanci
`DeviceNotAvailableException`

sbloccaDispositivo

public boolean unlockDevice ()

Sblocca il dispositivo se è in stato criptato.

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

Ritorni
`boolean`	`true` se l'operazione ha esito positivo o se il dispositivo non è criptato.

Lanci
`DeviceNotAvailableException`

unmountDebugfs

public void unmountDebugfs ()

Smonta il debugfs.

Lanci
`DeviceNotAvailableException`

waitForBootComplete

public boolean waitForBootComplete (long timeOut)

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

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

Ritorni
`boolean`	true se il flag di avvio completato del dispositivo è impostato entro il timeout

Lanci
`DeviceNotAvailableException`

attesaPerDispositivoDisponibile

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 ripristino è disattivato e non disponibile.

Lanci
`DeviceNotAvailableException`

attesaPerDispositivoDisponibile

public boolean waitForDeviceAvailable (long waitTime)

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

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

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

Lanci
`DeviceNotAvailableException`

waitForDeviceAvailableInFetchPath

public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

Attende che il dispositivo risponda e sia disponibile senza considerare il percorso di ripristino.

Parametri
`waitTime`	`long`

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

Lanci
`DeviceNotAvailableException`

waitForDeviceBootloader

public void waitForDeviceBootloader ()

Si blocca finché il dispositivo non è visibile tramite fastboot. Usa il timeout predefinito.

Lanci
`DeviceNotAvailableException`

attesaPerDispositivoInRecovery

public boolean waitForDeviceInRecovery (long waitTime)

Blocchi per fare in modo che il dispositivo si trovi in stato di "recupero ADb" (tieni presente che questo è diverso da IDeviceRecovery).

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

Ritorni
`boolean`	`true` se il dispositivo avvia il recupero prima della scadenza del tempo. `false` in caso contrario

attesaPerDispositivoInSideload

public boolean waitForDeviceInSideload (long waitTime)

Blocchi in modo che il dispositivo si trovi in stato "adb sideload"

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

Ritorni
`boolean`	`true` se il dispositivo viene avviato in sideload prima della scadenza del tempo. `false` in caso contrario

attesaPerDispositivoNonDisponibile

public boolean waitForDeviceNotAvailable (long waitTime)

Blocchi per cui il dispositivo non è disponibile, cioè non è presente nell'ADB

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

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

attesaPerDispositivoOnline

public void waitForDeviceOnline ()

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

Tieni presente che il dispositivo potrebbe non rispondere necessariamente ai comandi al completamento. Usa invece waitForDeviceAvailable().

Lanci
`DeviceNotAvailableException`

attesaPerDispositivoOnline

public void waitForDeviceOnline (long waitTime)

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

Tieni presente che il dispositivo potrebbe non rispondere necessariamente ai comandi al completamento. Usa invece waitForDeviceAvailable().

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

Lanci
`DeviceNotAvailableException`

waitForDeviceShell

public boolean waitForDeviceShell (long waitTime)

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

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

Ritorni
`boolean`	`true` se il dispositivo diventa reattivo prima dello scadere di `waitTime`.

Metodi protetti

addExtraConnectionBuilderArgs

protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

Parametri
`builder`	`DefaultConnection.ConnectionBuilder`

buildAdbShellCommand

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

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

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

Ritorni
`String[]`

checkApiLevelAgainst

protected void checkApiLevelAgainst (String feature, 
                int strictMinLevel)

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

creaRiavviaDeviceAction

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

Crea un RebootDeviceAction da utilizzare quando si esegue un'azione di riavvio.

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

Ritorni
`NativeDevice.RebootDeviceAction`	l'elemento `RebootDeviceAction` creato.

createRunUtil

protected IRunUtil createRunUtil ()

Ritorni
`IRunUtil`

doAdbRiavvia

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.DeviceNotAvailableEccezione
`DeviceNotAvailableException`

garantireRuntimePermissionSupported

protected void ensureRuntimePermissionSupported ()

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
`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`

InizializeConnection

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

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

Lanci
`DeviceNotAvailableException`
`TargetSetupError`

internalGetProperty

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

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

Parametri
`propName`	`String`: il nome della proprietà del dispositivo restituito da "adb shell getprop"
`fastbootVar`	`String`: il nome della variabile fastboot equivalente su cui eseguire la query. Se `null`, non verrà tentata la query fastboot.
`description`	`String`: una semplice descrizione della variabile. La prima lettera deve essere maiuscola.

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

Lanci
`DeviceNotAvailableException`

èInRiavviaCallback

protected boolean isInRebootCallback ()

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

Ritorni
`boolean`

èPiù recente

protected boolean isNewer (File localFile, 
                IFileEntry entry)

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

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

Ritorni
`boolean`

notificaRiavvioTerminato

protected void notifyRebootEnded ()

Invia notifiche a IDeviceActionReceiver relative all'evento di fine del riavvio.

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

notificaRiavviaAvviato

protected void notifyRebootStarted ()

Invia notifiche a tutti i IDeviceActionReceiver circa l'evento di avvio del riavvio.

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

performDeviceAction

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

Esegue un'azione su questo dispositivo. Tenta di ripristinare il dispositivo e, facoltativamente, di riprovare a eseguire il comando se l'azione non riesce.

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

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

Lanci
`DeviceNotAvailableException`	se il tentativo di recupero non va a buon fine o se il numero massimo di tentativi non è andato a buon fine

postAdbRiavvia

protected void postAdbReboot ()

Eventuali azioni aggiuntive che è possibile eseguire dopo un riavvio.

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

Configurazione prePostBoot

protected void prePostBootSetup ()

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

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

pullFileInternal

protected boolean pullFileInternal (String remoteFilePath, 
                File localFile)

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

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

impostaOrologio

protected void setClock (Clock clock)

Imposta l'istanza di orologio da utilizzare.

Parametri
`clock`	`Clock`

Processo setMicrodroid

protected void setMicrodroidProcess (Process process)

Contrassegna il TestDevice come microdroide e imposta il relativo ID cliente.

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

setTestDeviceOptions

protected void setTestDeviceOptions ( deviceOptions)

Parametri
`deviceOptions`

Comando BasicFastboot

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`

Comando BasicFastboot

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

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

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

Ritorni
`CommandResult`

attesaPerDispositivoNonDisponibile

protected boolean waitForDeviceNotAvailable (String operationDesc, 
                long time)

Attendi che il dispositivo diventi non disponibile (interrompi la segnalazione ad adb).

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

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

Dispositivo nativo

Riepilogo

Classi nidificate

Costanti

Campi

Costruttori pubblici

Metodi pubblici

Metodi protetti

Costanti

ID_UTENTE_NON_VALIDO

MAX_HOST_DEVICE_TIME_OFFSET

MAX_RETRY_ATTEMPTS

Campi

PERCORSO_DEBUGFS

SCHEDA_SD

STORAGE_EMULATED

Opzioni m

mStateMonitor

Costruttori pubblici

Dispositivo nativo

Metodi pubblici

batchPrefetchStartupBuildProps

CANNOT TRANSLATE

checkApiLevelAgainstNextRelease

checkConnectivity

Finestra di dialogo di errore

cancellaUltimaReteWifiConnessa

CANCELLA

connettitiaallareteWifi

connettitiaallareteWifi

connettitiaallareteWifi

connettitiaallareteWifi

connettitiAllaWifiNetworkIfNeeded

connettitiAllaWifiNetworkIfNeeded

CreaUtente

CreaUtente

CreaUtente

CreaUtenteNoThrow

deleteFile

deleteFile

annullaregistrazioneDeviceActionReceiver

dispositivoRiavvio avviato

dispositivoSoftRiavviatoDa

disattivareAdbRoot

disattiva KeyGuard

disattivareNetworkMonitor

disconnetti daWifi

fileExist

fileExist

dumpHeap

attivaAdbRoot

abilitaNetworkMonitor

eseguireAdbCommand

eseguireAdbCommand

eseguireAdbCommand

eseguireFastbootCommand

eseguireFastbootCommand

eseguireLongFastbootCommand

eseguireLongFastbootCommand

eseguireShellCommand

eseguireShellCommand

eseguireShellCommand

eseguireShellCommand

eseguireShellV2Command

eseguireShellV2Command

eseguireShellV2Command

eseguireShellV2Command

eseguireShellV2Command

eseguireShellV2Command

eseguireShellV2Command

fastbootWipePartition

getActiveApexes

getAllSettings

getAllocationState

getAndroidId

getAndroidId

getApiLevel

getAppPackageInfo

getAppPackageInfos

getBasebandVersion