Pour commencer à développer des applications .NET MAUI multiplateformes natives sur Windows, installez Visual Studio 2022 17.8 ou ultérieur en suivant les étapes d’installation.
Prérequis
- Visual Studio 2022 17.8 ou ultérieur. Pour plus d’informations sur les systèmes d’exploitation pris en charge, le matériel, les langages pris en charge et des exigences et instructions supplémentaires, consultez Configuration requise pour Visual Studio 2022.
Pour générer, signer et déployer des applications .NET MAUI pour iOS, vous avez également besoin des éléments suivants :
Sinon, pour déployer les builds de débogage de votre application directement de Windows sur votre appareil iOS avec un redémarrage à chaud, vous avez besoin des éléments suivants :
Installation
Pour créer des applications .NET MAUI, vous aurez besoin de la dernière version de Visual Studio 2022 :
Installez Visual Studio ou modifiez votre installation existante et installez la charge de travail Développement .NET Multi-platform App UI avec ses options d’installation facultatives par défaut :
Remarque
La mise hors service de Visual Studio pour Mac est prévue le 31 août 2024, conformément à la Politique de cycle de vie moderne de Microsoft. Visual Studio pour Mac 17.6 continuera d’être pris en charge jusqu’au 31 août 2024, avec des mises à jour de maintenance pour les problèmes de sécurité et les plateformes mises à jour d’Apple. Pour plus d’informations, notamment sur les options alternatives pour le développement sur un Mac, consultez Qu’arrive-t-il à Visual Studio pour Mac ?.
Pour commencer à développer des applications .NET MAUI multiplateformes natives sur macOS, installez Visual Studio 2022 pour Mac 17.6 en suivant les étapes d’installation.
Prérequis
Pour générer, signer et déployer des applications .NET MAUI pour iOS ou macOS, vous avez également besoin des éléments suivants :
Installation
Pour créer des applications .NET MAUI, vous aurez besoin de la dernière version de Visual Studio pour Mac :
Installez Visual Studio 2022 pour Mac ou modifiez votre installation existante et vérifiez que les charges de travail suivantes sont installées :
- .NET
- .NET MAUI
- Android
- iOS
Important
Pour les nouvelles installations de Visual Studio 2022 pour Mac, la sélection de la charge de travail .NET MAUI sélectionne automatiquement les charges de travail Android et iOS, qui sont actuellement requises pour le développement .NET MAUI.
Installez .NET 8 via le programme d’installation autonome.
Une fois que .NET 8 a terminé l’installation, exécutez dotnet workload install maui
dans un terminal.
Important
Pour utiliser Visual Studio pour Mac avec .NET 8, cochez la case Visual Studio > Préférences > Autre > Fonctionnalités d’évaluation> Utiliser le kit SDK .NET 8 s’il est installé (nécessite un redémarrage).
Si vous rencontrez des problèmes réseau durant l’installation dans un environnement d’entreprise, passez en revue les instructions d’installation derrière un pare-feu ou un proxy.
Installation derrière un pare-feu ou un serveur proxy
Pour installer Visual Studio 2022 pour Mac derrière un pare-feu, certains points de terminaison doivent être accessibles afin d’autoriser les téléchargements des outils et mises à jour nécessaires à votre logiciel. Pour plus d’informations sur la configuration de votre réseau afin d’autoriser l’accès aux points de terminaison requis, consultez Installer et utiliser Visual Studio pour Mac derrière un pare-feu ou un serveur proxy.
Remarque
La prise en charge de .NET MAUI dans Visual Studio Code est toujours en préversion. Essayez-le et partagez vos commentaires !
Installer Visual Studio Code et l’extension .NET MAUI
Installez Visual Studio Code.
Sous l’onglet Extensions, recherchez « .NET MAUI » et installez l’extension .NET MAUI. 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.
Remarque
L’extension .NET MAUI nécessite le kit de développement C# qui comprend l’extension C#. Vous devez vous connecter au Kit de développement C# pour utiliser les fonctionnalités de l’extension .NET MAUI. Pour plus d’informations sur le Kit de développement C# et sa famille d’extensions, consultez la documentation du Kit de développement C#.
Installer les charges de travail .NET et .NET MAUI
Installez .NET 8.
Sur Windows, il est recommandé d’utiliser le programme d’installation de Visual Studio pour gérer .NET et les installations des charges de travail .NET MAUI. Vous trouverez des instructions sur l’utilisation du programme d’installation de Visual Studio ici.
Installez la charge de travail .NET MAUI.
Sur Windows et macOS, exécutez la commande suivante dans un terminal :
dotnet workload install maui
Sur Linux, exécutez la commande suivante dans un terminal :
dotnet workload install maui-android
Pour déboguer une application .NET MAUI dans Visual Studio Code, vous devez disposer d’une plateforme cible valide pour le système d’exploitation de votre ordinateur de développement :
Votre système d’exploitation |
Plateformes cibles prises en charge |
Windows |
Windows, Android |
macOS |
Android, iOS, macOS |
Linux |
Android |
iOS et macOS
Pour déboguer sur une cible iOS ou macOS dans 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. Vous pouvez télécharger la dernière mise en production stable de Xcode dans l’App Store Mac.
- Exécutez
xcode-select --install
dans un terminal pour acquérir les outils en ligne de commande Xcode.
Android
Pour déboguer sur une cible Android dans Visual Studio Code :
- Installez Microsoft OpenJDK 17.
- Installez le kit Android SDK via l’une des approches suivantes :
- (Recommandé) Créer un projet .NET MAUI (
dotnet new maui
) et utiliser la cible InstallAndroidDependencies.
- Installer via Visual Studio (Windows uniquement).
- Installer via Android Studio.
- Installer via votre gestionnaire de package préféré sur Linux.
Dépannage
Vous pouvez rencontrer des problèmes lors de la configuration de l’extension .NET MAUI pour Visual Studio Code. Si vous rencontrez toujours des problèmes après avoir suivi les étapes de résolution des problèmes ci-dessous, signalez un problème.
Création du projet
Si vous essayez de créer un projet et que l’Explorateur de fichiers continue à apparaître dans une boucle infinie, vous ne sélectionnez peut-être pas un dossier vide. Vérifiez qu’il n’existe aucun fichier ou dossier masqué, créez un dossier ou créez votre application .NET MAUI à partir de la ligne de commande à l’aide de dotnet new maui
.
Utilisation de la cible InstallAndroidDependencies
.NET 8 a une cible de build qui vous aide à configurer votre environnement Android pour vous. Exécutez la commande suivante dans un terminal pour configurer votre ordinateur et votre environnement Android :
dotnet build -t:InstallAndroidDependencies -f:net8.0-android -p:AndroidSdkDirectory="<AndroidSdkPath>" -p:JavaSdkDirectory="<JavaSdkPath>" -p:AcceptAndroidSDKLicenses=True
Dans la commande ci-dessus :
AndroidSdkDirectory="<AndroidSdkPath>"
: installe ou met à jour les dépendances Android avec le chemin d’accès absolu spécifié.
- Windows : le chemin AndroidSdkPath suggéré est
%LOCALAPPDATA%/Android/Sdk
.
- MacOS : le chemin AndroidSdkPath suggéré est
$HOME/Library/Android/sdk
.
JavaSdkDirectory="<JavaSdkPath>"
: installe Java sur le chemin d’accès absolu spécifié.
AcceptAndroidSDKLicenses=True
: accepte les licences Android requises pour le développement.
Une erreur indique que le kit Android SDK ou Java SDK n’a pas été trouvé
- Ouvrez la palette de commandes (Ctrl/Cmd + Maj + P) et recherchez la commande
.NET MAUI: Configure Android
. Sélectionnez à la fois « Définir le chemin d’accès du kit Android SDK » et « Définir le chemin d’accès du kit Android JDK » et vérifiez qu’ils pointent vers leur installation respective.
- Le dossier Android SDK doit avoir les sous-dossiers tels que
build-tools
, cmdline-tools
et platform-tools
.
- Le dossier Java OpenJDK doit avoir les sous-dossiers tels que
bin
, lib
, etc.
- Sur Windows, si vous effectuez l’installation via Visual Studio, le kit Java SDK se trouve dans
C:\Program Files\Microsoft\
et le kit Android SDK dans C:\Program Files (x86)\Android\android-sdk
.
- Définissez la variable d’environnement
JAVA_HOME
sur un chemin d’accès Java OpenJDK valide.
- Définissez la variable d’environnement
ANDROID_HOME
sur le chemin d’accès de votre kit Android SDK.
- Vérifiez vos versions minimales des dépendances Android installées :
- build-tools >= 34.0.0
- cmdline-tools == 11.0
- platforms;android-34*
- .NET 8: platform-tools = 34.0.5
Une erreur indique que les licences Android ne sont pas acceptées
Dans une invite de commandes ou un terminal avec privilèges élevés, accédez au dossier cmdline-tools/latest/bin/
de votre Kit Android SDK et exécutez sdkmanager --licenses
, puis suivez les invites de l’interface CLI.
Mes dépendances Android ne sont pas chargées dans l’Explorateur de solutions, mais mon application se génère correctement
Il s’agit d’un problème connu si vous effectuez l’installation dans %APPDATA%
sur Windows, lequel sera résolu dans une prochaine version.
Configuration d’iOS/Xcode
- Si vous recevez une erreur indiquant que Xcode est introuvable, exécutez
xcode-select --install
dans un terminal, puis vérifiez que xcode-select -p
pointe vers votre installation Xcode.
- Si vous rencontrez toujours des problèmes, ouvrez Xcode lui-même pour vous assurer qu’il se charge correctement. Une fois Xcode ouvert, accédez à Xcode > Paramètres > Emplacements et vérifiez que le champ Outils en ligne de commande pointe vers le code Xcode approprié.
- Il existe un problème connu où vous devez parfois créer votre application iOS/macOS deux fois pour pouvoir la déployer. Ce problème sera résolu dans une prochaine version.
Problèmes de débogage
- Le débogage peut ne pas arriver à démarrer pour plusieurs raisons. S’il n’y a pas d’erreur claire dans la fenêtre Sortie, vérifiez d’abord que vous utilisez la configuration d’exécution « .NET MAUI » dans Visual Studio Code.
- Vous pouvez essayer une génération en ligne de commande à partir du terminal pour voir si l’erreur se trouve dans votre code ou l’extension .NET MAUI. Par exemple, vous pouvez exécuter
dotnet build -f:net8.0-android
pour voir si votre génération Android fonctionne en dehors de Visual Studio Code. Si c’est le cas, Signalez un problème
Limites connues
Cette extension est encore en préversion anticipée, c’est pourquoi il existe un certain nombre de limitations connues. Veuillez nous faire part de vos commentaires sur d’autres fonctionnalités que vous souhaiteriez voir pendant que nous continuons à créer cette nouvelle expérience.
- Les fonctionnalités d’édition XAML sont très légères. Elles vous offrent une autocomplétion et une coloration syntaxique de base. Nous explorons comment améliorer l’expérience XAML dans une prochaine version.
- Actuellement, vous ne pouvez pas changer le framework cible pour IntelliSense (il affiche une coloration syntaxique uniquement pour le premier framework cible listé dans votre fichier .csproj). Cette fonctionnalité est en cours.
- Le rechargement à chaud XAML et .NET n’est pas pris en charge pour l’instant.
- Cette extension n’a pas encore été entièrement testée avec les dernières versions bêta iOS et Xcode.
Veuillez nous faire part de vos commentaires sur d’autres fonctionnalités que vous souhaiteriez voir pendant que nous continuons à créer cette nouvelle expérience.
Fournir des commentaires
Lisez les FAQ du kit de développement C# et consultez les Problèmes connus existants avant de signaler un nouveau problème ou une nouvelle suggestion. Vous pouvez signaler des suggestions et des problèmes à partir de Visual Studio Code via la boîte de dialogue Aide > Signaler un problème. Veillez à sélectionner « Une extension », puis l’extension .NET MAUI dans la liste déroulante.