Tutoriel .NET MAUI – Créez votre première application multiplateforme en C#

Vous pouvez décider de déployer sur une ou plusieurs des plateformes en fonction de votre environnement de développement. Vous venez d’exécuter et de déployer votre application sur Windows. À présent, nous allons configurer un appareil ou un émulateur Android.

Activez Hyper-V

Dans votre barre de Windows Search, tapez fonctionnalités Windows et sélectionnez Activer ou désactiver les fonctionnalités Windows.

Vérifiez que la case Hyper-V est cochée et sélectionnez OK.

Vous devez redémarrer votre machine pour que la modification prenne effet.

Installation de Android SDK

Ouvrez Visual Studio et votre solution MyFirstMauiApp. Dans le menu déroulant de la cible de débogage, sélectionnez net8.0-android sous Framework.

Des versions spécifiques d’Android SDK sont nécessaires pour créer des projets. Si vous n'avez pas accepté la licence du SDK Android, le message d'erreur suivant s'affiche dans la fenêtre Liste d’erreurs.

Double-cliquez sur le message pour démarrer le processus d'acceptation de la licence. Cliquez sur Accepter pour chacune des licences présentes et l'installation automatique commencera.

Configurer l’émulateur Android

Si vous n'avez pas d'appareil Android sur lequel effectuer le déploiement, vous pouvez suivre ces étapes pour configurer un émulateur Android. Si vous l'avez déjà fait ou si vous souhaitez utiliser votre propre appareil Android, vous pouvez ignorer cette étape.

Si c'est la première fois que vous créez une application .NET MAUI, vous verrez Émulateur Android sélectionné dans le menu déroulant de la cible de débogage. Cliquez dessus pour démarrer le processus de création. Si une boîte de dialogue d'acceptation de licence s'affiche, sélectionnez Accepter.

Cela fait apparaître la fenêtre Nouvel appareil. Sélectionnez le bouton Créer pour créer un émulateur avec les paramètres par défaut. Cela téléchargera les images de l'émulateur et finalisera la création de l'émulateur à utiliser dans Visual Studio. Cette étape peut prendre un certain temps.

Ne vous inquiétez pas si le niveau d’API que vous voyez est différent des images. Cela doit être de 33 ou plus.

Une fois l’émulateur créé, un bouton indiquant Démarrer s’affiche. Cliquez dessus.

Vous pouvez être invité à activer la plate-forme de l’hyperviseur Windows. Suivez ladocumentation pour activer l’accélération afin d’améliorer les performances (nécessaire pour que l’émulateur soit opérationnel). Sélectionnez Run Anyway.

L’Émulateur Android sera lancé et sera entièrement terminé lorsque vous verrez la possibilité de Arrêter dans le Gestionnaire d’appareils Android. Cette opération peut prendre un certain temps.

Une fois l’opération terminée, elle s’affiche dans le menu de débogage Visual Studio.

Votre émulateur Android est maintenant créé et prêt à être utilisé. La prochaine fois que vous exécuterez Visual Studio, l'émulateur apparaîtra directement dans la fenêtre cible de débogage et démarrera lorsque vous le sélectionnerez. Si vous rencontrez des problèmes ou rencontrez des problèmes de performances avec l'émulateur, lisez la documentation d'installation complète.

Configurer un appareil Android

Pour développer avec votre appareil Android, le débogage USB doit être activé. Suivez ces étapes sur l’appareil pour le connecter à Visual Studio. Si vous n’avez pas d’appareil Android, vous pouvez ignorer cette section.

Activer le mode développeur

1. Accédez à l’écran Paramètres.
2. Trouvez le numéro de build en utilisant la recherche en haut de l'écran des paramètres, ou localisez-le dans À propos du téléphone.
3. Appuyez sur numéro de build 7 à 10 fois jusqu’à ce que \ "vous êtes maintenant un développeur ! " s’affiche.

Vérifier l’état du débogage USB

1. Accédez à l’écran Paramètres.
2. Trouvez le débogage USB en utilisant la recherche en haut de l'écran des paramètres, ou localisez-le dans les options du développeur.
3. Activez le débogage USB s’il n’est pas déjà activé.

Approuver l’appareil

1. Branchez votre appareil à votre ordinateur.
2. Vous êtes invité à Autoriser le débogage USB.
3. Cochez Toujours autoriser à partir de cet ordinateur.
4. Cliquez sur Autoriser.

Votre appareil est désormais configuré et s’affichera dans Visual Studio en tant que cible de déploiement.

Vous rencontrez des problèmes ? Consultez la documentation.

Votre émulateur ou appareil doit maintenant être configuré pour le déploiement !

Exécuter sur Android

Assurez-vous que votre appareil ou émulateur est sélectionné comme cible de débogage.

Dans le menu, sélectionnez Débogage > Commencer le débogage (ou appuyez sur F5). Si cette option est désactivée, vérifiez qu’un émulateur ou un appareil est sélectionné.

Votre application sera créée, déployée sur l'appareil/l'émulateur Android sélectionné et exécutée.