Поделиться через

Использование пакета Windows App SDK в существующем проекте

Если у вас есть рабочий стол проект, в котором вы хотите использовать Windows App SDK, вы можете установить пакет NuGet Windows App SDK в ваш проект (последнюю версию или любую другую нужную версию). Распакованные приложения (т. е. приложения, которые не используют MSIX для их технологии развертывания), должны следовать этой процедуре, если они используют пакет SDK для приложений Windows. Но упакованные приложения тоже могут это сделать.

Внимание

Если вы работаете с приложением UWP, перейдите к разделу "Миграция из UWP" в пакет SDK для приложений Windows.

Примечание.

Эта процедура поддерживается в проектах C# .NET 6 (и более поздних версиях) и классических проектах C++ . Эти типы проектов могут использовать пакеты NuGet из стабильного канала выпуска, канала предварительной версии или экспериментального канала выпуска.

Требования

  • Visual Studio 2026 или более поздней версии.
  • Рабочие нагрузки и компоненты для разработки приложений Для Windows. Дополнительные сведения см. в разделе "Установка средств" для пакета SDK для приложений Windows.

Инструкции

  1. Откройте существующий проект в Visual Studio.

    Примечание.

    Если у вас есть настольный проект C#, убедитесь, что элемент TargetFramework в файле проекта имеет уникальное определение для Windows 10 (например, net6.0-windows10.0.19041.0), чтобы можно было вызывать API-интерфейсы среды выполнения Windows. Дополнительные сведения см. в статье Вызов API Windows Runtime в настольных приложениях.

  2. Убедитесь, что включены ссылки на пакеты:

    1. В Visual Studio выберите элементы Сервис>Диспетчер пакетов NuGet>Параметры диспетчера пакетов.
    2. Убедитесь, что PackageReference выбран для формата управления пакетами по умолчанию.

  3. Щелкните правой кнопкой мыши проект в обозревателе решений и выберите Управление пакетами NuGet.

  4. В окне диспетчер пакетов NuGet установите флажок "Включить предварительную версию" в верхней части окна, перейдите на вкладку "Обзор" и найдите один из следующих пакетов:

    • Чтобы установить один из выпусков версии 1.0 или более поздней версии, найдите пакет Microsoft.WindowsAppSDK .
    • Чтобы установить один из выпусков 0.8, найдите пакет Microsoft.ProjectReunion .

  5. После того как вы нашли соответствующий пакет NuGet для приложений Windows, выберите пакет и нажмите кнопку "Установить" в правой области окна NuGet диспетчер пакетов.

    Снимок экрана установки пакета NuGet Windows App SDK

    Примечание.

    Пакет NuGet Windows App SDK содержит другие вложенные пакеты (включая Microsoft.WindowsAppSDK.Foundation, Microsoft.WindowsAppSDK.WinUI и другие), которые содержат реализации для определенных компонентов в Windows App SDK. Вы не можете установить эти вложенные пакеты по отдельности, чтобы ссылаться только на определенные компоненты в проекте. Необходимо установить основной пакет NuGet пакета SDK для приложений Windows, который включает все компоненты.

  6. Только для распакованных приложений. Прежде чем распакованное приложение сможет использовать API и компоненты Windows App SDK, приложение должно сначала загрузить исполняемую среду Windows App SDK, чтобы ссылаться на пакет фреймворка Windows App SDK. Дополнительные сведения см. в разделе «Использование среды выполнения Windows App SDK для приложений, упакованных с внешним расположением или без упаковки» и «Учебник: Использование API загрузчика в приложении, упакованном с внешним расположением или без упаковки и использующем Windows App SDK».

  7. Теперь приложение может использовать API и компоненты пакета SDK для приложений Windows, доступные в установленном канале выпуска. Список доступных функций см. в разделе "Каналы выпуска".

Дополнительные сведения

Если ваш существующий проект является проектом на C++, и вы хотите использовать Windows Runtime API в Windows App SDK, необходимо добавить поддержку C++/WinRT. Поддержка Visual Studio для C++/WinRT, XAML, расширения VSIX и пакета NuGet. Найдите сведения о пакете Microsoft.Windows.CppWinRT NuGet. Без этого пакета ваш проект не сможет найти файлы заголовков пространства имен для Windows Runtime API в Windows App SDK.

Если появляется ошибка Класс не зарегистрирован при попытке использовать компонент Windows App SDK, возможно, вам потребуется добавить в проект динамическую зависимость от пакета Windows App SDK Framework. Дополнительные сведения см. в статье о пакетах платформы MSIX и динамических зависимостях.

См. также

  • Last updated on