IDevice

public interface IDevice
implements IShellEnabledDevice

com.android.ddmlib.IDevice

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

Riepilogo

Costanti

int CHANGE_BUILD_INFO

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

int CHANGE_CLIENT_LIST

Maschera di bit per la modifica del dispositivo: modifica dell'elenco Client.

int CHANGE_PROFILEABLE_CLIENT_LIST

Maschera di bit per la modifica del dispositivo: modifica dell'elenco ProfileableClient.

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 è stata ritirata. 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.

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.

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 IShellEnabledDevice.executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit).

default void forceStop(String applicationName)

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

abstract 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 getBattery(long freshnessTime, TimeUnit timeUnit)

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

abstract getBattery()

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

abstract Integer getBatteryLevel(long freshnessMs)

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

abstract Integer getBatteryLevel()

Questo metodo è obsoleto. utilizzare getBattery()

abstract Client getClient(String applicationName)

Restituisce un Client in base al nome dell'applicazione.

abstract String getClientName(int pid)

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

abstract Client[] getClients()

Restituisce l'array di client.

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

default ProfileableClient[] getProfileableClients()

Restituisce l'array di client profilabili.

abstract getProperties()

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

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

abstract String getPropertyCacheOrSync(String name)

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

abstract int getPropertyCount()

Questo metodo è obsoleto. dettaglio di implementazione

abstract String getPropertySync(String name)

Questo metodo è obsoleto. utilizzare IShellEnabledDevice.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 inviare / recuperare file da e verso il dispositivo.

abstract boolean hasClients()

Restituisce un valore che indica se IDevice ha Client.

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

Installa un'applicazione Android sul dispositivo.

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

Installa un'applicazione Android sul dispositivo.

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

Installa un'applicazione Android sul dispositivo.

default void installPackages( apks, boolean reinstall, installOptions)

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

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

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

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( remoteApks, boolean reinstall, installOptions)

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

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

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

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 supporta IDevice.Feature.SCREEN_RECORD.

abstract boolean supportsFeature(IDevice.HardwareFeature feature)

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_CLIENT_LIST

public static final int CHANGE_CLIENT_LIST

Maschera di bit per la modifica del dispositivo: modifica dell'elenco Client.

Constant Value: 2 (0x00000002)

CHANGE_PROFILEABLE_CLIENT_LIST

public static final int CHANGE_PROFILEABLE_CLIENT_LIST

Maschera di bit per la modifica del dispositivo: modifica dell'elenco ProfileableClient.

Valore costante: 8 (0x00000008)

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

Constant Value: "ANDROID_ROOT"

PROP_BUILD_API_LEVEL

public static final String PROP_BUILD_API_LEVEL

Constant Value: "ro.build.version.sdk"

PROP_BUILD_CHARACTERISTICS

public static final String PROP_BUILD_CHARACTERISTICS

Constant Value: "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

Constant Value: "ro.build.type"

PROP_BUILD_VERSION

public static final String PROP_BUILD_VERSION

Constant Value: "ro.build.version.release"

PROP_BUILD_VERSION_NUMBER

public static final String PROP_BUILD_VERSION_NUMBER

Questa costante è obsoleta.
Utilizza PROP_BUILD_API_LEVEL.

Constant Value: "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

Constant Value: "ro.product.cpu.abi2"

PROP_DEVICE_CPU_ABI_LIST

public static final String PROP_DEVICE_CPU_ABI_LIST

Constant Value: "ro.product.cpu.abilist"

PROP_DEVICE_DENSITY

public static final String PROP_DEVICE_DENSITY

Constant Value: "ro.sf.lcd_density"

PROP_DEVICE_EMULATOR_DENSITY

public static final String PROP_DEVICE_EMULATOR_DENSITY

Constant Value: "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

Constant Value: "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.

Constant Value: "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

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

executeShellCommand

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

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

Parametri
command String

receiver IShellOutputReceiver

maxTimeToOutputResponse long

maxTimeUnits TimeUnit

is InputStream

Lanci
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

executeShellCommand

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

executeShellCommand

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

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

Parametri
command String

receiver IShellOutputReceiver

maxTimeToOutputResponse int

Lanci
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

forceStop

public void forceStop (String applicationName)

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

Parametri
applicationName String: il nome dell'applicazione

getAbis

public abstract  getAbis ()

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

Ritorni
l'elenco degli ABI.

getAvdData

public ListenableFuture<AvdData> getAvdData ()

Restituisce informazioni sull'AVD in esecuzione nell'emulatore.

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

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

Ritorni
ListenableFuture<AvdData> il AvdData del dispositivo.

getAvdName

public 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 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 abstract 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 abstract  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 abstract  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 abstract Integer getBatteryLevel (long freshnessMs)

Questo metodo è obsoleto.
utilizza 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
com.android.ddmlib.ShellCommandUnresponsiveException
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

getBatteryLevel

public abstract Integer getBatteryLevel ()

Questo metodo è obsoleto.
utilizza 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 abstract 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 abstract 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 abstract Client[] getClients ()

Restituisce l'array di client.

Ritorni
Client[]

getDensity

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

Restituisce un FileListingService per questo dispositivo.

Ritorni
FileListingService

getHardwareCharacteristics

public  getHardwareCharacteristics ()

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

Ritorni

getLanguage

public abstract String getLanguage ()

Restituisce la lingua dell'utente.

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

getLastInstallMetrics

public InstallMetrics getLastInstallMetrics ()

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

Ritorni
InstallMetrics Metriche InstallMetrics che descrivono l'installazione.

getMountPoint

public abstract String getMountPoint (String name)

Restituisce un punto di montaggio.

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

getProfileableClients

public ProfileableClient[] getProfileableClients ()

Restituisce l'array di client profilabili.

Ritorni
ProfileableClient[]

getProperties

public abstract  getProperties ()

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

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

Ritorni

getProperty

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

Questo metodo è obsoleto.
utilizza invece IShellEnabledDevice.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.
Ritorni
String il valore o null se la proprietà non esiste
Lanci
TimeoutException in caso di timeout della connessione.
AdbCommandRejectedException se adb rifiuta il comando
ShellCommandUnresponsiveException nel caso in cui il comando shell non invii output per un determinato periodo di tempo.
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.

Ritorni
int

getPropertySync

public abstract String getPropertySync (String name)

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

getRegion

public abstract String getRegion ()

Restituisce la regione dell'utente.

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

getScreenshot

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

getScreenshot

public abstract RawImage getScreenshot (long timeout, 
                TimeUnit unit)

Parametri
timeout long

unit TimeUnit

Ritorni
RawImage

Lanci
AdbCommandRejectedException
TimeoutException

getSerialNumber

public abstract String getSerialNumber ()

Restituisce il numero di serie del dispositivo.

Ritorni
String

getState

public abstract IDevice.DeviceState getState ()

Restituisce lo stato del dispositivo.

Ritorni
IDevice.DeviceState

getSyncService

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

hasClients

public abstract boolean hasClients ()

Restituisce un valore che indica se IDevice ha Client.

Ritorni
boolean

installPackage

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

installPackage

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

installPackage

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

installPackages

public void installPackages ( apks, 
                boolean reinstall, 
                 installOptions)

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

Parametri
apks : elenco di APK da installare (1 APK principale + 0..n APK suddivisi)
reinstall boolean: imposta su true se deve essere eseguita la reinstallazione dell'app
installOptions : argomenti aggiuntivi facoltativi da passare. Consulta "adb shell pm install --help" per le opzioni disponibili.
Lanci
InstallException se l'installazione non va a buon fine.

installPackages

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

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

Parametri
apks : elenco di APK da installare (1 APK principale + 0..n APK suddivisi)
reinstall boolean: imposta su true se deve essere eseguita la reinstallazione dell'app
installOptions : argomenti aggiuntivi facoltativi da passare. Consulta "adb shell pm install --help" per le opzioni disponibili.
timeout long: timeout di installazione
timeoutUnit TimeUnit: ERROR(/TimeUnit) corrispondente al parametro di timeout
Lanci
InstallException 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.
Lanci
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.
Lanci
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'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 se l'installazione non va a buon fine.

installRemotePackages

public void installRemotePackages ( remoteApks, 
                boolean reinstall, 
                 installOptions)

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

Parametri
remoteApks : elenco dei percorsi dei file APK sul dispositivo da installare
reinstall boolean: imposta su true se deve essere eseguita la reinstallazione dell'app
installOptions : argomenti aggiuntivi facoltativi da passare. Consulta "adb shell pm install --help" per le opzioni disponibili.
Lanci
InstallException se l'installazione non va a buon fine.

installRemotePackages

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

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

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

isBootLoader

public abstract boolean isBootLoader ()

Indica se il dispositivo è in modalità bootloader.

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

isEmulator

public abstract boolean isEmulator ()

Restituisce true se il dispositivo è un emulatore.

Ritorni
boolean

isOffline

public abstract boolean isOffline ()

Indica se il dispositivo è offline.

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

isOnline

public abstract boolean isOnline ()

Indica se il dispositivo è pronto.

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

isRoot

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

uccidere

public void kill (String applicationName)

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

Parametri
applicationName String: il nome dell'applicazione

pullFile

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

push

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

Esegue il push di più file o directory.

Parametri
local String: i file locali da trasferire
remote String: il percorso remoto che rappresenta una directory
Lanci
in caso di errore I/O sulla connessione
AdbCommandRejectedException se adb rifiuta il comando
TimeoutException in caso di timeout durante la lettura delle risposte dal dispositivo
SyncException se alcuni file non sono stati caricati

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
Lanci
in caso di errore I/O sulla connessione
AdbCommandRejectedException se adb rifiuta il comando
TimeoutException in caso di timeout durante la lettura delle risposte dal dispositivo
SyncException se non è stato possibile eseguire il push del file

rawBinder

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

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

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

Parametri
service String: il nome del servizio Android a cui connettersi
parameters String: i parametri del comando binder
Ritorni
SocketChannel Un SocketChannel connesso al processo di esecuzione sul dispositivo. dopo l'uso.
Lanci
AdbCommandRejectedException
TimeoutException

rawExec

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

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

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

Parametri
executable String

parameters String

Ritorni
SocketChannel Un SocketChannel connesso al processo di esecuzione sul dispositivo. dopo l'uso.
Lanci
AdbCommandRejectedException
TimeoutException

fai ripartire

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

Lanci
AdbCommandRejectedException
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

Lanci
AdbCommandRejectedException
TimeoutException

removeRemotePackage

public abstract void removeRemotePackage (String remoteFilePath)

Rimuove un file dal dispositivo.

Parametri
remoteFilePath String: percorso sul dispositivo del file da rimuovere
Lanci
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.
Lanci
TimeoutException in caso di timeout della connessione.
AdbCommandRejectedException se adb rifiuta il comando
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 ulteriori informazioni, vedi "adb root".

Ritorni
boolean true se il daemon adb è in esecuzione come root, altrimenti false.
Lanci
TimeoutException in caso di timeout della connessione.
AdbCommandRejectedException se adb rifiuta il comando.
ShellCommandUnresponsiveException se non è possibile eseguire query sullo stato della radice.
IOException

startScreenRecorder

public abstract 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 abstract boolean supportsFeature (IDevice.HardwareFeature feature)

Indica se questo dispositivo supporta la funzionalità hardware specificata.

Parametri
feature IDevice.HardwareFeature

Ritorni
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

Ritorni
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
Ritorni
String String percorso di destinazione sul dispositivo per il file
Lanci
TimeoutException in caso di timeout della connessione.
AdbCommandRejectedException se adb rifiuta il comando
in caso di errore I/O sulla connessione.
SyncException se si verifica un errore durante il push del pacchetto sul dispositivo.

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.
Ritorni
String un String con un codice di errore o null in caso di esito positivo.
Lanci
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
Ritorni
String un String con un codice di errore o null in caso di esito positivo.
Lanci
InstallException se la disinstallazione non va a buon fine.