A partire dal 2026, per allinearci al nostro modello di sviluppo trunk stabile e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per compilare e contribuire ad AOSP, utilizza android-latest-release. Il branch del manifest android-latest-release farà sempre riferimento alla release più recente pubblicata su AOSP. Per saperne di più, consulta la sezione Modifiche ad AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

DeviceImpl

public final class DeviceImpl
extends Object implements IDevice

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

Un dispositivo. Può essere un dispositivo fisico o un emulatore.

Riepilogo

Costruttori pubblici
`DeviceImpl(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`	`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`	`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, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` Esegue un comando shell sul dispositivo e invia il risultato a un `receiver`.
`void`	`forceStop(String applicationName)` Forza l'interruzione di un'applicazione in base al nome.
`List<String>`	`getAbis()` Restituisce le ABI supportate da questo dispositivo.
`ListenableFuture<AvdData>`	`getAvdData()` Restituisce informazioni sull'AVD in esecuzione nell'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.
`Future<Integer>`	`getBattery(long freshnessTime, TimeUnit timeUnit)` Restituisce il livello batteria del dispositivo, da 0 a 100%.
`Future<Integer>`	`getBattery()` Restituisce il livello batteria del dispositivo, da 0 a 100%.
`Integer`	`getBatteryLevel(long freshnessMs)` Restituisce il livello batteria del dispositivo, da 0 a 100%.
`Integer`	`getBatteryLevel()` Restituisce il livello batteria del dispositivo, da 0 a 100%.
`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 (più comprensibile) per questo dispositivo.
`Map<String, String>`	`getProperties()` Restituisce le proprietà del dispositivo memorizzate nella cache.
`String`	`getProperty(String name)` Metodo pratico che tenta di recuperare una proprietà tramite `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 trasferire file da e verso il dispositivo.
`ListenableFuture<String>`	`getSystemProperty(String name)` Esegui una potenziale query asincrona per una proprietà di sistema.
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` Installa un'app per Android sul dispositivo.
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)` Installa un'app per Android sul dispositivo.
`void`	`installPackage(String packageFilePath, boolean reinstall, String... extraArgs)` Installa un'app per Android sul dispositivo.
`void`	`installPackages(List<File> apks, boolean reinstall, List<String> installOptions, long timeout, TimeUnit timeoutUnit)` Installa un'app per Android composta da più file APK (uno principale e 0-n pacchetti suddivisi)
`void`	`installPackages(List<File> apks, boolean reinstall, List<String> installOptions)` Installa un'app per Android composta da diversi file APK (uno principale e 0..n pacchetti suddivisi) con timeout predefinito
`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(List<String> remoteApks, boolean reinstall, List<String> installOptions, long timeout, TimeUnit timeoutUnit)` Installa un'app per Android composta da diversi file APK presenti localmente sul dispositivo
`void`	`installRemotePackages(List<String> remoteApks, boolean reinstall, List<String> installOptions)` Installa un'app per Android composta da diversi file APK presenti localmente sul dispositivo con timeout predefinito
`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 questo supporta `Feature.SCREEN_RECORD`.
`boolean`	`supportsFeature(IDevice.HardwareFeature feature)` Restituisce un valore che 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 (String serialNumber, 
                IDevice.DeviceState deviceState)

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

Metodi pubblici

arePropertiesSet

public boolean arePropertiesSet ()

Restituisce true se le proprietà sono state memorizzate nella cache

Resi
`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`: il 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

Genera
`AdbCommandRejectedException`
`IOException`
`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.

Genera
`AdbCommandRejectedException`
`IOException`
`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

Genera
`AdbCommandRejectedException`
`IOException`
`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

Genera
`AdbCommandRejectedException`
`IOException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

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

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

Genera
`AdbCommandRejectedException`
`IOException`
`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.

maxTimeToOutputResponse viene utilizzato come tempo di attesa massimo quando si prevede l'output 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
`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 errore.
`maxTimeUnits`	`TimeUnit`: unità per i valori non nulli di `maxTimeout` e `maxTimeToOutputResponse`.

Genera
`AdbCommandRejectedException`
`IOException`
`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`

Genera
`AdbCommandRejectedException`
`IOException`
`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.

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 errore.
`maxTimeUnits`	`TimeUnit`: unità per i valori `maxTimeToOutputResponse` diversi da zero.

Genera
`AdbCommandRejectedException`
`IOException`
`ShellCommandUnresponsiveException`
`TimeoutException`

forceStop

public void forceStop (String applicationName)

Forza l'interruzione 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 List<String> 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.

Resi
`List<String>`	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

Resi
`ListenableFuture<AvdData>`	`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 di origine Android), questo metodo restituirà "<build>".

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

Resi
`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.

Resi
`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 Future<Integer> getBattery (long freshnessTime, 
                TimeUnit timeUnit)

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

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

Parametri
`freshnessTime`	`long`: la recentezza desiderata del livello batteria
`timeUnit`	`TimeUnit`: il `TimeUnit` di freshnessTime

Resi
`Future<Integer>`	un `Future` che può essere utilizzato per interrogare il livello batteria. Future restituirà un `ExecutionException` se non è stato possibile recuperare il livello batteria.

getBattery

public Future<Integer> getBattery ()

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

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

Resi
`Future<Integer>`	un `Future` che può essere utilizzato per interrogare il livello batteria. Future restituirà un `ExecutionException` se non è stato possibile recuperare il livello batteria.

getBatteryLevel

public Integer getBatteryLevel (long freshnessMs)

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

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

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

getBatteryLevel

public Integer getBatteryLevel ()

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

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

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

getDensity

public int getDensity ()

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

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

getFileListingService

public FileListingService getFileListingService ()

Restituisce un FileListingService per questo dispositivo.

Resi
`FileListingService`

getLanguage

public String getLanguage ()

Restituisce la lingua dell'utente.

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

getLastInstallMetrics

public InstallMetrics getLastInstallMetrics ()

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

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

Resi
`String`

getName

public String getName ()

Restituisce un nome (più comprensibile) 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.

Resi
`String`

getProperties

public Map<String, String> getProperties ()

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

Resi
`Map<String, String>`

getProperty

public String getProperty (String name)

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

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

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

Resi
`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.

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

getPropertyCount

public int getPropertyCount ()

Restituisce il numero di proprietà per questo dispositivo.

Resi
`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.

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

getRegion

public String getRegion ()

Restituisce la regione dell'utente.

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

getScreenRecorderCommand

public static String getScreenRecorderCommand (String remoteFilePath, 
                ScreenRecorderOptions options)

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

Resi
`String`

getScreenshot

public RawImage getScreenshot ()

Acquisisce uno screenshot del dispositivo e lo restituisce come RawImage.

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

Genera
`AdbCommandRejectedException`
`IOException`
`TimeoutException`

getScreenshot

public RawImage getScreenshot (long timeout, 
                TimeUnit unit)

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

Resi
`RawImage`

Genera
`AdbCommandRejectedException`
`IOException`
`TimeoutException`

getSerialNumber

public String getSerialNumber ()

Restituisce il numero di serie del dispositivo.

Resi
`String`

getState

public IDevice.DeviceState getState ()

Restituisce lo stato del dispositivo.

Resi
`IDevice.DeviceState`

getSyncService

public SyncService getSyncService ()

Restituisce un oggetto SyncService per trasferire file da e verso il dispositivo.

Resi
`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).

Genera
`AdbCommandRejectedException`
`IOException`
`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.

Resi
`ListenableFuture<String>`	un `ListenableFuture.` `get` potrebbe restituire null.

installPackage

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

Installa un'app per 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.

Genera
`InstallException`

installPackage

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

Installa un'app per 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 errore.
`maxTimeUnits`	`TimeUnit`: unità per i valori non nulli di `maxTimeout` e `maxTimeToOutputResponse`.
`extraArgs`	`String`: argomenti aggiuntivi facoltativi da passare. Consulta "adb shell pm install --help" per le opzioni disponibili.

Genera
`InstallException`

installPackage

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

Installa un'app per 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. Consulta "adb shell pm install --help" per le opzioni disponibili.

Genera
`InstallException`

installPackages

public void installPackages (List<File> apks, 
                boolean reinstall, 
                List<String> installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

Installa un'app per Android composta da più file APK (uno principale e 0-n pacchetti suddivisi)

Parametri
`apks`	`List`: 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`	`List`: argomenti aggiuntivi facoltativi da passare. Consulta "adb shell pm install --help" per le opzioni disponibili.
`timeout`	`long`: timeout di installazione
`timeoutUnit`	`TimeUnit`: `TimeUnit` corrispondente al parametro di timeout

Genera
`InstallException`

installPackages

public void installPackages (List<File> apks, 
                boolean reinstall, 
                List<String> installOptions)

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

Parametri
`apks`	`List`: 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`	`List`: argomenti aggiuntivi facoltativi da passare. Consulta "adb shell pm install --help" per le opzioni disponibili.

Genera
`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 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.

Genera
`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 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. Consulta "adb shell pm install --help" per le opzioni disponibili.

Genera
`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 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 errore.
`maxTimeUnits`	`TimeUnit`: unità per i valori non nulli di `maxTimeout` e `maxTimeToOutputResponse`.
`extraArgs`	`String`: argomenti aggiuntivi facoltativi da passare. Consulta "adb shell pm install --help" per le opzioni disponibili.

Genera
`InstallException`

installRemotePackages

public void installRemotePackages (List<String> remoteApks, 
                boolean reinstall, 
                List<String> installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

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

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

Genera
`InstallException`

installRemotePackages

public void installRemotePackages (List<String> remoteApks, 
                boolean reinstall, 
                List<String> installOptions)

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

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

Genera
`InstallException`

isBootLoader

public boolean isBootLoader ()

Indica se il dispositivo è in modalità bootloader.

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

isEmulator

public boolean isEmulator ()

Restituisce true se il dispositivo è un emulatore.

Resi
`boolean`

isOffline

public boolean isOffline ()

Indica se il dispositivo è offline.

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

isOnline

public boolean isOnline ()

Indica se il dispositivo è pronto.

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

isRoot

public boolean isRoot ()

Esegue una query sullo stato di root attuale del dispositivo. Per saperne di più, consulta la sezione "adb root".

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

Genera
`AdbCommandRejectedException`
`IOException`
`ShellCommandUnresponsiveException`
`TimeoutException`

kill

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.

Genera
`AdbCommandRejectedException`
`IOException`
`SyncException`
`TimeoutException`

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

Genera
`AdbCommandRejectedException`
`IOException`
`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

Genera
`AdbCommandRejectedException`
`IOException`
`SyncException`
`TimeoutException`

rawBinder

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

Richiama il servizio Android Binder Bridge su un dispositivo remoto. Restituisce un canale socket collegato al comando di associazione 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 del raccoglitore

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

Genera
`AdbCommandRejectedException`
`IOException`
`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 qualsiasi cosa venga letta dal socket può provenire da uno dei due output ed essere intercalata.

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

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

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

Genera
`AdbCommandRejectedException`
`IOException`
`TimeoutException`

riavvio

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.

Genera
`AdbCommandRejectedException`
`IOException`
`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

Genera
`AdbCommandRejectedException`
`IOException`
`TimeoutException`

removeRemotePackage

public void removeRemotePackage (String remoteFilePath)

Rimuove un file dal dispositivo.

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

Genera
`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.

Genera
`AdbCommandRejectedException`
`IOException`
`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 saperne di più, consulta la sezione "adb root".

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

Genera
`AdbCommandRejectedException`
`IOException`
`ShellCommandUnresponsiveException`
`TimeoutException`

startScreenRecorder

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

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

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

Genera
`AdbCommandRejectedException`
`IOException`
`ShellCommandUnresponsiveException`
`TimeoutException`

supportsFeature

public boolean supportsFeature (IDevice.HardwareFeature feature)

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

Parametri
`feature`	`IDevice.HardwareFeature`

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

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

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

Genera
`AdbCommandRejectedException`
`IOException`
`SyncException`
`TimeoutException`

toString

public String toString ()

Resi
`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.

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

Genera
`InstallException`

uninstallPackage

public String uninstallPackage (String packageName)

Disinstalla un pacchetto dal dispositivo.

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

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

Genera
`InstallException`