Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Créez, générez et exécutez votre première application WinUI 3. Choisissez Visual Studio pour une expérience IDE complète avec la prise en charge du concepteur visuel, ou dotnet nouveau pour travailler à partir de la ligne de commande dans n’importe quel éditeur. Utilisez les onglets ci-dessous pour basculer entre les deux approches.
Configurer votre environnement de développement
Pour développer des applications WinUI 3 avec Visual Studio, vous devez Visual Studio 2026 avec les charges de travail requises et le mode développeur activés.
Configurer avec WinGet (recommandé)
Ouvrez Terminal Windows et exécutez la commande suivante dans PowerShell pour installer automatiquement Visual Studio 2026 avec les charges de travail requises et activer le mode développeur à l’aide d’un fichier de configuration WinGet :
winget configure -f https://aka.ms/winui-config
Pour passer en revue le fichier de configuration et en savoir plus, consultez son README sur GitHub.
Note
Si WinGet n’est pas disponible dans votre environnement, installez-le d’abord :
Install-Module -Name Microsoft.WinGet.Client -Force
Repair-WinGetPackageManager -AllUsers
Pour plus d’informations, consultez Utilisation de WinGet .
Configurer manuellement
Si vous préférez installer manuellement les outils :
Activez le mode développeur : ouvrez Windows Paramètres, accédez à System > Advanced et basculez le mode développeur sur Activé.
Téléchargez et installez Visual Studio 2026. Pour plus d’informations, consultez Install Visual Studio.
Dans le programme d’installation Visual Studio, sélectionnez la charge de travail de développement d’applications WinUI sous l’onglet Charges de travail. Pour le développement C++, sélectionnez également les outils de développement d’applications WinUI C++ sous cette charge de travail dans le volet Détails de l’installation.
Capture d’écran de l’interface utilisateur de l'installateur Visual Studio avec l’ensemble de fonctionnalités pour le développement d’applications WinUI sélectionné.
Conseil / Astuce
Si vous ne voyez pas les modèles WinUI après l'installation de Visual Studio, ouvrez le programme d'installation Visual Studio, sélectionnez Modify et vérifiez que la charge de travail Dévelopment d'applicationsWinUI est cochée. Redémarrez Visual Studio après avoir modifié l’installation.
Créer et lancer votre première application WinUI 3
Ouvrez Visual Studio 2026, puis sélectionnez Créer un projet.
Recherchez WinUI, sélectionnez le modèle de projet C# WinUI Blank App (empaquetée), puis sélectionnez Suivant.
Entrez un nom de projet, puis sélectionnez Créer.
Appuyez sur Démarrer (F5) pour générer et exécuter votre application.
Votre application se compile, se déploie et se lance en mode débogage.
Vous avez créé et lancé votre première application WinUI 3 ! 🎉
Résolution des problèmes
Si vous rencontrez des problèmes lors de la génération ou de l’exécution de votre première application, essayez ces correctifs courants :
| Problème | Solution |
|---|---|
| Les modèles WinUI n'apparaissent pas dans Visual Studio | Ouvrez le programme d’installation Visual Studio, sélectionnez Modifier et vérifiez que la charge de travail de développement d’applications WinUI est cochée. Redémarrez Visual Studio après avoir modifié l’installation. Pour plus d’informations, consultez le conseil dans Configurer votre environnement de développement . |
| La génération échoue avec les erreurs de version du Kit de développement logiciel (SDK) | Ouvrez le programme d’installation Visual Studio et sélectionnez Composants individuels. Vérifiez que la version du KIT de développement logiciel (SDK) Windows cible de votre projet est installée. Dans votre fichier de projet, vérifiez que TargetFramework correspond au SDK installé (par exemple, net10.0-windows10.0.26100.0). |
| Échecs de restauration NuGet | Effacez le cache NuGet local et restaurez à nouveau. Dans un terminal, exécutez : dotnet nuget locals all --clear puis dotnet restore. |
| Erreur « Mode développeur non activé » | Ouvrez Windows Settings >System > Advanced et basculez le mode développeur sur Activé. Pour plus d’informations, consultez Activer le mode développeur . |
| Modifications non reconnues après la première installation du Kit de développement logiciel (SDK) | Après avoir installé ou mis à jour les charges de travail SDK d'application Windows ou Visual Studio pour la première fois, redémarrez Visual Studio afin qu’il récupère les nouveaux composants. |
Conseil / Astuce
Si aucune des solutions ci-dessus ne résout votre problème, consultez les problèmes signalés sur GitHub pour SDK d'application Windows ou posez votre question sur Microsoft Q&A.
Étapes suivantes
Créer votre première application WinUI
Prêt à aller plus loin ? Suivez le tutoriel pas à pas pour générer une application WinUI complète.
Galerie WinUI 3
Explorez des exemples interactifs de contrôles, de fonctionnalités et de caractéristiques de WinUI.
Exemples et ressources
Parcourez les exemples de code, les projets de démarrage et les outils pour accélérer votre développement.
Collaborer avec nous sur GitHub
La source de ce contenu se trouve sur GitHub, où vous pouvez également créer et examiner les problèmes et les demandes de tirage. Pour plus d’informations, consultez notre guide du contributeur.
Windows developer