WinUI

Préparez-vous à développer avec WinUI 3

Page mise à jour :
Date de création de la page :

Environnement d’exploitation

Windows
  • Windows 11
Studio visuel
  • Visual Studio 2022 version 17.9.3
.FILET
  • .NET 6
  • (.NET 8)
WinUI
  • WinUI 3
Kit de développement logiciel (SDK) d’application Windows
  • 1.4.230913002

Conditions préalables

Dans certains cas, des versions inférieures peuvent également fonctionner.

Windows
  • Windows 10
  • Windows 11
Studio visuel
  • Visual Studio 2022 version 17.9.3 ou ultérieure
.FILET
  • .NET 6
  • (.NET 8)
Kit de développement logiciel (SDK) d’application Windows
  • 1.4.230913002 ou version ultérieure

Installer Visual Studio et configurer WinUI

Des projets de développement WinUI 3 peuvent être ajoutés avec l’installation de Visual Studio. Cette section fournit une description simplifiée du processus d’installation de Visual Studio. Pour des instructions détaillées, veuillez vous référer aux conseils suivants.

Lancez le programme d’installation de Visual Studio 2022 à partir d’Internet ou d’un média. Il prend en charge les éditions Community, Professional ou supérieures.

Dans la sélection de la charge de travail, sélectionnez . Développement de bureau NET.

「. NET Desktop Development et vérifiez Windows App SDK C# Templates dans les détails d’installation sur la droite.

Maintenant, il suffit de commencer l’installation. Il y a d’autres écrans, mais je ne les expliquerai pas tant qu’ils n’auront pas créé un projet.

Une fois l’installation terminée, créez un nouveau projet.

Il y a un dans l’élément de recherche en haut à winui droite, donc lorsque vous le sélectionnez, le modèle de projet WinUI 3 s’affiche, alors sélectionnez n’importe quel modèle et créez un projet.

Vous pouvez désormais développer des applications à l’aide de WinUI 3.

Si vous voyez « Ciblage d’une version de .NET qui n’est pas installée »

À partir de la version 17.9.1 2022 de Visual Studio , .NET pour WinUI 3 cible .NET 6. Si vous ne sélectionnez pas d’environnements d’exécution supplémentaires dans Visual Studio 2022, seul le runtime .NET 8 sera installé, et vous pouvez voir un avertissement comme celui ci-dessous.

Si vous êtes inquiet, vous pouvez installer le runtime .NET 6 ou simplement ignorer l’avertissement. Vous n’avez pas besoin d’installer le runtime .NET 6 pour déboguer.

Si vous souhaitez ajouter un environnement de développement WinUI 3 ultérieurement

Si vous installez d’abord Visual Studio, vous pouvez ajouter un environnement de développement WinUI 3 ultérieurement.

Démarrez Visual Studio et sélectionnez Outils > Obtenir des outils et des fonctionnalités dans le menu.

Le même écran que lors de l’installation de Visual Studio s’affiche, ce qui vous permet d’utiliser l’extension . Assurez-vous que l’option « Développement de bureau .NET » est cochée, puis cochez « Modèle C# du SDK d’application Windows » dans « Détails d’installation » sur la droite.

Activer le mode développeur

Les applications WinUI s’exécutent dans un environnement à sécurité renforcée, contrairement aux autres applications de bureau. Par conséquent, il ne peut pas être exécuté tel quel. Lorsque vous essayez de l’exécuter, vous verrez une boîte de dialogue comme celle ci-dessous et vous serez invité à activer le « Mode développeur ». Si vous cliquez sur le lien, l’écran de réglage s’affichera, veuillez donc activer le « Mode développeur ».

Même si vous n’utilisez pas Visual Studio, vous pouvez également activer ou désactiver le « Mode développeur » à partir de l’écran des paramètres. Sélectionnez « Paramètres » dans le menu Démarrer.

Dans le menu Système, sélectionnez Pour les développeurs.

Il y a une bascule pour « Pour les développeurs », alors réglez-la sur « On ». Une note s’affichera, alors sélectionnez « Oui » pour l’activer.

Si vous souhaitez passer à .NET 8

Si vous créez un projet avec ce modèle, il s’agit par défaut de .NET 6. Même si je change le cadre cible en .NET 8 à partir des propriétés du projet, la build affiche toujours des erreurs et des avertissements. Cependant, vers le 13/03/2024, le SDK de l’application Windows sera mis à jour pour prendre officiellement en charge .NET 8.

Cependant, le modèle est toujours dans .NET 6, vous devrez donc travailler sur .NET 8 une fois que vous aurez créé le projet. Il est possible qu’il soit pris en charge dans les futures mises à niveau de version.

Tout d’abord, créez un projet, puis utilisez NuGet pour mettre à jour les versions liées au SDK d’application Windows.

Sauf indication contraire, tout est à jour. Microsoft.WindowsAppSDK doit être au moins 1.5.XXXX.

Remplacez le cadre cible par .NET 8 à partir des propriétés du projet.

Même si vous générez dans cet état, une erreur s’affichera car les paramètres du projet sont obsolètes.

Ouvrez le fichier projet en tant que code.

RuntimeIdentifiersPuisqu’il y a un paramètre, supprimez le caractère de 10 comme suit Win10 .

Avant la modification

<RuntimeIdentifiers>win10-x86;win10-x64;win10-arm64</RuntimeIdentifiers>

↓

Après le correctif

<RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>

Il réécrit également les paramètres de publication du programme. Ouvrez chaque .pubxml fichier dans le dossier Properties > PublishProfiles.

RuntimeIdentifier De même, , supprimez le caractère de 10 dans le Win10 paramètre de .

Après cela, reconstruisez et vérifiez qu’il n’y a pas d’erreurs ou d’avertissements. .pubxml (Il y aura un avertissement dans le fichier, mais vous n’avez pas à vous en soucier car il s’agit d’une syntaxe différente de ce problème.) )

Cependant, pour une raison quelconque, la bibliothèque de classes WinUI continue d’avertir même si vous faites la même chose que ci-dessus. Pour l’instant, vous pouvez l’exécuter, alors attendons que cela soit résolu.