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 plutôt commencer avec Android ou Windows.

Dans ce tutoriel, vous allez créer votre première application .NET MAUI dans Visual Studio et l’exécuter sur un simulateur 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 Créer un projet pour créer un projet :

   

2. Dans la fenêtre Créer un projet, sélectionnez MAUI dans la liste déroulante Tous les types de projets, sélectionnez le modèle Application .NET MAUI, puis cliquez sur le bouton Suivant :

   

3. Dans la fenêtre Configurer votre nouveau projet, nommez votre projet, choisissez un emplacement approprié pour celui-ci, puis cliquez sur le bouton Suivant :

   

4. Dans la fenêtre Informations supplémentaires, choisissez la version de .NET que vous souhaitez cibler, puis cliquez sur le bouton Créer :

   

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 Cible de débogage pour sélectionner Émulateurs Android, puis l’entrée Émulateur Android :

   

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

   

   Visual Studio démarre le processus d’installation du Kit de développement logiciel (SDK) Android et de l’émulateur Android par défaut.

8. Dans la fenêtre Android SDK – Contrat de licence, appuyez sur le bouton Accepter :

   

9. Dans la boîte de dialogue Contrôle de compte d’utilisateur, appuyez sur le bouton Oui :

   

   Attendez que Visual Studio télécharge le Kit de développement logiciel (SDK) Android et l’émulateur Android par défaut.

10. Dans la boîte de dialogue Contrôle de compte d’utilisateur, appuyez sur le bouton Oui :

    

11. Dans la boîte de dialogue Kit de développement logiciel (SDK) Android, appuyez sur le bouton Installer :

    

12. Dans la fenêtre Android SDK – Contrat de licence, appuyez sur le bouton Accepter :

    

    Attendez que Visual Studio installe les composants du Kit de développement logiciel (SDK) Android.

13. Dans la fenêtre Nouvel appareil, appuyez sur le bouton Créer :

    

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

14. Fermez la fenêtre Gestionnaire d’appareils Android :

    

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 – Contrat de licence, appuyez sur le bouton Accepter :

    

17. Dans la boîte de dialogue Contrôle de compte d’utilisateur, appuyez sur le bouton Oui :

    

    Attendez que Visual Studio soit installé pour télécharger le Kit de développement logiciel (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.

    Avertissement

    L’accélération matérielle doit être activée pour optimiser les performances de l’émulateur Android. Sans elle, l’émulateur s’exécutera très lentement. Pour plus d’informations, consultez Guide pratique pour 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 que le nombre de clics de bouton est incrémenté.

    

Dépannage

Si la compilation de votre application échoue, passez en revue l’article 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 liés à l’émulateur Android.

6. Dans la barre d’outils Visual Studio, appuyez sur le bouton Machine Windows 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 que le nombre de clics de bouton est incrémenté.

   

Dépannage

Si la compilation de votre application échoue, passez en revue l’article 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 Cible de débogage pour sélectionner Simulateurs iOS, 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 que le nombre de clics de bouton est incrémenté.

   

Dépannage

Si la compilation de votre application échoue, passez en revue l’article 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.

Cibler Android

Si vous souhaitez utiliser des émulateurs Android, suivez ces étapes pour installer et créer un émulateur :

1. Accédez à <YOUR_ANDROID_SDK_DIRECTORY>/cmdline-tools/11.0/bin/ dans votre terminal.

2. Utilisez sdkmanager pour installer l’émulateur.

   Sous Windows, exécutez les commandes suivantes dans le terminal :

   sdkmanager --install emulator
   sdkmanager --install "system-images;android-33;google_apis;x86_64"
   

   Sous macOS, exécutez les commandes suivantes dans le terminal :

   ./sdkmanager --install emulator
   ./sdkmanager --install "system-images;android-33;google_apis;x86_64"
   

   Remarque

   Les guillemets autour des arguments de ligne de commande sdkmanager sont importants.

3. Ensuite, vous pouvez créer un émulateur sur la ligne de commande avec avdmanager d’Android.

   Sous Windows, exécutez les commandes suivantes dans le terminal :

   avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64"
   

   Sous macOS, exécutez les commandes suivantes dans le terminal :

   ./avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64"
   

   Remarque

   Les guillemets autour des arguments de ligne de commande avdmanager sont importants.

Vous pouvez également déboguer sur des appareils Android physiques.

Cible iOS

Les simulateurs iOS sont intégrés dans Xcode. Pour télécharger les simulateurs, assurez-vous que l’option est sélectionnée pour les installer lors du premier lancement de Xcode, ou allez dans Xcode > Paramètres > Plateformes et choisissez un runtime de simulateur à installer.

Pour déboguer avec un appareil iOS, suivez ces étapes avant de tenter de déboguer :

1. Spécifiez votre ID Apple dans Xcode > Paramètres > Compte.
2. Enregistrez l’appareil auprès de votre équipe si vous faites partie du Programme pour les développeurs Apple.
3. Activez le mode développeur sur votre appareil, comme décrit dans Activer le mode développeur sur un 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 Autoriser.