Partager via


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

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 :

    Nouvelle solution.

  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 :

    Choisissez un modèle.

  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 :

    Configurez le projet.

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

    Informations supplémentaires

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

    Dépendances restaurées.

  1. 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 :

    Sélectionnez la cible de débogage de l’Émulateur Android pour .NET MAUI.

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

    Bouton Émulateur Android.

    Visual Studio commence à installer Android SDK et l’Émulateur Android par défaut.

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

    Première fenêtre de Contrat de licence Android SDK.

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

    Deuxième fenêtre de Contrat de licence Android SDK.

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

    Boîte de dialogue de contrôle de compte d’utilisateur de licence Android SDK.

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

    Fenêtre de licence d’appareil Android.

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

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

    Bouton d’émulateur Android.

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

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

    Boîte de dialogue de contrôle de compte d’utilisateur de Gestionnaire d’appareils Android.

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

    Nouvelle fenêtre Appareil Android.

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

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

    Fenêtre Gestionnaire d’appareils Android.

  11. 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 :

    Bouton d’émulateur Pixel 5 API 34.

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

  12. 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é.

    Application en cours d’exécution dans l’émulateur Android.

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.

  1. 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 :

    Sélectionnez la cible de débogage d’ordinateur Windows pour .NET MAUI.

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

    Bouton Exécuter l’application .NET MAUI dans Visual Studio.

    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 :

    Boîte de dialogue Activer le mode Développeur Windows.

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

    Bouton bascule du mode Développeur sur l’application des paramètres Windows 11.

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

  3. 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é.

    Application .NET MAUI s’exécutant sur Windows.

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.

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

  2. 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 :

    Cibles de débogage de simulateurs iOS Visual Studio.

  3. 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 :

    Choix de cible de débogage de simulateur iOS Visual Studio.

    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.

  4. 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é.

    Application .NET MAUI s’exécutant dans le simulateur iOS sur un Mac.

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.

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