A partire dal 2026, per allinearci al nostro modello di sviluppo stabile del trunk e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per la creazione e il contributo ad AOSP, consigliamo di utilizzare android-latest-release anziché aosp-main. Il ramo del manifest android-latest-release farà sempre riferimento alla release più recente inviata ad AOSP. Per saperne di più, vedi Modifiche ad AOSP.

DeviceImpl

public final class DeviceImpl
extends Object implements IDevice

java.lang.Object
↳	com.android.tradefed.device.server.DeviceImpl

Un dispositivo. Può trattarsi di un dispositivo fisico o di un emulatore.

Riepilogo

Costruttori pubblici
`DeviceImpl(ClientTracker clientTracer, String serialNumber, IDevice.DeviceState deviceState)`

Metodi pubblici
`boolean`	`arePropertiesSet()` Restituisce `true` se le proprietà sono state memorizzate nella cache
`void`	`createForward(int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)` Crea un port forwarding tra una porta TCP locale e un socket di dominio Unix remoto.
`void`	`createForward(int localPort, int remotePort)` Crea un port forwarding tra una porta locale e una remota.
`void`	`createReverse(int remotePort, int localPort)` Crea un'inversione di porta tra una porta remota e una locale.
`void`	`executeBinderCommand(String[] parameters, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)` Esegue un comando Binder sul dispositivo e invia il risultato a un `receiver` Utilizza la chiamata exec:cmd o abb_exec: più veloce se sia il sistema operativo del dispositivo sia l'host ADB Server supportano la funzionalità di esecuzione di Android Binder Bridge.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` Esegue un comando shell sul dispositivo e invia il risultato a un `receiver`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)` Una versione del comando executeShell che può accettare un flusso di input da inviare tramite stdin.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` Esegue un comando shell sul dispositivo e invia il risultato a un `receiver` È simile alla chiamata di `executeShellCommand(command, receiver, DdmPreferences.getTimeOut())`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, int maxTimeToOutputResponse)`
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` Esegue un comando shell sul dispositivo e invia il risultato a un `receiver`.
`void`	`forceStop(String applicationName)` Forza l'arresto di un'applicazione in base al nome.
	`getAbis()` Restituisce le ABI supportate da questo dispositivo.
`ListenableFuture<AvdData>`	`getAvdData()` Restituisce informazioni sull'AVD su cui è in esecuzione l'emulatore.
`String`	`getAvdName()` Restituisce il nome dell'AVD su cui è in esecuzione l'emulatore.
`String`	`getAvdPath()` Restituisce il percorso assoluto del dispositivo virtuale nel file system.
	`getBattery(long freshnessTime, TimeUnit timeUnit)` Restituisce il livello della batteria del dispositivo, da 0 a 100 percento.
	`getBattery()` Restituisce il livello della batteria del dispositivo, da 0 a 100 percento.
`Integer`	`getBatteryLevel(long freshnessMs)` Restituisce il livello della batteria del dispositivo, da 0 a 100 percento.
`Integer`	`getBatteryLevel()` Restituisce il livello della batteria del dispositivo, da 0 a 100 percento.
`ClientImpl`	`getClient(String applicationName)` Restituisce un `Client` in base al nome dell'applicazione.
`String`	`getClientName(int pid)` Restituisce il nome del client per pid o `null` se il pid non è noto
`ClientTracker`	`getClientTracker()`
`ClientImpl[]`	`getClients()` Restituisce l'array di client.
`int`	`getDensity()` Restituisce il bucket di densità dello schermo del dispositivo leggendo il valore della proprietà di sistema `PROP_DEVICE_DENSITY`.
`FileListingService`	`getFileListingService()` Restituisce un `FileListingService` per questo dispositivo.
`String`	`getLanguage()` Restituisce la lingua dell'utente.
`InstallMetrics`	`getLastInstallMetrics()` Recupera le informazioni sull'installazione più recente su questo dispositivo.
`String`	`getMountPoint(String name)` Restituisce un punto di montaggio.
`String`	`getName()` Restituisce un nome (leggibile) per questo dispositivo.
`ClientImpl[]`	`getNativeClients()`
`ClientImpl`	`getNativeClients(String applicationName)`
`ProfileableClientImpl[]`	`getProfileableClients()` Restituisce l'array di client profilabili.
	`getProperties()` Restituisce le proprietà del dispositivo memorizzate nella cache.
`String`	`getProperty(String name)` Metodo pratico che tenta di recuperare una proprietà tramite `IShellEnabledDevice.getSystemProperty(String)` con un tempo di attesa molto breve e gestisce le eccezioni.
`String`	`getPropertyCacheOrSync(String name)` Una combinazione di `getProperty(String)` e `getPropertySync(String)` che tenterà di recuperare la proprietà dalla cache.
`int`	`getPropertyCount()` Restituisce il numero di proprietà per questo dispositivo.
`String`	`getPropertySync(String name)` Una variante di `getProperty(String)` che tenterà di recuperare la proprietà specificata direttamente dal dispositivo, senza utilizzare la cache.
`String`	`getRegion()` Restituisce la regione dell'utente.
`static String`	`getScreenRecorderCommand(String remoteFilePath, ScreenRecorderOptions options)`
`RawImage`	`getScreenshot()` Acquisisce uno screenshot del dispositivo e lo restituisce come `RawImage`.
`RawImage`	`getScreenshot(long timeout, TimeUnit unit)`
`String`	`getSerialNumber()` Restituisce il numero di serie del dispositivo.
`IDevice.DeviceState`	`getState()` Restituisce lo stato del dispositivo.
`SyncService`	`getSyncService()` Restituisce un oggetto `SyncService` per inviare / recuperare file da e verso il dispositivo.
`ListenableFuture<String>`	`getSystemProperty(String name)` Esegui una potenziale query asincrona per una proprietà di sistema.
`boolean`	`hasClients()` Restituisce un valore che indica se `IDevice` ha `Client`.
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)` Installa un'applicazione Android sul dispositivo.
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` Installa un'applicazione Android sul dispositivo.
`void`	`installPackage(String packageFilePath, boolean reinstall, String... extraArgs)` Installa un'applicazione Android sul dispositivo.
`void`	`installPackages( apks, boolean reinstall, installOptions)` Installa un'applicazione Android composta da diversi file APK (uno principale e 0..n pacchetti suddivisi) con timeout predefinito
`void`	`installPackages( apks, boolean reinstall, installOptions, long timeout, TimeUnit timeoutUnit)` Installa un'applicazione Android composta da diversi file APK (uno principale e 0-n pacchetti suddivisi)
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` Installa il pacchetto dell'applicazione che è stato inviato a una posizione temporanea sul dispositivo.
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, String... extraArgs)` Installa il pacchetto dell'applicazione che è stato inviato a una posizione temporanea sul dispositivo.
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)` Installa il pacchetto dell'applicazione che è stato inviato a una posizione temporanea sul dispositivo.
`void`	`installRemotePackages( remoteApks, boolean reinstall, installOptions)` Installa un'applicazione Android composta da diversi file APK presenti localmente sul dispositivo con timeout predefinito
`void`	`installRemotePackages( remoteApks, boolean reinstall, installOptions, long timeout, TimeUnit timeoutUnit)` Installa un'applicazione Android composta da diversi file APK presenti localmente sul dispositivo
`boolean`	`isBootLoader()` Indica se il dispositivo è in modalità bootloader.
`boolean`	`isEmulator()` Restituisce `true` se il dispositivo è un emulatore.
`boolean`	`isOffline()` Indica se il dispositivo è offline.
`boolean`	`isOnline()` Indica se il dispositivo è pronto.
`boolean`	`isRoot()` Esegue una query sullo stato di root attuale del dispositivo.
`void`	`kill(String applicationName)` Termina un'applicazione in base al nome.
`void`	`pullFile(String remote, String local)` Recupera un singolo file.
`void`	`push(String[] local, String remote)` Esegue il push di più file o directory.
`void`	`pushFile(String local, String remote)` Esegue il push di un singolo file.
`SocketChannel`	`rawBinder(String service, String[] parameters)` Richiama il servizio Android Binder Bridge su un dispositivo remoto.
`SocketChannel`	`rawExec(String executable, String[] parameters)` Richiama il servizio host:exec su un dispositivo remoto.
`void`	`reboot(String into)` riavvia il dispositivo.
`void`	`removeForward(int localPort)` Rimuove un port forwarding tra una porta locale e una remota.
`void`	`removeRemotePackage(String remoteFilePath)` Rimuove un file dal dispositivo.
`void`	`removeReverse(int remotePort)` Rimuove un'inversione di porta tra una porta remota e una locale.
`boolean`	`root()` Chiedi al daemon adb di diventare root sul dispositivo.
`void`	`startScreenRecorder(String remoteFilePath, ScreenRecorderOptions options, IShellOutputReceiver receiver)` Avvia la registrazione dello schermo sul dispositivo se supporta `IDevice.Feature.SCREEN_RECORD`.
`boolean`	`supportsFeature(IDevice.HardwareFeature feature)` Indica se questo dispositivo supporta la funzionalità hardware specificata.
`boolean`	`supportsFeature(IDevice.Feature feature)` Restituisce un valore che indica se questo dispositivo supporta la funzionalità software specificata.
`String`	`syncPackageToDevice(String localFilePath)` Esegue il push di un file sul dispositivo
`String`	`toString()`
`String`	`uninstallApp(String applicationID, String... extraArgs)` Disinstalla un'app dal dispositivo.
`String`	`uninstallPackage(String packageName)` Disinstalla un pacchetto dal dispositivo.

Costruttori pubblici

DeviceImpl

public DeviceImpl (ClientTracker clientTracer, 
                String serialNumber, 
                IDevice.DeviceState deviceState)

Parametri
`clientTracer`	`ClientTracker`
`serialNumber`	`String`
`deviceState`	`IDevice.DeviceState`

Metodi pubblici

arePropertiesSet

public boolean arePropertiesSet ()

Restituisce true se le proprietà sono state memorizzate nella cache

Ritorni
`boolean`

createForward

public void createForward (int localPort, 
                String remoteSocketName, 
                IDevice.DeviceUnixSocketNamespace namespace)

Crea un port forwarding tra una porta TCP locale e un socket di dominio Unix remoto.

Parametri
`localPort`	`int`: la porta locale da inoltrare
`remoteSocketName`	`String`: nome del socket di dominio Unix creato sul dispositivo
`namespace`	`IDevice.DeviceUnixSocketNamespace`: lo spazio dei nomi in cui è stato creato il socket di dominio Unix

Lanci
`AdbCommandRejectedException`
`TimeoutException`

createForward

public void createForward (int localPort, 
                int remotePort)

Crea un port forwarding tra una porta locale e una remota.

Parametri
`localPort`	`int`: la porta locale da inoltrare
`remotePort`	`int`: la porta remota.

Lanci
`AdbCommandRejectedException`
`TimeoutException`

createReverse

public void createReverse (int remotePort, 
                int localPort)

Crea un'inversione di porta tra una porta remota e una locale.

Parametri
`remotePort`	`int`: la porta remota da invertire.
`localPort`	`int`: la porta locale

Lanci
`AdbCommandRejectedException`
`TimeoutException`

executeBinderCommand

public void executeBinderCommand (String[] parameters, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                InputStream is)

Esegue un comando Binder sul dispositivo e invia il risultato a un receiver

Utilizza la chiamata exec:cmd o abb_exec: più veloce se sia il sistema operativo del dispositivo sia l'host ADB Server supportano la funzionalità di esecuzione di Android Binder Bridge.

Parametri
`parameters`	`String`: il comando binder da eseguire
`receiver`	`IShellOutputReceiver`: il `IShellOutputReceiver` che riceverà l'output del comando binder
`maxTimeToOutputResponse`	`long`
`maxTimeUnits`	`TimeUnit`
`is`	`InputStream`: flusso di input facoltativo da inviare tramite stdin

Lanci
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

Esegue un comando shell sul dispositivo e invia il risultato a un receiver.

maxTimeToOutputResponse viene utilizzato come tempo di attesa massimo quando si prevede l'output del comando dal dispositivo.
In qualsiasi momento, se il comando shell non restituisce alcun output per un periodo superiore a maxTimeToOutputResponse, il metodo genererà ShellCommandUnresponsiveException.

Per i comandi come l'output del log, deve essere utilizzato un valore maxTimeToOutputResponse pari a 0, il che significa che il metodo non genererà mai un'eccezione e verrà bloccato finché IShellOutputReceiver.isCancelled() del destinatario non restituisce true.

Parametri
`command`	`String`: il comando shell da eseguire
`receiver`	`IShellOutputReceiver`: il `IShellOutputReceiver` che riceverà l'output del comando shell
`maxTimeToOutputResponse`	`long`: il periodo di tempo massimo durante il quale il comando può non restituire alcuna risposta. Un valore pari a 0 indica che il metodo attenderà per sempre (finché `receiver` non annulla l'esecuzione) l'output del comando e non genererà mai un'eccezione.
`maxTimeUnits`	`TimeUnit`: unità per i valori `maxTimeToOutputResponse` diversi da zero.

Lanci
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                InputStream is)

Una versione del comando executeShell che può accettare un flusso di input da inviare tramite stdin.

Parametri
`command`	`String`
`receiver`	`IShellOutputReceiver`
`maxTimeToOutputResponse`	`long`
`maxTimeUnits`	`TimeUnit`
`is`	`InputStream`

Lanci
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Esegue un comando shell sul dispositivo e invia il risultato a un receiver

È simile alla chiamata di executeShellCommand(command, receiver, DdmPreferences.getTimeOut()).

Parametri
`command`	`String`: il comando shell da eseguire
`receiver`	`IShellOutputReceiver`: il `IShellOutputReceiver` che riceverà l'output del comando shell

Lanci
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                int maxTimeToOutputResponse)

Parametri
`command`	`String`
`receiver`	`IShellOutputReceiver`
`maxTimeToOutputResponse`	`int`

Lanci
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

Esegue un comando shell sul dispositivo e invia il risultato a un receiver.

Parametri
`command`	`String`: il comando shell da eseguire
`receiver`	`IShellOutputReceiver`: il `IShellOutputReceiver` che riceverà l'output del comando shell
`maxTimeout`	`long`: il timeout massimo per la restituzione del comando. Un valore pari a 0 indica che non verrà applicato alcun timeout massimo.
`maxTimeToOutputResponse`	`long`: il periodo di tempo massimo durante il quale il comando può non restituire alcuna risposta. Un valore pari a 0 indica che il metodo attenderà per sempre (finché `receiver` non annulla l'esecuzione) l'output del comando e non genererà mai un'eccezione.
`maxTimeUnits`	`TimeUnit`: unità per i valori non nulli di `maxTimeout` e `maxTimeToOutputResponse`.

Lanci
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

forceStop

public void forceStop (String applicationName)

Forza l'arresto di un'applicazione in base al nome. Vengono rimosse tutte le sveglie in sospeso e i calcoli in coda.

Parametri
`applicationName`	`String`: il nome dell'applicazione

getAbis

public  getAbis ()

Restituisce le ABI supportate da questo dispositivo. Le ABI sono ordinate in base all'ordine preferito, con la prima ABI che è la più preferita.

Ritorni
	l'elenco degli ABI.

getAvdData

public ListenableFuture<AvdData> getAvdData ()

Restituisce informazioni sull'AVD in esecuzione nell'emulatore.

AvdData.getName è il nome dell'AVD o null se non ce n'è.

AvdData.getPath è il percorso AVD o null se si tratta di un dispositivo fisico, il sottocomando della console dell'emulatore non è riuscito o la versione dell'emulatore è precedente alla 30.0.18

Ritorni
`ListenableFuture<AvdData>`	il `AvdData` del dispositivo.

getAvdName

public String getAvdName ()

Restituisce il nome dell'AVD su cui è in esecuzione l'emulatore.

Questo è valido solo se isEmulator() restituisce true.

Se l'emulatore non esegue alcun AVD (ad esempio, viene eseguito da una build dell'albero delle origini Android), questo metodo restituirà "<build>".

Nota: preferisci utilizzare getAvdData() se vuoi controllare il timeout.

Ritorni
`String`	il nome dell'AVD o `null` se non ce n'è.

getAvdPath

public String getAvdPath ()

Restituisce il percorso assoluto del dispositivo virtuale nel file system. Il percorso dipende dal sistema operativo; avrà separatori / su Linux e separatori \ su Windows.

Nota: preferisci utilizzare getAvdData() se vuoi controllare il timeout.

Ritorni
`String`	il percorso AVD o null se si tratta di un dispositivo fisico, il sottocomando della console dell'emulatore non è riuscito o la versione dell'emulatore è precedente alla 30.0.18

getBattery

public  getBattery (long freshnessTime, 
                TimeUnit timeUnit)

Restituisce il livello della batteria del dispositivo, da 0 a 100 percento.

Il livello della batteria potrebbe essere memorizzato nella cache. Esegue query sul dispositivo per il livello della batteria solo se freshnessTime è scaduto dall'ultima query riuscita.

Parametri
`freshnessTime`	`long`: la recency desiderata del livello batteria
`timeUnit`	`TimeUnit`: il `ERROR(/TimeUnit)` di freshnessTime

Ritorni
	un `ERROR(/Future)` che può essere utilizzato per interrogare il livello della batteria. Future restituirà un `ERROR(/ExecutionException)` se non è stato possibile recuperare il livello della batteria.

getBattery

public  getBattery ()

Restituisce il livello della batteria del dispositivo, da 0 a 100 percento.

Il livello della batteria potrebbe essere memorizzato nella cache. Esegue query sul dispositivo per il livello della batteria solo se sono trascorsi 5 minuti dall'ultima query riuscita.

Ritorni
	un `ERROR(/Future)` che può essere utilizzato per interrogare il livello della batteria. Future restituirà un `ERROR(/ExecutionException)` se non è stato possibile recuperare il livello della batteria.

getBatteryLevel

public Integer getBatteryLevel (long freshnessMs)

Restituisce il livello della batteria del dispositivo, da 0 a 100 percento.

Il livello della batteria potrebbe essere memorizzato nella cache. Esegue query sul dispositivo per il livello della batteria solo se sono trascorsi freshnessMs ms dall'ultima query riuscita.

Ritorni
`Integer`	il livello della batteria o `null` se non è stato possibile recuperarlo

getBatteryLevel

public Integer getBatteryLevel ()

Restituisce il livello della batteria del dispositivo, da 0 a 100 percento.

Il livello della batteria potrebbe essere memorizzato nella cache. Esegue query sul dispositivo per il livello della batteria solo se sono trascorsi 5 minuti dall'ultima query riuscita.

Ritorni
`Integer`	il livello della batteria o `null` se non è stato possibile recuperarlo

getClient

public ClientImpl getClient (String applicationName)

Restituisce un Client in base al nome dell'applicazione.

Parametri
`applicationName`	`String`: il nome dell'applicazione

Ritorni
`ClientImpl`	l'oggetto `Client` o `null` se non è stata trovata alcuna corrispondenza.

getClientName

public String getClientName (int pid)

Restituisce il nome del client per pid o null se il pid non è noto

Parametri
`pid`	`int`: il PID del client.

Ritorni
`String`

getClientTracker

public ClientTracker getClientTracker ()

Ritorni
`ClientTracker`

getClienti

public ClientImpl[] getClients ()

Restituisce l'array di client.

Ritorni
`ClientImpl[]`

getDensity

public int getDensity ()

Restituisce il bucket di densità dello schermo del dispositivo leggendo il valore della proprietà di sistema PROP_DEVICE_DENSITY.

Ritorni
`int`	la densità o -1 se non è possibile determinarla.

getFileListingService

public FileListingService getFileListingService ()

Restituisce un FileListingService per questo dispositivo.

Ritorni
`FileListingService`

getLanguage

public String getLanguage ()

Restituisce la lingua dell'utente.

Ritorni
`String`	La lingua dell'utente o null se è sconosciuta

getLastInstallMetrics

public InstallMetrics getLastInstallMetrics ()

Recupera le informazioni sull'installazione più recente su questo dispositivo.

Ritorni
`InstallMetrics`	Metriche `InstallMetrics` che descrivono l'installazione.

getMountPoint

public String getMountPoint (String name)

Restituisce un punto di montaggio.

Parametri
`name`	`String`: il nome del punto di montaggio da restituire

Ritorni
`String`

getName

public String getName ()

Restituisce un nome (leggibile) per questo dispositivo. In genere, si tratta del nome dell'AVD per gli AVD e di una combinazione del nome del produttore, del nome del modello e del numero di serie per i dispositivi.

Ritorni
`String`

getNativeClients

public ClientImpl[] getNativeClients ()

Ritorni
`ClientImpl[]`

getNativeClients

public ClientImpl getNativeClients (String applicationName)

Parametri
`applicationName`	`String`

Ritorni
`ClientImpl`

getProfileableClients

public ProfileableClientImpl[] getProfileableClients ()

Restituisce l'array di client profilabili.

Ritorni
`ProfileableClientImpl[]`

getProperties

public  getProperties ()

Restituisce le proprietà del dispositivo memorizzate nella cache. Contiene l'intero output di "getprop"

Ritorni

getProperty

public String getProperty (String name)

Metodo pratico che tenta di recuperare una proprietà tramite IShellEnabledDevice.getSystemProperty(String) con un tempo di attesa molto breve e gestisce le eccezioni.

Nota: preferisci utilizzare IShellEnabledDevice.getSystemProperty(String) se vuoi controllare il timeout.

Parametri
`name`	`String`: il nome del valore da restituire.

Ritorni
`String`	il valore o `null` se il valore della proprietà non era immediatamente disponibile

getPropertyCacheOrSync

public String getPropertyCacheOrSync (String name)

Una combinazione di getProperty(String) e getPropertySync(String) che tenterà di recuperare la proprietà dalla cache. Se non viene trovato, verrà eseguito un tentativo sincrono di interrogare direttamente il dispositivo e ripopolare la cache in caso di esito positivo.

Parametri
`name`	`String`: il nome del valore da restituire.

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

getPropertyCount

public int getPropertyCount ()

Restituisce il numero di proprietà per questo dispositivo.

Ritorni
`int`

getPropertySync

public String getPropertySync (String name)

Una variante di getProperty(String) che tenterà di recuperare la proprietà specificata direttamente dal dispositivo, senza utilizzare la cache. Questo metodo deve essere utilizzato (solo) per le proprietà volatili.

Parametri
`name`	`String`: il nome del valore da restituire.

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

getRegion

public String getRegion ()

Restituisce la regione dell'utente.

Ritorni
`String`	La regione dell'utente o null se è sconosciuta

getScreenRecorderCommand

public static String getScreenRecorderCommand (String remoteFilePath, 
                ScreenRecorderOptions options)

Parametri
`remoteFilePath`	`String`
`options`	`ScreenRecorderOptions`

Ritorni
`String`

getScreenshot

public RawImage getScreenshot ()

Acquisisce uno screenshot del dispositivo e lo restituisce come RawImage.

Ritorni
`RawImage`	lo screenshot come `RawImage` o `null` se si è verificato un problema.

Lanci
`AdbCommandRejectedException`
`TimeoutException`

getScreenshot

public RawImage getScreenshot (long timeout, 
                TimeUnit unit)

Parametri
`timeout`	`long`
`unit`	`TimeUnit`

Ritorni
`RawImage`

Lanci
`AdbCommandRejectedException`
`TimeoutException`

getSerialNumber

public String getSerialNumber ()

Restituisce il numero di serie del dispositivo.

Ritorni
`String`

getState

public IDevice.DeviceState getState ()

Restituisce lo stato del dispositivo.

Ritorni
`IDevice.DeviceState`

getSyncService

public SyncService getSyncService ()

Restituisce un oggetto SyncService per inviare / recuperare file da e verso il dispositivo.

Ritorni
`SyncService`	`null` se non è stato possibile creare SyncService. Ciò può verificarsi se adb si rifiuta di aprire la connessione perché `IDevice` non è valido (o è stato disconnesso).

Lanci
`AdbCommandRejectedException`
`TimeoutException`

getSystemProperty

public ListenableFuture<String> getSystemProperty (String name)

Esegui una potenziale query asincrona per una proprietà di sistema.

Parametri
`name`	`String`: il nome del valore da restituire.

Ritorni
`ListenableFuture<String>`	un `ListenableFuture.` `ERROR(get/Future#get() get)` potrebbe restituire null.

hasClients

public boolean hasClients ()

Restituisce un valore che indica se IDevice ha Client.

Ritorni
`boolean`

installPackage

public void installPackage (String packageFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                String... extraArgs)

Installa un'applicazione Android sul dispositivo. Si tratta di un metodo helper che combina i passaggi syncPackageToDevice, installRemotePackage e removePackage

Parametri
`packageFilePath`	`String`: il percorso assoluto del file system del file sull'host locale da installare
`reinstall`	`boolean`: imposta su `true` se deve essere eseguita la reinstallazione dell'app
`receiver`	`InstallReceiver`: il `InstallReceiver` da utilizzare per monitorare l'installazione e ottenere lo stato finale.
`maxTimeout`	`long`: il timeout massimo per la restituzione del comando. Un valore pari a 0 indica che non verrà applicato alcun timeout massimo.
`maxTimeToOutputResponse`	`long`: il periodo di tempo massimo durante il quale il comando può non restituire alcuna risposta. Un valore pari a 0 indica che il metodo attenderà per sempre (finché `receiver` non annulla l'esecuzione) l'output del comando e non genererà mai un'eccezione.
`maxTimeUnits`	`TimeUnit`: unità per i valori non nulli di `maxTimeout` e `maxTimeToOutputResponse`.
`extraArgs`	`String`: argomenti aggiuntivi facoltativi da passare. Per le opzioni disponibili, consulta "adb shell pm install --help".

Lanci
`InstallException`

installPackage

public void installPackage (String packageFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                String... extraArgs)

Installa un'applicazione Android sul dispositivo. Si tratta di un metodo helper che combina i passaggi syncPackageToDevice, installRemotePackage e removePackage

Parametri
`packageFilePath`	`String`: il percorso assoluto del file system del file sull'host locale da installare
`reinstall`	`boolean`: imposta su `true` se deve essere eseguita la reinstallazione dell'app
`receiver`	`InstallReceiver`: il `InstallReceiver` da utilizzare per monitorare l'installazione e ottenere lo stato finale.
`extraArgs`	`String`: argomenti aggiuntivi facoltativi da passare. Consulta "adb shell pm install --help" per le opzioni disponibili.

Lanci
`InstallException`

installPackage

public void installPackage (String packageFilePath, 
                boolean reinstall, 
                String... extraArgs)

Installa un'applicazione Android sul dispositivo. Si tratta di un metodo helper che combina i passaggi syncPackageToDevice, installRemotePackage e removePackage

Parametri
`packageFilePath`	`String`: il percorso assoluto del file system del file sull'host locale da installare
`reinstall`	`boolean`: imposta su `true` se deve essere eseguita la reinstallazione dell'app
`extraArgs`	`String`: argomenti aggiuntivi facoltativi da passare. Per le opzioni disponibili, consulta "adb shell pm install --help".

Lanci
`InstallException`

installPackages

public void installPackages ( apks, 
                boolean reinstall, 
                 installOptions)

Installa un'applicazione Android composta da diversi file APK (uno principale e 0..n pacchetti suddivisi) con timeout predefinito

Parametri
`apks`	: elenco di APK da installare (1 APK principale + 0..n APK suddivisi)
`reinstall`	`boolean`: imposta su `true` se deve essere eseguita la reinstallazione dell'app
`installOptions`	: argomenti aggiuntivi facoltativi da passare. Per le opzioni disponibili, consulta "adb shell pm install --help".

Lanci
`InstallException`

installPackages

public void installPackages ( apks, 
                boolean reinstall, 
                 installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

Installa un'applicazione Android composta da diversi file APK (uno principale e 0-n pacchetti suddivisi)

Parametri
`apks`	: elenco di APK da installare (1 APK principale + 0..n APK suddivisi)
`reinstall`	`boolean`: imposta su `true` se deve essere eseguita la reinstallazione dell'app
`installOptions`	: argomenti aggiuntivi facoltativi da passare. Consulta "adb shell pm install --help" per le opzioni disponibili.
`timeout`	`long`: timeout di installazione
`timeoutUnit`	`TimeUnit`: `ERROR(/TimeUnit)` corrispondente al parametro di timeout

Lanci
`InstallException`

installRemotePackage

public void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                String... extraArgs)

Installa il pacchetto dell'applicazione che è stato inviato a una posizione temporanea sul dispositivo.

Parametri
`remoteFilePath`	`String`: percorso file assoluto del file del pacchetto sul dispositivo
`reinstall`	`boolean`: imposta su `true` se deve essere eseguita la reinstallazione dell'app
`receiver`	`InstallReceiver`: il `InstallReceiver` da utilizzare per monitorare l'installazione e ottenere lo stato finale.
`extraArgs`	`String`: argomenti aggiuntivi facoltativi da passare. Consulta "adb shell pm install --help" per le opzioni disponibili.

Lanci
`InstallException`

installRemotePackage

public void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                String... extraArgs)

Installa il pacchetto dell'applicazione che è stato inviato a una posizione temporanea sul dispositivo.

Parametri
`remoteFilePath`	`String`: percorso file assoluto del file del pacchetto sul dispositivo
`reinstall`	`boolean`: imposta su `true` se deve essere eseguita la reinstallazione dell'app
`extraArgs`	`String`: argomenti aggiuntivi facoltativi da passare. Per le opzioni disponibili, consulta "adb shell pm install --help".

Lanci
`InstallException`

installRemotePackage

public void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                String... extraArgs)

Installa il pacchetto dell'applicazione che è stato inviato a una posizione temporanea sul dispositivo.

Parametri
`remoteFilePath`	`String`: percorso file assoluto del file del pacchetto sul dispositivo
`reinstall`	`boolean`: imposta su `true` se deve essere eseguita la reinstallazione dell'app
`receiver`	`InstallReceiver`: il `InstallReceiver` da utilizzare per monitorare l'installazione e ottenere lo stato finale.
`maxTimeout`	`long`: il timeout massimo per la restituzione del comando. Un valore pari a 0 indica che non verrà applicato alcun timeout massimo.
`maxTimeToOutputResponse`	`long`: il periodo di tempo massimo durante il quale il comando può non restituire alcuna risposta. Un valore pari a 0 indica che il metodo attenderà per sempre (finché `receiver` non annulla l'esecuzione) l'output del comando e non genererà mai un'eccezione.
`maxTimeUnits`	`TimeUnit`: unità per i valori non nulli di `maxTimeout` e `maxTimeToOutputResponse`.
`extraArgs`	`String`: argomenti aggiuntivi facoltativi da passare. Per le opzioni disponibili, consulta "adb shell pm install --help".

Lanci
`InstallException`

installRemotePackages

public void installRemotePackages ( remoteApks, 
                boolean reinstall, 
                 installOptions)

Installa un'applicazione Android composta da diversi file APK presenti localmente sul dispositivo con timeout predefinito

Parametri
`remoteApks`	: elenco dei percorsi dei file APK sul dispositivo da installare
`reinstall`	`boolean`: imposta su `true` se deve essere eseguita la reinstallazione dell'app
`installOptions`	: argomenti aggiuntivi facoltativi da passare. Per le opzioni disponibili, consulta "adb shell pm install --help".

Lanci
`InstallException`

installRemotePackages

public void installRemotePackages ( remoteApks, 
                boolean reinstall, 
                 installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

Installa un'applicazione Android composta da diversi file APK presenti localmente sul dispositivo

Parametri
`remoteApks`	: elenco dei percorsi dei file APK da installare sul dispositivo
`reinstall`	`boolean`: imposta su `true` se deve essere eseguita la reinstallazione dell'app
`installOptions`	: argomenti aggiuntivi facoltativi da passare. Consulta "adb shell pm install --help" per le opzioni disponibili.
`timeout`	`long`: timeout di installazione
`timeoutUnit`	`TimeUnit`: `ERROR(/TimeUnit)` corrispondente al parametro di timeout

Lanci
`InstallException`

isBootLoader

public boolean isBootLoader ()

Indica se il dispositivo è in modalità bootloader.

Ritorni
`boolean`	`true` se `getState()` restituisce `DeviceState.BOOTLOADER`.

isEmulator

public boolean isEmulator ()

Restituisce true se il dispositivo è un emulatore.

Ritorni
`boolean`

isOffline

public boolean isOffline ()

Indica se il dispositivo è offline.

Ritorni
`boolean`	`true` se `getState()` restituisce `DeviceState.OFFLINE`.

isOnline

public boolean isOnline ()

Indica se il dispositivo è pronto.

Ritorni
`boolean`	`true` se `getState()` restituisce `DeviceState.ONLINE`.

isRoot

public boolean isRoot ()

Esegue una query sullo stato di root attuale del dispositivo. Per ulteriori informazioni, vedi "adb root".

Ritorni
`boolean`	true se il daemon adb è in esecuzione come root, altrimenti false.

Lanci
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

uccidere

public void kill (String applicationName)

Termina un'applicazione in base al nome. Questa operazione distrugge solo le attività, lasciando il relativo stato nel sistema Android.

Parametri
`applicationName`	`String`: il nome dell'applicazione

pullFile

public void pullFile (String remote, 
                String local)

Recupera un singolo file.

Parametri
`remote`	`String`: il percorso completo del file remoto
`local`	`String`: La destinazione locale.

Lanci
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

push

public void push (String[] local, 
                String remote)

Esegue il push di più file o directory.

Parametri
`local`	`String`: i file locali da trasferire
`remote`	`String`: il percorso remoto che rappresenta una directory

Lanci
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

pushFile

public void pushFile (String local, 
                String remote)

Esegue il push di un singolo file.

Parametri
`local`	`String`: il percorso del file locale.
`remote`	`String`: il percorso del file remoto

Lanci
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

rawBinder

public SocketChannel rawBinder (String service, 
                String[] parameters)

Richiama il servizio Android Binder Bridge su un dispositivo remoto. Restituisce un canale socket connesso al comando del binder del dispositivo.

La proprietà di SocketChannel viene ceduta al chiamante, che deve chiuderlo esplicitamente dopo l'utilizzo.

Parametri
`service`	`String`: il nome del servizio Android a cui connettersi
`parameters`	`String`: i parametri del comando binder

Ritorni
`SocketChannel`	Un SocketChannel connesso al processo di esecuzione sul dispositivo. dopo l'uso.

Lanci
`AdbCommandRejectedException`
`TimeoutException`

rawExec

public SocketChannel rawExec (String executable, 
                String[] parameters)

Richiama il servizio host:exec su un dispositivo remoto. Restituisce un canale socket connesso al processo di esecuzione. Tieni presente che il servizio exec non distingue stdout e stderr, quindi ciò che viene letto dal socket può provenire da entrambi gli output ed essere intercalato.

La proprietà di SocketChannel viene ceduta al chiamante, che deve chiuderlo esplicitamente dopo l'utilizzo.

Parametri
`executable`	`String`
`parameters`	`String`

Ritorni
`SocketChannel`	Un SocketChannel connesso al processo di esecuzione sul dispositivo. dopo l'uso.

Lanci
`AdbCommandRejectedException`
`TimeoutException`

fai ripartire

public void reboot (String into)

riavvia il dispositivo.

Parametri
`into`	`String`: il nome del bootloader in cui riavviare o null per riavviare semplicemente il dispositivo.

Lanci
`AdbCommandRejectedException`
`TimeoutException`

removeForward

public void removeForward (int localPort)

Rimuove un port forwarding tra una porta locale e una remota.

Parametri
`localPort`	`int`: la porta locale da inoltrare

Lanci
`AdbCommandRejectedException`
`TimeoutException`

removeRemotePackage

public void removeRemotePackage (String remoteFilePath)

Rimuove un file dal dispositivo.

Parametri
`remoteFilePath`	`String`: percorso sul dispositivo del file da rimuovere

Lanci
`InstallException`

removeReverse

public void removeReverse (int remotePort)

Rimuove un'inversione di porta tra una porta remota e una locale.

Parametri
`remotePort`	`int`: la porta remota.

Lanci
`AdbCommandRejectedException`
`TimeoutException`

root

public boolean root ()

Chiedi al daemon adb di diventare root sul dispositivo. Questa operazione potrebbe non riuscire in modo invisibile e può avere esito positivo solo nelle build per sviluppatori. Per ulteriori informazioni, vedi "adb root".

Ritorni
`boolean`	true se il daemon adb è in esecuzione come root, altrimenti false.

Lanci
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

startScreenRecorder

public void startScreenRecorder (String remoteFilePath, 
                ScreenRecorderOptions options, 
                IShellOutputReceiver receiver)

Avvia la registrazione dello schermo sul dispositivo se supporta IDevice.Feature.SCREEN_RECORD.

Parametri
`remoteFilePath`	`String`
`options`	`ScreenRecorderOptions`
`receiver`	`IShellOutputReceiver`

Lanci
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

supportsFeature

public boolean supportsFeature (IDevice.HardwareFeature feature)

Indica se questo dispositivo supporta la funzionalità hardware specificata.

Parametri
`feature`	`IDevice.HardwareFeature`

Ritorni
`boolean`

supportsFeature

public boolean supportsFeature (IDevice.Feature feature)

Restituisce un valore che indica se questo dispositivo supporta la funzionalità software specificata.

Parametri
`feature`	`IDevice.Feature`

Ritorni
`boolean`

syncPackageToDevice

public String syncPackageToDevice (String localFilePath)

Esegue il push di un file sul dispositivo

Parametri
`localFilePath`	`String`: il percorso assoluto del file sull'host locale

Ritorni
`String`	`String` percorso di destinazione sul dispositivo per il file

Lanci
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

toString

public String toString ()

Ritorni
`String`

uninstallApp

public String uninstallApp (String applicationID, 
                String... extraArgs)

Disinstalla un'app dal dispositivo.

Parametri
`applicationID`	`String`: l'ID applicazione Android da disinstallare
`extraArgs`	`String`: argomenti aggiuntivi facoltativi da passare. Consulta "adb shell pm install --help" per le opzioni disponibili.

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

Lanci
`InstallException`

uninstallPackage

public String uninstallPackage (String packageName)

Disinstalla un pacchetto dal dispositivo.

Parametri
`packageName`	`String`: l'ID applicazione Android da disinstallare

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

Lanci
`InstallException`