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

IShellEnabledDevice

public interface IShellEnabledDevice

com.android.ddmlib.IShellEnabledDevice

Sous-classes indirectes connues

DeviceImpl, DeviceManager.FastbootDevice, IDevice, NullDevice, RemoteAvdIDevice, StubDevice, StubLocalAndroidVirtualDevice, VmRemoteDevice

DeviceImpl	Un appareil.
DeviceManager.FastbootDevice	Représentation d'un appareil en mode Fastboot.
IDevice	Un appareil.
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`
StubDevice	Implémentation de l'espace réservé stub d'un `IDevice`.
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.

Appareil abstrait pouvant recevoir des commandes shell.

Résumé

Méthodes publiques
`abstract 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`.
`abstract 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`.
`abstract String`	`getName()` Renvoie un nom (humanisé) pour cet appareil.
`abstract ListenableFuture<String>`	`getSystemProperty(String name)` Effectuez une requête asynchrone potentielle pour une propriété système.

Méthodes publiques

executeShellCommand

public abstract 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
`TimeoutException`	en cas de délai d'expiration de la connexion lors de l'envoi de la commande.
`AdbCommandRejectedException`	si adb rejette la commande.
`ShellCommandUnresponsiveException`	si la commande shell n'envoie aucune sortie pendant une période supérieure à `maxTimeToOutputResponse`.
	en cas d'erreur d'E/S sur la connexion.

Voir aussi :

DdmPreferences.getTimeOut()

executeShellCommand

public abstract 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
`TimeoutException`	en cas de délai d'expiration de la connexion lors de l'envoi de la commande.
`AdbCommandRejectedException`	si adb rejette la commande.
`ShellCommandUnresponsiveException`	si la commande shell n'envoie aucune sortie pendant une période supérieure à `maxTimeToOutputResponse`.
	en cas d'erreur d'E/S sur la connexion.

Voir aussi :

DdmPreferences.getTimeOut()

getName

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

getSystemProperty

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