Настройка классического приложения для упаковки с помощью MSIX в Visual StudioSet up your desktop application for MSIX packaging in Visual Studio

Для создания пакета для классического приложения в Visual Studio можно использовать Проект упаковки приложений Windows.You can use the Windows Application Packaging Project project in Visual Studio to generate a package for your desktop app. Затем вы можете распространить пакет в Microsoft Store, в Интернете, на своем предприятии или с помощью любого другого механизма распространения.Then you can distribute your package to the Microsoft Store, on the Web, in your enterprise or any other distribution mechanism you're using.

Требуемая версия и рабочая нагрузка Visual StudioRequired Visual Studio version and workload

Проект упаковки приложений Windows доступен в приведенных ниже версиях Visual Studio.The Windows Application Packaging Project project is available in the following versions of Visual Studio:

  • Visual Studio 2019Visual Studio 2019
  • Visual Studio 2017 15.5 и более поздних версийVisual Studio 2017 15.5 and later

Чтобы шаблон проекта упаковки приложений Windows отобразился в меню "Добавление проекта", убедитесь, что у вас установлена хотя бы одна из следующих рабочих нагрузок Visual Studio:To see the Windows Application Packaging Project template in the 'Add New Project' menu, you need to make sure you have at least one of the following the Visual Studio workloads installed:

  • рабочая нагрузка "Разработка приложений для универсальной платформы Windows";The 'Universal Windows Platform development' workload
  • дополнительный компонент "Средства упаковки MSIX" в рабочей нагрузке .NET Core;The Optional Component 'MSIX Packaging Tools' in the NET Core workload.
  • дополнительный компонент "Средства упаковки MSIX" в рабочей нагрузке "Разработка классических приложений .NET".The Optional Component 'MSIX Packaging Tools' in the .NET desktop development workload.

Для оптимальной работы рекомендуем использовать последний выпуск Visual Studio.For the best experience we recommend that you use the latest Visual Studio release.

Важно!

Проект упаковки приложений Windows в Visual Studio поддерживается в Windows 10 версии 1607 и более поздних версиях.The Windows Application Packaging Project project in Visual Studio is supported on Windows 10, version 1607, and later. Его можно использовать только в проектах, предназначенных для юбилейного обновления Windows 10 (10.0; сборка 14393) или более поздней версии.It can only be used in projects that target Windows 10 Anniversary Update (10.0; Build 14393) or a later release.

Ниже приведены некоторые другие действия, которые можно выполнить в проекте упаковки приложений Visual Studio.Here are a few other things you can do from the Visual Studio Application Packaging Project:

✔️ Автоматическое создание визуальных ресурсовAutomatically generate visual assets.

✔️ Внесение изменений в манифест с помощью визуального конструктораMake changes to your manifest using a visual designer.

✔️ Создание пакета или набора с использованием мастераGenerate your package or bundle using a wizard.

✔️ (При публикации в Microsoft Store) Простое назначение приложению идентификатора на основе имени, уже зарезервированного в Центре партнеров.(If publishing to the Microsoft Store) Easily assign an identity to your application from a name that you've already reserved in Partner Center.

Подготовьте свое приложениеPrepare your application

Прежде чем приступить к созданию пакета для приложения, ознакомьтесь с этим руководством. Prepare to package a desktop application (Подготовка к упаковке классического приложения).Review this guide before you begin creating a package for your application: Prepare to package a desktop application.

Установите Проект упаковки приложения Windows в свое решение.Setup the Windows Application Packaging Project in your solution

  1. В Visual Studio откройте решение, содержащее проект вашего классического приложения.In Visual Studio, open the solution that contains your desktop application project.

  2. Добавьте Проект упаковки приложения Windows в свое решение.Add a Windows Application Packaging Project project to your solution.

    Вам не потребуется добавлять в него какой-либо код.You won't have to add any code to it. Он используется только для создания пакета.It's just there to generate a package for you. Мы будем называть этот проект "проектом упаковки".We'll refer to this project as the "packaging project".

    Проект упаковки

  3. Задайте целевую версию проекта (любую), но не забудьте указать для параметра Минимальная версия значение Юбилейное обновление Windows 10.Set the Target Version of this project to any version that you want, but make sure to set the Minimum Version to Windows 10 Anniversary Update.

    Диалоговое окно выбора версии упаковки

  4. В Обозревателе решений щелкните правой кнопкой мыши Приложения в проекте упаковки и выберите команду Добавить ссылку.In Solution Explorer, right-click the Applications folder under the packaging project and choose Add Reference.

    Добавление ссылки на проект

  5. Выберите пакет классического приложения и нажмите кнопку ОК.Choose your desktop application project, and then choose the OK button.

    Проект классического приложения

    В пакет можно включить несколько классических приложений, однако, когда пользователи выбирают плитку с вашим приложением, запустить можно только одно из них.You can include multiple desktop applications in your package, but only one of them can start when users choose your app tile. В узле Приложения щелкните правой кнопкой мыши приложение, которое пользователи должны запускать, выбирая плитку приложения, и выберите Задать как точку входа.In the Applications node, right-click the application that you want users to start when they choose the app's tile, and then choose Set as Entry Point.

    Задать как точку входа

  6. Соберите проект упаковки, чтобы убедиться, что ошибок нет.Build the packaging project to ensure that no errors appear. При возникновении ошибок откройте Диспетчер конфигурации и убедитесь, что проекты предназначены для той же платформы.If you receive errors, open Configuration Manager and ensure that your projects target the same platform.

    Диспетчер конфигурации

  7. Используйте мастер Создание пакетов приложения, чтобы создать пакет или набор MSIX или файл .msixupload/.appxupload (для публикации в Store).Use the Create App Packages wizard to generate an MSIX package/bundle or an .msixupload/.appxupload file (for Store publishing to the Store).

Дальнейшие действияNext steps

Упаковка классического приложения в Visual StudioPackage your desktop app in Visual Studio

См. статью Package a desktop or UWP app in Visual Studio (Упаковка классического приложения или приложения UWP в Visual Studio)See Package a Desktop or UWP app in Visual Studio

Запуск, отладка и тестирование классических приложенийRun, debug or test your desktop application

См. Запуск, отладка и тестирование упакованного классического приложенияSee Run, debug, and test a packaged application

Дополнительные ресурсыAdditional resources

ВидеоVideo

 

Call UWP APIs in desktop apps (Вызов API UWP в классических приложениях)Enhance your desktop application by adding UWP APIs

См. Улучшение классического приложения для Windows 10See Enhance your desktop application for Windows 10

Улучшение классического приложения путем добавления проектов UWP и компоненты среды выполнения WindowsExtend your desktop application by adding UWP projects and Windows Runtime Components

См. в статье Extend your desktop app with modern UWP components (Улучшение классических приложений с помощью современных компонентов UWP).See Extend your desktop application with modern UWP components.

Распространение приложенияDistribute your app

См. статью Distribute your packaged desktop app (Распространение упакованного классического приложения)See Distribute a packaged desktop application