Gestion des appareils virtuels avec l’Gestionnaire de périphériques Android
Cet article décrit comment utiliser Android Device Manager pour créer et configurer des appareils virtuels Android (AVD) qui émulent des appareils physiques Android. Vous pouvez utiliser ces appareils virtuels pour exécuter et tester votre application sans avoir à dépendre d’un appareil physique. Pour plus d’informations sur les appareils virtuels Android, consultez Créer et gérer des appareils virtuels sur developer.android.com.
Important
Activez l’accélération matérielle pour les appareils Android. Pour plus d’informations, consultez Accélération matérielle pour les performances de l’émulateur.
Android Device Manager sur Windows
Vous utilisez l’Gestionnaire de périphériques Android pour créer et configurer un appareil virtuel Android (AVD) qui s’exécute dans l’émulateur Android. Chaque AVD est une configuration d’émulateur qui simule un appareil Android physique. Vous pouvez ainsi exécuter et tester votre application dans diverses configurations qui simulent différents appareils Android physiques.
Spécifications
Pour utiliser l’Gestionnaire de périphériques Android, vous aurez besoin des éléments suivants :
Visual Studio 2022 : Les éditions Community, Professional et Enterprise sont prises en charge.
API Android SDK Level 30 ou version ultérieure. Veillez à installer le Kit de développement logiciel (SDK) Android à son emplacement par défaut s’il n’est pas déjà installé : C :\Program Files (x86)\Android\android-sdk.
Les packages suivants doivent être installés :
- Android SDK Tools 5.0 ou version ultérieure
- Android SDK Platform-Tools 31.0.3 ou version ultérieure
- Android SDK Build-Tools 30.0.2 ou version ultérieure
- Émulateur Android 30.8.4 ou version ultérieure
Ces paquets doivent être affichés avec l’état Installé, comme illustré dans la capture d’écran suivante :
Lorsque vous installez la charge de travail de développement de l’interface utilisateur de l’application multiplateforme .NET dans Visual Studio, tout est installé pour vous. Pour plus d’informations sur la configuration de .NET MAUI avec Visual Studio, consultez Générer votre première application.
Ouvrir le gestionnaire d’appareils
Ouvrez le Gestionnaire de périphériques Android dans Visual Studio à partir du menu Outils en appuyant sur Outils > Android > Gestionnaire de périphériques :
Écran principal
Lorsque vous exécutez le Gestionnaire de périphériques Android, il présente un écran qui affiche tous les appareils virtuels actuellement configurés. Pour chaque appareil virtuel, le Nom, l’OS (version d’Android), le Processeur, la quantité de Mémoire, ainsi que la Résolution d’écran sont affichés :
Quand vous sélectionnez un appareil dans la liste, le bouton Démarrer apparaît à droite. Appuyez sur le bouton Démarrer pour lancer l’émulateur avec cet appareil virtuel. Si l’émulateur s’exécute avec l’appareil virtuel sélectionné, le bouton Démarrer passe à un bouton Arrêter que vous pouvez utiliser pour arrêter l’émulateur.
Créer un appareil
Pour créer un appareil, appuyez sur le bouton Nouveau :
La fenêtre Nouvel appareil s’affiche. Pour configurer l’appareil, procédez comme suit :
Donnez un nouveau nom à l’appareil. Dans l’exemple suivant, le nouvel appareil est nommé Pixel 3a - API 31.
Sélectionnez un appareil physique à émuler en sélectionnant un appareil dans la zone Appareil de base.
Sélectionnez un type de processeur pour cet appareil virtuel avec la zone Processeur .
Il est recommandé de choisir x86_64 et d’activer l’accélération matérielle.
Sélectionnez la version Android (niveau API) avec la zone système d’exploitation .
Si vous sélectionnez un niveau d’API Android qui n’a pas encore été installé, l’Gestionnaire de périphériques affiche un message de téléchargement d’un nouvel appareil en bas de l’écran. Il télécharge et installe les fichiers nécessaires lors de la création de l’appareil virtuel.
Si vous souhaitez inclure des API Google Play Services dans votre appareil virtuel, sélectionnez l’option API Google. Pour inclure l’application Google Play Store sur l’appareil virtuel, sélectionnez l’option Google Play Store
Remarque
Les images Google Play Store sont disponibles uniquement pour certains types d’appareils de base tels que Pixel, Pixel 2, Pixel 3 et Nexus 5. Cela est indiqué par le texte
(+ Store)du nom de l’image.Utilisez la liste des propriétés pour modifier certaines des propriétés les plus couramment modifiées. Pour apporter des modifications aux propriétés, consultez Modification des propriétés d’appareil virtuel Android.
Ajoutez toutes les propriétés supplémentaires que vous devez définir explicitement avec la zone Ajouter une propriété en bas de la fenêtre :
Vous pouvez également définir une propriété personnalisée en sélectionnant Custom....
Appuyez sur le bouton Créer pour créer le nouvel appareil :
Vous pouvez obtenir un écran d’acceptation de licence lorsque vous créez l’appareil. Sélectionnez Accepter si vous acceptez les termes du contrat de licence.
Android Device Manager ajoute le nouvel appareil à la liste des appareils virtuels installés et affiche un indicateur de progression Création en cours pendant la création de l’appareil :
Une fois le processus de création terminé, le nouvel appareil apparaît dans la liste des appareils virtuels installés avec un bouton Démarrer , prêt à être lancé
Modifier l’appareil
Pour modifier un appareil virtuel existant, sélectionnez l’appareil, puis appuyez sur le bouton Modifier :
Appuyez sur Modifier pour afficher la fenêtre Éditeur d’appareil pour l’appareil virtuel sélectionné.
La fenêtre Éditeur d’appareil répertorie les propriétés de l’appareil virtuel sous la colonne Propriété , avec les valeurs correspondantes de chaque propriété dans la colonne Valeur . Lorsque vous sélectionnez une propriété, une description détaillée de cette propriété s’affiche à droite.
Pour changer une propriété, modifiez sa valeur dans la colonne Valeur. Par exemple, dans la capture d’écran suivante, la hw.lcd.density propriété est modifiée à 240 :
Une fois que vous avez apporté les modifications de configuration nécessaires, appuyez sur le bouton Enregistrer . Pour plus d’informations sur la modification des propriétés des appareils virtuels, consultez Modification des propriétés d’appareil virtuel Android.
Options supplémentaires
Des options supplémentaires pour l’utilisation des appareils sont disponibles dans le menu déroulant Options supplémentaires (...) :
Le menu Options supplémentaires contient les éléments suivants :
Dupliquer et modifier : dupliquer l’appareil actuellement sélectionné et l’ouvre dans l’écran Nouvel appareil avec un nouveau nom similaire à l’appareil existant. Par exemple, la sélection de Pixel 3a - API 31 et l’appui sur Dupliquer et Modifier ajoute un compteur au nom : Pixel 3a - API 31 (1).
Démarrer avec les paramètres d’usine par défaut : démarre l’appareil avec un démarrage à froid.
Commencez par les journaux du noyau : démarre l’émulateur et ouvre le répertoire des journaux du noyau.
Télécharger l’image système : télécharge l’image système du système d’exploitation Android pour l’appareil, si elle n’est pas déjà téléchargée.
Révéler dans l’Explorateur : ouvre l’Explorateur Windows et accède au dossier contenant les fichiers de l’appareil virtuel.
Réparation : lance une réparation sur l’appareil.
Réinitialisation aux paramètres d’usine : réinitialise l’appareil sélectionné à ses paramètres par défaut, ce qui efface les modifications apportées à l’état interne de l’appareil pendant son exécution. Cette action efface également le démarrage rapide actuel instantané s’il existe. Cette modification ne modifie pas les modifications que vous apportez à l’appareil virtuel lors de la création et de la modification. Une boîte de dialogue s’affiche avec le rappel indiquant que cette réinitialisation ne peut pas être annulée : appuyez sur Réinitialisation d’usine pour confirmer la réinitialisation.
Delete : supprime définitivement l’appareil virtuel sélectionné. Une boîte de dialogue rappelant que la suppression d’un appareil ne peut pas être annulée s’affiche. Appuyez sur Supprimer si vous êtes certain que vous souhaitez supprimer l’appareil.
Dépannage
Les sections suivantes expliquent comment diagnostiquer et résoudre les problèmes qui peuvent se produire quand vous utilisez Android Device Manager pour configurer les appareils virtuels.
Version incorrecte des outils du Kit de développement logiciel (SDK) Android
Si vous avez installé les outils android SDK incorrects, installés, cette boîte de dialogue d’erreur peut s’afficher lors du lancement :
Si vous voyez cette boîte de dialogue d’erreur, appuyez sur Open SDK Manager pour ouvrir le Gestionnaire android SDK. Dans le Gestionnaire du Kit de développement logiciel (SDK) Android, accédez à l’onglet Outils et installez les packages suivants :
- Outils en ligne de commande android SDK 5.0 ou version ultérieure
- Android SDK Platform-Tools 31.0.3 ou version ultérieure
- Android SDK Build-Tools 30.0.3 ou version ultérieure
Capture instantanée désactive le Wi-Fi sur Android Oreo
Si vous avez configuré AVD pour Android Oreo avec un accès Wi-Fi simulé, le redémarrage de l’AVD après un instantané peut entraîner la désactivation de l’accès Wi-Fi.
Pour éviter ce problème,
Ouvrez le Gestionnaire de périphériques Android.
Sélectionnez l’AVD dans Android Device Manager.
Dans le menu Options supplémentaires (...) , sélectionnez Révéler dans l’Explorateur.
Accédez au dossier default_boot des instantané>.
Supprimer le fichier snapshot.pb :
Redémarrez l'AVD.
Une fois ces modifications apportées, l’AVD sera redémarré dans un état qui permet au Wi-Fi de fonctionner à nouveau.
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour