Créez votre première application

Dans ce tutoriel, vous allez créer votre première application .NET MAUI dans Visual Studio 2022 et l’exécuter sur un émulateur Android :

Le développement d’applications .NET MAUI pour iOS sur Windows nécessite un hôte de build Mac. Si vous n’avez pas spécifiquement besoin de cibler iOS et que vous n’avez pas de Mac, il peut être préférable de commencer plutôt avec Android ou Windows.

Dans ce tutoriel, vous allez créer votre première application .NET MAUI dans Visual Studio 2022 et l’exécuter sur un émulateur iOS :

Dans ce tutoriel, vous allez créer votre première application .NET MAUI dans Visual Studio 2022 et l’exécuter sur Windows :

1. Lancez Visual Studio 2022. Dans la fenêtre de démarrage, cliquez sur Create a new project pour créer un projet :

   

2. Dans la fenêtre Create a new project, sélectionnez MAUI dans la liste déroulante All project types, sélectionnez le modèle .NET MAUI App, puis cliquez sur le bouton Next :

   

3. Dans la fenêtre Configure your new project, nommez votre projet, choisissez un emplacement approprié et cliquez sur le bouton Next :

   

4. Dans la fenêtre Additional information, choisissez la version de .NET que vous souhaitez cibler, puis cliquez sur le bouton Create :

   

5. Attendez que le projet soit créé et que ses dépendances soient restaurées :

   

6. Dans la barre d’outils Visual Studio, utilisez la liste déroulante Debug Target pour sélectionner Android Emulators, puis l’entrée Android Emulator :

   

7. Dans la barre d’outils Visual Studio, appuyez sur le bouton Android Emulator :

   

   Visual Studio démarre le processus d’installation du SDK Android et de l’émulateur Android par défaut.

8. Dans la fenêtre Android SDK - License Agreement, appuyez sur le bouton Accept :

   

9. Dans la boîte de dialogue User Account Control, appuyez sur le bouton Yes :

   

   Attendez que Visual Studio télécharge le SDK Android et l’émulateur Android par défaut.

10. Dans la boîte de dialogue User Account Control, appuyez sur le bouton Yes :

    

11. Dans la boîte de dialogue Android SDK Platform is missing, appuyez sur le bouton Install :

    

12. Dans la fenêtre Android SDK - License Agreement, appuyez sur le bouton Accept :

    

    Attendez que Visual Studio installe les composants du SDK Android.

13. Dans la fenêtre New Device, appuyez sur le bouton Create :

    

    Attendez que Visual Studio télécharge, décompresse et crée un émulateur Android.

14. Fermez la fenêtre Android Device Manager :

    

15. Dans la barre d’outils Visual Studio, appuyez sur le bouton Pixel 7 - API 35 (Android 15.0 - API 35) :

    

16. Dans la fenêtre Android SDK - License Agreement, appuyez sur le bouton Accept :

    

17. Dans la boîte de dialogue User Account Control, appuyez sur le bouton Yes :

    

    Attendez que Visual Studio soit installé pour télécharger le SDK Android.

18. Dans la barre d’outils Visual Studio, appuyez sur le bouton Pixel 7 - API 35 (Android 15.0 - API 35) pour générer et exécuter l’application :

    

    Visual Studio démarre l’émulateur Android, génère l’application et déploie l’application sur l’émulateur.

    Warning

    L’accélération matérielle doit être activée pour optimiser les performances de l’émulateur Android. À défaut, l’émulateur s’exécutera très lentement. Pour plus d’informations, consultez l’article Comment activer l’accélération matérielle avec des émulateurs Android (Hyper-V & AEHD).

19. Dans l’application en cours d’exécution dans l’émulateur Android, appuyez plusieurs fois sur le bouton Click me et observez l'incrémentation du nombre de clics du bouton.

    

Résolution des problèmes

Si la compilation de votre application échoue, reportez-vous à l’article sur la Résolution des problèmes connus, dans lequel vous trouverez peut-être une solution à votre problème. Si le problème est lié à l’émulateur Android, consultez Résolution des problèmes de l’émulateur Android.

6. Dans la barre d’outils Visual Studio, appuyez sur le bouton Windows Machine pour générer et exécuter l’application :

   

7. Dans l’application en cours d’exécution, appuyez plusieurs fois sur le bouton Click me et observez l'incrémentation du nombre de clics du bouton :

   

Résolution des problèmes

Si la compilation de votre application échoue, reportez-vous à l’article sur la Résolution des problèmes connus, dans lequel vous trouverez peut-être une solution à votre problème.

6. Dans Visual Studio, appairez l’IDE à un hôte de build Mac. Pour plus d’informations, consultez Appairer avec un Mac pour le développement iOS.

7. Dans la barre d’outils Visual Studio, utilisez la liste déroulante Debug Target pour sélectionner iOS Simulators, puis un simulateur iOS spécifique :

   

8. Dans la barre d’outils Visual Studio, appuyez sur le bouton Démarrer du simulateur iOS que vous avez choisi pour générer et exécuter votre application :

   

   Visual Studio génère l’application, démarre le simulateur iOS distant pour Windows, et déploie l’application sur le simulateur distant. Pour plus d’informations sur le simulateur iOS distant pour Windows, consultez Simulateur iOS distant pour Windows.

9. Dans l’application en cours d’exécution, appuyez plusieurs fois sur le bouton Click me et observez l'incrémentation du nombre de clics du bouton.

   

Résolution des problèmes

Si la compilation de votre application échoue, reportez-vous à l’article sur la Résolution des problèmes connus, dans lequel vous trouverez peut-être une solution à votre problème.

Les applications .NET MAUI qui ciblent Mac Catalyst ne peuvent être lancées et déboguées qu’à l’aide de Visual Studio Code.

Dans ce tutoriel, vous allez créer votre première application .NET MAUI dans Visual Studio Code et l’exécuter sur un émulateur Android :

Dans ce tutoriel, vous allez créer votre première application .NET MAUI dans Visual Studio Code sur un Mac et l’exécuter sur un simulateur iOS :

Dans ce tutoriel, vous allez créer votre première application .NET MAUI dans Visual Studio Code sur un Mac et l’exécuter sur macOS :

Dans ce tutoriel, vous allez créer votre première application .NET MAUI dans Visual Studio Code sur Windows et l’exécuter sur Windows :

7. Dans Visual Studio Code, vérifiez que votre environnement Android est configuré correctement en appuyant sur Ctrl+Maj+P sur Windows, ou Cmd+Maj+P sur macOS, puis en sélectionnant .NET MAUI : Configurer Android, suivi d’Actualiser l’environnement Android. Toutes les erreurs détectées doivent être traitées.

8. Dans la barre d’état située en bas de Visual Studio Code, appuyez sur le symbole de crochets courbés { } et vérifiez que le Debug Target est défini sur un émulateur Android spécifique :

   

   Vous pouvez également définir la cible de débogage en appuyant sur Ctrl+Maj+P sur Windows, ou Cmd+Maj+P sur macOS, puis en sélectionnant .NET MAUI : Choisir un appareil Android dans la palette de commandes.

9. Générez et exécutez l’application sur Android en appuyant sur F5 ou en appuyant sur le bouton Exécuter dans le coin supérieur droit de Visual Studio Code :

   

   Si vous êtes invité à sélectionner un débogueur dans la palette de commandes, sélectionnez C#, puis la configuration de lancement de votre projet.

10. Dans l’application en cours d’exécution dans votre émulateur Android choisi, appuyez sur le bouton Cliquez sur moi plusieurs fois et observez que le nombre de clics de bouton est incrémenté :

    

Déboguer l’application sur un appareil Android

Pour déboguer l’application sur un appareil Android :

1. Vérifiez que votre appareil est configuré pour le déploiement. Pour plus d’informations, consultez Configurer un appareil pour le déploiement.
2. Connectez votre appareil à votre machine et sélectionnez-le en tant que cible de débogage dans Visual Studio Code.
3. Exécutez l’application.

7. Dans Visual Studio Code, vérifiez que votre environnement Apple est configuré correctement en appuyant sur Cmd+Maj+P , puis en sélectionnant .NET MAUI : Configurer Apple, suivi de l’environnement Actualiser Apple. Toutes les erreurs détectées doivent être traitées.

8. Dans la barre d’état située en bas de Visual Studio Code, appuyez sur le symbole des accolades { } et vérifiez que la cible Debug Target est définie sur un simulateur iOS spécifique :

   

   Vous pouvez également définir la cible de débogage en appuyant sur Cmd+Maj+P et en sélectionnant .NET MAUI : Choisir un appareil iOS dans la palette de commandes.

9. Générez et exécutez l’application sur iOS en appuyant sur F5 ou en appuyant sur le bouton Exécuter dans le coin supérieur droit de Visual Studio Code :

   

   Si vous êtes invité à sélectionner un débogueur dans la palette de commandes, sélectionnez C#, puis la configuration de lancement de votre projet.

10. Dans l'application qui s'exécute dans votre simulateur iOS choisi, appuyez sur le bouton Cliquez-moi plusieurs fois et observez que le nombre de clics sur le bouton est incrémenté :

    

Déboguer l’application sur un appareil iOS

Pour déboguer l’application sur un appareil iOS :

1. Vérifiez que vous avez ajouté votre ID Apple à Xcode dans Paramètres > Xcode > Comptes.
2. Vérifiez que votre appareil a été inscrit auprès de votre équipe, si vous appartenez au Programme des développeurs Apple.
3. Activez le mode développeur sur votre appareil. La première fois que vous exécutez votre application, une fenêtre contextuelle peut apparaître sur l’appareil. Assurez-vous de sélectionner Allow. Pour plus d’informations sur le mode développeur, consultez Activation du mode développeur sur un appareil sur developer.apple.com.
4. Connectez votre appareil à votre machine et sélectionnez-le en tant que cible de débogage dans Visual Studio Code.
5. Exécutez l’application.

7. Dans Visual Studio Code, vérifiez que votre environnement Apple est configuré correctement en appuyant sur Cmd+Maj+P , puis en sélectionnant .NET MAUI : Configurer Apple, suivi de l’environnement Actualiser Apple. Toutes les erreurs détectées doivent être traitées.

8. Dans la barre d’état située en bas de Visual Studio Code, appuyez sur le symbole des accolades { } et vérifiez que la cible Debug Target est définie sur votre Mac :

   

   Vous pouvez également définir la cible de débogage en appuyant sur Cmd+Maj+P et en sélectionnant .NET MAUI : Choisir un appareil macOS dans la palette de commandes.

9. Générez et exécutez l’application sur macOS en appuyant sur F5 ou en appuyant sur le bouton Exécuter dans le coin supérieur droit de Visual Studio Code :

   

   Si vous êtes invité à sélectionner un débogueur dans la palette de commandes, sélectionnez C#, puis la configuration de lancement de votre projet.

10. Dans l’application en cours d’exécution, appuyez plusieurs fois sur le bouton Click me et observez l'incrémentation du nombre de clics du bouton :

    

7. Dans la barre d’état située en bas de Visual Studio Code, appuyez sur le symbole des accolades { } et vérifiez que la cible Debug Target est définie sur Windows :

   

   Vous pouvez également définir la cible de débogage en appuyant sur Ctrl+Maj+P et en sélectionnant .NET MAUI : Choisir un appareil Windows dans la palette de commandes.

8. Générez et exécutez l’application sur Windows en appuyant sur F5 ou en appuyant sur le bouton Exécuter dans le coin supérieur droit de Visual Studio Code :

   

   Si vous êtes invité à sélectionner un débogueur dans la palette de commandes, sélectionnez C#, puis la configuration de lancement de votre projet.

9. Dans l’application en cours d’exécution, appuyez plusieurs fois sur le bouton Click me et observez l'incrémentation du nombre de clics du bouton :