avdmanager

avdmanager est un outil de ligne de commande qui vous permet de créer et de gérer des appareils virtuels Android à partir de la ligne de commande. Un appareil virtuel Android (ou AVD) vous permet de définir les caractéristiques d'un téléphone Android, d'une montre Wear OS ou d'un appareil Android TV que vous souhaitez simuler dans Android Emulator.

Si vous utilisez Android Studio, vous n'avez pas besoin d'utiliser cet outil. À la place, vous pouvez créer et gérer des AVD à partir de l'IDE.

L'outil avdmanager est inclus dans le package d'outils de ligne de commande du SDK Android sur android_sdk/cmdline-tools/version/bin/avdmanager.

Syntaxe

Pour utiliser avdmanager, respectez la syntaxe suivante :

avdmanager [global options] command [command options]

Options générales

Tableau 1. Liste des options globales pour avdmanager

Option globale Description
-s | --silent Mode silencieux : seules les erreurs s'affichent.
-h | --help Aide sur l'utilisation
-v | --verbose Mode détaillé : les erreurs, les avertissements et les messages d'information s'affichent.
--clear cache Videz le cache du fichier manifeste du dépôt SDK Manager.

Commandes et options de commande

Tableau 2. Liste des commandes et des options pour avdmanager

Commande et options Description
create avd -n name -k "sdk_id" [-c {path|size}] [-f] [-p path]

Créez un nouvel appareil virtuel Android. Vous devez définir une variable name pour l'appareil virtuel Android et spécifier l'ID du package du SDK à utiliser pour l'appareil à l'aide d'une variable sdk_id encadrée par des guillemets. Par exemple, la commande suivante crée un appareil virtuel Android nommé test à l'aide de l'image système x86 pour le niveau d'API 25 :

avdmanager create avd -n test -k "system-images;android-25;google_apis;x86"
Voici une description des utilisations des autres options :
  • -c {path|size} : chemin d'accès à l'image de carte SD correspondant à cet appareil virtuel Android, ou taille de la nouvelle image de carte SD à créer pour cet appareil, exprimée en Ko ou Mo. Elle est indiquée par l'icôneK ou M. Par exemple, -c path/to/sdcard/ ou -c 1000M.
  • -f : force la création de l'appareil virtuel Android. Utilisez cette option si vous devez écraser un appareil virtuel Android existant avec un nouvel appareil portant le même nom.
  • -p path : chemin d'accès à l'emplacement où le répertoire des fichiers de cet appareil virtuel Android sera créé. Si vous ne spécifiez pas de chemin, l'AVD est créé dans ~/.android/avd/.
delete avd -n name Supprimez un appareil virtuel Android. Vous devez spécifier l'appareil virtuel Android avec name.
move avd -n name [-p path] [-r new-name] Déplacez ou renommez un AVD. Vous devez spécifier l'appareil virtuel Android avec name. Vous trouverez ci-dessous les utilisations des autres options :
  • -p path : chemin d'accès absolu à l'emplacement où créer le répertoire vers lequel les fichiers de cet appareil virtuel Android seront déplacés. Si vous n'incluez pas cet argument, l'AVD ne sera pas déplacé. Vous pouvez choisir de ne pas inclure cet argument si vous souhaitez simplement renommer l'appareil virtuel Android.
  • -r new-name : nouveau nom du fichier AVD.
list [target|device|avd] [-c] Répertoriez l'ensemble des cibles, des définitions d'appareils ou des appareils virtuels Android disponibles. Si vous ne spécifiez pas target, device ni avd, avdmanager répertorie les trois. Incluez l'argument -c pour recevoir une sortie compacte adaptée aux scripts. L'argument -c n'est pas disponible lorsque vous répertoriez les trois options ensemble.