Sdílet prostřednictvím

Použití sady Windows App SDK v existujícím projektu

Pokud máte desktopový projekt, ve kterém chcete použít sadu Windows App SDK, můžete do projektu nainstalovat balíček NuGet sady Windows App SDK (nejnovější verze nebo libovolná verze, kterou potřebujete). Nebalené aplikace (to znamená aplikace, které nepoužívají MSIX jako svou technologii nasazení) musí dodržet tento postup, pokud chtějí používat Windows App SDK. Zabalené aplikace ale můžou to udělat i.

Důležitý

Pokud pracujete na aplikaci pro UWP, přečtěte si informace o Migrace z UWP do sady Windows App SDK.

Poznámka

Tento postup je podporován v projektech C# .NET 6 (a novějších) a desktopových projektech C++. Tyto typy projektů mohou používat balíčky NuGet ze stabilního kanálu verze , kanálu verze Preview , nebo z kanálu experimentální verze .

Požadavky

Instrukce

  1. Otevřete existující projekt v sadě Visual Studio.

    Poznámka

    Pokud máte desktopový projekt C#, ujistěte se, že je prvek TargetFramework v souboru projektu nastavený na moniker specifický pro Windows 10 (například net6.0-windows10.0.19041.0), abyste mohli volat rozhraní API prostředí Windows Runtime. Další informace najdete v tématu Volání rozhraní API prostředí Windows Runtime v desktopových aplikacích.

  2. Ujistěte se, že jsou povolené odkazy na balíček :

    1. V sadě Visual Studio klikněte na Tools>Správce balíčků NuGet>Nastavení Správce balíčků.
    2. Ujistěte se, že PackageReference je vybrán jako výchozí formát správy balíčků.

  3. Klikněte pravým tlačítkem na projekt v Průzkumníku řešenía zvolte Spravovat balíčky NuGet.

  4. V okně správce balíčků NuGet zaškrtněte políčko Zahrnout předběžné verze v horní části okna, vyberte kartu Procházet a vyhledejte jeden z následujících balíčků:

    • Pokud chcete nainstalovat některou z verzí 1.0 nebo novějších, vyhledejte balíček Microsoft.WindowsAppSDK.
    • Pokud chcete nainstalovat některou z verzí 0.8, vyhledejte balíček Microsoft.ProjectReunion.

  5. Jakmile najdete příslušný balíček NuGet sady Windows App SDK, vyberte balíček a klikněte na Nainstalovat v pravém podokně okna Správce balíčků NuGet.

    snímek obrazovky s nainstalovaným balíčkem NuGet sady Windows App SDK

    Poznámka

    Balíček NuGet sady Windows App SDK obsahuje další dílčí balíčky (včetně Microsoft.WindowsAppSDK.Foundation, Microsoft.WindowsAppSDK.WinUIa dalších), které obsahují implementace pro konkrétní součásti v sadě Windows App SDK. Tyto dílčí balíčky nemůžete nainstalovat jednotlivě, abyste mohli odkazovat pouze na určité součásti v projektu. Musíte nainstalovat hlavní balíček NuGet sady Windows App SDK, který obsahuje všechny komponenty.

  6. Pro rozbalené aplikace pouze. Než bude vaše rozbalená aplikace moct používat rozhraní API a komponenty sady Windows App SDK, musí vaše aplikace nejprve načíst modul runtime sady Windows App SDK, aby odkázala na balíček frameworku sady Windows App SDK. Další informace najdete v tématu Použití modulu runtime sady Windows App SDK pro aplikace zabalené s externím umístěním nebo bez balíčku a Kurz: Použití rozhraní API bootstrapperu v aplikaci zabalené s externím umístěním nebo bez balíčku, která používá sadu Windows App SDK.

  7. Vaše aplikace teď může používat rozhraní API a komponenty sady Windows App SDK, které jsou k dispozici v kanálu vydané verze, který jste nainstalovali. Pro seznam dostupných funkcí se podívejte na kanály vydaných verzí .

Další informace

Pokud je váš existující projekt projektem C++ a chcete volat rozhraní API prostředí Windows Runtime v sadě Windows App SDK, budete muset přidat podporu pro C++/WinRT. Viz podpora sady Visual Studio pro C++/WinRT, XAML, rozšíření VSIX a balíček NuGet. Vyhledejte informace o balíčku Microsoft.Windows.CppWinRT NuGet. Bez tohoto balíčku nebude váš projekt moct najít soubory hlaviček oboru názvů pro rozhraní API prostředí Windows Runtime v sadě SDK Windows App.

Pokud při pokusu o použití komponenty Windows App SDK narazíte na chybu třídy Class not registered, možná budete muset do projektu přidat dynamickou závislost na balíčku Windows App SDK Framework. Další informace najdete v tématu balíčky architektury MSIX a dynamické závislosti.

Viz také

  • Last updated on