De Windows App SDK gebruiken in een bestaand project

Als u een WPF-, WinForms- of Win32-bureaubladproject hebt waarin u functies van de Windows App SDK wilt gebruiken, kunt u het Windows App SDK NuGet-pakket in uw project installeren.

Vereiste voorwaarden

Voordat u het Windows App SDK NuGet-pakket in uw app installeert en gebruikt, moet u ervoor zorgen dat aan deze vereisten wordt voldaan:

Aanwijzingen

  1. Open een bestaand WPF-, WinForms- of Win32-project in Visual Studio. Zorg ervoor dat deze is geconfigureerd voor Call Windows Runtime API's.

  2. Open de NuGet Pakketbeheer in Visual Studio:

    1. Klik op Tools > NuGet Pakketbeheer > NuGet-pakketten voor oplossing beheren... .
      –OF–
    2. Klik met de rechtermuisknop op uw project in Solution Explorer en kies Beheer nuGet-pakketten voor oplossing... .

  3. Selecteer in het venster NuGet Pakketbeheer het tabblad Browse en zoek het volgende pakket:

    • Microsoft. WindowsAppSDK.

  4. Nadat u het juiste Windows App SDK NuGet-pakket hebt gevonden, schakelt u het pakket in, schakelt u het selectievakje in het rechterdeelvenster van het venster NuGet Pakketbeheer in naast het project waar u het pakket wilt installeren en klikt u vervolgens op Install.

    Schermopname van het Windows App SDK NuGet-pakket dat wordt geïnstalleerd

    Opmerking

    Het NuGet-pakket van de Windows App SDK bevat andere subpakketten (waaronder Microsoft.WindowsAppSDK.Foundation, Microsoft.WindowsAppSDK.WinUI en andere) die de implementaties voor specifieke onderdelen in de Windows App SDK bevatten. Over het algemeen raden we u aan het hoofd-Windows App SDK NuGet-pakket te installeren, dat alle onderdelen bevat. In sommige gevallen kunt u een subpakket afzonderlijk installeren om alleen naar bepaalde onderdelen in uw project te verwijzen. Zie bijvoorbeeld Install and deploy Windows ML.

Aanvullende stappen voor uitgepakte apps

Als uw app is uitgepakt (welke bureaublad-apps standaard zijn), zijn er enkele extra stappen nodig om de Windows App SDK te gebruiken.

Zie Het overzicht van pakketten voor meer informatie over de verpakte en uitgepakte termen.

1. Installeer de Windows App SDK Runtime

De Windows App SDK Runtime moet worden geïnstalleerd op elke computer waarop de app wordt uitgevoerd.

Voor uw ontwikkelcomputer raden we u aan Latest Windows App SDK downloads te bezoeken, vervolgens te downloaden, uit te pakken en uit te voeren:

  • De nieuwste stabiele release onder Runtime-downloads.
  • Een versie- en releasekanaal van de runtime die overeenkomt met de versie en het releasekanaal van de Microsoft. WindowsAppSDK NuGet-pakket dat u hebt geïnstalleerd.

Kies de juiste installatieoptie voor de architectuur van uw computer.

Belangrijk

Wanneer uw app is geïmplementeerd, bent u verantwoordelijk voor het implementeren van vereiste Windows App SDK runtimepakketten voor uw eindgebruikers. Zie Windows App SDK implementatiehandleiding voor frameworkafhankelijke apps die zijn verpakt met externe locatie of uitgepakt voor meer informatie.

2. Initialiseer de Windows App SDK Runtime

Standaard wordt een WPF-, WinForms- of Win32-bureaublad-app uitgepakt. Een uitgepakte app moet de Windows App SDK-runtime initialiseren voordat u een andere functie van de Windows App SDK gebruikt.

U kunt dit automatisch doen wanneer uw app wordt gestart via automatische initialisatie.

  1. Klik in Solution Explorer met de rechtermuisknop op uw project en kies Projectbestand bewerken.

  2. Voeg binnen het PropertyGroup element een WindowsPackageType elementenset toe aan None.

<WindowsPackageType>None</WindowsPackageType>

Wanneer u uw project bouwt, worden deze bestanden toegevoegd aan uw project in Visual Studio:

  • MddBootstrapAutoInitializer.cs
  • WindowsAppSDK-VersionInfo.cs

  1. Bewerk het .cxproj-bestand handmatig.

  2. Voeg binnen het <PropertyGroup Label="Globals"> element een WindowsPackageType elementenset toe aan None.

<WindowsPackageType>None</WindowsPackageType>

Opmerking

Als u geavanceerde behoeften hebt (zoals aangepaste foutafhandeling of als u een specifieke versie van de Windows App SDK wilt laden), kunt u de bootstrapper-API expliciet aanroepen in plaats van auto-initialisatie kunt u de bootstrapper-API expliciet aanroepen. Zie Gebruik de Windows App SDK runtime voor apps die zijn verpakt met externe locatie of uitgepakt en Tutorial: gebruik de bootstrapper-API in een app die is verpakt met externe locatie of uitgepakt die gebruikmaakt van de Windows App SDK.

Meer informatie

Als u een klasse niet geregistreerd is fout tegenkomt wanneer u een Windows App SDK-onderdeel probeert te gebruiken, moet u mogelijk een dynamische afhankelijkheid van het Windows App SDK Framework-pakket aan uw project toevoegen. Zie MSIX Framework-pakketten en dynamische afhankelijkheden voor meer informatie.

Zie ook

  • Last updated on