À partir du 27 mars 2025, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main pour créer et contribuer à AOSP. Pour en savoir plus, consultez la section Modifications apportées à AOSP.

Cette page a été traduite par l'API Cloud Translation.

StubDevice

public class StubDevice
extends Object implements IDevice

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

Sous-classes directes connues

DeviceManager.FastbootDevice, NullDevice, RemoteAvdIDevice, StubLocalAndroidVirtualDevice, VmRemoteDevice

DeviceManager.FastbootDevice	Représentation d'un appareil en mode Fastboot.
NullDevice	Espace réservé `IDevice` utilisé par `DeviceManager` pour allouer lorsque `IDeviceSelection.nullDeviceRequested()` est `true`
RemoteAvdIDevice	Espace réservé `IDevice` utilisé par `DeviceManager` pour allouer lorsque `DeviceSelectionOptions.gceDeviceRequested()` est `true`
StubLocalAndroidVirtualDevice	Espace réservé `IDevice` utilisé par `DeviceManager` pour allouer lorsque `DeviceSelectionOptions.localVirtualDeviceRequested()` est `true`
VmRemoteDevice	Un appareil virtuel à distance que nous allons gérer depuis la machine virtuelle.

Implémentation de l'espace réservé stub d'un IDevice.

Résumé

Constructeurs publics
`StubDevice(String serial)`
`StubDevice(String serial, boolean isEmulator)`

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`	`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)` 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)` Cette méthode est obsolète. utiliser `executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit)`.
`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`.
	`getAbis()` Renvoie les ABI compatibles avec cet appareil.
`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)` Cette méthode est obsolète. Utilisez plutôt `getBattery(long, TimeUnit)`.
`Integer`	`getBatteryLevel()` Cette méthode est obsolète. Utilisez plutôt `getBattery()`.
`Client`	`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.
`Client[]`	`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.
`String`	`getMountPoint(String name)` Renvoie un point de montage.
`String`	`getName()` Renvoie un nom (humanisé) pour cet appareil.
	`getProperties()` Cette méthode est obsolète. Utilisez plutôt `getSystemProperty(String)`.
`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)` Cette méthode est obsolète. Utilisez plutôt `getProperty(String)`.
`int`	`getPropertyCount()` Cette méthode est obsolète. Obsolète dans ddmlib avec "détail d'implémentation" comme motif.
`String`	`getPropertySync(String name)` Cette méthode est obsolète. Utilisez plutôt `getProperty(String)`.
`String`	`getRegion()` Renvoie la région de l'utilisateur.
`RawImage`	`getScreenshot()` Prend une capture d'écran de l'appareil et la renvoie sous la forme d'un `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( apkFilePaths, boolean reinstall, extraArgs, long timeOutInMs, TimeUnit timeunit)` 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.
`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`	`pullFile(String remote, String local)` Extrait un seul fichier.
`void`	`pushFile(String local, String remote)` Envoie un seul fichier.
`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`	`removeForward(int localPort, int remotePort)`
`void`	`removeForward(int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)`
`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`	`setSerial(String serial)`
`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 arg0)` 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`	`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

StubDevice

public StubDevice (String serial)

Paramètres
`serial`	`String`

StubDevice

public StubDevice (String serial, 
                boolean isEmulator)

Paramètres
`serial`	`String`
`isEmulator`	`boolean`

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`

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)

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)

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

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`

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.

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)

Cette méthode est obsolète.
utilisez plutôt 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
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getBatteryLevel

public Integer getBatteryLevel ()

Cette méthode est obsolète.
utilisez plutôt 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 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 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 Client[] getClients ()

Renvoie le tableau des clients.

Renvoie
`Client[]`

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

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`

getProperties

public  getProperties ()

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

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)

Cette méthode est obsolète.
utilisez plutôt getProperty(String).

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

getPropertyCount

public int getPropertyCount ()

Cette méthode est obsolète.
deprecated in ddmlib with "implementation detail" as reason.

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

Renvoie
`int`

getPropertySync

public String getPropertySync (String name)

Cette méthode est obsolète.
utilisez plutôt getProperty(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
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

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

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 ( apkFilePaths, 
                boolean reinstall, 
                 extraArgs, 
                long timeOutInMs, 
                TimeUnit timeunit)

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

Paramètres
`apkFilePaths`	: 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
`extraArgs`	: arguments supplémentaires facultatifs à transmettre. Consultez "adb shell pm install --help" pour connaître les options disponibles.
`timeOutInMs`	`long` : délai d'installation
`timeunit`	`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`

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`

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`

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`

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`

removeForward

public void removeForward (int localPort, 
                int remotePort)

Paramètres
`localPort`	`int`
`remotePort`	`int`

Génère
`AdbCommandRejectedException`
`TimeoutException`

removeForward

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

Paramètres
`localPort`	`int`
`remoteSocketName`	`String`
`namespace`	`IDevice.DeviceUnixSocketNamespace`

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`

setSerial

public void setSerial (String serial)

Paramètres
`serial`	`String`

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

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

Paramètres
`arg0`	`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`

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`