L'émulateur Android simule les appareils Android sur votre ordinateur afin que vous puissiez tester votre application sur une variété d'appareils et de niveaux d'API Android sans avoir besoin d'avoir chaque appareil physique. L'émulateur offre ces avantages : Flexibilité : En plus de pouvoir simuler une variété d'appareils et de niveaux d'API Android, l'émulateur est livré avec des configurations prédéfinies pour divers téléphones, tablettes, Wear OS et Android TV. Haute fidélité : L'émulateur fournit presque toutes les capacités d'un véritable appareil Android. Vous pouvez simuler des appels téléphoniques et des SMS entrants, spécifier l'emplacement de l'appareil, simuler différentes vitesses de réseau, simuler la rotation et d'autres capteurs matériels, accéder au Google Play Store, et bien plus encore. Vitesse : tester votre application sur l'émulateur est à certains égards plus rapide et plus facile que de le faire sur un appareil physique. Par exemple, vous pouvez transférer des données plus rapidement vers l'émulateur que vers un appareil connecté via USB Dans la plupart des cas, l'émulateur est la meilleure option pour vos besoins de test. Cette page couvre les fonctionnalités de base de l'émulateur et comment démarrer avec Vous pouvez également déployer votre application sur un appareil physique. Pour plus d'informations, voir Exécuter des applications sur un périphérique matériel ## Premiers pas avec l'émulateur L'émulateur Android vous permet de tester virtuellement votre application sur de nombreux appareils différents. L'émulateur est fourni avec Android Studio, vous n'avez donc pas besoin de l'installer séparément. Pour utiliser l'émulateur, suivez ces étapes de base, qui sont décrites plus en détail dans les sections suivantes : - Vérifiez que vous disposez de la configuration système requise - Créer un appareil virtuel Android (AVD) - Exécutez votre application sur l'émulateur - Naviguer dans l'émulateur Cette page couvre les étapes pour configurer et explorer votre environnement de test virtuel plus en détail. Si votre application s'exécute déjà sur l'émulateur et que vous êtes prêt à utiliser des fonctionnalités plus avancées, consultez Utilisation avancée de l'émulateur Si vous rencontrez des problèmes avec l'émulateur, consultez Résoudre les problèmes connus avec l'émulateur Android. En fonction de vos besoins et de vos ressources, il peut être utile de se pencher sur la configuration système requise et les configurations techniques, ou il peut être préférable d'utiliser un périphérique physique. Configuration système requise pour l'émulateur Pour une expérience optimale, vous devez utiliser l'émulateur dans Android Studio sur un ordinateur avec au moins les spécifications suivantes : - 16 Go de RAM - Système d'exploitation Windows, macOS, Linux ou Chrome OS 64 bits - 16 Go d'espace disque Si vous ne disposez pas de ces spécifications, l'émulateur peut toujours fonctionner, mais pas de manière fluide. Dans ce cas, envisagez plutôt de tester sur un périphérique physique en suivant les instructions de Exécuter des applications sur un périphérique matériel Créer un appareil virtuel Android Chaque instance de l'émulateur Android utilise un *Appareil virtuel Android (AVD)* pour spécifier la version Android et les caractéristiques matérielles de la simulation appareil. Pour tester efficacement votre application, créez un AVD qui modélise chaque appareil sur lequel votre application est conçue pour s'exécuter. Pour créer un AVD, voir Créer et gérer des appareils virtuels Chaque AVD fonctionne comme un appareil indépendant avec son propre stockage privé pour les données utilisateur, la carte SD, etc. Par défaut, l'émulateur stocke les données utilisateur, les données de la carte SD et le cache dans un répertoire spécifique à cet AVD. Lorsque vous lancez l'émulateur, il charge les données utilisateur et les données de la carte SD à partir du répertoire AVD Exécutez votre application sur l'émulateur Après avoir créé un AVD, vous pouvez démarrer l'émulateur Android et exécuter une application dans votre projet : Dans la barre d'outils, sélectionnez l'AVD sur lequel vous souhaitez exécuter votre application dans le menu de l'appareil cible Figure 1.Le menu de l'appareil cible Cliquez sur Courir. L'émulateur peut prendre environ une minute pour se lancer pour la première fois, mais les lancements suivants utilisent un instantané et devraient se lancer plus rapidement. Si vous rencontrez des problèmes, consultez le guide de dépannage Une fois votre application installée sur votre AVD, vous pouvez l'exécuter à partir de l'appareil lorsque vous exécuterait n'importe quelle application sur un appareil. Chaque fois que vous souhaitez déployer de nouvelles modifications, vous devez cliquer **Exécuter** ou **Appliquer les modifications** à nouveau Assistant d'appariement Wear OS Si vous souhaitez tester votre application avec des appareils Wear OS, l'assistant de couplage Wear OS vous guide pas à pas dans le couplage des émulateurs Wear OS avec des téléphones physiques ou virtuels directement dans Android Studio. Pour en savoir plus, consultez Utiliser l'assistant de couplage de l'émulateur Wear OS Naviguer dans l'émulateur Pendant que l'émulateur est en cours d'exécution, vous pouvez utiliser le pointeur de votre souris d'ordinateur pour imiter votre doigt sur l'écran tactile et utiliser le panneau de l'émulateur pour effectuer des actions courantes. Naviguer dans l'écran de l'émulateur Utilisez le pointeur de votre souris d'ordinateur pour imiter votre doigt sur l'écran tactile, sélectionnez les éléments de menu et les champs de saisie, puis cliquez sur les boutons et les commandes. Utilisez le clavier de votre ordinateur pour saisir des caractères et entrer des raccourcis d'émulateur **Tableau 1 Gestes de navigation dans le émulateur |Fonctionnalité||Description| |Balayer l'écran||Pointer vers l'écran, appuyer et maintenir le bouton principal de la souris, balayer l'écran, puis relâcher.| |Faites glisser un élément||Pointez sur un élément à l'écran, maintenez le bouton principal de la souris enfoncé, déplacez l'élément, puis relâchez.| |Appuyez sur||Pointez vers l'écran, appuyez sur le bouton principal de la souris, puis relâchez.| |Appuyez deux fois||Pointez sur l'écran, double-cliquez rapidement sur le bouton principal de la souris, puis relâchez.| |Touchez& maintenez||Pointez sur un élément à l'écran, appuyez sur le bouton principal de la souris, maintenez enfoncé, puis relâchez.| |Type||Vous pouvez taper dans l'émulateur en utilisant le clavier de votre ordinateur ou en utilisant un clavier qui apparaît sur l'écran de l'émulateur.Appuyez sur Contrôle (Commande sur macOS) fait apparaître un geste de pincement interface multi-touch. La souris agit comme le premier doigt, et à travers le point d'ancrage est le deuxième doigt. Faites glisser le curseur pour déplacer le premier point Cliquer sur le bouton gauche de la souris imite toucher les deux points et relâcher les mimiques ramassant les deux |Balayage vertical||Ouvrir un menu vertical à l'écran et utiliser la molette de défilement (molette de la souris) pour faire défiler les éléments du menu. Cliquez sur un élément de menu pour le sélectionner.| Effectuer des actions courantes à l'aide du panneau de l'émulateur Pour effectuer des actions courantes avec l'émulateur, utilisez la barre d'outils de l'émulateur, si vous exécutez l'émulateur dans Android Studio, ou le panneau sur le côté droit, si vous exécutez l'émulateur dans une fenêtre en dehors d'Android Studio. Le tableau 2 décrit les actions courantes de l'émulateur et les boutons associés Vous pouvez utiliser des raccourcis clavier pour effectuer de nombreuses actions courantes dans l'émulateur Pour une liste complète des raccourcis dans l'émulateur, appuyez sur `F1` ( `Command`+sur macOS) pour ouvrir le volet Aide dans le Étendu contrôles fenêtre. **Tableau 2 Actions courantes dans l'émulateur |Fonctionnalité||Description| |Fermer | |Fermer l'émulateur.| |Réduire | |Réduire la fenêtre de l'émulateur.| |Redimensionner||Redimensionnez l'émulateur comme vous le feriez pour n'importe quelle autre fenêtre du système d'exploitation. L'émulateur conserve un format d'image adapté à votre appareil.| |Puissance | |Cliquez pour allumer ou éteindre l'écran | Cliquez et maintenez enfoncé pour allumer ou éteindre l'appareil |Augmenter le volume | |Cliquez pour afficher un curseur et augmenter le volume. Cliquez à nouveau pour augmenter le volume ou utilisez le curseur pour modifier le volume.| |Baisser le volume | |Cliquez pour afficher un curseur et baisser le volume. Cliquez à nouveau pour le baisser davantage ou utilisez le curseur pour modifier le volume.| |Pivoter à gauche | |Faites pivoter l'appareil de 90 degrés dans le sens inverse des aiguilles d'une montre.| |Pivoter à droite | |Faites pivoter l'appareil de 90 degrés dans le sens des aiguilles d'une montre.| |Faire une capture d'écran | |Cliquez pour prendre une capture d'écran de l'appareil.Cliquez pour changer le curseur en icône de zoom. Pour quitter le mode zoom, cliquez à nouveau sur le bouton Pour effectuer un zoom avant et arrière en mode zoom : Pour effectuer un panoramique en mode zoom, maintenez Pour appuyer sur l'écran de l'appareil en mode zoom, |Retour | |Revenir à l'écran précédent ou fermer une boîte de dialogue, un menu d'options, le panneau Notifications ou le clavier à l'écran.| |Accueil | |Revenir à l'écran d'accueil.Aperçu (Applications récentes) |Appuyez pour ouvrir une liste d'images miniatures des applications avec lesquelles vous avez travaillé récemment. Pour ouvrir une application, appuyez sur sa miniature. Pour supprimer une vignette de la liste, balayez-la vers la gauche ou vers la droite. Ce bouton n'est pas compatible avec Wear OS.| |Plier | |Pour les appareils pliables, pliez l'appareil pour afficher sa configuration d'écran plus petite.| |Déplier | |Pour les appareils pliables, dépliez l'appareil pour afficher sa configuration d'écran plus grande.| |Bouton 1 | |Pour les appareils Wear, appuyez sur le bouton 1 de l'appareil. Uniquement disponible sur les appareils Wear exécutant le niveau d'API 28 ou supérieur.| |Bouton 2 | |Pour les appareils Wear, appuyez sur le bouton 2 de l'appareil. Uniquement disponible sur les appareils Wear exécutant le niveau d'API 30 ou supérieur.| |Paume | |Pour les appareils Wear, appuyez votre paume sur l'écran de l'appareil. Cela règle votre appareil en mode ambiant. Uniquement disponible sur les appareils Wear exécutant le niveau d'API 28 ou supérieur.| |Inclinaison | |Pour les appareils Wear, inclinez l'appareil. Ceci quitte le mode ambiant. Uniquement disponible sur les appareils Wear exécutant le niveau d'API 28 ou supérieur.| |Menu||Appuyer |Control+ M ( Command+ M sur macOS) pour simuler le bouton Menu |Plus | |Cliquez pour accéder aux autres fonctionnalités et paramètres.| ## Mettre à jour l'émulateur Pour mettre à jour l'émulateur Android, sélectionnez le Composant **Émulateur Android** dans l'onglet **Outils SDK** du **Gestionnaire SDK Pour obtenir des instructions, consultez Mettez à jour vos outils à l'aide du SDK Manager.