Använda Windows App SDK i ett befintligt projekt

Om du har ett WPF-, WinForms- eller Win32-skrivbordsprojekt där du vill använda funktioner i Windows App SDK kan du installera Windows App SDK NuGet-paketet i projektet.

Förutsättningar

Innan du installerar och använder Windows App SDK NuGet-paketet i din app måste du se till att dessa krav uppfylls:

Instruktioner

  1. Öppna ett befintligt WPF-, WinForms- eller Win32-projekt i Visual Studio. Kontrollera att den är konfigurerad för att Anropa Windows Runtime API:er.

  2. I Visual Studio öppnar du NuGet Správca balíkov:

    1. Klicka på Verktyg > NuGet-pakethanteraren > Hantera NuGet-paket för lösning....
      –ELLER–
    2. Högerklicka på projektet i Prieskumník riešení och välj Hantera NuGet-paket för lösning... .

  3. I fönstret NuGet Správca balíkov väljer du fliken Browse och söker efter följande paket:

    • Microsoft. WindowsAppSDK.

  4. När du har hittat rätt Windows App SDK NuGet-paket markerar du paketet, markerar kryssrutan i den högra rutan i fönstret NuGet Správca balíkov bredvid projektet där du vill installera paketet och klickar sedan på Installera.

    Skärmbild av Windows App SDK NuGet-paketet som installeras

    Not

    Windows App SDK NuGet-paketet innehåller andra underpaket (inklusive Microsoft.WindowsAppSDK.Foundation, Microsoft.WindowsAppSDK.WinUIoch andra) som innehåller implementeringarna för specifika komponenter i Windows App SDK. I allmänhet rekommenderar vi att du installerar huvudpaketet Windows App SDK NuGet, som innehåller alla komponenter. I vissa fall kan du installera ett underpaket individuellt för att bara referera till vissa komponenter i projektet. Se till exempel Installera och distribuera Windows ML.

Ytterligare steg för att packa upp appar

Om din app packas upp (vilka skrivbordsappar är som standard) finns det några ytterligare steg som krävs för att använda Windows App SDK.

Mer information om termerna paketerad och opaketerad finns i Paketeringsöversikt.

1. Installera Windows App SDK Runtime

Windows App SDK Runtime måste installeras på alla datorer där appen körs.

För utvecklingsdatorn rekommenderar vi att du besöker Latest Windows App SDK nedladdningar och sedan laddar ned, packa upp och kör något av följande:

  • Den senaste stabila versionen under Körningsnedladdningar.
  • En version och versionskanal för körningen som matchar versionen och versionskanalen för Microsoft.WindowsAppSDK NuGet-paket som du har installerat.

Välj lämpligt installationsalternativ för datorns arkitektur.

Viktig

När din app distribueras ansvarar du för att distribuera nödvändiga Windows App SDK körningspaket till dina slutanvändare. Mer information finns i distributionsguiden för Windows App SDK för ramverksberoende appar som paketeras med en extern plats eller utan paketering.

2. Initiera Windows App SDK Runtime

Som standard är en WPF-, WinForms- eller Win32-skrivbordsapp opacketerad. En app utan förpackning måste initiera Windows App SDK körtid innan man använder någon annan funktion i Windows App SDK.

Du kan göra det automatiskt när din app startar via automatisk initiering.

  1. I Prieskumník riešeníhögerklickar du på projektet och väljer Redigera projektfil.

  2. I elementet PropertyGroup lägger du till ett WindowsPackageType element inställt på None.

<WindowsPackageType>None</WindowsPackageType>

När du skapar projektet läggs dessa filer till i projektet i Visual Studio:

  • MddBootstrapAutoInitializer.cs
  • WindowsAppSDK-VersionInfo.cs

  1. Redigera .cxproj-filen manuellt.

  2. I elementet <PropertyGroup Label="Globals"> lägger du till ett WindowsPackageType element inställt på None.

<WindowsPackageType>None</WindowsPackageType>

Not

Om du har avancerade behov (till exempel anpassad felhantering eller för att läsa in en specifik version av Windows App SDK) kan du i stället för auto-initialization anropa bootstrapper-API:et explicit– mer information finns i Använd Windows App SDK runtime för appar som paketeras med extern plats eller packas upp och Tutorial: Använd bootstrapper-API:et i en app som paketeras med extern plats eller packas upp som använder Windows App SDK.

Mer information

Om du stöter på ett "Klass inte registrerad"-felet när du försöker använda en Windows App SDK-komponent kan du behöva lägga till ett dynamiskt beroende på Windows App SDK Framework-paketet i projektet. Mer information finns i MSIX-ramverkspaket och dynamiska beroenden.

Se även

  • Last updated on