Pour commencer à développer des applications .NET MAUI natives multiplateformes sur Windows, macOS ou Linux, installez la dernière version de Visual Studio Code en suivant les étapes d’installation .
Prérequis
Pour générer, signer et déployer des applications .NET MAUI pour iOS et Mac Catalyst, vous aurez besoin des éléments suivants :
Installer Visual Studio Code
Pour créer des applications .NET MAUI, vous devez télécharger la dernière version de Visual Studio Code :
Installez Visual Studio Code. Pour obtenir des instructions détaillées sur l’installation de Visual Studio Code, consultez Visual Studio Code sur Windows, Visual Studio Code sur macOSet Visual Studio Code sur Linux.
Installer l’extension .NET MAUI
Avant de pouvoir créer des applications .NET MAUI dans Visual Studio Code, vous devez installer l’extension .NET MAUI :
Lancez Visual Studio Code.
Dans Visual Studio Code, accédez à l’onglet Extensions et recherchez « .NET MAUI ». Ensuite, sélectionnez l'extension .NET MAUI et installez-la en appuyant sur le bouton Installer :
L’extension .NET MAUI installe automatiquement le Kit de développement C# et les extensions C#, qui sont nécessaires pour que l’extension .NET MAUI s’exécute. Pour plus d’informations sur le Kit de développement C#, consultez Kit de développement C# pour Visual Studio Code.
Connecter votre compte au Kit de développement C#
L’utilisation du Kit de développement C# vous oblige à vous connecter avec un compte Microsoft disposant d’un abonnement Visual Studio actif :
Dans l’onglet Bienvenue pour bien démarrer avec .NET MAUI, appuyez sur le bouton Connecter :
Suivez les invites pour vous connecter à votre compte Microsoft. Pour plus d’informations, consultez Connexion au Kit de développement C#.
Pour plus d’informations sur les licences du Kit de développement C#, consultez FAQ sur le Kit de développement C#.
Configurer votre environnement .NET
Vous aurez besoin du Kit de développement logiciel (SDK) .NET installé sur votre ordinateur pour développer des applications .NET MAUI. Si le Kit de développement logiciel (SDK) .NET n’est pas installé sur votre ordinateur, l’approche recommandée pour l’installer sur Windows est via Visual Studio Installer. Pour plus d’informations, consultez Installation.
Vous pouvez également installer manuellement le Kit de développement logiciel (SDK) .NET :
Téléchargez le programme d’installation .NET.
Installez le Kit de développement logiciel (SDK) .NET en exécutant le programme d’installation .NET. Pour plus d’informations, consultez Installer .NET sur Windows, Linux et macOS.
Pourboire
Sur Linux, vous pouvez installer le Kit de développement logiciel (SDK) .NET à l’aide des instructions d’installation scriptées .
Pour vérifier que le Kit de développement logiciel (SDK) .NET est installé :
Ouvrez un terminal.
Dans le terminal, exécutez la commande suivante :
dotnet --version
Vous devez voir la version du Kit de développement logiciel (SDK) .NET que vous avez installé.
Remarque
Il peut être nécessaire de redémarrer votre machine avant de vérifier que le Kit de développement logiciel (SDK) .NET est installé.
Configurer votre environnement MAUI .NET
Vous aurez besoin du SDK .NET MAUI installé sur votre ordinateur pour développer des applications .NET MAUI. Si le Kit de développement logiciel (SDK) .NET MAUI n’est pas installé sur votre ordinateur, l’approche recommandée pour l’installer sur Windows est via Visual Studio Installer. Pour plus d’informations, consultez Installation.
Vous pouvez également installer manuellement le Kit de développement logiciel (SDK) .NET MAUI :
Ouvrez un terminal.
Dans le terminal sur Windows, exécutez la commande suivante :
dotnet workload install maui
Dans le terminal sur macOS, exécutez la commande suivante :
sudo dotnet workload install maui
Dans le terminal sur Linux, exécutez la commande suivante :
dotnet workload install maui-android
Pour vérifier que le SDK .NET MAUI est installé :
Ouvrez un terminal.
Dans le terminal, exécutez la commande suivante :
dotnet workload list
Sur Windows et macOS, vous devez voir l’ID de charge de travail maui répertorié en même temps que la version installée. Toutefois, si vous l’avez installé via Visual Studio Installer sur Windows, les ID de charge de travail suivants sont répertoriés :
android
maui-windows
maccatalyst
ios
Sur Linux, vous devez voir l’ID de charge de travail maui-android répertorié en même temps que la version installée.
Pour générer et déboguer une application .NET MAUI, vous devez disposer d’une plateforme cible valide par rapport au système d’exploitation de votre ordinateur de développement. Le tableau suivant répertorie les plateformes cibles prises en charge sur chaque système d’exploitation :
| Votre système d’exploitation |
Plateformes cibles prises en charge |
| Windows |
Windows, Android |
| macOS |
Android, iOS, macOS |
| Linux |
Android |
La création d’une application .NET MAUI pour Android et pour les plateformes Apple vous oblige à effectuer une configuration et une configuration supplémentaires.
Android
Pour traiter la configuration de votre ordinateur pour le développement .NET MAUI sur Android avec Visual Studio Code, procédez comme suit :
Télécharger et installer le Kit de développement logiciel (SDK) Java
Pour télécharger et installer le Kit de développement logiciel (SDK) Java, puis configurer Visual Studio Code pour l’utiliser :
Téléchargez et installez Microsoft OpenJDK 17. Pour plus d’informations sur l’installation d’OpenJDK, consultez Installer la build Microsoft d’OpenJDK.
Plutôt que de télécharger et d'installer de manière manuelle, vous pouvez utiliser la cible de compilation InstallAndroidDependencies pour installer le SDK Java et le SDK Android. Pour plus d’informations, consultez Utilisation de la cible InstallAndroidDependencies.
Important
Vérifiez que vous notez l’emplacement sur lequel l’OpenJDK est installé, car cela est nécessaire à l’étape suivante.
Vérifiez que vous avez configuré le chemin d’accès à OpenJDK via l’une des approches suivantes :
Définissez la variable d’environnement JAVA_HOME pour définir le chemin du Kit de développement logiciel (SDK) Java pour votre ordinateur. Il s’agit de l’approche recommandée, qui définit le chemin du Kit de développement logiciel (SDK) Java au niveau de l’ordinateur.
Remarque
Si vous installez OpenJDK sur Windows via MSI, vous pouvez choisir le paramètre d’installation de la variable d’environnement JAVA_HOME.
Dans Visual Studio Code, appuyez sur Ctrl+Maj+P sur Windows, ou CMD+MAJ+P sur macOS, puis sélectionnez .NET MAUI : Configurer Android, suivi de Sélectionner l’emplacement du SDK Java pour définir le chemin du SDK Java au niveau de l’utilisateur/espace de travail.
Configurez le chemin du Kit de développement logiciel (SDK) Java dans votre fichier .csproj en définissant la propriété $(JavaSdkDirectory) MSBuild sur le chemin OpenJDK. Cela définit le chemin du Kit de développement logiciel (SDK) Java au niveau du projet.
Télécharger et installer le Kit de développement logiciel (SDK) Android
Pour télécharger et installer le Kit de développement logiciel (SDK) Android, puis configurer Visual Studio Code pour l’utiliser :
Téléchargez et installez le Kit de développement logiciel (SDK) Android via l’une des approches suivantes :
- Téléchargez et installez le Kit de développement logiciel (SDK) Android en créant un projet .NET MAUI, puis utilisez la cible de build
InstallAndroidDependencies, qui permet de configurer votre environnement Android. Il s’agit de l’approche recommandée. Pour plus d’informations, consultez Utilisation de la cible InstallAndroidDependencies.
- Téléchargez et installez le Kit de développement logiciel (SDK) Android sur Windows en installant la charge de travail de développement .NET MAUI dans Visual Studio, puis la création et l’exécution d’une application .NET MAUI sur Android. Ce processus garantit que le Kit de développement logiciel (SDK) Android et un émulateur Android sont installés.
- Téléchargez et installez le Kit de développement logiciel (SDK) Android via Android Studio. Pour plus d’informations, consultez Installer Android Studio sur developer.android.com.
- Téléchargez et installez le Kit de développement logiciel (SDK) Android via votre gestionnaire de package préféré sur Linux.
Vérifiez que vous avez configuré le chemin d’accès au Kit de développement logiciel (SDK) Android via l’une des approches suivantes :
- Définissez la variable d’environnement
ANDROID_HOME pour définir le chemin du Kit de développement logiciel (SDK) Android pour votre ordinateur. Il s’agit de l’approche recommandée, qui définit le chemin du Kit de développement logiciel (SDK) Android au niveau de l’ordinateur.
- Dans Visual Studio Code, appuyez sur Ctrl+Maj+P sur Windows, ou CMD+MAJ+P sur macOS, puis sélectionnez .NET MAUI : Configurer android, suivi de Sélectionner l’emplacement du Kit de développement logiciel (SDK) Android pour définir le chemin du SDK Android au niveau de l’utilisateur/espace de travail.
- Configurez le chemin du Kit de développement logiciel (SDK) Android dans votre fichier .csproj en définissant la propriété
$(AndroidSdkDirectory) MSBuild sur le chemin du Kit de développement logiciel (SDK) Android. Cela définit le chemin du Kit de développement logiciel (SDK) Android au niveau du projet.
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 de Actualiser l’environnement Android. Toutes les erreurs détectées doivent être traitées :
- Dans la palette de commandes, sélectionnez .NET MAUI : Configurer android suivi des deux Sélectionner l’emplacement du Kit de développement logiciel (SDK) Android et Sélectionner l’emplacement du Kit de développement logiciel (SDK) Android et vérifier qu’ils pointent correctement vers les installations de chacune d’elles. Sur Windows, si vous installez les kits sdk via Visual Studio, OpenJDK se trouve à C :\Program Files\Microsoft et le Kit de développement logiciel (SDK) Android se trouve à C :\Program Files (x86)\Android\android-sdk.
- Vérifiez que votre dossier Android SDK contient des sous-dossiers tels que outils de compilation, outils en ligne de commande, et plateforme-outils.
- Vérifiez que votre dossier OpenJDK contient des sous-dossiers tels que bin, lib, etc.
- Vérifiez que la variable d’environnement
ANDROID_HOME est définie sur le chemin de votre Kit de développement logiciel (SDK) Android.
- Vérifiez que la variable d’environnement
JAVA_HOME est définie sur le chemin de votre Kit de développement logiciel (SDK) Java.
- Si les licences Android n’ont pas été acceptées, dans un terminal avec élévation de privilèges, accédez au dossier cmdline-tools/{version}/bin de votre kit de développement logiciel (SDK) Android, exécutez
sdkmanager --licenses et ensuite suivez les instructions de l'interface en ligne de commande.
Utilisation de la cible InstallAndroidDependencies
L'approche recommandée pour installer les dépendances requises pour votre projet .NET MAUI sur Android consiste à exécuter la cible MSBuild InstallAndroidDependencies. Cette cible installe le Kit de développement logiciel (SDK) Android pour vous, s’il n’est pas déjà installé.
Dans un terminal, créez un projet .NET MAUI :
dotnet new maui -n "MyMauiApp"
Dans un terminal, remplacez le répertoire par MyMauiApp, puis générez l’application lors de la spécification de la cible de build InstallAndroidDependencies :
cd MyMauiApp
dotnet build -t:InstallAndroidDependencies -f:net9.0-android -p:AndroidSdkDirectory="/path/to/sdk" -p:AcceptAndroidSDKLicenses=True
Remarque
La cible InstallAndroidDependencies MSBuild peut également installer le Kit de développement logiciel (SDK) Java si la propriété JavaSdkDirectory MSBuild est fournie.
Dans la commande ci-dessus :
-
-p:AndroidSdkDirectory="/path/to/sdk" installe ou met à jour les dépendances Android vers le chemin absolu spécifié. Les chemins suggérés sont %LOCALAPPDATA%/Android/Sdk sur Windows, et $HOME/Library/Android/sdk sur macOS.
-
-p:AcceptAndroidSDKLicenses=True accepte les licences Android requises pour le développement.
- (facultatif)
-p:JavaSdkDirectory="/path/to/sdk" installe le Kit de développement logiciel (SDK) Java sur le chemin absolu spécifié.
Essayez d’éviter d’utiliser des chemins contenant des espaces ou des caractères non ASCII.
Télécharger et installer un émulateur Android
Pour télécharger et installer un émulateur Android sur lequel exécuter vos applications :
Dans un terminal, accédez au {YOUR_ANDROID_SDK_FOLDER}/cmdline-tools/{version}/bin/.
Dans un terminal, utilisez la commande sdkmanager pour télécharger et installer un émulateur Android :
Sur Windows, exécutez les commandes suivantes :
sdkmanager --install emulator
sdkmanager --install "system-images;android-35;google_apis;x86_64"
Sur macOS, exécutez les commandes suivantes :
./sdkmanager --install emulator
./sdkmanager --install "system-images;android-35;google_apis;arm64-v8a"
Remarque
La commande ci-dessus suppose un Apple Silicon Mac. Pour un Mac Intel, remplacez arm64-v8a par x86_64.
Pour plus d’informations sur la commande sdkmanager, consultez sdkmanager sur developer.android.com.
Dans un terminal, utilisez la commande avdmanager pour créer un émulateur Android :
Sur Windows, exécutez les commandes suivantes :
avdmanager create avd -n MyAndroidVirtualDevice-API35 -k "system-images;android-35;google_apis;x86_64"
Sur macOS, exécutez les commandes suivantes :
./avdmanager create avd -n MyAndroidVirtualDevice-API35 -k "system-images;android-35;google_apis;arm64-v8a"
Remarque
La commande ci-dessus suppose un Apple Silicon Mac. Pour un Mac Intel, remplacez arm64-v8a par x86_64.
Pour plus d’informations sur la commande avdmanager, consultez avdmanager sur developer.android.com.
iOS et macOS
Pour configurer votre Mac pour le développement MAUI .NET sur iOS et Mac Catalyst avec Visual Studio Code :
Installez la version de Xcode requise par la version .NET MAUI que vous utilisez. Pour obtenir plus d’informations, consultez les Versions de mise en production. La dernière version stable de Xcode peut être téléchargée depuis l’Apple App Store.
Dans un terminal, exécutez la commande suivante pour acquérir les outils en ligne de commande Xcode :
xcode-select --install
Lancez Xcode et acceptez les contrats de licence. Si les simulateurs ne commencent pas à s'installer, accédez à Paramètres > Xcode > Composants et installez vos environnements d'exécution de simulateur choisis.
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 Actualiser l'environnement Apple. Toutes les erreurs détectées doivent être traitées :
- Vérifiez que vous avez exécuté
xcode-select --install dans un terminal.
- Si vous recevez une erreur indiquant que Xcode n’a pas été trouvé, exécutez
xcode-select -p dans un terminal et vérifiez qu’il retourne un chemin d’accès à votre installation Xcode.
- Ouvrez Xcode pour vous assurer qu’il se charge correctement, puis accédez à Paramètres de > Xcode > Localisation et vérifiez que le champ Outils en ligne de commande pointe vers l'installation correcte de Xcode.
Dépannage
Si vous rencontrez des problèmes lors de l’installation de l’extension .NET MAUI dans Visual Studio Code, vous trouverez plus d’informations sur les problèmes en accédant à la fenêtre Sortie (Ctrl+Maj+U sur Windows ou CMD+MAJ+U sur macOS) et en sélectionnant .NET MAUI dans la liste déroulante.
Fournir des commentaires
Pour fournir des commentaires sur l’extension .NET MAUI à partir de Visual Studio Code, accédez à la boîte de dialogue Aide > Signaler le problème. Ensuite, veillez à sélectionner « Rapport de bogues » comme valeur de l'Il s’agit d’une liste déroulante « Extension VS Code » comme valeur de la liste déroulante Pour et de .NET MAUI comme valeur de la liste déroulante Extension :
