Требования к пакету приложений для приложения MSIX

Требования

Следуйте этим рекомендациям, чтобы подготовить пакеты приложения для отправки в Microsoft Store.

Перед сборкой пакета приложения для Microsoft Store

Обязательно протестируйте ваше приложение с помощью приложение для Windows Certification Kit. Мы также рекомендуем протестировать приложение на различных типах оборудования. Обратите внимание, что до тех пор, пока мы не сертифицируем приложение и сделаем его доступным из Microsoft Store, его можно установить и запустить только на компьютерах с лицензиями разработчика.

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

Если вы используете Майкрософт Visual Studio в качестве среды разработки, у вас уже есть встроенные средства, которые делают создание пакета приложения быстрым и простым процессом. Дополнительные сведения см. в разделе "Упаковка приложений".

При создании пакета в Visual Studio убедитесь, что вы выполнили вход с той же учетной записью, связанной с учетной записью разработчика. Некоторые части манифеста пакета содержат конкретные сведения, связанные с вашей учетной записью. Эта информация обнаруживается и добавляется автоматически. Без дополнительных сведений, добавленных в манифест, могут возникнуть сбои отправки пакета.

При создании пакетов UWP приложения Visual Studio может создать MSIX или appx-файл, или MSIXupload или APPXUPLOAD-файл. Для приложений UWP настоятельно рекомендуется всегда загружать файл .msixupload или .appxupload на страницу "Пакеты". Дополнительные сведения об упаковке приложений UWP для Магазина см. в разделе Упаковка приложений UWP с помощью Visual Studio.

Подписывание кода для отправки приложений в Microsoft Store

Пакеты MSIX и AppX не обязаны быть подписаны сертификатом, выданным доверенным центром сертификации, при отправке в Microsoft Store. Microsoft Store автоматически подписывает пакеты MSIX/AppX с помощью сертификата Майкрософт во время процесса публикации после прохождения сертификации приложения. Это означает:

• Для отправки в MSIX/AppX Store не нужно приобретать сертификат подписи кода, доверенный УЦ.
• Вам не нужно предоставлять PFX-файл или .cer из центра сертификации для отправки пакетов MSIX/AppX
• Для отправки в MSIX и AppX Store USB-токены или аппаратные модули безопасности (HSM) не требуются.
• Магазин заменяет любую существующую подпись в пакетах MSIX/AppX сертификатом Майкрософт, предоставляя клиентам доверие и безопасность.

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

Для приложений UWP Visual Studio может создать пакет приложений (MSIXbundle или .appxbundle), чтобы уменьшить размер скачиваемого приложения. Это может быть полезно, если вы определили ресурсы, относящиеся к языку, различные ресурсы масштабирования изображений или ресурсы, которые применяются к определенным версиям Майкрософт DirectX.

С пакетом приложений пользователь будет загружать только соответствующие файлы, а не все возможные ресурсы. Дополнительные сведения о пакетах приложений можно посмотреть в разделе Packaging apps и Package a UWP app with Visual Studio.

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

Если для создания пакета не используется Visual Studio, необходимо создать манифест пакета вручную.

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

Манифест должен содержать некоторые сведения о вашей учетной записи и приложении. Эти сведения можно найти, просмотрев сведения об удостоверении приложения в разделе "Управление продуктами" на странице обзора приложения на панели мониторинга.

Пакеты приложений (.msixbundle или .appxbundle) используют другой манифест. Ознакомьтесь с документацией по манифесту пакета для получения подробных сведений и требований к манифестам пакетов приложений. Обратите внимание, что в файле .msixbundle или .appxbundle манифест каждого включенного пакета должен использовать те же элементы и атрибуты, за исключением атрибута ProcessorArchitecture элемента Identity.

Требования к формату пакета

Пакеты приложения должны соответствовать этим требованиям.

Поддерживаемые версии

Для приложений UWP все пакеты должны ориентироваться на версию Windows 10 или Windows 11, поддерживаемую Магазином. Версии, поддерживаемые пакетом, должны быть указаны в атрибутах MinVersion и MaxVersionTested элемента TargetDeviceFamily манифеста приложения.

XML-файл StoreManifest

StoreManifest.xml — это необязательный файл конфигурации, который может быть включен в пакеты приложений. Его целью является включение таких функций, как объявление вашего приложения как приложения устройства Microsoft Store или указание требований, от которых зависит пакет, чтобы быть применимым к устройству, которые манифест пакета не охватывает. При использовании StoreManifest.xml отправляется с пакетом приложения и должен находиться в корневой папке основного проекта приложения. Дополнительные сведения см. в схеме StoreManifest.

Нумерирование версий пакета

Каждый предоставленный пакет должен иметь номер версии (указан в качестве значения в атрибуте Version элемента Package/Identity в манифесте приложения). Microsoft Store применяет определенные правила, связанные с номерами версий, которые работают несколько иначе в разных версиях ОС.

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

При выборе пакета UWP из опубликованной заявки Microsoft Store всегда будет использовать пакет с наивысшей версией, применимый к устройству клиента с Windows 10 или Windows 11. Это обеспечивает большую гибкость и позволяет контролировать, какие пакеты будут предоставляться клиентам на определенных типах устройств. Важно отметить, что эти пакеты можно отправлять в любом порядке; Вы не ограничиваетесь предоставлением более поздних версий пакетов с каждой последующей отправкой.

Вы можете предоставить несколько пакетов UWP с одинаковым номером версии. Однако пакеты, которые имеют один и тот же номер версии, не могут иметь одинаковую архитектуру, так как полная идентификация, которую использует Магазин для каждого из ваших пакетов, должна быть уникальной. Дополнительные сведения см. в разделе "Удостоверение".

При предоставлении нескольких пакетов UWP, использующих один и тот же номер версии, архитектура (в порядке x64, x86, Arm, neutral) будет использоваться для выбора того, какой из них имеет более высокий рейтинг (когда Магазин определяет, какой пакет должен предоставляться устройству клиента). При ранжировании пакетов приложений, использующих тот же номер версии, самый высокий ранг архитектуры в пакете считается: пакет приложений, содержащий пакет x64, будет иметь более высокий ранг, чем один, содержащий только пакет x86.

Это обеспечивает большую гибкость для развития приложения с течением времени. Вы можете загружать и отправлять новые пакеты с более низкими номерами версий, чтобы добавить поддержку для устройств Windows 10 или Windows 11, которые ранее не поддерживались, можно добавить пакеты с более высокими номерами версий и более строгими зависимостями, чтобы воспользоваться преимуществами функций оборудования или ОС, или добавить пакеты с более высокими номерами версий, которые служат обновлениями для части или всей существующей клиентской базы.

В следующем примере показано, как управлять нумерированием версий для доставки предполагаемых пакетов клиентам по нескольким отправкам.

Пример. Переход к одному пакету вместо нескольких отправок

Windows 10 позволяет создавать единую базу кода, которая выполняется везде. Это упрощает запуск нового кроссплатформенного проекта. Однако по ряду причин может не потребоваться объединить существующие базы кода, чтобы сразу создать один проект.

Правила управления версиями пакетов можно использовать для постепенного перемещения клиентов в один пакет для семейства универсальных устройств, при доставке нескольких промежуточных обновлений для определенных семейств устройств (включая те, которые используют преимущества Windows 10 API). В приведенном ниже примере показано, как одни и те же правила последовательно применяются к сериям отправок для одного и того же приложения.

Использование нумерования версий для отката до ранее отправленного пакета для новых приобретений

Если вы храните копии своих пакетов, у вас будет возможность выполнить откат пакета приложения в Магазине до более ранней версии пакета для Windows 10, если вы обнаружите проблемы с выпуском. Это временный способ ограничить прерывание работы клиентов во время устранения проблемы.

Для этого создайте новую отправку. Удалите проблемный пакет и отправьте старый пакет, который вы хотите предоставить в Магазине. Клиенты, которые уже получили пакет, который вы откатили, по-прежнему будут иметь проблемный пакет (так как старый пакет будет иметь более ранний номер версии). Но это остановит всех остальных от получения проблемного пакета, позволяя приложению по-прежнему быть доступным в Магазине.

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

Поддерживаемые языки

Приложения можно отправлять на Microsoft Store более чем на 100 языках.

Дополнительные сведения о настройке языков в приложениях см. в статье "Глобализация" и "Локализация" и "Общие сведения о языках профилей пользователей" иязыках манифеста приложения. У нас также есть набор средств многоязычных приложений, которые помогают создавать приложения, поддерживающие несколько языков.

Список поддерживаемых языков

Это языки, поддерживаемые Microsoft Store. Ваше приложение должно поддерживать хотя бы один из этих языков.

Языковые коды, не включенные здесь, не поддерживаются магазином. Рекомендуется не включать пакеты, предназначенные для кодов языка, отличных от указанных ниже; такие пакеты не будут распространяться клиентами и могут привести к задержкам или сбоям в сертификации.