Créez votre première application

Dans ce tutoriel, vous apprendrez à créer et exécuter votre première application .NET MAUI (.NET Multi-platform App UI) dans Visual Studio 2022 sur Windows ou Visual Studio Code sur Windows, macOS ou Linux. Cela permettra de s’assurer que votre environnement de développement est correctement configuré.

Visual Studio

Prérequis

• Visual Studio 2022 17.8 ou version ultérieure, avec la charge de travail de l’interface utilisateur de l’application multiplateforme .NET installée. Pour plus d’informations, consultez Installation.

Créer une 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 commence à installer Android SDK et l’Émulateur Android par défaut.

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

   

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

   

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

    

11. Dans la fenêtre Acceptation de la licence, appuyez sur le bouton Accepter :

    

    Attendez que Visual Studio télécharge le kit de développement logiciel Android et l’Émulateur Android.

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

    

    Visual Studio commence à créer un émulateur Android par défaut.

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

    

14. 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.

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

    

16. Dans la barre d’outils Visual Studio, appuyez sur le bouton Pixel 5 - API 34 (Android 14.0 - API 33) 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).

17. 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, utilisez la liste déroulante Cible de débogage pour sélectionner Framework, puis l’entrée net8.0-windows :

   

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

   

   Si vous n’avez pas activé le mode développeur, Visual Studio vous invite à l’activer. Dans la boîte de dialogue Activer le mode développeur pour Windows, cliquez sur paramètres pour les développeurs afin d’ouvrir l’application Paramètres :

   

   Dans l’application Paramètres, activez le mode développeur et acceptez l’exclusion de responsabilité :

   

   Fermez l’application Paramètres, puis fermez la boîte de dialogue Activer le mode développeur pour Windows.

8. 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 2022 pour Mac.

Visual Studio Code

Prérequis

• Visual Studio Code avec l’extension .NET MAUI installée. Pour plus d’informations, consultez Installation.

Créer une application

Pour créer une application .NET MAUI :

1. Lancer Visual Studio Code. Dans l’Explorateur, cliquez sur Créer un projet .NET. Vous pouvez également sélectionner CTRL/CMD+MAJ+P .NET : Nouveau projet....
2. Sélectionnez Application .NET MAUI ou Application .NET MAUI Blazor.
3. Sélectionnez un dossier vide. Si l’Explorateur de fichiers s’ouvre à nouveau, votre dossier n’est pas vide.
4. Nom du projet.
5. Vérifiez que le projet se charge correctement dans l’Explorateur de solutions, puis ouvrez un fichier C# ou XAML.

Remarque

Vous pouvez également ouvrir un projet .NET MAUI existant dans Visual Studio Code via le menu Fichier > Ouvrir….

Vous devez maintenant voir votre application dans l’Explorateur de solutions du Kit de développement C# dans Visual Studio Code. Étant donné que l’extension .NET MAUI dépend du Kit de développement C#, vous pouvez utiliser toutes ses fonctionnalités en même temps que l’extension .NET MAUI.

Choisir votre appareil cible

Pour choisir votre appareil cible, cliquez sur le symbole des accolades { } dans le coin inférieur droit de Visual Studio Code. Vous pouvez utiliser ce symbole pour changer votre projet de démarrage, changer votre cible de débogage par toute cible valide sur votre ordinateur de développement et épingler l’un ou l’autre paramètre à la barre d’état de Visual Studio Code :

Vous pouvez également définir le projet de démarrage et la cible de débogage dans la palette de commandes, en utilisant CTRL/CMD+Maj+P et en recherchant « .NET MAUI ».

Vous pouvez déployer sur votre ordinateur de développement local (bureau Windows ou macOS avec Xcode) sans étapes supplémentaires.

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.

Déboguer votre application

Pour déboguer votre application, accédez au menu Exécuter et Déboguer de Visual Studio Code, puis sélectionnez le bouton Exécuter et déboguer. Vous pouvez également utiliser F5 pour démarrer une session de débogage. Si Visual Studio Code vous invite à sélectionner un débogueur, veillez à sélectionner C#.

Remarque

Dans les versions préliminaires de l’extension, le débogueur était répertorié comme .NET MAUI. Dans la version stable, cette configuration a été remplacée par C#.

Le débogueur choisira automatiquement la cible de débogage et le projet de démarrage que vous avez définis dans le menu entre accolades{ }. Il vous sera demandé de choisir une cible de débogage si vous n’avez rien sélectionné.

Une fois que votre application démarre le débogage, vous pouvez utiliser les outils de débogage Visual Studio Code intégrés pour définir des points d’arrêt, parcourir votre code et bien plus encore.

En savoir plus

Si vous rencontrez des problèmes avec l’extension, vous pouvez suivre les étapes de résolution des problèmes, consulter les problèmes connus ou fournir des commentaires.

Étapes suivantes

Dans ce tutoriel, vous avez appris à créer et à exécuter votre première application .NET MAUI (.NET Multi-platform App UI).

Pour découvrir les principes fondamentaux de la création d’une application avec .NET MAUI, consultez Créer une application .NET MAUI. Vous pouvez également suivre un cours complet de formation à .NET MAUI. Consultez Créer des applications mobiles et de bureau avec MAUI .NET.