Udostępnij za pośrednictwem

Korzystanie z zestawu SDK aplikacji systemu Windows w istniejącym projekcie

  • Artykuł

Jeśli masz projekt klasyczny, w którym chcesz użyć zestawu SDK aplikacji systemu Windows, możesz zainstalować pakiet NuGet zestawu SDK aplikacji systemu Windows w projekcie (najnowszą wersję lub dowolną potrzebną wersję). Aplikacje rozpakowane (czyli aplikacje, które nie używają MSIX do ich technologii wdrażania) muszą postępować zgodnie z tą procedurą, jeśli mają używać Windows App SDK. Jednak spakowane aplikacje również mogą to zrobić.

Ważny

Jeśli pracujesz nad aplikacją platformy UWP, zapoznaj się z tematem Migrate from UWP to the Windows App SDK.

Notatka

Ta procedura jest obsługiwana w projektach C# .NET 6 (i nowszych) oraz projektach klasycznych języka C++. Te typy projektów mogą używać pakietów NuGet z kanału stabilnego wydania , wersji zapoznawczej kanału wydania lub eksperymentalnego kanału wydania .

Warunki wstępne

Instrukcje

  1. Otwórz istniejący projekt w programie Visual Studio.

    Notatka

    Jeśli masz projekt desktopowy w języku C#, upewnij się, że element TargetFramework w pliku projektu jest ustawiony na moniker specyficzny dla systemu Windows 10 (na przykład net6.0-windows10.0.19041.0), aby można było wywoływać interfejsy API środowiska uruchomieniowego systemu Windows. Aby uzyskać więcej informacji, zobacz Wywoływanie interfejsów API środowiska uruchomieniowego Windows w aplikacjach desktopowych.

  2. Upewnij się, że odwołania do pakietów są włączone:

    1. W programie Visual Studio kliknij opcję Tools>NuGet Package Manager>Package Manager Settings.
    2. Upewnij się, że PackageReference jest wybrany jako domyślny format zarządzania pakietami.

  3. Kliknij prawym przyciskiem myszy projekt w eksploratorze rozwiązań , a następnie wybierz pozycję Zarządzaj pakietami NuGet.

  4. W oknie menedżera pakietów NuGet zaznacz pole wyboru Dołącz wersję wstępną w górnej części okna, wybierz kartę Przeglądaj i wyszukaj jeden z następujących pakietów:

    • Aby zainstalować jedną z wersji 1.0 lub nowszych, wyszukaj pakiet Microsoft.WindowsAppSDK.
    • Aby zainstalować jedną z wersji 0.8, wyszukaj pakiet Microsoft.ProjectReunion.

  5. Po znalezieniu odpowiedniego pakietu NuGet dla Windows App SDK, wybierz pakiet, a następnie kliknij Zainstaluj w prawym okienku okna Menedżera pakietów NuGet.

    Zrzut ekranu przedstawiający instalowany pakiet NuGet zestawu SDK aplikacji systemu Windows

    Notatka

    Pakiet NuGet zestawu SDK aplikacji systemu Windows zawiera inne podpakiety (w tym Microsoft.WindowsAppSDK.Foundation, Microsoft.WindowsAppSDK.WinUIi inne), które zawierają implementacje dla określonych składników w zestawie SDK aplikacji systemu Windows. Nie można zainstalować tych pakietów podrzędnych indywidualnie, aby odwoływać się tylko do niektórych składników w projekcie. Należy zainstalować główny pakiet NuGet zestawu SDK aplikacji systemu Windows, który zawiera wszystkie składniki.

  6. W przypadku aplikacji rozpakowanych tylko. Zanim rozpakowana aplikacja będzie mogła używać interfejsów API i składników zestawu SDK aplikacji systemu Windows, aplikacja musi najpierw załadować środowisko uruchomieniowe zestawu SDK aplikacji systemu Windows, aby odwołać się do pakietu struktury zestawu SDK aplikacji systemu Windows. Aby uzyskać więcej informacji, zobacz Używanie środowiska wykonawczego Windows App SDK dla aplikacji spakowanych z zewnętrzną lokalizacją lub niespakowanych oraz Samouczek: Używanie API bootstrappera w aplikacji spakowanej z zewnętrzną lokalizacją lub niespakowanej, która wykorzystuje Windows App SDK.

  7. Aplikacja może teraz używać interfejsów API i składników zestawu SDK aplikacji systemu Windows, które są dostępne w kanale wydania udostępnionym po instalacji. Aby uzyskać listę dostępnych funkcji, sprawdź kanały wydania .

Dalsze informacje

Jeśli istniejący projekt jest projektem języka C++ i chcesz wywołać interfejsy API środowiska uruchomieniowego systemu Windows w zestawie SDK aplikacji systemu Windows, musisz dodać obsługę języka C++/WinRT. Zobacz wsparcie Visual Studio dla C++/WinRT, XAML, rozszerzenia VSIX i pakietu NuGet. Poszukaj informacji na temat pakietu Microsoft.Windows.CppWinRT NuGet. Bez tego pakietu projekt nie będzie mógł znaleźć plików nagłówków przestrzeni nazw dla interfejsów API środowiska uruchomieniowego systemu Windows w zestawie SDK aplikacji systemu Windows.

Jeśli wystąpi błąd Klasa niezarejestrowana podczas próby użycia komponentu Windows App SDK, może być konieczne dodanie do projektu dynamicznej zależności od pakietu Windows App SDK Framework. Aby uzyskać więcej informacji, zobacz pakiety struktury MSIX i zależności dynamiczne.

Zobacz też