Dela via

Använda Windows App SDK i ett befintligt projekt

  • Artikel

Om du har ett skrivbordsprojekt där du vill använda Windows App SDK kan du installera Windows App SDK NuGet-paketet i projektet (den senaste versionen eller valfri version som du behöver). Appar utan paket (dvs. appar som inte använder MSIX för sin distributionsmetod) måste följa den här proceduren om de ska använda Windows App SDK. Men paketerade appar kan också göra det.

Viktig

Om du arbetar med en UWP-app kan du läsa Migrera från UWP till Windows App SDK.

Not

Den här proceduren stöds i C# .NET 6-projekt (och senare) och C++-skrivbordsprojekt. Dessa projekttyper kan använda NuGet-paket från antingen den stabila versionskanalen, förhandsversionskanaleller den experimentella versionskanalen.

Förutsättningar

Instruktioner

  1. Öppna ett befintligt projekt i Visual Studio.

    Notera

    Om du har ett C#-skrivbordsprojekt kontrollerar du att elementet TargetFramework i projektfilen är inställt på en Windows 10-specifik moniker (till exempel net6.0-windows10.0.19041.0) så att du kan anropa Windows Runtime-API:er. För mer information, se Anropa Windows Runtime-API:er i skrivbordsappar.

  2. Kontrollera att paketreferenser är aktiverade:

    1. I Visual Studio klickar du på Tools>NuGet Package Manager>Package Manager Settings.
    2. Kontrollera att PackageReference har valts för Standardpakethanteringsformat.

  3. Högerklicka på projektet i Solution Exploreroch välj Hantera NuGet-paket.

  4. I fönstret NuGet Package Manager markerar du kryssrutan Inkludera förhandsversion längst upp i fönstret, väljer fliken Bläddra och söker efter något av följande paket:

    • Om du vill installera någon av 1.0 eller senare versionersöker du efter Microsoft.WindowsAppSDK-paketet.
    • Om du vill installera någon av 0.8-versionernasöker du efter paketet Microsoft.ProjectReunion.

  5. När du har hittat rätt Windows App SDK NuGet-paket väljer du paketet och klickar på Installera i den högra rutan i fönstret NuGet Package Manager.

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

    Obs

    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. Du kan inte installera dessa underpaket individuellt för att bara referera till vissa komponenter i projektet. Du måste installera huvudpaketet för Windows App SDK NuGet, som innehåller alla komponenter.

  6. Endast för opaketerade appar. Innan din uppackade app kan använda Windows App SDK-API:er och komponenter måste appen först ladda Windows App SDK-runtime för att referera till Windows App SDK-ramverkspaketet. Mer information finns i Använd Windows App SDK-runtime för appar som paketeras med extern läge eller är ouppackade och Självstudie: Använda bootstrapper-API:et i en app som paketeras med extern läge eller är ouppackad och använder Windows App SDK.

  7. Din app kan nu använda Windows App SDK-API:er och komponenter som är tillgängliga i den versionskanal som du har installerat. För en lista över tillgängliga funktioner, se versionskanaler.

Mer information

Om ditt befintliga projekt är ett C++-projekt och du vill anropa Windows Runtime-API:er i Windows App SDK måste du lägga till stöd för C++/WinRT. Se Visual Studio-stöd för C++/WinRT, XAML, VSIX-tillägget och NuGet-paketet. Leta efter information där om paketet Microsoft.Windows.CppWinRT NuGet. Utan det paketet kommer projektet inte att kunna hitta namnområdeshuvudfilerna för Windows Runtime-API:er i Windows App SDK.

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