WinUI (på engelska)

Förbered dig för att utveckla med WinUI 3

Sidan uppdaterad :
Datum för skapande av sida :

Omvärld

Windows
  • Windows 11 (på engelska)
Visuell studio
  • Visual Studio 2022 version 17.9.3
.NÄT
  • .NET 6
  • (.NET 8)
WinUI (på engelska)
  • WinUI 3
SDK för Windows-appar
  • 1.4.230913002

Förutsättningar

I vissa fall kan även lägre versioner fungera.

Windows
  • Windows 10 (på engelska)
  • Windows 11 (på engelska)
Visuell studio
  • Visual Studio 2022 version 17.9.3 eller senare
.NÄT
  • .NET 6
  • (.NET 8)
SDK för Windows-appar
  • 1.4.230913002 och senare

Installera Visual Studio och konfigurera WinUI

WinUI 3-utvecklingsprojekt kan läggas till med Visual Studio-installationen. Det här avsnittet innehåller en förenklad beskrivning av Visual Studio-installationsprocessen. För detaljerade instruktioner, se följande tips.

Starta installationsprogrammet för Visual Studio 2022 från internet eller media. Den stöder Community, Professional eller högre utgåvor.

I valet av arbetsbelastning väljer du . Utveckling av NET Desktop.

「. NET Desktop Development och kontrollera Windows App SDK C#-mallar i installationsinformationen till höger.

Nu är det bara att starta installationen. Det finns andra skärmar, men jag kommer inte att förklara dem förrän de skapar ett projekt.

När installationen är klar skapar du ett nytt projekt.

Det finns en i sökobjektet uppe till winui höger, så när du väljer den kommer WinUI 3-projektmallen att visas, så välj vilken mall som helst och skapa ett projekt.

Nu kan du utveckla program med hjälp av WinUI 3.

Om du ser "Rikta in dig på en version av .NET som inte är installerad"

Från och med Visual Studio 2022-versionen 17.9.1 riktar sig .NET för WinUI 3 mot .NET 6. Om du inte väljer några ytterligare körningar i Visual Studio 2022 installeras endast .NET 8-körningen och du kan se en varning som den nedan.

Om du är orolig kan du installera .NET 6-körningen eller bara stänga varningen. Du behöver inte installera .NET 6-körningen för att felsöka.

Om du vill lägga till en WinUI 3-utvecklingsmiljö senare

Om du installerar Visual Studio först kan du lägga till en WinUI 3-utvecklingsmiljö senare.

Starta Visual Studio och välj Verktyg > Hämta verktyg och funktioner på menyn.

Samma skärm som när du installerade Visual Studio visas, så att du kan använda . Kontrollera att ".NET Desktop Development" är markerat och markera "Windows App SDK C# Template" från "Installation Details" (Installationsinformation) till höger.

Aktivera utvecklarläge

WinUI-program körs i en säkerhetsförbättrad miljö till skillnad från andra skrivbordsprogram. Därför kan den inte köras som den är. När du försöker köra den kommer du att se en dialogruta som den nedan och du kommer att uppmanas att aktivera "Utvecklarläge". Om du klickar på länken kommer inställningsskärmen att visas, så aktivera "Utvecklarläge".

Även om du inte använder Visual Studio kan du också aktivera eller inaktivera "Utvecklarläge" från inställningsskärmen. Välj "Inställningar" från Start-menyn.

På menyn System väljer du För utvecklare.

Det finns en växel för "För utvecklare", så ställ in den på "På". En anteckning kommer att visas, så välj "Ja" för att aktivera den.

Om du vill ändra till .NET 8

Om du skapar ett projekt med den här mallen används .NET 6 som standard. Även om jag ändrar målramverket till .NET 8 från projektegenskaperna visar bygget fortfarande fel och varningar. Men runt 2024-03-13 kommer SDK:n för Windows-appen att uppdateras för att officiellt stödja .NET 8.

Mallen finns dock fortfarande i .NET 6, så du måste arbeta med .NET 8 när du har skapat projektet. Det kan finnas en möjlighet att det kommer att stödjas i framtida versionsuppgraderingar.

Skapa först ett projekt och använd sedan NuGet för att uppdatera SDK-relaterade versioner för Windows-appen.

Om inget annat anges är allt uppdaterat. Microsoft.WindowsAppSDK måste vara minst 1.5.XXXX.

Ändra målramverket till .NET 8 från projektegenskaperna.

Även om du skapar i det här läget visas ett fel eftersom projektinställningarna är inaktuella.

Öppna projektfilen som kod.

RuntimeIdentifiersEftersom det finns en parameter tar du bort tecknet 10 för på följande Win10 sätt.

Innan ändring

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

↓

Efter korrigeringen

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

Den skriver också om programmets publiceringsinställningar. Öppna varje .pubxml fil i mappen Properties > PublishProfiles.

På samma sätt RuntimeIdentifier tar du bort tecknet 10 för i Win10 parametern för .

Efter det, bygg om och kontrollera att det inte finns några fel eller varningar. .pubxml (Det kommer att finnas en varning i filen, men du behöver inte oroa dig för det eftersom det är en annan syntax än det här problemet.) )

Men av någon anledning fortsätter WinUI-klassbiblioteket att varna även om du gör samma sak som ovan. För närvarande kan du köra det, så låt oss vänta tills detta är åtgärdat.