IDevice

public interface IDevice
implements IShellEnabledDevice

com.android.ddmlib.IDevice


Un appareil. Il peut s'agir d'un appareil physique ou d'un émulateur.

Résumé

Constantes

int CHANGE_BUILD_INFO

Masque de bits de modification de l'appareil : modification des informations de compilation.

int CHANGE_CLIENT_LIST

Masque de bits de modification de l'appareil : modification de la liste Client.

int CHANGE_PROFILEABLE_CLIENT_LIST

Masque de bits de modification de l'appareil : modification de la liste ProfileableClient.

int CHANGE_STATE

Masque de bits de modification de l'appareil : DeviceState modification.

String FIRST_EMULATOR_SN

Numéro de série du premier émulateur connecté.

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

Cette constante est obsolète. Utilisez 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

Expression régulière du numéro de série de l'émulateur.

String UNKNOWN_PACKAGE

Méthodes publiques

abstract boolean arePropertiesSet()

Renvoie true si les propriétés ont été mises en cache.

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

Crée un transfert de port entre un port TCP local et un socket de domaine Unix distant.

abstract void createForward(int localPort, int remotePort)

Crée un transfert de port entre un port local et un port distant.

default void createReverse(int remotePort, int localPort)

Crée une inversion de port entre un port distant et un port local.

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

Exécute une commande Binder sur l'appareil et envoie le résultat à un receiver

Cette méthode utilise l'appel exec:cmd ou abb_exec: plus rapide si l'OS de l'appareil et le serveur ADB hôte sont compatibles avec la fonctionnalité d'exécution Android Binder Bridge.

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

Version de la commande executeShell qui peut accepter un flux d'entrée à envoyer via stdin.

abstract void executeShellCommand(String command, IShellOutputReceiver receiver)

Exécute une commande shell sur l'appareil et envoie le résultat à un receiver.

Cela revient à appeler executeShellCommand(command, receiver, DdmPreferences.getTimeOut()).

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

Cette méthode est obsolète. Utilisez IShellEnabledDevice.executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit).

default void forceStop(String applicationName)

Forcez l'arrêt d'une application en indiquant son nom.

abstract getAbis()

Renvoie les ABI compatibles avec cet appareil.

default ListenableFuture<AvdData> getAvdData()

Renvoie des informations sur l'AVD sur lequel l'émulateur s'exécute.

abstract String getAvdName()

Renvoie le nom de l'AVD sur lequel l'émulateur est exécuté.

abstract String getAvdPath()

Renvoie le chemin d'accès absolu à l'appareil virtuel dans le système de fichiers.

abstract getBattery(long freshnessTime, TimeUnit timeUnit)

Renvoie le niveau de batterie de l'appareil, de 0 à 100 %.

abstract getBattery()

Renvoie le niveau de batterie de l'appareil, de 0 à 100 %.

abstract Integer getBatteryLevel(long freshnessMs)

Cette méthode est obsolète. utiliser getBattery(long, TimeUnit)

abstract Integer getBatteryLevel()

Cette méthode est obsolète. utiliser getBattery()

abstract Client getClient(String applicationName)

Renvoie un Client par son nom d'application.

abstract String getClientName(int pid)

Renvoie le nom du client par PID ou null si le PID est inconnu.

abstract Client[] getClients()

Renvoie le tableau des clients.

abstract int getDensity()

Renvoie le bucket de densité de l'écran de l'appareil en lisant la valeur de la propriété système PROP_DEVICE_DENSITY.

abstract FileListingService getFileListingService()

Renvoie un FileListingService pour cet appareil.

default getHardwareCharacteristics()

Renvoie les caractéristiques obtenues en lisant la propriété des caractéristiques de compilation.

abstract String getLanguage()

Renvoie la langue de l'utilisateur.

default InstallMetrics getLastInstallMetrics()

Obtient les informations sur l'installation la plus récente sur cet appareil.

abstract String getMountPoint(String name)

Renvoie un point de montage.

default ProfileableClient[] getProfileableClients()

Renvoie le tableau des clients profilables.

abstract getProperties()

Cette méthode est obsolète. Utilisez plutôt IShellEnabledDevice.getSystemProperty(String).

abstract String getProperty(String name)

Méthode pratique qui tente de récupérer une propriété via IShellEnabledDevice.getSystemProperty(String) avec un temps d'attente très court et qui supprime les exceptions.

abstract String getPropertyCacheOrSync(String name)

Cette méthode est obsolète. Utilisez plutôt IShellEnabledDevice.getSystemProperty(String).

abstract int getPropertyCount()

Cette méthode est obsolète. d'implémentation

abstract String getPropertySync(String name)

Cette méthode est obsolète. utiliser IShellEnabledDevice.getSystemProperty(String)

abstract String getRegion()

Renvoie la région de l'utilisateur.

abstract RawImage getScreenshot()

Prend une capture d'écran de l'appareil et la renvoie sous la forme d'un RawImage.

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

Renvoie le numéro de série de l'appareil.

abstract IDevice.DeviceState getState()

Renvoie l'état de l'appareil.

abstract SyncService getSyncService()

Renvoie un objet SyncService pour transférer des fichiers vers et depuis l'appareil.

abstract boolean hasClients()

Indique si IDevice comporte des Client.

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

Installe une application Android sur l'appareil.

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

Installe une application Android sur l'appareil.

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

Installe une application Android sur l'appareil.

default void installPackages( apks, boolean reinstall, installOptions)

Installe une application Android composée de plusieurs fichiers APK (un fichier principal et 0 à n packages divisés) avec le délai avant expiration par défaut.

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

Installe une application Android composée de plusieurs fichiers APK (un fichier principal et 0 à n packages fractionnés).

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

Installe le package d'application qui a été transféré vers un emplacement temporaire sur l'appareil.

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

Installe le package d'application qui a été transféré vers un emplacement temporaire sur l'appareil.

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

Installe le package d'application qui a été transféré vers un emplacement temporaire sur l'appareil.

default void installRemotePackages( remoteApks, boolean reinstall, installOptions)

Installe une application Android composée de plusieurs fichiers APK situés localement sur l'appareil avec le délai avant expiration par défaut.

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

Installe une application Android composée de plusieurs fichiers APK situés localement sur l'appareil.

abstract boolean isBootLoader()

Indique si l'appareil est en mode bootloader.

abstract boolean isEmulator()

Renvoie true si l'appareil est un émulateur.

abstract boolean isOffline()

Indique si l'appareil est hors connexion.

abstract boolean isOnline()

Indique si l'appareil est prêt.

abstract boolean isRoot()

Interroge l'état root actuel de l'appareil.

default void kill(String applicationName)

Arrête une application en fonction de son nom.

abstract void pullFile(String remote, String local)

Extrait un seul fichier.

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

Envoie plusieurs fichiers ou répertoires.

abstract void pushFile(String local, String remote)

Envoie un seul fichier.

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

Appelez le service Android Binder Bridge sur un appareil distant.

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

Appelez le service host:exec sur un appareil distant.

abstract void reboot(String into)

Redémarrez l'appareil.

default void removeForward(int localPort)

Supprime un transfert de port entre un port local et un port distant.

default void removeForward(int localPort, int remotePort)

Cette méthode est obsolète. Utiliser removeForward(int)

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

Cette méthode est obsolète. Utiliser removeForward(int)

abstract void removeRemotePackage(String remoteFilePath)

Supprime un fichier de l'appareil.

default void removeReverse(int remotePort)

Supprime l'inversion de port entre un port distant et un port local.

abstract boolean root()

Demandez au daemon adb de devenir root sur l'appareil.

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

Lance l'enregistrement de l'écran sur l'appareil si celui-ci est compatible avec IDevice.Feature.SCREEN_RECORD.

abstract boolean supportsFeature(IDevice.HardwareFeature feature)

Indique si cet appareil est compatible avec la fonctionnalité matérielle spécifiée.

abstract boolean supportsFeature(IDevice.Feature feature)

Indique si cet appareil est compatible avec la fonctionnalité logicielle spécifiée.

abstract String syncPackageToDevice(String localFilePath)

Transfère un fichier sur l'appareil

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

Désinstalle une application de l'appareil.

abstract String uninstallPackage(String packageName)

Désinstalle un package de l'appareil.

Constantes

CHANGE_BUILD_INFO

public static final int CHANGE_BUILD_INFO

Masque de bits de modification de l'appareil : modification des informations de compilation.

Valeur constante : 4 (0x00000004)

CHANGE_CLIENT_LIST

public static final int CHANGE_CLIENT_LIST

Masque de bits de modification de l'appareil : modification de la liste Client.

Valeur constante : 2 (0x00000002)

CHANGE_PROFILEABLE_CLIENT_LIST

public static final int CHANGE_PROFILEABLE_CLIENT_LIST

Masque de bits de modification de l'appareil : modification de la liste ProfileableClient.

Valeur constante : 8 (0x00000008)

CHANGE_STATE

public static final int CHANGE_STATE

Masque de bits de modification de l'appareil : DeviceState modification.

Valeur constante : 1 (0x00000001)

FIRST_EMULATOR_SN

public static final String FIRST_EMULATOR_SN

Numéro de série du premier émulateur connecté.

Valeur de constante : "emulator-5554"

MNT_DATA

public static final String MNT_DATA

Valeur de constante : "ANDROID_DATA"

MNT_EXTERNAL_STORAGE

public static final String MNT_EXTERNAL_STORAGE

Valeur de constante : "EXTERNAL_STORAGE"

MNT_ROOT

public static final String MNT_ROOT

Valeur de constante : "ANDROID_ROOT"

PROP_BUILD_API_LEVEL

public static final String PROP_BUILD_API_LEVEL

Valeur de constante : "ro.build.version.sdk"

PROP_BUILD_CHARACTERISTICS

public static final String PROP_BUILD_CHARACTERISTICS

Valeur constante : "ro.build.characteristics"

PROP_BUILD_CODENAME

public static final String PROP_BUILD_CODENAME

Valeur de constante : "ro.build.version.codename"

PROP_BUILD_TAGS

public static final String PROP_BUILD_TAGS

Valeur de constante : "ro.build.tags"

PROP_BUILD_TYPE

public static final String PROP_BUILD_TYPE

Valeur constante : "ro.build.type"

PROP_BUILD_VERSION

public static final String PROP_BUILD_VERSION

Valeur de constante : "ro.build.version.release"

PROP_BUILD_VERSION_NUMBER

public static final String PROP_BUILD_VERSION_NUMBER

Cette constante est obsolète.
Utilisez PROP_BUILD_API_LEVEL.

Valeur de constante : "ro.build.version.sdk"

PROP_DEBUGGABLE

public static final String PROP_DEBUGGABLE

Valeur de constante : "ro.debuggable"

PROP_DEVICE_CPU_ABI

public static final String PROP_DEVICE_CPU_ABI

Valeur de constante : "ro.product.cpu.abi"

PROP_DEVICE_CPU_ABI2

public static final String PROP_DEVICE_CPU_ABI2

Valeur de constante : "ro.product.cpu.abi2"

PROP_DEVICE_CPU_ABI_LIST

public static final String PROP_DEVICE_CPU_ABI_LIST

Valeur constante : "ro.product.cpu.abilist"

PROP_DEVICE_DENSITY

public static final String PROP_DEVICE_DENSITY

Valeur de constante : "ro.sf.lcd_density"

PROP_DEVICE_EMULATOR_DENSITY

public static final String PROP_DEVICE_EMULATOR_DENSITY

Valeur de constante : "qemu.sf.lcd_density"

PROP_DEVICE_LANGUAGE

public static final String PROP_DEVICE_LANGUAGE

Valeur de constante : "persist.sys.language"

PROP_DEVICE_MANUFACTURER

public static final String PROP_DEVICE_MANUFACTURER

Valeur constante : "ro.product.manufacturer"

PROP_DEVICE_MODEL

public static final String PROP_DEVICE_MODEL

Valeur de constante : "ro.product.model"

PROP_DEVICE_REGION

public static final String PROP_DEVICE_REGION

Valeur de constante : "persist.sys.country"

RE_EMULATOR_SN

public static final String RE_EMULATOR_SN

Expression régulière du numéro de série de l'émulateur.

Valeur de constante : "emulator-(\d+)"

UNKNOWN_PACKAGE

public static final String UNKNOWN_PACKAGE

Valeur constante : ""

Méthodes publiques

arePropertiesSet

public abstract boolean arePropertiesSet ()

Renvoie true si les propriétés ont été mises en cache.

Renvoie
boolean

createForward

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

Crée un transfert de port entre un port TCP local et un socket de domaine Unix distant.

Paramètres
localPort int : port local à transférer

remoteSocketName String : nom du socket de domaine Unix créé sur l'appareil

namespace IDevice.DeviceUnixSocketNamespace : espace de noms dans lequel le socket de domaine Unix a été créé

Génère
TimeoutException en cas de délai d'expiration de la connexion.
AdbCommandRejectedException si adb rejette la commande.
en cas d'erreur d'E/S sur la connexion.

createForward

public abstract void createForward (int localPort, 
                int remotePort)

Crée un transfert de port entre un port local et un port distant.

Paramètres
localPort int : port local à transférer

remotePort int : port distant.

Génère
TimeoutException en cas de délai d'expiration de la connexion.
AdbCommandRejectedException si adb rejette la commande.
en cas d'erreur d'E/S sur la connexion.

createReverse

public void createReverse (int remotePort, 
                int localPort)

Crée une inversion de port entre un port distant et un port local.

Paramètres
remotePort int : port distant à inverser.

localPort int : port local.

Génère
TimeoutException en cas de délai d'expiration de la connexion.
AdbCommandRejectedException si adb rejette la commande.
en cas d'erreur d'E/S sur la connexion.

executeBinderCommand

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

Exécute une commande Binder sur l'appareil et envoie le résultat à un receiver

Cette méthode utilise l'appel exec:cmd ou abb_exec: plus rapide si l'OS de l'appareil et le serveur ADB hôte sont compatibles avec la fonctionnalité d'exécution Android Binder Bridge.

Paramètres
parameters String : commande Binder à exécuter

receiver IShellOutputReceiver : IShellOutputReceiver qui recevra le résultat de la commande binder

maxTimeToOutputResponse long

maxTimeUnits TimeUnit

is InputStream : flux d'entrée facultatif à envoyer via stdin

Génère
TimeoutException en cas de délai d'expiration de la connexion.
AdbCommandRejectedException si adb rejette la commande.
ShellCommandUnresponsiveException au cas où la commande Binder n'enverrait pas de résultat pendant un certain temps.
en cas d'erreur d'E/S sur la connexion.

executeShellCommand

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

Version de la commande executeShell qui peut accepter un flux d'entrée à envoyer via stdin.

Paramètres
command String

receiver IShellOutputReceiver

maxTimeToOutputResponse long

maxTimeUnits TimeUnit

is InputStream

Génère
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Exécute une commande shell sur l'appareil et envoie le résultat à un receiver.

Cela revient à appeler executeShellCommand(command, receiver, DdmPreferences.getTimeOut()).

Paramètres
command String : commande shell à exécuter

receiver IShellOutputReceiver : IShellOutputReceiver qui recevra la sortie de la commande shell

Génère
TimeoutException en cas de délai d'expiration de la connexion.
AdbCommandRejectedException si adb rejette la commande.
ShellCommandUnresponsiveException au cas où la commande shell n'enverrait pas de résultat pendant une durée donnée.
en cas d'erreur d'E/S sur la connexion.

executeShellCommand

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

Cette méthode est obsolète.
Utilisez IShellEnabledDevice.executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit).

Paramètres
command String

receiver IShellOutputReceiver

maxTimeToOutputResponse int

Génère
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

forceStop

public void forceStop (String applicationName)

Forcez l'arrêt d'une application en indiquant son nom. Toutes les alarmes en attente et les calculs en file d'attente sont supprimés.

Paramètres
applicationName String : nom de l'application

getAbis

public abstract  getAbis ()

Renvoie les ABI compatibles avec cet appareil. Les ABI sont triées par ordre de préférence, la première étant la plus préférée.

Renvoie
Liste des ABI.

getAvdData

public ListenableFuture<AvdData> getAvdData ()

Renvoie des informations sur l'AVD sur lequel l'émulateur s'exécute.

AvdData.getName correspond au nom de l'AVD ou à null s'il n'y en a pas.

AvdData.getPath correspond au chemin d'accès de l'AVD ou à la valeur "null" s'il s'agit d'un appareil physique, si la sous-commande de la console de l'émulateur a échoué ou si la version de l'émulateur est antérieure à la version 30.0.18.

Renvoie
ListenableFuture<AvdData> le AvdData de l'appareil.

getAvdName

public abstract String getAvdName ()

Renvoie le nom de l'AVD sur lequel l'émulateur est exécuté.

Cette option n'est valide que si isEmulator() renvoie "true".

Si l'émulateur n'exécute aucun AVD (par exemple, s'il est exécuté à partir d'une compilation d'arborescence source Android), cette méthode renvoie "<build>".

Remarque : Préférez utiliser getAvdData() si vous souhaitez contrôler le délai d'inactivité.

Renvoie
String Nom de l'AVD ou null s'il n'y en a pas.

getAvdPath

public abstract String getAvdPath ()

Renvoie le chemin d'accès absolu à l'appareil virtuel dans le système de fichiers. Le chemin d'accès dépend du système d'exploitation. Il comporte des séparateurs de nom "/" sous Linux et "\" sous Windows.

Remarque : Préférez utiliser getAvdData() si vous souhaitez contrôler le délai d'inactivité.

Renvoie
String Chemin d'accès à l'AVD ou null s'il s'agit d'un appareil physique, si la sous-commande de la console de l'émulateur a échoué ou si la version de l'émulateur est antérieure à la version 30.0.18

getBattery

public abstract  getBattery (long freshnessTime, 
                TimeUnit timeUnit)

Renvoie le niveau de batterie de l'appareil, de 0 à 100 %.

Il est possible que le niveau de batterie soit mis en cache. Interroge l'appareil sur le niveau de sa batterie uniquement si freshnessTime a expiré depuis la dernière requête réussie.

Paramètres
freshnessTime long : récence souhaitée du niveau de batterie

timeUnit TimeUnit : ERROR(/TimeUnit) de freshnessTime

Renvoie
un ERROR(/Future) qui peut être utilisé pour interroger le niveau de la batterie. L'objet Future renverra un ERROR(/ExecutionException) si le niveau de batterie n'a pas pu être récupéré.

getBattery

public abstract  getBattery ()

Renvoie le niveau de batterie de l'appareil, de 0 à 100 %.

Il est possible que le niveau de batterie soit mis en cache. L'appareil n'est interrogé sur le niveau de sa batterie que si cinq minutes se sont écoulées depuis la dernière requête réussie.

Renvoie
un ERROR(/Future) qui peut être utilisé pour interroger le niveau de la batterie. L'objet Future renverra un ERROR(/ExecutionException) si le niveau de batterie n'a pas pu être récupéré.

getBatteryLevel

public abstract Integer getBatteryLevel (long freshnessMs)

Cette méthode est obsolète.
utiliser getBattery(long, TimeUnit)

Renvoie le niveau de batterie de l'appareil, de 0 à 100 %.

Il est possible que le niveau de batterie soit mis en cache. Interroge l'appareil sur le niveau de sa batterie uniquement si freshnessMs ms se sont écoulées depuis la dernière requête réussie.

Renvoie
Integer le niveau de batterie ou null s'il n'a pas pu être récupéré.

Génère
com.android.ddmlib.ShellCommandUnresponsiveException
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

getBatteryLevel

public abstract Integer getBatteryLevel ()

Cette méthode est obsolète.
utiliser getBattery()

Renvoie le niveau de batterie de l'appareil, de 0 à 100 %.

Il est possible que le niveau de batterie soit mis en cache. L'appareil n'est interrogé sur le niveau de sa batterie que si cinq minutes se sont écoulées depuis la dernière requête réussie.

Renvoie
Integer le niveau de batterie ou null s'il n'a pas pu être récupéré.

Génère
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

getClient

public abstract Client getClient (String applicationName)

Renvoie un Client par son nom d'application.

Paramètres
applicationName String : nom de l'application

Renvoie
Client l'objet Client ou null si aucune correspondance n'a été trouvée.

getClientName

public abstract String getClientName (int pid)

Renvoie le nom du client par PID ou null si le PID est inconnu.

Paramètres
pid int : PID du client.

Renvoie
String

getClients

public abstract Client[] getClients ()

Renvoie le tableau des clients.

Renvoie
Client[]

getDensity

public abstract int getDensity ()

Renvoie le bucket de densité de l'écran de l'appareil en lisant la valeur de la propriété système PROP_DEVICE_DENSITY.

Renvoie
int la densité, ou -1 si elle ne peut pas être déterminée.

getFileListingService

public abstract FileListingService getFileListingService ()

Renvoie un FileListingService pour cet appareil.

Renvoie
FileListingService

getHardwareCharacteristics

public  getHardwareCharacteristics ()

Renvoie les caractéristiques obtenues en lisant la propriété des caractéristiques de compilation.

Renvoie

getLanguage

public abstract String getLanguage ()

Renvoie la langue de l'utilisateur.

Renvoie
String Langue de l'utilisateur ou valeur nulle si elle est inconnue

getLastInstallMetrics

public InstallMetrics getLastInstallMetrics ()

Obtient les informations sur l'installation la plus récente sur cet appareil.

Renvoie
InstallMetrics InstallMetrics métriques décrivant l'installation.

getMountPoint

public abstract String getMountPoint (String name)

Renvoie un point de montage.

Paramètres
name String : nom du point de montage à renvoyer

Renvoie
String

getProfileableClients

public ProfileableClient[] getProfileableClients ()

Renvoie le tableau des clients profilables.

Renvoie
ProfileableClient[]

getProperties

public abstract  getProperties ()

Cette méthode est obsolète.
use IShellEnabledDevice.getSystemProperty(String) instead

Renvoie les propriétés de l'appareil mises en cache. Il contient l'intégralité de la sortie de "getprop".

Renvoie

getProperty

public abstract String getProperty (String name)

Méthode pratique qui tente de récupérer une propriété via IShellEnabledDevice.getSystemProperty(String) avec un temps d'attente très court et qui supprime les exceptions.

Remarque : Nous vous recommandons d'utiliser IShellEnabledDevice.getSystemProperty(String) si vous souhaitez contrôler le délai d'inactivité.

Paramètres
name String : nom de la valeur à renvoyer.

Renvoie
String la valeur ou null si la valeur de la propriété n'était pas immédiatement disponible.

getPropertyCacheOrSync

public abstract String getPropertyCacheOrSync (String name)

Cette méthode est obsolète.
use IShellEnabledDevice.getSystemProperty(String) instead

Combinaison de getProperty(String) et getPropertySync(String) qui tente de récupérer la propriété à partir du cache. Si elle n'est pas trouvée, une tentative synchrone de requête directe sur l'appareil est effectuée, et le cache est rempli à nouveau en cas de succès.

Paramètres
name String : nom de la valeur à renvoyer.

Renvoie
String la valeur ou null si la propriété n'existe pas.

Génère
TimeoutException en cas de délai d'expiration de la connexion.
AdbCommandRejectedException si adb rejette la commande.
ShellCommandUnresponsiveException au cas où la commande shell n'enverrait pas de résultat pendant une durée donnée.
en cas d'erreur d'E/S sur la connexion.

getPropertyCount

public abstract int getPropertyCount ()

Cette méthode est obsolète.
détail de l'implémentation

Renvoie le nombre de propriétés pour cet appareil.

Renvoie
int

getPropertySync

public abstract String getPropertySync (String name)

Cette méthode est obsolète.
utiliser IShellEnabledDevice.getSystemProperty(String)

Variante de getProperty(String) qui tente de récupérer la propriété donnée directement à partir de l'appareil, sans utiliser le cache. Cette méthode ne doit être utilisée que pour les propriétés volatiles.

Paramètres
name String : nom de la valeur à renvoyer.

Renvoie
String la valeur ou null si la propriété n'existe pas.

Génère
TimeoutException en cas de délai d'expiration de la connexion.
AdbCommandRejectedException si adb rejette la commande.
ShellCommandUnresponsiveException au cas où la commande shell n'enverrait pas de résultat pendant une durée donnée.
en cas d'erreur d'E/S sur la connexion.

getRegion

public abstract String getRegion ()

Renvoie la région de l'utilisateur.

Renvoie
String Région de l'utilisateur ou valeur nulle si elle est inconnue

getScreenshot

public abstract RawImage getScreenshot ()

Prend une capture d'écran de l'appareil et la renvoie sous la forme d'un RawImage.

Renvoie
RawImage la capture d'écran sous forme de RawImage ou de null en cas de problème.

Génère
TimeoutException en cas de délai d'expiration de la connexion.
AdbCommandRejectedException si adb rejette la commande.
en cas d'erreur d'E/S sur la connexion.

getScreenshot

public abstract RawImage getScreenshot (long timeout, 
                TimeUnit unit)

Paramètres
timeout long

unit TimeUnit

Renvoie
RawImage

Génère
AdbCommandRejectedException
TimeoutException

getSerialNumber

public abstract String getSerialNumber ()

Renvoie le numéro de série de l'appareil.

Renvoie
String

getState

public abstract IDevice.DeviceState getState ()

Renvoie l'état de l'appareil.

Renvoie
IDevice.DeviceState

getSyncService

public abstract SyncService getSyncService ()

Renvoie un objet SyncService pour transférer des fichiers vers et depuis l'appareil.

Renvoie
SyncService null si SyncService n'a pas pu être créé. Cela peut se produire si adb refuse d'ouvrir la connexion, car le IDevice n'est pas valide (ou a été déconnecté).

Génère
TimeoutException en cas de délai d'expiration de la connexion.
AdbCommandRejectedException si adb rejette la commande.
si la connexion avec adb a échoué.

hasClients

public abstract boolean hasClients ()

Indique si IDevice comporte des Client.

Renvoie
boolean

installPackage

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

Installe une application Android sur l'appareil. Il s'agit d'une méthode d'assistance qui combine les étapes syncPackageToDevice, installRemotePackage et removePackage.

Paramètres
packageFilePath String : chemin d'accès absolu au fichier sur l'hôte local à installer

reinstall boolean : défini sur true si l'application doit être réinstallée

receiver InstallReceiver : InstallReceiver à utiliser pour surveiller l'installation et obtenir l'état final.

maxTimeout long : délai avant expiration maximal pour le retour de la commande. Une valeur de 0 signifie qu'aucun délai maximal ne sera appliqué.

maxTimeToOutputResponse long : durée maximale pendant laquelle la commande est autorisée à ne produire aucune réponse. Une valeur de 0 signifie que la méthode attendra indéfiniment (jusqu'à ce que receiver annule l'exécution) la sortie de la commande et ne générera jamais d'exception.

maxTimeUnits TimeUnit : unités pour les valeurs non nulles maxTimeout et maxTimeToOutputResponse.

extraArgs String : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm install --help" pour connaître les options disponibles.

Génère
InstallException si l'installation échoue.

installPackage

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

Installe une application Android sur l'appareil. Il s'agit d'une méthode d'assistance qui combine les étapes syncPackageToDevice, installRemotePackage et removePackage.

Paramètres
packageFilePath String : chemin d'accès absolu au fichier sur l'hôte local à installer

reinstall boolean : défini sur true si l'application doit être réinstallée

receiver InstallReceiver : InstallReceiver à utiliser pour surveiller l'installation et obtenir l'état final.

extraArgs String : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm install --help" pour connaître les options disponibles.

Génère
InstallException si l'installation échoue.

installPackage

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

Installe une application Android sur l'appareil. Il s'agit d'une méthode d'assistance qui combine les étapes syncPackageToDevice, installRemotePackage et removePackage.

Paramètres
packageFilePath String : chemin d'accès absolu au fichier sur l'hôte local à installer

reinstall boolean : défini sur true si l'application doit être réinstallée

extraArgs String : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm install --help" pour connaître les options disponibles.

Génère
InstallException si l'installation échoue.

installPackages

public void installPackages ( apks, 
                boolean reinstall, 
                 installOptions)

Installe une application Android composée de plusieurs fichiers APK (un fichier principal et 0 à n packages divisés) avec le délai avant expiration par défaut.

Paramètres
apks  : liste des APK à installer (1 APK principal + 0 à n APK fractionnés)

reinstall boolean : défini sur true si l'application doit être réinstallée

installOptions  : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm install --help" pour connaître les options disponibles.

Génère
InstallException si l'installation échoue.

installPackages

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

Installe une application Android composée de plusieurs fichiers APK (un fichier principal et 0 à n packages fractionnés).

Paramètres
apks  : liste des APK à installer (1 APK principal + 0 à n APK fractionnés)

reinstall boolean : défini sur true si l'application doit être réinstallée

installOptions  : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm install --help" pour connaître les options disponibles.

timeout long : délai d'installation

timeoutUnit TimeUnit : ERROR(/TimeUnit) correspondant au paramètre de délai d'inactivité

Génère
InstallException si l'installation échoue.

installRemotePackage

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

Installe le package d'application qui a été transféré vers un emplacement temporaire sur l'appareil.

Paramètres
remoteFilePath String : chemin d'accès absolu au fichier du package sur l'appareil

reinstall boolean : défini sur true si l'application doit être réinstallée

receiver InstallReceiver : InstallReceiver à utiliser pour surveiller l'installation et obtenir l'état final.

extraArgs String : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm install --help" pour connaître les options disponibles.

Génère
InstallException si l'installation échoue.

installRemotePackage

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

Installe le package d'application qui a été transféré vers un emplacement temporaire sur l'appareil.

Paramètres
remoteFilePath String : chemin d'accès absolu au fichier du package sur l'appareil

reinstall boolean : défini sur true si l'application doit être réinstallée

extraArgs String : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm install --help" pour connaître les options disponibles.

Génère
InstallException si l'installation échoue.

installRemotePackage

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

Installe le package d'application qui a été transféré vers un emplacement temporaire sur l'appareil.

Paramètres
remoteFilePath String : chemin d'accès absolu au fichier du package sur l'appareil

reinstall boolean : défini sur true si l'application doit être réinstallée

receiver InstallReceiver : InstallReceiver à utiliser pour surveiller l'installation et obtenir l'état final.

maxTimeout long : délai avant expiration maximal pour le retour de la commande. Une valeur de 0 signifie qu'aucun délai maximal ne sera appliqué.

maxTimeToOutputResponse long : durée maximale pendant laquelle la commande est autorisée à ne produire aucune réponse. Une valeur de 0 signifie que la méthode attendra indéfiniment (jusqu'à ce que receiver annule l'exécution) la sortie de la commande et ne générera jamais d'exception.

maxTimeUnits TimeUnit : unités pour les valeurs non nulles maxTimeout et maxTimeToOutputResponse.

extraArgs String : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm install --help" pour connaître les options disponibles.

Génère
InstallException si l'installation échoue.

installRemotePackages

public void installRemotePackages ( remoteApks, 
                boolean reinstall, 
                 installOptions)

Installe une application Android composée de plusieurs fichiers APK situés localement sur l'appareil avec le délai avant expiration par défaut.

Paramètres
remoteApks  : liste des chemins d'accès aux fichiers APK à installer sur l'appareil

reinstall boolean : défini sur true si l'application doit être réinstallée

installOptions  : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm install --help" pour connaître les options disponibles.

Génère
InstallException si l'installation échoue.

installRemotePackages

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

Installe une application Android composée de plusieurs fichiers APK situés localement sur l'appareil.

Paramètres
remoteApks  : liste des chemins d'accès aux fichiers APK à installer sur l'appareil

reinstall boolean : défini sur true si l'application doit être réinstallée

installOptions  : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm install --help" pour connaître les options disponibles.

timeout long : délai d'installation

timeoutUnit TimeUnit : ERROR(/TimeUnit) correspondant au paramètre de délai d'inactivité

Génère
InstallException si l'installation échoue.

isBootLoader

public abstract boolean isBootLoader ()

Indique si l'appareil est en mode bootloader.

Renvoie
boolean true si getState() renvoie DeviceState.BOOTLOADER.

isEmulator

public abstract boolean isEmulator ()

Renvoie true si l'appareil est un émulateur.

Renvoie
boolean

isOffline

public abstract boolean isOffline ()

Indique si l'appareil est hors connexion.

Renvoie
boolean true si getState() renvoie DeviceState.OFFLINE.

isOnline

public abstract boolean isOnline ()

Indique si l'appareil est prêt.

Renvoie
boolean true si getState() renvoie DeviceState.ONLINE.

isRoot

public abstract boolean isRoot ()

Interroge l'état root actuel de l'appareil. Pour en savoir plus, consultez "adb root".

Renvoie
boolean "true" si le daemon adb est exécuté en tant que root, "false" dans le cas contraire.

Génère
TimeoutException en cas de délai d'expiration de la connexion.
AdbCommandRejectedException si adb rejette la commande.
ShellCommandUnresponsiveException

arrête

public void kill (String applicationName)

Arrête une application en fonction de son nom. Cela ne détruit que les activités, laissant leur état seul dans le système Android.

Paramètres
applicationName String : nom de l'application

pullFile

public abstract void pullFile (String remote, 
                String local)

Extrait un seul fichier.

Paramètres
remote String : chemin d'accès complet au fichier distant

local String : destination locale.

Génère
en cas d'exception d'E/S.
AdbCommandRejectedException si adb rejette la commande.
TimeoutException en cas de délai d'inactivité lors de la lecture des réponses de l'appareil.
SyncException en cas d'exception de synchronisation.

push

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

Envoie plusieurs fichiers ou répertoires.

Paramètres
local String : fichiers locaux à transférer

remote String : chemin d'accès distant représentant un répertoire

Génère
en cas d'erreur d'E/S sur la connexion.
AdbCommandRejectedException si adb rejette la commande.
TimeoutException en cas de délai d'inactivité lors de la lecture des réponses de l'appareil.
SyncException si certains fichiers n'ont pas pu être transférés ;

pushFile

public abstract void pushFile (String local, 
                String remote)

Envoie un seul fichier.

Paramètres
local String : chemin d'accès local.

remote String : chemin d'accès au fichier distant

Génère
en cas d'erreur d'E/S sur la connexion.
AdbCommandRejectedException si adb rejette la commande.
TimeoutException en cas de délai d'inactivité lors de la lecture des réponses de l'appareil.
SyncException si le fichier n'a pas pu être transféré ;

rawBinder

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

Appelez le service Android Binder Bridge sur un appareil distant. Renvoie un canal de socket connecté à la commande de liaison de l'appareil.

La propriété du SocketChannel est cédée à l'appelant. Il doit être fermé explicitement après utilisation.

Paramètres
service String : nom du service Android auquel se connecter

parameters String : paramètres de la commande binder

Renvoie
SocketChannel Un SocketChannel connecté au processus d'exécution sur l'appareil. après utilisation.

Génère
AdbCommandRejectedException
TimeoutException

rawExec

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

Appelez le service host:exec sur un appareil distant. Renvoie un canal de socket connecté au processus d'exécution. Notez que le service d'exécution ne fait pas la différence entre stdout et stderr. Par conséquent, tout ce qui est lu à partir du socket peut provenir de l'une ou l'autre des sorties et être entrelacé.

La propriété du SocketChannel est cédée à l'appelant. Il doit être fermé explicitement après utilisation.

Paramètres
executable String

parameters String

Renvoie
SocketChannel Un SocketChannel connecté au processus d'exécution sur l'appareil. après utilisation.

Génère
AdbCommandRejectedException
TimeoutException

redémarrer

public abstract void reboot (String into)

Redémarrez l'appareil.

Paramètres
into String : nom du bootloader dans lequel redémarrer, ou null pour redémarrer simplement l'appareil.

Génère
TimeoutException en cas de délai d'expiration de la connexion.
AdbCommandRejectedException si adb rejette la commande.
IOException

removeForward

public void removeForward (int localPort)

Supprime un transfert de port entre un port local et un port distant.

Paramètres
localPort int : port local à transférer

Génère
TimeoutException en cas de délai d'expiration de la connexion.
AdbCommandRejectedException si adb rejette la commande.
en cas d'erreur d'E/S sur la connexion.

removeForward

public void removeForward (int localPort, 
                int remotePort)

Cette méthode est obsolète.
Utilisez removeForward(int)

Paramètres
localPort int

remotePort int

Génère
AdbCommandRejectedException
TimeoutException

removeForward

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

Cette méthode est obsolète.
Utilisez removeForward(int)

Paramètres
localPort int

remoteSocketName String

namespace IDevice.DeviceUnixSocketNamespace

Génère
AdbCommandRejectedException
TimeoutException

removeRemotePackage

public abstract void removeRemotePackage (String remoteFilePath)

Supprime un fichier de l'appareil.

Paramètres
remoteFilePath String : chemin d'accès sur l'appareil au fichier à supprimer

Génère
InstallException si l'installation échoue.

removeReverse

public void removeReverse (int remotePort)

Supprime l'inversion de port entre un port distant et un port local.

Paramètres
remotePort int : port distant.

Génère
TimeoutException en cas de délai d'expiration de la connexion.
AdbCommandRejectedException si adb rejette la commande.
en cas d'erreur d'E/S sur la connexion.

racine

public abstract boolean root ()

Demandez au daemon adb de devenir root sur l'appareil. Cette opération peut échouer silencieusement et ne peut réussir que sur les versions pour les développeurs. Pour en savoir plus, consultez "adb root".

Renvoie
boolean "true" si le daemon adb est exécuté en tant que root, "false" dans le cas contraire.

Génère
TimeoutException en cas de délai d'expiration de la connexion.
AdbCommandRejectedException si adb rejette la commande.
ShellCommandUnresponsiveException Si l'état racine ne peut pas être interrogé.
IOException

startScreenRecorder

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

Lance l'enregistrement de l'écran sur l'appareil si celui-ci est compatible avec IDevice.Feature.SCREEN_RECORD.

Paramètres
remoteFilePath String

options ScreenRecorderOptions

receiver IShellOutputReceiver

Génère
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

supportsFeature

public abstract boolean supportsFeature (IDevice.HardwareFeature feature)

Indique si cet appareil est compatible avec la fonctionnalité matérielle spécifiée.

Paramètres
feature IDevice.HardwareFeature

Renvoie
boolean

supportsFeature

public abstract boolean supportsFeature (IDevice.Feature feature)

Indique si cet appareil est compatible avec la fonctionnalité logicielle spécifiée.

Paramètres
feature IDevice.Feature

Renvoie
boolean

syncPackageToDevice

public abstract String syncPackageToDevice (String localFilePath)

Transfère un fichier sur l'appareil

Paramètres
localFilePath String : chemin d'accès absolu au fichier sur l'hôte local

Renvoie
String Chemin de destination String sur l'appareil pour le fichier

Génère
TimeoutException en cas de délai d'expiration de la connexion.
AdbCommandRejectedException si adb rejette la commande.
en cas d'erreur d'E/S sur la connexion.
SyncException si une erreur se produit lors du transfert du package sur l'appareil.

uninstallApp

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

Désinstalle une application de l'appareil.

Paramètres
applicationID String : ID de l'application Android à désinstaller

extraArgs String : arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm install --help" pour connaître les options disponibles.

Renvoie
String String avec un code d'erreur ou null en cas de succès.

Génère
InstallException si la désinstallation échoue.

uninstallPackage

public abstract String uninstallPackage (String packageName)

Désinstalle un package de l'appareil.

Paramètres
packageName String : ID de l'application Android à désinstaller

Renvoie
String String avec un code d'erreur ou null en cas de succès.

Génère
InstallException si la désinstallation échoue.