À partir de 2026, pour nous aligner sur notre modèle de développement stable et garantir la stabilité de la plate-forme pour l'écosystème, nous publierons le code source sur AOSP au deuxième et au quatrième trimestre. Pour créer et contribuer à AOSP, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main. La branche de fichier manifeste android-latest-release fera toujours référence à la version la plus récente envoyée à AOSP. Pour en savoir plus, consultez Modifications apportées à AOSP.

DeviceImpl

public final class DeviceImpl
extends Object implements IDevice

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

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

Résumé

Constructeurs publics
`DeviceImpl(ClientTracker clientTracer, String serialNumber, IDevice.DeviceState deviceState)`

Méthodes publiques
`boolean`	`arePropertiesSet()` Renvoie `true` si les propriétés ont été mises en cache.
`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.
`void`	`createForward(int localPort, int remotePort)` Crée un transfert de port entre un port local et un port distant.
`void`	`createReverse(int remotePort, int localPort)` Crée une inversion de port entre un port distant et un port local.
`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.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` Exécute une commande shell sur l'appareil et envoie le résultat à un `receiver`.
`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.
`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())`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, int maxTimeToOutputResponse)`
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` Exécute une commande shell sur l'appareil et envoie le résultat à un `receiver`.
`void`	`forceStop(String applicationName)` Forcez l'arrêt d'une application en indiquant son nom.
	`getAbis()` Renvoie les ABI compatibles avec cet appareil.
`ListenableFuture<AvdData>`	`getAvdData()` Renvoie des informations sur l'AVD sur lequel l'émulateur s'exécute.
`String`	`getAvdName()` Renvoie le nom de l'AVD sur lequel l'émulateur est exécuté.
`String`	`getAvdPath()` Renvoie le chemin d'accès absolu à l'appareil virtuel dans le système de fichiers.
	`getBattery(long freshnessTime, TimeUnit timeUnit)` Renvoie le niveau de batterie de l'appareil, de 0 à 100 %.
	`getBattery()` Renvoie le niveau de batterie de l'appareil, de 0 à 100 %.
`Integer`	`getBatteryLevel(long freshnessMs)` Renvoie le niveau de batterie de l'appareil, de 0 à 100 %.
`Integer`	`getBatteryLevel()` Renvoie le niveau de batterie de l'appareil, de 0 à 100 %.
`ClientImpl`	`getClient(String applicationName)` Renvoie un `Client` par son nom d'application.
`String`	`getClientName(int pid)` Renvoie le nom du client par PID ou `null` si le PID est inconnu.
`ClientTracker`	`getClientTracker()`
`ClientImpl[]`	`getClients()` Renvoie le tableau des clients.
`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`.
`FileListingService`	`getFileListingService()` Renvoie un `FileListingService` pour cet appareil.
`String`	`getLanguage()` Renvoie la langue de l'utilisateur.
`InstallMetrics`	`getLastInstallMetrics()` Obtient les informations sur l'installation la plus récente sur cet appareil.
`String`	`getMountPoint(String name)` Renvoie un point de montage.
`String`	`getName()` Renvoie un nom (humanisé) pour cet appareil.
`ClientImpl[]`	`getNativeClients()`
`ClientImpl`	`getNativeClients(String applicationName)`
`ProfileableClientImpl[]`	`getProfileableClients()` Renvoie le tableau des clients profilables.
	`getProperties()` Renvoie les propriétés de l'appareil mises en cache.
`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.
`String`	`getPropertyCacheOrSync(String name)` Combinaison de `getProperty(String)` et `getPropertySync(String)` qui tente de récupérer la propriété à partir du cache.
`int`	`getPropertyCount()` Renvoie le nombre de propriétés pour cet appareil.
`String`	`getPropertySync(String name)` Variante de `getProperty(String)` qui tente de récupérer la propriété donnée directement à partir de l'appareil, sans utiliser le cache.
`String`	`getRegion()` Renvoie la région de l'utilisateur.
`static String`	`getScreenRecorderCommand(String remoteFilePath, ScreenRecorderOptions options)`
`RawImage`	`getScreenshot()` Prend une capture d'écran de l'appareil et la renvoie sous forme de `RawImage`.
`RawImage`	`getScreenshot(long timeout, TimeUnit unit)`
`String`	`getSerialNumber()` Renvoie le numéro de série de l'appareil.
`IDevice.DeviceState`	`getState()` Renvoie l'état de l'appareil.
`SyncService`	`getSyncService()` Renvoie un objet `SyncService` pour transférer des fichiers vers et depuis l'appareil.
`ListenableFuture<String>`	`getSystemProperty(String name)` Effectuez une requête asynchrone potentielle pour une propriété système.
`boolean`	`hasClients()` Indique si `IDevice` comporte des `Client`.
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)` Installe une application Android sur l'appareil.
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` Installe une application Android sur l'appareil.
`void`	`installPackage(String packageFilePath, boolean reinstall, String... extraArgs)` Installe une application Android sur l'appareil.
`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.
`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).
`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.
`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.
`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.
`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.
`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.
`boolean`	`isBootLoader()` Indique si l'appareil est en mode bootloader.
`boolean`	`isEmulator()` Renvoie `true` si l'appareil est un émulateur.
`boolean`	`isOffline()` Indique si l'appareil est hors connexion.
`boolean`	`isOnline()` Indique si l'appareil est prêt.
`boolean`	`isRoot()` Interroge l'état root actuel de l'appareil.
`void`	`kill(String applicationName)` Arrête une application en fonction de son nom.
`void`	`pullFile(String remote, String local)` Extrait un seul fichier.
`void`	`push(String[] local, String remote)` Envoie plusieurs fichiers ou répertoires.
`void`	`pushFile(String local, String remote)` Envoie un seul fichier.
`SocketChannel`	`rawBinder(String service, String[] parameters)` Appelez le service Android Binder Bridge sur un appareil distant.
`SocketChannel`	`rawExec(String executable, String[] parameters)` Appelez le service host:exec sur un appareil distant.
`void`	`reboot(String into)` Redémarrez l'appareil.
`void`	`removeForward(int localPort)` Supprime un transfert de port entre un port local et un port distant.
`void`	`removeRemotePackage(String remoteFilePath)` Supprime un fichier de l'appareil.
`void`	`removeReverse(int remotePort)` Supprime l'inversion de port entre un port distant et un port local.
`boolean`	`root()` Demandez au daemon adb de devenir root sur l'appareil.
`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`.
`boolean`	`supportsFeature(IDevice.HardwareFeature feature)` Indique si cet appareil est compatible avec la fonctionnalité matérielle spécifiée.
`boolean`	`supportsFeature(IDevice.Feature feature)` Indique si cet appareil est compatible avec la fonctionnalité logicielle spécifiée.
`String`	`syncPackageToDevice(String localFilePath)` Transfère un fichier sur l'appareil
`String`	`toString()`
`String`	`uninstallApp(String applicationID, String... extraArgs)` Désinstalle une application de l'appareil.
`String`	`uninstallPackage(String packageName)` Désinstalle un package de l'appareil.

Constructeurs publics

DeviceImpl

public DeviceImpl (ClientTracker clientTracer, 
                String serialNumber, 
                IDevice.DeviceState deviceState)

Paramètres
`clientTracer`	`ClientTracker`
`serialNumber`	`String`
`deviceState`	`IDevice.DeviceState`

Méthodes publiques

arePropertiesSet

public boolean arePropertiesSet ()

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

Renvoie
`boolean`

createForward

public 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
`AdbCommandRejectedException`
`TimeoutException`

createForward

public 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
`AdbCommandRejectedException`
`TimeoutException`

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
`AdbCommandRejectedException`
`TimeoutException`

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
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

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

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

maxTimeToOutputResponse est utilisé comme temps d'attente maximal lorsque la sortie de la commande est attendue de l'appareil.
À tout moment, si la commande shell ne produit rien pendant une période supérieure à maxTimeToOutputResponse, la méthode génère ShellCommandUnresponsiveException.

Pour les commandes telles que la sortie du journal, une valeur maxTimeToOutputResponse de 0 doit être utilisée, ce qui signifie que la méthode ne générera jamais d'exception et se bloquera jusqu'à ce que IShellOutputReceiver.isCancelled() du récepteur renvoie true.

Paramètres
`command`	`String` : commande shell à exécuter
`receiver`	`IShellOutputReceiver` : `IShellOutputReceiver` qui recevra la sortie de la commande shell
`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 `maxTimeToOutputResponse` non nulles.

Génère
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

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 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
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

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

Paramètres
`command`	`String`
`receiver`	`IShellOutputReceiver`
`maxTimeToOutputResponse`	`int`

Génère
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

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

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

Paramètres
`command`	`String` : commande shell à exécuter
`receiver`	`IShellOutputReceiver` : `IShellOutputReceiver` qui recevra la sortie de la commande shell
`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`.

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

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

getBatteryLevel

public Integer getBatteryLevel ()

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

getClient

public ClientImpl getClient (String applicationName)

Renvoie un Client par son nom d'application.

Paramètres
`applicationName`	`String` : nom de l'application

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

getClientName

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

getClientTracker

public ClientTracker getClientTracker ()

Renvoie
`ClientTracker`

getClients

public ClientImpl[] getClients ()

Renvoie le tableau des clients.

Renvoie
`ClientImpl[]`

getDensity

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

Renvoie un FileListingService pour cet appareil.

Renvoie
`FileListingService`

getLanguage

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

Renvoie un point de montage.

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

Renvoie
`String`

getName

public String getName ()

Renvoie un nom (humanisé) pour cet appareil. Il s'agit généralement du nom de l'AVD pour les AVD et d'une combinaison du nom du fabricant, du nom du modèle et du numéro de série pour les appareils.

Renvoie
`String`

getNativeClients

public ClientImpl[] getNativeClients ()

Renvoie
`ClientImpl[]`

getNativeClients

public ClientImpl getNativeClients (String applicationName)

Paramètres
`applicationName`	`String`

Renvoie
`ClientImpl`

getProfileableClients

public ProfileableClientImpl[] getProfileableClients ()

Renvoie le tableau des clients profilables.

Renvoie
`ProfileableClientImpl[]`

getProperties

public  getProperties ()

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

Renvoie

getProperty

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

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.

getPropertyCount

public int getPropertyCount ()

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

Renvoie
`int`

getPropertySync

public String getPropertySync (String name)

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.

getRegion

public String getRegion ()

Renvoie la région de l'utilisateur.

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

getScreenRecorderCommand

public static String getScreenRecorderCommand (String remoteFilePath, 
                ScreenRecorderOptions options)

Paramètres
`remoteFilePath`	`String`
`options`	`ScreenRecorderOptions`

Renvoie
`String`

getScreenshot

public 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
`AdbCommandRejectedException`
`TimeoutException`

getScreenshot

public RawImage getScreenshot (long timeout, 
                TimeUnit unit)

Paramètres
`timeout`	`long`
`unit`	`TimeUnit`

Renvoie
`RawImage`

Génère
`AdbCommandRejectedException`
`TimeoutException`

getSerialNumber

public String getSerialNumber ()

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

Renvoie
`String`

getState

public IDevice.DeviceState getState ()

Renvoie l'état de l'appareil.

Renvoie
`IDevice.DeviceState`

getSyncService

public 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
`AdbCommandRejectedException`
`TimeoutException`

getSystemProperty

public ListenableFuture<String> getSystemProperty (String name)

Effectuez une requête asynchrone potentielle pour une propriété système.

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

Renvoie
`ListenableFuture<String>`	Un `ListenableFuture.` `ERROR(get/Future#get() get)` peut renvoyer la valeur null.

hasClients

public boolean hasClients ()

Indique si IDevice comporte des Client.

Renvoie
`boolean`

installPackage

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

installPackage

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

installPackage

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

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`

installPackages

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

installRemotePackage

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

installRemotePackage

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

installRemotePackage

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

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`

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`

isBootLoader

public boolean isBootLoader ()

Indique si l'appareil est en mode bootloader.

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

isEmulator

public boolean isEmulator ()

Renvoie true si l'appareil est un émulateur.

Renvoie
`boolean`

isOffline

public boolean isOffline ()

Indique si l'appareil est hors connexion.

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

isOnline

public boolean isOnline ()

Indique si l'appareil est prêt.

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

isRoot

public 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
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

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 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
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

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
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

pushFile

public 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
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

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 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
`AdbCommandRejectedException`
`TimeoutException`

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
`AdbCommandRejectedException`
`TimeoutException`

removeRemotePackage

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

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
`AdbCommandRejectedException`
`TimeoutException`

racine

public 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
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

startScreenRecorder

public 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 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 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 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
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

toString

public String toString ()

Renvoie
`String`

uninstallApp

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

uninstallPackage

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