WinUI

Forbered dig på at udvikle med WinUI 3

Side opdateret :
Dato for oprettelse af side :

Driftsmiljø

Windows
  • Windows 11
Visual Studio
  • Visual Studio 2022 version 17.9.3
.NET
  • .NET 6
  • (.NET 8)
WinUI
  • WinUI 3
Windows App SDK
  • 1.4.230913002

Forudsætninger

I nogle tilfælde kan lavere versioner også fungere.

Windows
  • Windows 10
  • Windows 11
Visual Studio
  • Visual Studio 2022 version 17.9.3 eller nyere
.NET
  • .NET 6
  • (.NET 8)
Windows App SDK
  • 1.4.230913002 eller nyere

Installer Visual Studio og konfigurer WinUI

WinUI 3-udviklingsprojekter kan tilføjes med Visual Studio-installationen. Dette afsnit indeholder en forenklet beskrivelse af Visual Studio-installationsprocessen. For detaljerede instruktioner henvises til følgende tips.

Start installationsprogrammet til Visual Studio 2022 fra internettet eller medierne. Det understøtter Community, Professional eller nyere udgaver.

I valget af arbejdsbelastning skal du vælge . NET Desktop udvikling.

「. NET Desktop Development og tjek Windows App SDK C#-skabeloner fra installationsoplysningerne til højre.

Nu skal du bare starte installationen. Der er andre skærme, men jeg vil ikke forklare dem, før de opretter et projekt.

Når installationen er færdig, skal du oprette et nyt projekt.

Der er et i søgeelementet øverst winui til højre, så når du vælger det, vises WinUI 3-projektskabelonen, så vælg en skabelon og opret et projekt.

Du kan nu udvikle applikationer ved hjælp af WinUI 3.

Hvis du ser "Målretter mod en version af .NET, der ikke er installeret"

Fra og med Visual Studio 2022-versionen 17.9.1 er .NET til WinUI 3 rettet mod .NET 6. Hvis du ikke vælger yderligere kørsler i Visual Studio 2022, er det kun .NET 8-kørslen, der installeres, og du kan få vist en advarsel som den nedenfor.

Hvis du er bekymret, kan du installere .NET 6-kørslen eller bare afvise advarslen. Du behøver ikke at installere .NET 6-kørslen for at foretage fejlfinding.

Hvis du vil tilføje et WinUI 3-udviklingsmiljø senere

Hvis du installerer Visual Studio først, kan du tilføje et WinUI 3-udviklingsmiljø senere.

Start Visual Studio, og vælg Værktøjer > Hent værktøjer og funktioner i menuen.

Det samme skærmbillede, som da du installerede Visual Studio, vises, så du kan bruge . Sørg for, at ".NET Desktop Development" er markeret, og markér "Windows App SDK C# Template" fra "Installation Details" til højre.

Aktiver udviklertilstand

WinUI-applikationer kører i et sikkerhedsforbedret miljø i modsætning til andre desktop-applikationer. Derfor kan den ikke køres, som den er. Når du prøver at køre det, vil du se en dialogboks som den nedenfor, og du vil blive bedt om at aktivere "Udviklertilstand". Hvis du klikker på linket, vises indstillingsskærmen, så aktiver venligst "Udviklertilstand".

Selvom du ikke bruger Visual Studio, kan du også aktivere eller deaktivere "Udviklertilstand" fra indstillingsskærmen. Vælg "Indstillinger" i Start-menuen.

I menuen System skal du vælge For udviklere.

Der er en skift til "For udviklere", så indstil den til "Til". En note vil blive vist, så vælg "Ja" for at aktivere den.

Hvis du vil skifte til .NET 8

Hvis du opretter et projekt med denne skabelon, vil det som standard være .NET 6. Selvom jeg ændrer målrammen til .NET 8 fra projektegenskaberne, viser buildet stadig fejl og advarsler. Omkring 13/03/2024 vil Windows App SDK dog blive opdateret til officielt at understøtte .NET 8.

Skabelonen er dog stadig i .NET 6, så du skal arbejde på .NET 8, når du har oprettet projektet. Der kan være en mulighed for, at det vil blive understøttet i fremtidige versionsopgraderinger.

Opret først et projekt, og brug derefter NuGet til at opdatere de Windows App SDK-relaterede versioner.

Medmindre andet er alt opdateret. Microsoft.WindowsAppSDK skal være mindst 1.5.XXXX.

Skift destinationsstrukturen til .NET 8 fra projektegenskaberne.

Selvom du bygger i denne tilstand, vises der en fejl, fordi projektindstillingerne er forældede.

Åbn projektfilen som kode.

RuntimeIdentifiersDa der er en parameter, skal du fjerne tegnet af 10 som følger Win10 .

Før ændring

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

↓

Efter rettelsen

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

Det omskriver også programmets udgivelsesindstillinger. Åbn hver .pubxml fil i mappen Egenskaber > PublishProfiles.

På samme måde RuntimeIdentifier fjerner du tegnet for 10 i parameteren Win10 for .

Derefter skal du genopbygge og kontrollere, at der ikke er nogen fejl eller advarsler. .pubxml (Der vil være en advarsel i filen, men du behøver ikke bekymre dig om det, fordi det er en anden syntaks end dette problem.) )

Af en eller anden grund fortsætter WinUI-klassebiblioteket dog med at advare, selvom du gør det samme som ovenfor. Indtil videre kan du køre det, så lad os vente, indtil dette er rettet.