WinUI

Prepareu-vos per desenvolupar amb WinUI 3

Pàgina actualitzada :
Data de creació de la pàgina :

Entorn operatiu

Windows
  • Windows 11
Visual Studio
  • Visual Studio 2022 Versió 17.9.3
.XARXA
  • .NET 6
  • (.NET 8)
WinUI
  • WinUI 3
SDK de l'aplicació del Windows
  • 1.4.230913002

Prerequisits

En alguns casos, també poden funcionar versions inferiors.

Windows
  • Windows 10
  • Windows 11
Visual Studio
  • Visual Studio 2022 versió 17.9.3 o posterior
.XARXA
  • .NET 6
  • (.NET 8)
SDK de l'aplicació del Windows
  • 1.4.230913002 o posterior

Instal·lar Visual Studio i configurar WinUI

Els projectes de desenvolupament del WinUI 3 es poden afegir amb la instal·lació del Visual Studio. Aquesta secció proporciona una descripció simplificada del procés d'instal·lació del Visual Studio. Per obtenir instruccions detallades, consulteu els següents consells.

Inicieu l'instal·lador de Visual Studio 2022 des d'Internet o multimèdia. Admet edicions Community, Professional o superiors.

A la selecció de càrregues de treball, seleccioneu . NET Desenvolupament d'escriptori.

「. NET i comproveu Plantilles C# de l'SDK de l'aplicació Windows des dels detalls d'instal·lació a la dreta.

Ara només cal iniciar la instal·lació. Hi ha altres pantalles, però no les explicaré fins que no creïn un projecte.

Un cop finalitzada la instal·lació, creeu un nou projecte.

Hi ha un element de cerca a la winui part superior dreta, de manera que quan el seleccioneu, es mostrarà la plantilla de projecte WinUI 3, així que seleccioneu qualsevol plantilla i creeu un projecte.

Ara podeu desenvolupar aplicacions amb WinUI 3.

Si veieu "Orientació a una versió de .NET que no està instal·lada"

A partir de la versió 17.9.1 de Visual Studio 2022, .NET per a WinUI 3 té com a objectiu .NET 6. Si no seleccioneu cap temps d'execució addicional a Visual Studio 2022, només s'instal·larà el temps d'execució de .NET 8 i és possible que vegeu un advertiment com el següent.

Si us preocupa, podeu instal·lar el temps d'execució de .NET 6 o simplement descartar l'avís. No cal que instal·leu el temps d'execució de .NET 6 per depurar.

Si voleu afegir un entorn de desenvolupament WinUI 3 més endavant

Si instal·leu primer Visual Studio, podeu afegir un entorn de desenvolupament WinUI 3 més endavant.

Inicieu Visual Studio i seleccioneu Eines > Obtén eines i característiques al menú.

Es mostrarà la mateixa pantalla que quan vau instal·lar Visual Studio, de manera que podeu utilitzar el fitxer . Assegureu-vos que ".NET Desktop Development" estigui marcat i marqueu "Plantilla C# de l'SDK de l'aplicació Windows" des de "Detalls d'instal·lació" a la dreta.

Activar el mode de desenvolupador

Les aplicacions WinUI s'executen en un entorn de seguretat millorada a diferència d'altres aplicacions d'escriptori. Per tant, no es pot executar tal com està. Quan intenteu executar-lo, veureu un diàleg com el següent i se us demanarà que activeu el "Mode de desenvolupador". Si feu clic a l'enllaç, es mostrarà la pantalla de configuració, així que activeu el "Mode desenvolupador".

Fins i tot si no utilitzeu Visual Studio, també podeu habilitar o inhabilitar el "Mode de desenvolupador" des de la pantalla de configuració. Seleccioneu "Configuració" al menú Inici.

Al menú Sistema, seleccioneu Per a desenvolupadors.

Hi ha un commutador per a "Per a desenvolupadors", així que configureu-lo a "Activat". Es mostrarà una nota, així que seleccioneu "Sí" per activar-la.

Si voleu canviar a .NET 8

Si creeu un projecte amb aquesta plantilla, per defecte serà .NET 6. Fins i tot si canvio el marc de destinació a .NET 8 des de les propietats del projecte, la compilació encara mostra errors i advertències. Tanmateix, al voltant del 13/03/2024, l'SDK de l'aplicació de Windows s'actualitzarà per admetre oficialment .NET 8.

Tanmateix, la plantilla encara es troba a .NET 6, de manera que haureu de treballar a .NET 8 un cop hàgiu creat el projecte. Pot haver-hi la possibilitat que sigui compatible en futures actualitzacions de versions.

Primer, creeu un projecte i, a continuació, utilitzeu NuGet per actualitzar les versions relacionades amb l'SDK de l'aplicació Windows.

Llevat que sigui el contrari, tot està actualitzat. Microsoft.WindowsAppSDK ha de ser com a mínim 1.5.XXXX.

Canvieu el marc de destinació a .NET 8 des de les propietats del projecte.

Fins i tot si creeu en aquest estat, es mostrarà un error perquè la configuració del projecte està obsoleta.

Obriu el fitxer de projecte com a codi.

RuntimeIdentifiersCom que hi ha un paràmetre, elimineu el caràcter de la següent Win10 manera .10

Abans de la modificació

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

↓

Després de la correcció

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

També reescriu la configuració de publicació del programa. Obriu cada .pubxml fitxer a la carpeta Propietats > PublishProfiles.

De la mateixa manera RuntimeIdentifier , elimina el caràcter de 10 en el Win10 paràmetre de .

Després d'això, torneu a construir i verifiqueu que no hi hagi errors ni advertiments. .pubxml (Hi haurà un avís al fitxer, però no us haureu de preocupar perquè és una sintaxi diferent d'aquest problema.) )

Tanmateix, per alguna raó, la biblioteca de classes WinUI continua avisant fins i tot si feu el mateix que l'anterior. De moment, podeu executar-lo, així que esperem fins que això es solucioni.