À 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 dans AOSP, utilisez android-latest-release. 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.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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(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`	`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`	`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, 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.
`List<String>`	`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.
`Future<Integer>`	`getBattery(long freshnessTime, TimeUnit timeUnit)` Renvoie le niveau de batterie de l'appareil, de 0 à 100 %.
`Future<Integer>`	`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 %.
`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 la dernière installation sur cet appareil.
`String`	`getMountPoint(String name)` Renvoie un point de montage.
`String`	`getName()` Renvoie un nom (humanisé) pour cet appareil.
`Map<String, String>`	`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 `getSystemProperty(String)` avec un temps d'attente très court et qui ignore les exceptions.
`String`	`getPropertyCacheOrSync(String name)` Combinaison de `getProperty(String)` et `getPropertySync(String)` qui tentera 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 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.
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` Installe une application Android sur l'appareil.
`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, String... extraArgs)` Installe une application Android sur l'appareil.
`void`	`installPackages(List<File> apks, boolean reinstall, List<String> 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`	`installPackages(List<File> apks, boolean reinstall, List<String> installOptions)` Installe une application Android composée de plusieurs fichiers APK (un fichier principal et 0 à n packages divisés) avec le délai d'attente par défaut.
`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(List<String> remoteApks, boolean reinstall, List<String> installOptions, long timeout, TimeUnit timeoutUnit)` Installe une application Android composée de plusieurs fichiers APK situés localement sur l'appareil.
`void`	`installRemotePackages(List<String> remoteApks, boolean reinstall, List<String> 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.
`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 `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 vers 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 (String serialNumber, 
                IDevice.DeviceState deviceState)

Paramètres
`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`
`IOException`
`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`
`IOException`
`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`
`IOException`
`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 le résultat de la commande shell

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

executeShellCommand

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

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

Génère
`AdbCommandRejectedException`
`IOException`
`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.

maxTimeToOutputResponse est utilisé comme temps d'attente maximal lorsque le résultat de la commande est attendu de l'appareil.
À tout moment, si la commande shell ne produit aucun résultat 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, ce qui signifie que la méthode ne générera jamais d'exception et bloquera jusqu'à ce que IShellOutputReceiver.isCancelled() du récepteur renvoie true, doit être utilisée.

Paramètres
`command`	`String` : commande shell à exécuter
`receiver`	`IShellOutputReceiver` : `IShellOutputReceiver` qui recevra le résultat 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 pas générer de résultat. Une valeur de 0 signifie que la méthode attendra indéfiniment (jusqu'à ce que `receiver` annule l'exécution) le résultat 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`
`IOException`
`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`
`IOException`
`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.

Paramètres
`command`	`String` : commande shell à exécuter
`receiver`	`IShellOutputReceiver` : `IShellOutputReceiver` qui recevra le résultat de la commande shell
`maxTimeToOutputResponse`	`long` : durée maximale pendant laquelle la commande est autorisée à ne pas générer de résultat. Une valeur de 0 signifie que la méthode attendra indéfiniment (jusqu'à ce que `receiver` annule l'exécution) le résultat 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`
`IOException`
`ShellCommandUnresponsiveException`
`TimeoutException`

forceStop

public void forceStop (String applicationName)

Forcez l'arrêt d'une application en indiquant son nom. Cela supprime toutes les alarmes en attente et le calcul mis en file d'attente.

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

getAbis

public List<String> 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
`List<String>`	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 à l'AVD ou à la valeur "null" si l'appareil est 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 "/" sur Linux et des séparateurs "\" sur 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 Future<Integer> 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` : `TimeUnit` de freshnessTime

Renvoie
`Future<Integer>`	`Future` pouvant être utilisé pour interroger le niveau de batterie. L'avenir renverra un `ExecutionException` si le niveau de batterie n'a pas pu être récupéré.

getBattery

public Future<Integer> getBattery ()

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 cinq minutes se sont écoulées depuis la dernière requête réussie.

Renvoie
`Future<Integer>`	`Future` pouvant être utilisé pour interroger le niveau de batterie. L'avenir renverra un `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 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. Interroge l'appareil sur le niveau de sa batterie uniquement 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é.

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 la dernière installation 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`

getProperties

public Map<String, String> getProperties ()

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

Renvoie
`Map<String, String>`

getProperty

public String getProperty (String name)

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

Remarque : Nous vous recommandons d'utiliser 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 tentera de récupérer la propriété à partir du cache. Si elle n'est pas trouvée, une tentative synchrone sera effectuée pour interroger directement l'appareil et repopuler le cache 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 `null` en cas de problème.

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

getScreenshot

public RawImage getScreenshot (long timeout, 
                TimeUnit unit)

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

Renvoie
`RawImage`

Génère
`AdbCommandRejectedException`
`IOException`
`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`
`IOException`
`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.` `get` peut renvoyer la valeur "null".

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 à installer sur l'hôte local
`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, 
                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 à installer sur l'hôte local
`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 pas générer de résultat. Une valeur de 0 signifie que la méthode attendra indéfiniment (jusqu'à ce que `receiver` annule l'exécution) le résultat 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, 
                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 à installer sur l'hôte local
`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 (List<File> apks, 
                boolean reinstall, 
                List<String> 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`	`List` : 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`	`List` : 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` : `TimeUnit` correspondant au paramètre de délai d'inactivité

Génère
`InstallException`

installPackages

public void installPackages (List<File> apks, 
                boolean reinstall, 
                List<String> installOptions)

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

Paramètres
`apks`	`List` : 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`	`List` : 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, 
                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 pas générer de résultat. Une valeur de 0 signifie que la méthode attendra indéfiniment (jusqu'à ce que `receiver` annule l'exécution) le résultat 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 (List<String> remoteApks, 
                boolean reinstall, 
                List<String> installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

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

Paramètres
`remoteApks`	`List` : 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`	`List` : 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` : `TimeUnit` correspondant au paramètre de délai d'inactivité

Génère
`InstallException`

installRemotePackages

public void installRemotePackages (List<String> remoteApks, 
                boolean reinstall, 
                List<String> 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`	`List` : 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`	`List` : 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`
`IOException`
`ShellCommandUnresponsiveException`
`TimeoutException`

kill

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

transmettre

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

reboot

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

racine

public boolean root ()

Demandez au daemon adb de devenir root sur l'appareil. Cette opération peut échouer sans message d'erreur 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`
`IOException`
`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 Feature.SCREEN_RECORD.

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

Génère
`AdbCommandRejectedException`
`IOException`
`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 vers 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`
`IOException`
`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 d'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 d'application Android à désinstaller

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

Génère
`InstallException`