Упаковка настольного приложения или приложения UWP в Visual Studio

Перед распространением приложения необходимо упаковать его. В этой статье описывается процесс настройки, создания и тестирования пакета MSIX с помощью Visual Studio.

Типы пакетов приложений

• Пакет приложения (MSIX или .appx)
  Один пакет, содержащий приложение и его ресурсы, предназначенный для одной архитектуры устройства. Например, пакет приложения x64 или x86. Для назначения нескольких архитектур с помощью пакета приложений необходимо создать один для каждой архитектуры.

• Пакет приложений (.msixbundle или .appxbundle)
  Пакет приложений — это тип пакета, который может содержать несколько пакетов приложений, каждый из которых построен для поддержки конкретной архитектуры устройства. Например, пакет приложений может содержать три отдельных пакета приложений для конфигураций x86, x64 и ARM. Пакеты приложений должны создаваться по возможности, так как они позволяют приложению быть доступными на самом широком диапазоне устройств.

• Файл отправки пакета приложения (.msixupload или .appxupload) — только для отправки в Магазин
  Один файл, который может содержать несколько пакетов приложений или пакет приложений для поддержки различных архитектур процессоров. Файл загрузки пакета приложения также содержит символьный файл для проанализировать производительность приложения после публикации приложения в Microsoft Store. Этот файл будет автоматически создан для вас, если вы упаковывают приложение с Visual Studio с намерением отправить его в Центр партнеров для публикации в Microsoft Store.

Ниже приведен обзор шагов по подготовке и созданию пакета приложения:

1. Перед упаковкой приложения. Выполните следующие действия, чтобы убедиться, что приложение готово к упаковке.

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

3. Создайте пакет приложения. Используйте мастер упаковки Visual Studio для создания пакета приложения.

4. Запуск, отладка и тестирование упаковаемого приложения. Запустите и отладите пакет приложения из Visual Studio или путем установки пакета напрямую.

Перед упаковкой приложения

1. Тестирование приложения. Прежде чем упаковать приложение, убедитесь, что оно работает должным образом во всех семействах устройств, которые вы планируете поддерживать. К этим семействам устройств могут относиться настольные компьютеры, мобильные устройства, Surface Hub, Xbox, IoT-устройства или другие. Дополнительные сведения о развертывании и тестировании приложения с помощью Visual Studio см. в статье под названием Развертывание и отладка приложений UWP (также относится к упакованным настольным приложениям).

2. Оптимизация приложения. Вы можете использовать средства профилирования и отладки Visual Studio для оптимизации производительности упаковаемого приложения. Например, инструмент временной шкалы для оценки отзывчивости пользовательского интерфейса, инструмент анализа использования памяти, инструмент анализа использования ЦП и многое другое. Дополнительные сведения об этих средствах см. в разделе " Обзор функций профилирования ".

3. Проверьте .NET встроенную совместимость (для приложений VB и C#). В универсальная платформа Windows есть собственный компилятор, который улучшит производительность среды выполнения приложения. При этом изменении необходимо протестировать приложение в этой среде компиляции. По умолчанию конфигурация сборки Release включает .NET native цепочку инструментов, поэтому важно проверить работу приложения с помощью этой Release и проверить, работает ли ваше приложение должным образом.

Настройка проекта

Файл манифеста приложения (Package.appxmanifest) — это XML-файл, содержащий свойства и параметры, необходимые для создания пакета приложения. Например, свойства в файле манифеста приложения описывают изображение, используемое в качестве плитки приложения, и ориентации, поддерживаемые приложением при повороте устройства пользователем.

Конструктор манифестов Visual Studio позволяет обновлять файл манифеста без редактирования необработанного XML-файла.

Настройка пакета с помощью конструктора манифестов

1. В Обозреватель решений разверните узел проекта приложения.

2. Дважды щелкните файл Package.appxmanifest. Если файл манифеста уже открыт в представлении XML-кода, Visual Studio предложит закрыть файл.

3. Теперь вы можете решить, как настроить приложение. Каждая вкладка содержит настраиваемые сведения о вашем приложении и, при необходимости, ссылки на дополнительные материалы.

   конструктор

   Убедитесь, что у вас есть все изображения, необходимые для приложения на вкладке "Визуальные ресурсы ". Здесь можно указать значки и логотипы приложения.

   На вкладке "Упаковка" можно ввести данные публикации. Здесь можно выбрать сертификат, используемый для подписи приложения. Все приложения MSIX должны быть подписаны сертификатом.

   Замечание

   Начиная с Visual Studio 2019 года временный сертификат больше не создается в упакованных классических проектах или проектах UWP. Чтобы создать или экспортировать сертификаты, используйте командлеты PowerShell, описанные в этой статье. В последних версиях Visual Studio можно также подписать ваше приложение сертификатом, хранящимся в Azure Key Vault для сценариев разработки и тестирования.

   Это важно

   Если вы публикуете приложение в Microsoft Store, ваше приложение будет подписано доверенным сертификатом для вас. Это позволяет пользователю устанавливать и запускать приложение без установки связанного сертификата подписи приложения.

   При установке пакета приложения на устройстве сначала необходимо доверять пакету. Чтобы доверять пакету, сертификат должен быть установлен на устройстве пользователя.

4. Сохраните файл Package.appxmanifest после внесения необходимых изменений для приложения.

Если приложение распространяется через Microsoft Store, Visual Studio может связать пакет с Магазином. Для этого щелкните правой кнопкой мыши имя вашего проекта в Обозреватель решений и выберите Publish->Associate App с Store (до версии 16.3 Visual Studio 2019 меню Publish называлось Store). Это также можно сделать в мастере создания пакетов приложений , который описан в следующем разделе. При связывании приложения некоторые поля на вкладке "Упаковка" конструктора манифестов автоматически обновляются.

Создание пакета приложения

Приложения можно устанавливать без публикации в Магазине, публикуя их на веб-сайте, используя такие средства управления приложениями, как Microsoft Intune и Configuration Manager и т. д. Вы также можете напрямую установить пакет MSIX для тестирования на локальном или удаленном компьютере.

Создание пакета приложения с помощью мастера упаковки

Замечание

Следующие инструкции и снимки экрана описывают процесс по состоянию на Visual Studio 2019 версии 16.3. Если вы используете более раннюю версию, некоторые элементы пользовательского интерфейса могут выглядеть иначе. Если вы упаковываете настольное приложение, щелкните правой кнопкой мыши узел проекта упаковки приложений Windows.

1. В Обозреватель решений откройте решение для проекта приложения.

2. Щелкните проект правой кнопкой мыши и выберите Publish->Создание пакетов приложений (до Visual Studio 2019 версии 16.3, меню Publish называется Store).

   

3. Выберите Сайдлоадинг на первой странице мастера и нажмите Далее.

   

4. На странице "Выбор метода подписывания" выберите, следует ли пропустить подпись упаковки или выбрать сертификат для подписывания. Вы можете выбрать сертификат из локального хранилища сертификатов, выбрать файл сертификата или создать новый сертификат. Чтобы пакет MSIX был установлен на компьютере конечного пользователя, он должен быть подписан сертификатом, доверенным на компьютере.

   

5. Заполните страницу Выберите и настройте пакеты, как описано в разделе Create your app package upload file using Visual Studio.

Установка пакета приложения путем двойного щелчка

Пакеты приложений можно установить, дважды щелкнув файл пакета приложения. Для этого перейдите к файлу пакета приложения или набора приложений и дважды щелкните по нему. Установщик приложений запускает и предоставляет основные сведения о приложении, а также кнопку установки, индикатор хода установки и все соответствующие сообщения об ошибках.

Замечание

Установщик приложений предполагает, что пакет был подписан доверенным сертификатом на устройстве. Если это не так, необходимо установить сертификат подписи в хранилище доверенных пользователей или доверенных издателей центра сертификации на устройстве. Если вы не знаете, как это сделать, см. статью "Установка тестовых сертификатов".

Установка пакета приложения с помощью скрипта установки

1. Откройте папку *_Test.

2. Щелкните правой кнопкой мыши файл Add-AppDevPackage.ps1 . Выберите "Выполнить с помощью PowerShell " и следуйте инструкциям.
   

   Когда пакет приложения установлен, окно PowerShell отображает следующее сообщение: приложение успешно установлено.

3. Нажмите кнопку "Пуск", чтобы найти приложение по имени, а затем запустите его.

Дальнейшие действия. Отладка и проверка пакета приложения

Ознакомьтесь с Запуск, отладка и тестирование пакета приложения для того, чтобы узнать, как можно отладить ваше приложение в Visual Studio или используя инструменты отладки Windows.

Создайте файл пакета приложения для публикации в Магазине

Чтобы распространить приложение в Microsoft Store, рекомендуется создать файл отправки пакета app package upload (.msixupload или .appxupload) и отправить этот файл в Центр партнеров. Хотя можно отправить в Центр партнеров только пакет или набор приложений, мы рекомендуем вместо этого отправить файл загрузки пакета приложения.

Файл отправки пакета приложения можно создать с помощью мастера отправки пакета приложений Create App Packages в Visual Studio или создать его вручную из существующих пакетов приложений или пакетов приложений.

Замечание

Если вы хотите создать пакет приложения (MSIX or.appx) или пакет приложений (.msixbundle или .appxbundle) вручную, см. статью "Создание пакета приложения с помощью средства MakeAppx.exe".

Создание файла отправки пакета приложения с помощью Visual Studio

Замечание

Следующие инструкции и снимки экрана описывают процесс по состоянию на Visual Studio 2019 версии 16.3. Если вы используете более раннюю версию, некоторые элементы пользовательского интерфейса могут выглядеть иначе.

1. В Обозреватель решений откройте решение для проекта приложения UWP.

2. Щелкните проект правой кнопкой мыши и выберите Publish->Создание пакетов приложений (до Visual Studio 2019 версии 16.3, меню Publish называется Store). Если этот параметр отключен или не отображается вообще, убедитесь, что проект является универсальным проектом Windows.

   

   Откроется мастер создания пакетов приложений .

3. Выберите Microsoft Store используя новое имя приложения в первом диалоговом окне, а затем щелкните Next.

   диалоговое окно создания пакетов, показанное с помощью Microsoft Store

   Если вы уже связали проект с приложением в Магазине, вы также можете создать пакеты для связанного приложения Store. Если выбрать Sideloading, Visual Studio не создаст файл пакета приложения для загрузки (.msixupload или .appxupload) для размещения в Центре партнеров. Если вы хотите создать пакет MSIX или комплект для распространения вне Магазина, можно выбрать этот параметр.

4. На следующей странице войдите с учетной записью разработчика в Центр партнеров. Если у вас еще нет учетной записи разработчика, мастер поможет вам создать ее.

   

5. Выберите название приложения для вашего пакета из списка приложений, зарегистрированных в вашей учетной записи, или зарезервируйте новое в Центре партнёров, если вы еще не сделали это.

   Замечание

   Если вы используете Visual Studio 2017, вы не сможете перечислить приложения, зарегистрированные в вашей учетной записи, или зарезервировать новые имена приложений при использовании учетная запись Майкрософт (MSA), будут работать только учетные записи Microsoft Entra ID (AAD). Учетные записи MSA поддерживаются начиная с Visual Studio 2019 года.

6. Убедитесь, что выбраны все три конфигурации архитектуры (x86, x64 и ARM) в диалоговом окне "Выбор и настройка пакетов ", чтобы обеспечить развертывание приложения на самых широких диапазонах устройств. В списке " Создание пакета приложений " выберите Always. Пакет приложений (.appxbundle или msixbundle) предпочтителен для одного файла пакета приложения, так как он содержит коллекцию пакетов приложений, настроенных для каждого типа архитектуры процессора. При выборе генерации пакета приложений, он будет включен в окончательный файл загрузки пакета приложения (.appxupload или .msixupload) вместе с отладочной и аварийной аналитической информацией. Если вы не уверены, какие архитектуры следует выбрать, или хотите узнать больше о том, какие архитектуры используются различными устройствами, см. в разделе архитектуры пакетов приложений.

   

7. Включите общедоступные файлы символов для анализа производительности приложения из Центра партнеров после публикации приложения. Настройте дополнительные сведения, такие как нумерирование версий или расположение выходных данных пакета.

8. Нажмите кнопку "Создать", чтобы создать пакет приложения. Если вы выбрали один из Я хочу создать пакеты для отправки в Microsoft Store параметров на шаге 3 и создаёте пакет для отправки в Центр партнеров, мастер создаст файл отправки пакета (.appxupload или .msixupload). Если вы выбрали Я хочу создать пакеты для боковой загрузки на этапе 3, мастер создаст либо один пакет приложения, либо набор приложений на основе ваших вариантов, выбраных на этапе 6.

9. Когда приложение успешно упаковано, отобразится это диалоговое окно и вы можете получить файл отправки пакета приложения из указанного места вывода. На этом этапе можно проверить пакет приложения на локальном компьютере или удаленном компьютере и автоматизировать отправку в магазин.

   

Создание файла загрузки пакета приложения вручную

1. Поместите следующие файлы в папку:

   • Один или несколько пакетов приложений (MSIX или .appx) или пакет приложений (.msixbundle или .appxbundle).
   • Файл .appxsym. Это сжатый PDB-файл, содержащий публичные символы приложения, используемые для аварийной аналитики в Партнёрском центре. Этот файл можно опустить, но если это сделать, для приложения не будет доступна информация о аварийной аналитике или отладке.

2. Выберите все файлы в папке, щелкните по ним правой кнопкой мыши и выберите Отправить в>.

3. Измените имя расширения нового ZIP-файла с .zip на MSixupload или .appxupload.

Проверьте пакет приложения

Проверьте приложение перед отправкой в Центр партнеров для сертификации на локальном или удаленном компьютере. Вы можете проверять только релизные сборки пакета приложения, а не отладочные. Дополнительные сведения о отправке приложения в Центр партнеров см. в разделе "Отправка приложений".

Проверьте локально ваш пакет приложения

Замечание

Набор для сертификации приложений Windows (WACK) устарел и больше не поддерживается, однако его можно использовать для выполнения необязательных локальных проверок перед отправкой. Официальная сертификация выполняется автоматически при отправке пакета в Центр партнеров. См. статью "Отправка приложений".

1. На последней странице Создание пакета завершено мастера Создание пакетов приложений, оставьте параметр Локальный компьютер и щелкните Запустить Комплект сертификации Windows. Дополнительные сведения о тестировании вашего приложения с помощью комплекта сертификации приложений Windows читайте в комплекте сертификации приложение для Windows.

   Пакет сертификации приложение для Windows (WACK) выполняет различные тесты и возвращает результаты. Дополнительные сведения см. в разделе тесты комплекта сертификации приложений для Windows.

   Если у вас есть удаленное Windows 10 устройство, которое вы хотите использовать для тестирования, необходимо установить пакет сертификации приложение для Windows вручную на этом устройстве. В следующем разделе описаны следующие действия. После этого вы можете выбрать Удаленный компьютер и нажать на Запустить комплект сертификации приложений Windows, чтобы подключиться к удаленному устройству и выполнить тесты проверки.

2. После завершения WACK и прохождения сертификации приложение готово к отправке приложения в Центр партнеров. Убедитесь, что вы отправите правильный файл. Расположение файла по умолчанию можно найти в корневой папке решения \[AppName]\AppPackages , и оно завершится расширением ФАЙЛА .appxupload или MSIXupload. Имя будет иметь форму [AppName]_[AppVersion]_x86_x64_arm_bundle.appxupload или [AppName]_[AppVersion]_x86_x64_arm_bundle.msixupload если вы выбрали пакет приложений со всеми выбранными архитектурами пакета.

Проверка пакета приложения на удаленном устройстве Windows 10

1. Включите устройство Windows 10 для разработки, следуя инструкциям по включению устройства для разработки.

   Это важно

   Невозможно проверить пакет приложения на удаленном устройстве ARM для Windows 10.

2. Скачайте и установите средства удаленного доступа для Visual Studio. Эти средства используются для удаленного запуска комплекта сертификации приложение для Windows. Чтобы получить больше информации об этих средствах, включая место их загрузки, посетите страницу Запуск приложений MSIX на удаленной машине.

3. Скачайте необходимый пакет сертификации приложение для Windows/c0 и установите его на удаленном Windows 10 устройстве.

4. На странице "Создание пакета завершено " мастера нажмите кнопку " Удаленный компьютер " и нажмите кнопку с многоточием рядом с кнопкой "Проверить подключение ".

   Замечание

   Кнопка " Удаленный компьютер" доступна только в том случае, если выбрана по крайней мере одна конфигурация решения, поддерживающая проверку. Дополнительные сведения о тестировании приложения с помощью WACK, см. в разделе приложение для Windows Certification Kit.

5. Укажите форму устройства в подсети или укажите dns-имя или IP-адрес устройства, который находится за пределами подсети.

6. В списке Authentication Mode выберите None если устройство не требует входа с помощью учетных данных Windows.

7. Нажмите кнопку Select, а затем кнопку Launch приложение для Windows Certification Kit. Если удаленные средства выполняются на этом устройстве, Visual Studio подключается к устройству, а затем выполняет тесты проверки. См. тесты комплекта сертификации приложение для Windows.

Автоматизация отправки заявок в Магазин

Замечание

Начиная с Visual Studio 2026, функция «Автоматическая отправка в магазин» больше не поддерживается.

Начиная с Visual Studio 2019, вы можете отправить созданный appxupload-файл в Microsoft Store непосредственно из интегрированной среды разработки, выбрав Автоматически отправлять в Microsoft Store после проверки средствами сертификации приложений для Windows в конце мастера создания пакетов приложений Создание пакетов приложений. Эта функция использует Microsoft Entra ID для доступа к сведениям учетной записи Центра партнеров, необходимым для публикации приложения. Чтобы использовать эту функцию, вам потребуется связать Microsoft Entra ID с учетной записью Центра партнеров и получить несколько учетных данных, необходимых для отправки.

Связывание Microsoft Entra ID с учетной записью Центра партнеров

Прежде чем получить учетные данные, необходимые для автоматической отправки в Магазин, сначала выполните следующие действия на панели Центра партнеров, если вы еще этого не сделали.

1. Свяжите учетную запись Центра партнеров с Microsoft Entra ID вашей организации. Если ваша организация уже использует Office 365 или другие бизнес-службы из Майкрософт, у вас уже есть Azure AD. В противном случае можно создать новый клиент Azure AD из Центра партнеров без дополнительной платы.

2. Добавить приложение Azure AD в учетную запись Центра партнеров. Это приложение Azure AD представляет собой приложение или сервис, который вы будете использовать для доступа к отправленным данным вашей учетной записи Центра разработки. Вы должны назначить это приложение на роль менеджера. Если это приложение уже существует в каталоге Azure AD, вы можете выбрать его на странице Добавить приложения Azure AD, чтобы добавить его в учетную запись Центра разработки. В противном случае можно создать новое приложение Azure AD на странице Добавление приложений Azure AD.

Получите учетные данные, необходимые для отправки

Затем можно получить учетные данные Центра партнеров, необходимые для отправки: идентификатор клиента Azure, идентификатор клиента Клиента и ключ клиента Клиента.

1. Перейдите на панель мониторинга центра Partner Center и войдите с помощью учетных данных AZURE AD.

2. На панели мониторинга Центра партнеров выберите значок шестеренки (в правом верхнем углу панели мониторинга) и выберите параметры разработчика.

3. В меню "Параметры" в левой области щелкните "Пользователи".

4. Щелкните имя приложения Azure AD, чтобы перейти к параметрам приложения. На этой странице скопируйте значения идентификатора клиента и идентификатора клиента .

5. В разделе "Ключи" нажмите кнопку "Добавить новый ключ". На следующем экране скопируйте значение ключа , соответствующее секрету клиента. Вы не сможете получить доступ к этой информации еще раз после выхода из этой страницы, поэтому не потеряйте его. Дополнительные сведения см. в разделе Manage key for an Azure AD application.

Конфигурирование автоматической отправки в магазин приложений в Visual Studio

После выполнения предыдущих действий вы можете настроить автоматическую отправку в магазин приложений в Visual Studio 2019.

1. В конце мастера пакетов приложений Create App Packages выберите Автоматически отправить в Microsoft Store после проверки набора сертификации приложение для Windows и щелкните Перенастроить.

2. В диалоговом окне Настройки отправки Microsoft Store введите идентификатор арендатора Azure, идентификатор клиента и ключ клиента.

   

   Это важно

   Ваши учетные данные можно сохранить в профиле для использования в будущих отправках.

3. Нажмите кнопку ОК.

Отправка начнется после завершения тестов WACK. Ход отправки можно отслеживать в окне проверки и публикации .