Настройте ваше настольное приложение для упаковки в формат MSIX в Visual Studio

Статья
2025-04-22

Если ваше настольное приложение является приложением WinUI 3, ознакомьтесь с упаковкой приложения с помощью однопроектной MSIX. Приложение WinUI 3 — это приложение, использующее платформу Библиотеки пользовательского интерфейса Windows (WinUI) 3 для пользовательского интерфейса; и он использует пакет SDK для приложений Windows.
Но для всех других видов настольных приложений продолжайте читать эту тему.

Вы можете использовать проект упаковки приложений Windows в Visual Studio для создания пакета для настольного приложения. Затем вы можете распространить пакет в Microsoft Store, в Интернете, в вашей организации или любом другом механизме распространения, который вы используете.

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

Проект упаковки приложений Windows доступен в Visual Studio 2017 15.5 и более поздних версий.

Чтобы просмотреть шаблон проекта упаковки приложений Windows в меню "Добавить новый проект", необходимо убедиться, что установлен хотя бы один из следующих рабочих нагрузок Visual Studio:

Рабочая нагрузка "Разработка универсальной платформы Windows"
Необязательный компонент "Средства упаковки MSIX" в рабочей нагрузке NET Core.
Необязательный компонент "Средства упаковки MSIX" в среде разработки настольных приложений .NET.

Для оптимального использования рекомендуется использовать последнюю версию Visual Studio.

Это важно

Проект упаковки приложений Windows в Visual Studio поддерживается в Windows 10 версии 1607 и более поздних версиях. Его можно использовать только в проектах, предназначенных для юбилейного обновления Windows 10 (10.0; Сборка 14393) или более поздней версии.

Ниже приведены некоторые другие действия, которые можно сделать из проекта упаковки приложений Visual Studio.

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

✔️ Внесите изменения в манифест с помощью визуального конструктора.

✔️ Создайте пакет или комплект с помощью мастера.

✔️ (При публикации в Microsoft Store) Легко назначьте идентификатор приложению на основе имени, которое вы уже зарезервировали в Центре партнеров.

Подготовьте ваше приложение

Ознакомьтесь с этим руководством, прежде чем приступить к созданию пакета для приложения: Подготовка к упаковке настольного приложения.

Настройка проекта упаковки приложений Windows в решении

В Visual Studio откройте решение, содержащее проект настольного приложения.

Замечание

Если вы хотите собрать проект в конфигурации x64, убедитесь, что вы настроили связанный проект на x64. Чтобы подтвердить это, см. раздел [Дополнительные примечания](#Additional примечания) ниже.

Добавьте проект проекта упаковки приложений Windows в решение, выбрав соответствующий язык (C# или C++), соответствующий языку существующего проекта приложения dekstop.

Вам не придется добавлять код в проект упаковки. Его цель заключается только в создании и настройке пакета для вас. Мы будем ссылаться на этот проект как проект упаковки.
Установите целевую версию этого проекта на любую нужную версию, но убедитесь, что минимальная версия не ниже юбилейного обновления Windows 10.
Задайте проект упаковки приложений Windows в качестве запускаемого проекта (щелкните правой кнопкой мыши проект и выберите "Задать как начальный проект").
В Обозревателе решений щелкните правой кнопкой мыши папку зависимостей в проекте упаковки и выберите Добавить ссылку на проект....
Выберите проект настольного приложения и нажмите кнопку OK.

В ваш пакет можно включить несколько настольных приложений, но только одно из них может запускаться при выборе плитки вашего настольного приложения. На узле "Приложения" щелкните правой кнопкой мыши приложение, которое нужно запустить при выборе плитки приложения, а затем выберите "Задать в качестве точки входа".
Соберите проект упаковки, чтобы убедиться, что ошибки не возникают. При возникновении ошибок откройте Диспетчер конфигурации и убедитесь, что проекты предназначены для той же платформы.
Используйте мастер создания пакетов приложений для создания пакета MSIX, набора MSIX или файла .msixupload/.appxupload (для публикации в Microsoft Store).

Дополнительные примечания

Чтобы создать WAP для платформы x64, выполните одно из следующих действий:

Подход 1. Перед добавлением проекта WAP в любой из проектов добавьте архитектуру x64 с помощью configuration manager (как показано на снимке экрана ниже).

Configuration Manager.

Подход 2. Для существующих проектов, в которых добавлен WAP,

Удалите элементы x64 из файлов .sln вручную.

_Global_
_GlobalSection(SolutionConfigurationPlatforms) = preSolution_
_Debug|Any CPU = Debug|Any CPU_
_Debug|ARM = Debug|ARM_
_Debug|ARM64 = Debug|ARM64_ (remove)
_Debug|x64 = Debug|x64_ (remove)
_Debug|x86 = Debug|x86_
_Release|Any CPU = Release|Any CPU_
_Release|ARM = Release|ARM_
_Release|ARM64 = Release|ARM64_ (remove)
_Release|x64 = Release|x64_ (remove)
_Release|x86 = Release|x86"_