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

Questa pagina è stata tradotta dall'API Cloud Translation.

StubDevice

public class StubDevice
extends Object implements IDevice

java.lang.Object
↳	com.android.tradefed.device.StubDevice

Sottoclassi dirette note

DeviceManager.FastbootDevice, NullDevice, RemoteAvdIDevice, StubLocalAndroidVirtualDevice, VmRemoteDevice

DeviceManager.FastbootDevice	Rappresentazione di un dispositivo in modalità Fastboot.
NullDevice	Un segnaposto `IDevice` utilizzato da `DeviceManager` per allocare quando `IDeviceSelection.nullDeviceRequested()` è `true`
RemoteAvdIDevice	Un segnaposto `IDevice` utilizzato da `DeviceManager` per allocare quando `DeviceSelectionOptions.gceDeviceRequested()` è `true`
StubLocalAndroidVirtualDevice	Un segnaposto `IDevice` utilizzato da `DeviceManager` per allocare quando `DeviceSelectionOptions.localVirtualDeviceRequested()` è `true`
VmRemoteDevice	Un dispositivo virtuale remoto che gestiremo dall'interno della macchina virtuale.

Implementazione segnaposto stub di un IDevice.

Riepilogo

Costruttori pubblici
`StubDevice(String serial)`
`StubDevice(String serial, boolean isEmulator)`

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, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` Esegue un comando shell sul dispositivo e invia il risultato a un `receiver`.
`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)` Questo metodo è obsoleto. usa `executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit)`.
`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`.
	`getAbis()` Restituisce le ABI supportate da questo dispositivo.
`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)` Questo metodo è obsoleto. utilizza invece `getBattery(long, TimeUnit)`.
`Integer`	`getBatteryLevel()` Questo metodo è obsoleto. utilizza invece `getBattery()`.
`Client`	`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
`Client[]`	`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.
`String`	`getMountPoint(String name)` Restituisce un punto di montaggio.
`String`	`getName()` Restituisce un nome (leggibile) per questo dispositivo.
	`getProperties()` Questo metodo è obsoleto. utilizza invece `getSystemProperty(String)`.
`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)` Questo metodo è obsoleto. utilizza invece `getProperty(String)`.
`int`	`getPropertyCount()` Questo metodo è obsoleto. deprecato in ddmlib con "implementation detail" (dettaglio di implementazione) come motivo.
`String`	`getPropertySync(String name)` Questo metodo è obsoleto. utilizza invece `getProperty(String)`.
`String`	`getRegion()` Restituisce la regione dell'utente.
`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( apkFilePaths, boolean reinstall, extraArgs, long timeOutInMs, TimeUnit timeunit)` 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.
`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`	`pullFile(String remote, String local)` Recupera un singolo file.
`void`	`pushFile(String local, String remote)` Esegue il push di un singolo file.
`void`	`reboot(String into)` riavvia il dispositivo.
`void`	`removeForward(int localPort)` Rimuove un port forwarding tra una porta locale e una remota.
`void`	`removeForward(int localPort, int remotePort)`
`void`	`removeForward(int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)`
`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`	`setSerial(String serial)`
`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 arg0)` 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`	`uninstallApp(String applicationID, String... extraArgs)` Disinstalla un'app dal dispositivo.
`String`	`uninstallPackage(String packageName)` Disinstalla un pacchetto dal dispositivo.

Costruttori pubblici

StubDevice

public StubDevice (String serial)

Parametri
`serial`	`String`

StubDevice

public StubDevice (String serial, 
                boolean isEmulator)

Parametri
`serial`	`String`
`isEmulator`	`boolean`

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`

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)

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)

Questo metodo è obsoleto.
utilizza executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit).

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`

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.

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)

Questo metodo è obsoleto.
utilizza invece getBattery(long, 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 sono trascorsi freshnessMs ms dall'ultima query riuscita.

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

Lanci
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getBatteryLevel

public Integer getBatteryLevel ()

Questo metodo è obsoleto.
utilizza invece 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
`Integer`	il livello della batteria o `null` se non è stato possibile recuperarlo

Lanci
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getClient

public Client getClient (String applicationName)

Restituisce un Client in base al nome dell'applicazione.

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

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

getClienti

public Client[] getClients ()

Restituisce l'array di client.

Ritorni
`Client[]`

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

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`

getProperties

public  getProperties ()

Questo metodo è obsoleto.
utilizza invece getSystemProperty(String).

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)

Questo metodo è obsoleto.
utilizza invece getProperty(String).

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

Lanci
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getPropertyCount

public int getPropertyCount ()

Questo metodo è obsoleto.
deprecato in ddmlib con "implementation detail" (dettaglio di implementazione) come motivo.

Restituisce il numero di proprietà per questo dispositivo.

Ritorni
`int`

getPropertySync

public String getPropertySync (String name)

Questo metodo è obsoleto.
utilizza invece getProperty(String).

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

Lanci
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getRegion

public String getRegion ()

Restituisce la regione dell'utente.

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

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

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

Lanci
`InstallException`

installPackages

public void installPackages ( apkFilePaths, 
                boolean reinstall, 
                 extraArgs, 
                long timeOutInMs, 
                TimeUnit timeunit)

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

Parametri
`apkFilePaths`	: 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
`extraArgs`	: argomenti aggiuntivi facoltativi da passare. Consulta "adb shell pm install --help" per le opzioni disponibili.
`timeOutInMs`	`long`: timeout di installazione
`timeunit`	`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. Consulta "adb shell pm install --help" per le opzioni disponibili.

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

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`

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`

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`

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`

removeForward

public void removeForward (int localPort, 
                int remotePort)

Parametri
`localPort`	`int`
`remotePort`	`int`

Lanci
`AdbCommandRejectedException`
`TimeoutException`

removeForward

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

Parametri
`localPort`	`int`
`remoteSocketName`	`String`
`namespace`	`IDevice.DeviceUnixSocketNamespace`

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`

setSerial

public void setSerial (String serial)

Parametri
`serial`	`String`

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

Indica se questo dispositivo supporta la funzionalità hardware specificata.

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

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`