Questa pagina è stata tradotta dall'API Cloud Translation.

Dispositivo nativo

public class NativeDevice
extends Object implements IConfigurationReceiver, IManagedTestDevice, 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 la 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 sistema operativo "adb ...." .
`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 ognuno.
`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 attualmente 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 attualmente 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 sistema_server con system_server `ProcessInfo` precedente.
`boolean`	`deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)` Metodo di supporto per verificare se il dispositivo è stato riavviato temporaneamente a partire dall'ora UTC dall'epoca dispositivo e i relativi `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 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 il sistema variabili di ambiente.
`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 il tempo e il motivo dell'avvio a partire dalla data tempo dall'epoca del dispositivo e l'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 chiavi di rilascio (controllata da singoli produttori di dispositivi)
`DeviceDescriptor`	`getCachedDeviceDescriptor()` Restituisce un `DeviceDescriptor` memorizzato nella cache se il dispositivo è allocato, altrimenti restituisce il valore `DeviceDescriptor` corrente.
`DeviceDescriptor`	`getCachedDeviceDescriptor(boolean shortDescriptor)` Restituisce un `DeviceDescriptor` memorizzato nella cache se il dispositivo è 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 senza passando l'oggetto effettivo del dispositivo.
`DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` Restituisci un `DeviceDescriptor` dalle informazioni del dispositivo per avere informazioni senza passando 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 degli 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 in cui 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 valore `MountPointInfo` corrispondente al percorso del punto di montaggio specificato oppure `null` se il percorso non è 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 il comando "pidof" e "stat" e restituisce l'oggetto `ProcessInfo` con PID e 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
`String`	`getTrackingSerial()` Ai fini della gestione dei dispositivi, individua il numero di serie utilizzato per monitorare il dispositivo.
	`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 trasferire questo dispositivo a una nuova allocazione stato.
`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 eseguito il downgrade a non amministratore.
`boolean`	`isMultiUserSupported()` Determina se la funzionalità multiutente è supportata.
`boolean`	`isPackageInstalled(String packageName, String userId)` Esegui una query sul dispositivo per trovare un dato nome pacchetto e un dato ID utente per verificare se al momento installato o meno per quell'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 ritorna al completamento del comando e quando il dispositivo non è più visibile ad ADB.
`void`	`postAdbRootAction()` Esegui l'override se il dispositivo ha bisogno di determinate azioni dopo la root adb e prima del comando il dispositivo è di nuovo online.
`void`	`postAdbUnrootAction()` Esegui l'override se il dispositivo richiede l'esecuzione di determinate azioni dopo l'unroot dell'adb e prima il dispositivo è 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 la chiamata al termine dell'operazione.
`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 file `ERROR(/File)` temporaneo locale e lo restituisce `File`.
`File`	`pullFile(String remoteFilePath)` Recupera un file dal dispositivo, lo archivia in un file `ERROR(/File)` temporaneo locale e lo restituisce `File`.
`boolean`	`pullFile(String remoteFilePath, File localFile, int userId)` Recupera un file dal dispositivo.
`String`	`pullFileContents(String remoteFilePath)` Recupera un file dal dispositivo e restituisce i contenuti.
`File`	`pullFileFromExternal(String remoteFilePath)` Un metodo pratico per recuperare un file dalla memoria esterna del dispositivo, archivialo in un `ERROR(/File)` temporaneo locale e restituirà un riferimento a tale `File`.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, excludedDirectories)` Esegui il push ricorsivo dei contenuti delle directory al dispositivo, escludendo alcune directory che sono filtrati.
`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à per il 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 soltanto finché il dispositivo non è online, ad esempio 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 di profili esistenti 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`	`setTrackingSerial(String trackingSerial)` Ai fini della gestione dei dispositivi, traccia il numero di serie che utilizziamo per fare riferimento al dispositivo.
`void`	`setUseFastbootErase(boolean useFastbootErase)` 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 per 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 ID utente con un timeout predefinito.
`boolean`	`switchUser(int userId, long timeout)` Passa a un altro userId con il timeout fornito come scadenza.
`boolean`	`syncFiles(File localFileDir, String deviceFilePath)` Sincronizza in modo incrementale i contenuti di una directory di file locale con il dispositivo.
`Bugreport`	`takeBugreport()` 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 far sì che il dispositivo si trovi in "recupero ADB" (tieni presente che questo è diverso `IDeviceRecovery`).
`boolean`	`waitForDeviceInSideload(long waitTime)` Blocchi per far sì che il dispositivo si trovi in ''adb sideload'' stato
`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 del comando 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 di ddmlib per impostazione predefinita e utilizza sia "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 `IDeviceActionReceiver` relative all'evento di avvio del riavvio.
`boolean`	`performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)` Esegue un'azione su questo dispositivo.
`void`	`postAdbReboot()` 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 proprio ID cliente.
`void`	`setTestDeviceOptions( deviceOptions)`
`CommandResult`	`simpleFastbootCommand(long timeout, envVarMap, String[] fullCmd)` Esegue un semplice comando fastboot con variabili di ambiente e segnala lo stato del .
`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: -10.000 (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

SPAZIO DI ARCHIVIAZIONE_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 ()

Micro ottimizzazione (circa 400 millisecondi) mediante il precaricamento di tutti gli oggetti di cui abbiamo bisogno anziché chiamare "adb" getprop per ognuno. Ad esempio, il recupero di tutte le proprietà è veloce quanto il recupero di una. Ad esempio, device.getApiLevel(), checkApiLevelAgainstNextRelease e getBuildAlias dietro le quinte, "adb getprop". Li recuperiamo con una sola chiamata e chiamiamo NativeDevice.setProperty. Anche se non lo facciamo, NativeDevice chiama direttamente 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 trova ci sono 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 prende in considerazione ancora le funzionalità non ancora rilasciate, prima che venga innalzato il 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 modo eccessivo.

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 quando viene avviata 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.

Questa opzione è utile nei casi in cui vuoi assicurarti che ITestDevice#getLogcat() restituisca solo i resi Registra i dati generati dopo un determinato momento (ad esempio dopo il flashing della 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 rete Wi-Fi reti specificate nella mappa wifiSsidToPsk. Dopo aver stabilito una connessione, l'istanza proverà a Ripristina la connessione dopo ogni riavvio fino al giorno ITestDevice#disconnectFromWifi() oppure ITestDevice#clearLastConnectedWifiNetwork() ha chiamato.

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 al giorno ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork() ha chiamato.

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.

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`

connettitiallareteWifiIfNeeded

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

Una variante di connectToWifiNetwork(String, String) che si connette solo se il dispositivo attualmente 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`

connettitiallareteWifiIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Una variante di connectToWifiNetwork(String, String) che si connette solo se il dispositivo attualmente 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 sistema_server con system_server ProcessInfo precedente. 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`

dispositivoSoftRiavviatoDal

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Metodo di supporto per verificare se il dispositivo è stato riavviato temporaneamente a partire dall'ora UTC dall'epoca dispositivo e i relativi ERROR(/TimeUnit). Per riavvio software si intende system_server riavviato al di fuori di un riavvio forzato del dispositivo (ad esempio, riavvio richiesto). L'attuale utcEpochTime del dispositivo in Il 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 bloccherà fino a è 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 di input sia pronto, questo avviene più o meno nello stesso momento in cui dispositivo segnala BOOT_COMPLETE, apparentemente in modo asincrono, perché il framework attuale l'implementazione presenta race condizione occasionali. Viene quindi inviato un comando per ignorare il blocco tastiera (funziona solo su quelle non sicure)

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

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 ripulire del 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 se 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 il comando "enable-root" è "false", registrerà un messaggio e senza abilitare root.

L'attivazione della directory principale ADB potrebbe causare la disconnessione del dispositivo da ADB. Questo metodo bloccherà fino a è 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 riesce.

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 invece executeShellCommand(String), in quanto migliora il rilevamento dei guasti e le prestazioni.

Parametri
`timeout`	`long`: il tempo in millisecondi prima che il dispositivo venga considerato come non risponde, 0 L 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 invece executeShellCommand(String), in quanto migliora il rilevamento dei guasti e le prestazioni.

Parametri
`timeout`	`long`: il tempo in millisecondi prima che il dispositivo venga considerato come non risponde, 0 L 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 invece executeShellCommand(String), in quanto migliora il rilevamento dei guasti e le prestazioni.

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 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 il sistema variabili di ambiente.

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 viene eseguito il comando autorizzati a 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 un comando se questo non riesce a causa di un un'eccezione. L'eccezione DeviceNot responsiveException verrà generata se `retryAttempts` vengono eseguite senza successo.

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 viene eseguito il comando autorizzati a 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 un comando se questo non riesce a causa di un un'eccezione. L'eccezione DeviceNotDisabledException verrà generata se `retryAttempts` sono senza successo.

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 executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) con i 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 il comando stderr. stdout è vengono indirizzati allo stream 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 un comando se questo non riesce a causa di un un'eccezione. L'eccezione DeviceNotDisabledException verrà generata se `retryAttempts` sono senza successo.

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 un comando se questo non riesce a causa di un un'eccezione. L'eccezione DeviceNotDisabledException verrà generata se `retryAttempts` sono senza successo.

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 un comando se questo non riesce a causa di un un'eccezione. L'eccezione DeviceNotDisabledException verrà generata se `retryAttempts` sono senza successo.

Ritorni
`CommandResult`

Lanci
`DeviceNotAvailableException`

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

Metodo helper che cancella una partizione per il dispositivo.

Se getUseFastbootErase() è true, la cancellazione rapida dei dati verrà usata 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 utente id troverà un ID Android associato in questa funzione, pertanto alcuni ID utente potrebbero corrispondere a un valore nullo.

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. Scaricare la versione radio è specifico del dispositivo, quindi potrebbe non restituire le informazioni corrette per tutti i dispositivi. Questo fa affidamento sulla proprietà gsm.version.baseband per restituire le informazioni corrette sulla versione. Questo dato non è preciso per alcuni dispositivi CDMA e la versione qui restituita potrebbe non corrispondere la versione segnalata da fastboot e potrebbe non restituire la versione per la radio CDMA. TL;DR questo metodo segnala la versione accurata solo se la proprietà gsm.version.baseband è uguale alla versione restituita da fastboot getvar version-baseband.

Ritorni
`String`	la versione della banda di base `String` o `null` se non può essere determinata (il dispositivo non ha un segnale radio o la 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 la proprietà ha il valore `"0"`, `"n"`, `"no"`, `"off"`, `"false"` o `defaultValue` negli altri casi.

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 il tempo e il motivo dell'avvio a partire dalla data tempo dall'epoca del dispositivo e l'unità di tempo specificata. L'attuale utcEpochTime del dispositivo in Il millisecondo 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 es. 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 il dispositivo continui a funzionare su un dispositivo privo di scheda SD (o nel punto in cui la scheda SD non è ancora montata).

Ritorni
`InputStreamSource`	Un `InputStreamSource` che produrrà i contenuti della segnalazione di bug on demand. Nella 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 la "versione adb" > 1,0.36

Ritorni
`InputStreamSource`	a `InputStreamSource` del file ZIP contenente il bugreportz, restituisci null in 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 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 chiavi di rilascio (controllata da singoli produttori di dispositivi)

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

Lanci
`DeviceNotAvailableException`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

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

Ritorni
`DeviceDescriptor`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Restituisce un DeviceDescriptor memorizzato nella cache se il dispositivo è allocato, altrimenti restituisce il 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 senza passando l'oggetto effettivo del dispositivo.

Ritorni
`DeviceDescriptor`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Restituisci un DeviceDescriptor dalle informazioni del dispositivo per avere informazioni senza passando 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). Utilizza il tempo dell'epoca internamente.

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`

getEsecuzioneShellCommandLog

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 potrà 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. O nullo se qualcosa va sbagliato.

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 es. entrambi "/system" e "system" è supportata)

Ritorni
`IFileEntry`	`IFileEntry` o `null` se il file al `path` specificato non può essere trovato

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 FileEntry System per renderlo disponibile in 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 degli stati pieghevoli sul dispositivo. Può essere ottenuto con "cmd device_state" stati di stampa".

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 dall'ADB. Di conseguenza, i chiamanti non devono tenere un riferimento a IDevice, perché il riferimento 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 blocco tastiera e restituisce Null se la query Keyguard non è supportata.

Lanci
`DeviceNotAvailableException`

getLastAspettaRiavvioMillis

public long getLastExpectedRebootTimeMillis ()

Restituisce l'ultima volta in cui 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 in background acquisizione logcat

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 istantanee frequenti dei dati logcat acquisiti senza incorrere in una penalità di spazio su disco potenzialmente elevata per ottenere l'intero snapshot getLogcat().

Parametri
`maxBytes`	`int`: la quantità massima di dati da restituire. Deve essere un importo che può si adattano perfettamente alla memoria

Ritorni
`InputStreamSource`

getLogcatDump

public InputStreamSource getLogcatDump ()

Recupera il logcat attuale per il dispositivo. A differenza di getLogcat(), questo metodo restituiscono 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. In caso di errore viene restituito un flusso vuoto per acquisire i dati logcat.

getLogcatDal

public InputStreamSource getLogcatSince (long date)

Acquisisce un flusso di snapshot dei dati logcat acquisiti a partire dalla data fornita. L'ora dovrebbe essere usato 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 valore MountPointInfo corrispondente al percorso del punto di montaggio specificato oppure null se il percorso non è 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 il comando "pidof" e "stat" e restituisce l'oggetto ProcessInfo con PID e 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`	una `InputStreamSource` dello screenshot in 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 precedenti per supportare il "formato" e poi scalare

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

Ritorni
`InputStreamSource`	una `InputStreamSource` dello screenshot in formato o `null` se screenshot non riuscito.

Lanci
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

Acquisisce uno screenshot dal dispositivo. È consigliabile usare invece getScreenshot(String) con 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`	una `InputStreamSource` dello screenshot in formato o `null` se screenshot non riuscito.

Lanci
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot ()

Acquisisce uno screenshot dal dispositivo.

Ritorni
`InputStreamSource`	Una `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 qualche motivo non viene estratta una lapide, non presente nell'elenco. Solo un DeviceNotAvailableException terminerà il metodo in anticipo.

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`

getTrackingSerial

public String getTrackingSerial ()

Ai fini della gestione dei dispositivi, individua il numero di serie utilizzato per monitorare il dispositivo.

Ritorni
`String`

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 nell' 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 in "android.content.pm.UserInfo" nel progetto open source Android.

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. Può eseguire la transizione del dispositivo al nuovo stato. Informerà IDeviceMonitor di eventuali transizioni di stato.

Elaborare DeviceEvent, che può o meno trasferire questo dispositivo a una nuova allocazione stato.

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 "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 disponibili le opzioni di CPU e memoria 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 la data e l'ora di 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 disponibili le opzioni di CPU e memoria 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 disponibili le opzioni di CPU e memoria 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 la data e l'ora di 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 disponibili le opzioni di CPU e memoria 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 eseguito il downgrade a 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 trovare un dato nome pacchetto e un dato ID utente per verificare se al momento installato o meno per quell'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, l'utente principale 0.

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 "visibile" l'utente è un utente che sta interagendo con l'"umano" all'utente e, di conseguenza, può avviare attività di avvio (di solito, 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 "visibile" l'utente è un utente che sta interagendo con l'"umano" all'utente e, di conseguenza, può avviare attività di lancio 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 caso affermativo, potresti chiamare startVisibleBackgroundUser(int, int, boolean), superando un display restituito da listDisplayIdsForStartingVisibleBackgroundUsers() (che deve 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 caso affermativo, potresti chiamare startVisibleBackgroundUser(int, int, boolean), superando un display restituito 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 del Wi-Fi prima di testare non deve funzionare con 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 output verrà generato DeviceRuntimeException dal dispositivo non è come previsto.

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. Si tratta di una chiamata sicura che non verrà generata nemmeno la registrazione non va a buon fine.

Parametri
`tag`	`String`: il tag in base al quale registriamo il nostro messaggio nel logcat.
`level`	`Log.LogLevel`: il livello di debug del messaggio 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 ritorna al completamento del 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 determinate azioni dopo la root adb e prima del comando il dispositivo è di nuovo 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 determinate azioni dopo l'unroot dell'adb e prima il dispositivo è 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 questo metodo non deve essere chiamato esplicitamente, le implementazioni dovrebbero eseguire automaticamente questi passaggi quando si esegue un riavvio.

Potrebbe essere necessario chiamare quando il dispositivo si riavvia a causa di altri eventi (ad esempio, quando il comando di aggiornamento fastboot è stato completato)

Lanci
`DeviceNotAvailableException`

postInvocationTeardown

public void postInvocationTearDown (Throwable exception)

Passaggi aggiuntivi per la pulizia specifica del dispositivo che verranno eseguiti dopo la chiamata al termine dell'operazione.

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 saranno sostituite.

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 file ERROR(/File) temporaneo locale e lo restituisce 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 oppure `null` se il valore 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 file ERROR(/File) temporaneo locale e lo restituisce File.

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

Ritorni
`File`	Un elemento `ERROR(/File)` contenente i contenuti del file del dispositivo oppure `null` se il valore 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 saranno sostituite.
`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 oppure `null` se il valore 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, archivialo in un ERROR(/File) temporaneo locale e restituirà un riferimento a tale File.

Parametri
`remoteFilePath`	`String`: il percorso del file sul dispositivo in relazione alla memoria esterna del dispositivo punto di montaggio

Ritorni
`File`	Un elemento `ERROR(/File)` contenente i contenuti del file del dispositivo oppure `null` se il valore 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 che sono filtrati.

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à per il 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 soltanto finché il dispositivo non è online, ad esempio 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 di un'azione del dispositivo l'avvio e il termine dell'azione sul 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 di profili esistenti 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 l'operazione non è riuscita completato, 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, i listener verranno informati di testRunFailed e "false" verrà restituito. Il comando di test non verranno eseguite nuovamente. I chiamanti possono riprovare se necessario.

Se la connessione al dispositivo si perde prima del completamento dell'esecuzione del test e il ripristino non va a buon fine, i listener verranno informati di testRunFailed e verrà restituito un 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 completato 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 particolare; 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 attivato sono state assegnate.

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 assegnato 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 attivato sono state assegnate.

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 usare quando si verifica un problema di comunicazione del dispositivo riscontrati. 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`: "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`

setTrackingSerial

public void setTrackingSerial (String trackingSerial)

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

Parametri
`trackingSerial`	`String`

ImpostaUsaFastbootCancella

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 l'eliminazione rapida oppure `false` se è necessario deve essere usato 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().

startLogcat() e stopLogcat() in genere non devono essere chiamati quando in 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 da 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 per 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 la chiusura 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 ID utente 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 per quali file eseguire il push confrontando i timestamp dei file locali con il telecomando equivalenti. Solo "più recenti" o file inesistenti verranno inviati al dispositivo. Di conseguenza, l'overhead dovrebbe essere relativamente piccolo se il set di file sul dispositivo è già aggiornato.

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

Esempio di utilizzo: syncFiles("/tmp/files", "/sdcard") crea una directory /sdcard/files se non esiste già, e in modo ricorsivo esegue il push dei 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 in questo il percorso del file deve essere leggibile. Ad esempio, push a /data/local/tmp quando adb non è root non riuscirà

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. Restituisce null 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(). Pertanto, 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 far sì che il dispositivo si trovi in "recupero ADB" (tieni presente che questo è diverso 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 per far sì che il dispositivo si trovi in ''adb sideload'' stato

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. Utilizza le funzionalità di waitForDeviceAvailable() in alternativa.

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. Utilizza le funzionalità di waitForDeviceAvailable() in alternativa.

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 del comando 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 di ddmlib per impostazione predefinita e utilizza sia "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à eseguito alcun tentativo di 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. Tutte le API pubbliche per Se il valore è true, il riavvio deve essere disattivato.

Ritorni
`boolean`

èPiù recente

protected boolean isNewer (File localFile, 
                IFileEntry entry)

Restituisci true se il file locale è più recente del file remoto. IFileEntry in corso al minuto, in caso di numero uguale, il file sarà 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 IDeviceActionReceiver relative all'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 recuperare il dispositivo e, facoltativamente, riprova il comando se non va a buon fine.

Parametri
`actionDescription`	`String`: una breve descrizione dell'azione da eseguire. Utilizzato per il logging ai soli scopi.
`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 il numero massimo di tentativi effettuati senza operazione riuscita

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

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

Ritorni
`CommandResult`

SimpleFastbootCommand

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

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

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

Ritorni
`CommandResult`

attesaPerDispositivoNonDisponibile

protected boolean waitForDeviceNotAvailable (String operationDesc, 
                long time)

Attendi che il dispositivo 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

SPAZIO DI ARCHIVIAZIONE_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

connettitiallareteWifiIfNeeded

connettitiallareteWifiIfNeeded

CreaUtente

CreaUtente

CreaUtente

CreaUtenteNoThrow

deleteFile

deleteFile

annullaregistrazioneDeviceActionReceiver

dispositivoRiavvio avviato

dispositivoSoftRiavviatoDal

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