IDevice

public interface IDevice
implements IShellEnabledDevice

com.android.ddmlib.IDevice

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

Riepilogo

Costanti

int CHANGE_BUILD_INFO

Maschera di bit per la modifica del dispositivo: modifica delle informazioni sulla build.

int CHANGE_STATE

Maschera di bit di modifica del dispositivo: modifica DeviceState.

String FIRST_EMULATOR_SN

Numero di serie del primo emulatore connesso.

String MNT_DATA

String MNT_EXTERNAL_STORAGE

String MNT_ROOT

String PROP_BUILD_API_LEVEL

String PROP_BUILD_CHARACTERISTICS

String PROP_BUILD_CODENAME

String PROP_BUILD_TAGS

String PROP_BUILD_TYPE

String PROP_BUILD_VERSION

String PROP_BUILD_VERSION_NUMBER

Questa costante è deprecata. Usa PROP_BUILD_API_LEVEL.

String PROP_DEBUGGABLE

String PROP_DEVICE_CPU_ABI

String PROP_DEVICE_CPU_ABI2

String PROP_DEVICE_CPU_ABI_LIST

String PROP_DEVICE_DENSITY

String PROP_DEVICE_EMULATOR_DENSITY

String PROP_DEVICE_LANGUAGE

String PROP_DEVICE_MANUFACTURER

String PROP_DEVICE_MODEL

String PROP_DEVICE_REGION

String RE_EMULATOR_SN

Espressione regolare del numero di serie dell'emulatore.

String UNKNOWN_PACKAGE

Metodi pubblici

abstract boolean arePropertiesSet()

Restituisce true se le proprietà sono state memorizzate nella cache

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

abstract void createForward(int localPort, int remotePort)

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

default void createReverse(int remotePort, int localPort)

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

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

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

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

Questo metodo è obsoleto. Usa executeShellCommand(String,IShellOutputReceiver,long,TimeUnit).

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

default void forceStop(String applicationName)

Forza l'interruzione di un'applicazione in base al nome.

abstract List<String> getAbis()

Restituisce le ABI supportate da questo dispositivo.

default ListenableFuture<AvdData> getAvdData()

Restituisce informazioni sull'AVD in esecuzione nell'emulatore.

abstract String getAvdName()

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

abstract String getAvdPath()

Restituisce il percorso assoluto del dispositivo virtuale nel file system.

abstract Future<Integer> getBattery(long freshnessTime, TimeUnit timeUnit)

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

abstract Future<Integer> getBattery()

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

abstract Integer getBatteryLevel(long freshnessMs)

Questo metodo è obsoleto. utilizzare getBattery(long,TimeUnit)

abstract Integer getBatteryLevel()

Questo metodo è obsoleto. utilizzare getBattery()

abstract int getDensity()

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

abstract FileListingService getFileListingService()

Restituisce un FileListingService per questo dispositivo.

default Set<String> getHardwareCharacteristics()

Restituisce le funzionalità ottenute leggendo la proprietà delle caratteristiche della build.

abstract String getLanguage()

Restituisce la lingua dell'utente.

default InstallMetrics getLastInstallMetrics()

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

abstract String getMountPoint(String name)

Restituisce un punto di montaggio.

abstract Map<String, String> getProperties()

Questo metodo è obsoleto. utilizza invece getSystemProperty(String)

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

abstract String getPropertyCacheOrSync(String name)

Questo metodo è obsoleto. utilizza invece getSystemProperty(String)

abstract int getPropertyCount()

Questo metodo è obsoleto. dettaglio di implementazione

abstract String getPropertySync(String name)

Questo metodo è obsoleto. utilizzare getSystemProperty(String)

abstract String getRegion()

Restituisce la regione dell'utente.

abstract RawImage getScreenshot()

Acquisisce uno screenshot del dispositivo e lo restituisce come RawImage.

abstract RawImage getScreenshot(long timeout, TimeUnit unit)
abstract String getSerialNumber()

Restituisce il numero di serie del dispositivo.

abstract IDevice.DeviceState getState()

Restituisce lo stato del dispositivo.

abstract SyncService getSyncService()

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

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

Installa un'app per Android sul dispositivo.

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

Installa un'app per Android sul dispositivo.

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

Installa un'app per Android sul dispositivo.

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

default 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

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

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

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

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

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

default 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

default 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

abstract boolean isBootLoader()

Indica se il dispositivo è in modalità bootloader.

abstract boolean isEmulator()

Restituisce true se il dispositivo è un emulatore.

abstract boolean isOffline()

Indica se il dispositivo è offline.

abstract boolean isOnline()

Indica se il dispositivo è pronto.

abstract boolean isRoot()

Esegue una query sullo stato di root attuale del dispositivo.

default void kill(String applicationName)

Termina un'applicazione in base al nome.

abstract void pullFile(String remote, String local)

Recupera un singolo file.

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

Esegue il push di più file o directory.

abstract void pushFile(String local, String remote)

Esegue il push di un singolo file.

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

Richiama il servizio Android Binder Bridge su un dispositivo remoto.

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

Richiama il servizio host:exec su un dispositivo remoto.

abstract void reboot(String into)

Riavvia il dispositivo.

default void removeForward(int localPort)

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

default void removeForward(int localPort, int remotePort)

Questo metodo è obsoleto. Usa removeForward(int)

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

Questo metodo è obsoleto. Usa removeForward(int)

abstract void removeRemotePackage(String remoteFilePath)

Rimuove un file dal dispositivo.

default void removeReverse(int remotePort)

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

abstract boolean root()

Chiedi al daemon adb di diventare root sul dispositivo.

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

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

abstract boolean supportsFeature(IDevice.HardwareFeature feature)

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

abstract boolean supportsFeature(IDevice.Feature feature)

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

abstract String syncPackageToDevice(String localFilePath)

Esegue il push di un file sul dispositivo

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

Disinstalla un'app dal dispositivo.

abstract String uninstallPackage(String packageName)

Disinstalla un pacchetto dal dispositivo.

Costanti

CHANGE_BUILD_INFO

public static final int CHANGE_BUILD_INFO

Maschera di bit per la modifica del dispositivo: modifica delle informazioni sulla build.

Valore costante: 4 (0x00000004)

CHANGE_STATE

public static final int CHANGE_STATE

Maschera di bit di modifica del dispositivo: modifica DeviceState.

Constant Value: 1 (0x00000001)

FIRST_EMULATOR_SN

public static final String FIRST_EMULATOR_SN

Numero di serie del primo emulatore connesso.

Valore costante: "emulator-5554"

MNT_DATA

public static final String MNT_DATA

Valore costante: "ANDROID_DATA"

MNT_EXTERNAL_STORAGE

public static final String MNT_EXTERNAL_STORAGE

Valore costante: "EXTERNAL_STORAGE"

MNT_ROOT

public static final String MNT_ROOT

Valore costante: "ANDROID_ROOT"

PROP_BUILD_API_LEVEL

public static final String PROP_BUILD_API_LEVEL

Valore costante: "ro.build.version.sdk"

PROP_BUILD_CHARACTERISTICS

public static final String PROP_BUILD_CHARACTERISTICS

Valore costante: "ro.build.characteristics"

PROP_BUILD_CODENAME

public static final String PROP_BUILD_CODENAME

Valore costante: "ro.build.version.codename"

PROP_BUILD_TAGS

public static final String PROP_BUILD_TAGS

Valore costante: "ro.build.tags"

PROP_BUILD_TYPE

public static final String PROP_BUILD_TYPE

Valore costante: "ro.build.type"

PROP_BUILD_VERSION

public static final String PROP_BUILD_VERSION

Valore costante: "ro.build.version.release"

PROP_BUILD_VERSION_NUMBER

public static final String PROP_BUILD_VERSION_NUMBER

Questa costante è obsoleta.
Utilizza PROP_BUILD_API_LEVEL.

Valore costante: "ro.build.version.sdk"

PROP_DEBUGGABLE

public static final String PROP_DEBUGGABLE

Valore costante: "ro.debuggable"

PROP_DEVICE_CPU_ABI

public static final String PROP_DEVICE_CPU_ABI

Valore costante: "ro.product.cpu.abi"

PROP_DEVICE_CPU_ABI2

public static final String PROP_DEVICE_CPU_ABI2

Valore costante: "ro.product.cpu.abi2"

PROP_DEVICE_CPU_ABI_LIST

public static final String PROP_DEVICE_CPU_ABI_LIST

Valore costante: "ro.product.cpu.abilist"

PROP_DEVICE_DENSITY

public static final String PROP_DEVICE_DENSITY

Valore costante: "ro.sf.lcd_density"

PROP_DEVICE_EMULATOR_DENSITY

public static final String PROP_DEVICE_EMULATOR_DENSITY

Valore costante: "qemu.sf.lcd_density"

PROP_DEVICE_LANGUAGE

public static final String PROP_DEVICE_LANGUAGE

Valore costante: "persist.sys.language"

PROP_DEVICE_MANUFACTURER

public static final String PROP_DEVICE_MANUFACTURER

Valore costante: "ro.product.manufacturer"

PROP_DEVICE_MODEL

public static final String PROP_DEVICE_MODEL

Valore costante: "ro.product.model"

PROP_DEVICE_REGION

public static final String PROP_DEVICE_REGION

Valore costante: "persist.sys.country"

RE_EMULATOR_SN

public static final String RE_EMULATOR_SN

Espressione regolare del numero di serie dell'emulatore.

Valore costante: "emulator-(\d+)"

UNKNOWN_PACKAGE

public static final String UNKNOWN_PACKAGE

Valore costante: ""

Metodi pubblici

arePropertiesSet

public abstract boolean arePropertiesSet ()

Restituisce true se le proprietà sono state memorizzate nella cache

Resi
boolean

createForward

public abstract 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 se adb rifiuta il comando
TimeoutException in caso di timeout della connessione.
IOException in caso di errore I/O sulla connessione.

createForward

public abstract 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 se adb rifiuta il comando
TimeoutException in caso di timeout della connessione.
IOException in caso di errore I/O sulla connessione.

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 se adb rifiuta il comando
TimeoutException in caso di timeout della connessione.
IOException in caso di errore I/O sulla connessione.

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: (facoltativo) flusso di input da inviare tramite stdin
Genera
AdbCommandRejectedException se adb rifiuta il comando
ShellCommandUnresponsiveException nel caso in cui il comando binder non invii output per un determinato periodo di tempo.
TimeoutException in caso di timeout della connessione.
IOException in caso di errore I/O sulla connessione.

executeShellCommand

public abstract 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 se adb rifiuta il comando
ShellCommandUnresponsiveException nel caso in cui il comando shell non invii output per un determinato periodo di tempo.
TimeoutException in caso di timeout della connessione.
IOException in caso di errore I/O sulla connessione.

executeShellCommand

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

Questo metodo è obsoleto.
Utilizza executeShellCommand(String,IShellOutputReceiver,long,TimeUnit).

Parametri
command String

receiver IShellOutputReceiver

maxTimeToOutputResponse int

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

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 abstract 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 è presente.

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 abstract 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 abstract String getAvdPath ()

Restituisce il percorso assoluto del dispositivo virtuale nel file system. Il percorso dipende dal sistema operativo; avrà separatori / su Linux e \ 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 abstract 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 abstract 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 abstract Integer getBatteryLevel (long freshnessMs)

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

Resi
Integer il livello batteria o null se non è stato possibile recuperarlo
Genera
com.android.ddmlib.ShellCommandUnresponsiveException
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

getBatteryLevel

public abstract Integer getBatteryLevel ()

Questo metodo è obsoleto.
utilizza 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
Integer il livello batteria o null se non è stato possibile recuperarlo
Genera
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

getDensity

public abstract 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 abstract FileListingService getFileListingService ()

Restituisce un FileListingService per questo dispositivo.

Resi
FileListingService

getHardwareCharacteristics

public Set<String> getHardwareCharacteristics ()

Restituisce le funzionalità ottenute leggendo la proprietà delle caratteristiche della build.

Resi
Set<String>

Genera
Exception

getLanguage

public abstract 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 abstract String getMountPoint (String name)

Restituisce un punto di montaggio.

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

getProperties

public abstract Map<String, String> getProperties ()

Questo metodo è obsoleto.
utilizza invece getSystemProperty(String)

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

Resi
Map<String, String>

getProperty

public abstract 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 abstract String getPropertyCacheOrSync (String name)

Questo metodo è obsoleto.
utilizza invece getSystemProperty(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.
Resi
String il valore o null se la proprietà non esiste
Genera
AdbCommandRejectedException se adb rifiuta il comando
ShellCommandUnresponsiveException nel caso in cui il comando shell non invii output per un determinato periodo di tempo.
TimeoutException in caso di timeout della connessione.
IOException in caso di errore I/O sulla connessione.

getPropertyCount

public abstract int getPropertyCount ()

Questo metodo è obsoleto.
dettaglio di implementazione

Restituisce il numero di proprietà per questo dispositivo.

Resi
int

getPropertySync

public abstract String getPropertySync (String name)

Questo metodo è obsoleto.
utilizza getSystemProperty(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.
Resi
String il valore o null se la proprietà non esiste
Genera
AdbCommandRejectedException se adb rifiuta il comando
ShellCommandUnresponsiveException nel caso in cui il comando shell non invii output per un determinato periodo di tempo.
TimeoutException in caso di timeout della connessione.
IOException in caso di errore I/O sulla connessione.

getRegion

public abstract String getRegion ()

Restituisce la regione dell'utente.

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

getScreenshot

public abstract 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 se adb rifiuta il comando
TimeoutException in caso di timeout della connessione.
IOException in caso di errore I/O sulla connessione.

getScreenshot

public abstract RawImage getScreenshot (long timeout, 
                TimeUnit unit)

Parametri
timeout long

unit TimeUnit

Resi
RawImage

Genera
AdbCommandRejectedException
IOException
TimeoutException

getSerialNumber

public abstract String getSerialNumber ()

Restituisce il numero di serie del dispositivo.

Resi
String

getState

public abstract IDevice.DeviceState getState ()

Restituisce lo stato del dispositivo.

Resi
IDevice.DeviceState

getSyncService

public abstract 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 se adb rifiuta il comando
TimeoutException in caso di timeout della connessione.
IOException se la connessione con adb non è riuscita.

installPackage

public abstract 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 se l'installazione non va a buon fine.

installPackage

public abstract 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 se l'installazione non va a buon fine.

installPackage

public abstract 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 se l'installazione non va a buon fine.

installPackages

public abstract 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 se l'installazione non va a buon fine.

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 se l'installazione non va a buon fine.

installRemotePackage

public abstract 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.
Genera
InstallException se l'installazione non va a buon fine.

installRemotePackage

public abstract 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.
Genera
InstallException se l'installazione non va a buon fine.

installRemotePackage

public abstract 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 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 se l'installazione non va a buon fine.

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 se l'installazione non va a buon fine.

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 se l'installazione non va a buon fine.

isBootLoader

public abstract boolean isBootLoader ()

Indica se il dispositivo è in modalità bootloader.

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

isEmulator

public abstract boolean isEmulator ()

Restituisce true se il dispositivo è un emulatore.

Resi
boolean

isOffline

public abstract boolean isOffline ()

Indica se il dispositivo è offline.

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

isOnline

public abstract boolean isOnline ()

Indica se il dispositivo è pronto.

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

isRoot

public abstract 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 se adb rifiuta il comando.
TimeoutException in caso di timeout della connessione.
IOException
ShellCommandUnresponsiveException

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 abstract 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 se adb rifiuta il comando
SyncException in caso di eccezione di sincronizzazione.
TimeoutException in caso di timeout durante la lettura delle risposte dal dispositivo.
IOException in caso di eccezione di I/O.

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 se adb rifiuta il comando
SyncException se alcuni file non sono stati caricati
TimeoutException in caso di timeout durante la lettura delle risposte dal dispositivo
IOException in caso di errore I/O sulla connessione

pushFile

public abstract 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 se adb rifiuta il comando
SyncException se il file non è stato inviato
TimeoutException in caso di timeout durante la lettura delle risposte dal dispositivo
IOException in caso di errore I/O sulla connessione

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 abstract 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 se adb rifiuta il comando
TimeoutException in caso di timeout della connessione.
java.io.IOException
IOException

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 se adb rifiuta il comando
TimeoutException in caso di timeout della connessione.
IOException in caso di errore I/O sulla connessione.

removeForward

public void removeForward (int localPort, 
                int remotePort)

Questo metodo è obsoleto.
Utilizza removeForward(int)

Parametri
localPort int

remotePort int

Genera
AdbCommandRejectedException
IOException
TimeoutException

removeForward

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

Questo metodo è obsoleto.
Utilizza removeForward(int)

Parametri
localPort int

remoteSocketName String

namespace IDevice.DeviceUnixSocketNamespace

Genera
AdbCommandRejectedException
IOException
TimeoutException

removeRemotePackage

public abstract void removeRemotePackage (String remoteFilePath)

Rimuove un file dal dispositivo.

Parametri
remoteFilePath String: il percorso sul dispositivo del file da rimuovere
Genera
InstallException se l'installazione non va a buon fine.

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 se adb rifiuta il comando
TimeoutException in caso di timeout della connessione.
IOException in caso di errore I/O sulla connessione.

root

public abstract 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 se adb rifiuta il comando.
ShellCommandUnresponsiveException se non è possibile eseguire query sullo stato della radice.
TimeoutException in caso di timeout della connessione.
java.io.IOException
IOException

startScreenRecorder

public abstract 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 abstract 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 abstract 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 abstract 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 se adb rifiuta il comando
SyncException se si verifica un errore durante il push del pacchetto sul dispositivo.
TimeoutException in caso di timeout della connessione.
IOException in caso di errore I/O sulla connessione.

uninstallApp

public abstract 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 se la disinstallazione non va a buon fine.

uninstallPackage

public abstract 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 se la disinstallazione non va a buon fine.