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

Требования

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

Прежде чем создавать пакет приложения для Microsoft Store

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

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

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

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

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

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

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

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

С пакетом приложений пользователь будет загружать только соответствующие файлы, а не все возможные ресурсы. Дополнительные сведения о пакетах приложений см. в статье "Упаковка приложений " и "Упаковка приложения UWP" с помощью 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 позволяет создавать единую базу кода, которая выполняется везде. Это упрощает запуск нового кроссплатформенного проекта. Однако по ряду причин может не потребоваться объединить существующие базы кода, чтобы сразу создать один проект.

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

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

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

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

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

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

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

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

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

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

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