WinUI

Bereid je voor op ontwikkeling met WinUI 3

Pagina bijgewerkt :
Aanmaakdatum van pagina :

Werkomgeving

Ramen
  • Windows 11
Visuele Studio
  • Visual Studio 2022 versie 17.9.3
.NET
  • .NET 6
  • (.NET 8)
WinUI
  • WinUI 3
SDK voor Windows-app
  • 1.4.230913002

Voorwaarden

In sommige gevallen kunnen lagere versies ook werken.

Ramen
  • Vensters 10
  • Windows 11
Visuele Studio
  • Visual Studio 2022 versie 17.9.3 of hoger
.NET
  • .NET 6
  • (.NET 8)
SDK voor Windows-app
  • 1.4.230913002 of hoger

Visual Studio installeren en WinUI instellen

WinUI 3-ontwikkelingsprojecten kunnen worden toegevoegd met de Visual Studio-installatie. In deze sectie vindt u een vereenvoudigde beschrijving van het installatieproces van Visual Studio. Raadpleeg de volgende tips voor gedetailleerde instructies.

Start het installatieprogramma van Visual Studio 2022 vanaf internet of media. Het ondersteunt Community-, Professional- of hogere edities.

Selecteer in de selectie van de werkbelasting . NET Desktop Ontwikkeling.

「. NET Desktop Development en controleer Windows App SDK C#-sjablonen in de installatiedetails aan de rechterkant.

Nu hoef je alleen nog maar de installatie te starten. Er zijn andere schermen, maar ik zal ze pas uitleggen als ze een project maken.

Zodra de installatie is voltooid, maakt u een nieuw project.

Er is een in het zoekitem in de winui rechterbovenhoek, dus wanneer u het selecteert, wordt de WinUI 3-projectsjabloon weergegeven, dus selecteer een sjabloon en maak een project.

U kunt nu toepassingen ontwikkelen met behulp van WinUI 3.

Als u 'Targeting op een versie van .NET die niet is geïnstalleerd' ziet

Vanaf de versie 17.9.1 van Visual Studio 2022 richt .NET voor WinUI 3 zich op .NET 6. Als u geen extra runtimes selecteert in Visual Studio 2022, wordt alleen de .NET 8-runtime geïnstalleerd en ziet u mogelijk een waarschuwing zoals hieronder.

Als u zich zorgen maakt, kunt u de .NET 6-runtime installeren of de waarschuwing gewoon negeren. U hoeft de .NET 6-runtime niet te installeren om fouten op te sporen.

Als u later een WinUI 3-ontwikkelomgeving wilt toevoegen

Als u eerst Visual Studio installeert, kunt u later een WinUI 3-ontwikkelomgeving toevoegen.

Start Visual Studio en selecteer Tools > Tools en functies ophalen in het menu.

Hetzelfde scherm als toen u Visual Studio installeerde, wordt weergegeven, zodat u de . Zorg ervoor dat ".NET Desktop Development" is aangevinkt en vink "Windows App SDK C# Template" aan bij "Installation Details" aan de rechterkant.

Ontwikkelaarsmodus inschakelen

WinUI-toepassingen worden uitgevoerd in een omgeving met verbeterde beveiliging, in tegenstelling tot andere desktoptoepassingen. Daarom kan het niet worden uitgevoerd zoals het is. Wanneer u het probeert uit te voeren, ziet u een dialoogvenster zoals hieronder en wordt u gevraagd om "Ontwikkelaarsmodus" in te schakelen. Als u op de link klikt, wordt het instellingenscherm weergegeven, dus schakel "Ontwikkelaarsmodus" in.

Zelfs als u Visual Studio niet gebruikt, kunt u ook "Ontwikkelaarsmodus" in- of uitschakelen via het instellingenscherm. Selecteer "Instellingen" in het menu Start.

Selecteer in het menu Systeem de optie Voor ontwikkelaars.

Er is een schakelaar voor "Voor ontwikkelaars", dus zet deze op "Aan". Er wordt een notitie weergegeven, dus selecteer "Ja" om deze in te schakelen.

Als u wilt overstappen op .NET 8

Als u een project maakt met deze sjabloon, wordt deze standaard ingesteld op .NET 6. Zelfs als ik het doelframework verander naar .NET 8 vanuit de projecteigenschappen, vertoont de build nog steeds fouten en waarschuwingen. Rond 13-03-2024 wordt de Windows App SDK echter bijgewerkt om .NET 8 officieel te ondersteunen.

De sjabloon is echter nog steeds in .NET 6, dus u moet aan .NET 8 werken nadat u het project hebt gemaakt. Het is mogelijk dat het wordt ondersteund in toekomstige versie-upgrades.

Maak eerst een project en gebruik vervolgens NuGet om de Windows App SDK-gerelateerde versies bij te werken.

Tenzij anders is alles up-to-date. Microsoft.WindowsAppSDK moet minimaal 1.5.XXXX zijn.

Wijzig het doelframework in .NET 8 vanuit de projecteigenschappen.

Zelfs als u in deze staat bouwt, wordt er een foutmelding weergegeven omdat de projectinstellingen verouderd zijn.

Open het projectbestand als code.

RuntimeIdentifiersAangezien er een parameter is, verwijdert u het teken van als 10 volgt Win10 .

Vóór wijziging

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

↓

Na de oplossing

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

Het herschrijft ook de publicatie-instellingen van het programma. Open elk .pubxml bestand in de map Eigenschappen > PublishProfiles.

RuntimeIdentifier Op dezelfde manier , verwijder het teken van 10 in de Win10 parameter van .

Bouw daarna opnieuw op en controleer of er geen fouten of waarschuwingen zijn. .pubxml (Er zal een waarschuwing in het bestand staan, maar u hoeft zich daar geen zorgen over te maken omdat het een andere syntaxis is dan dit probleem.) )

Om de een of andere reden blijft de WinUI-klassebibliotheek echter waarschuwen, zelfs als u hetzelfde doet als hierboven. Voorlopig kun je het uitvoeren, dus laten we wachten tot dit is opgelost.