Создание пакета или пакета MSIX с помощью MakeAppx.exe

MakeAppx.exe создает пакеты приложений (MSIX или APPX) и пакеты пакетов приложений (MSIXBUNDLE или APPXBUNDLE). MakeAppx.exe также извлекает файлы из пакета приложения или пакета приложений и шифрует или расшифровывает пакеты приложения и пакеты приложений. Это средство входит в состав пакета SDK Windows 10 и его можно использовать через командную строку или файл скрипта.

Сведения об использовании MakeApp.exe для упаковки классического приложения см. в разделе "Упаковка классического приложения" вручную.

Важно!

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

Важно!

Обратите внимание, что MakeAppx.exe не создает файл отправки пакета приложения (.appxupload или MSIXUPLOAD), который является рекомендуемым типом допустимого пакета приложения для отправки в Центр партнеров. Файл отправки пакета приложения обычно создается как часть процесса упаковки Visual Studio, хотя его также можно создать вручную.

Использование MakeAppx.exe

В зависимости от пути установки пакета SDK MakeAppx.exe может находиться в следующих расположениях на компьютере с Windows 10:

  • C:\Program Files (x86)\Windows Kits\10\bin\<build number>\<architecture>\makeappx.exe

where <architecture> = x86, x64, arm, arm64 или chpe. Кроме того, он может находиться в:

  • C:\Program Files (x86)\Windows Kits\10\App Certification Kit\makeappx.exe

Синтаксис и параметры MakeAppx.exe

Общий синтаксис MakeAppx.exe:

MakeAppx <command> [options]      

В следующей таблице описаны команды для MakeAppx.exe.

Команда Описание
pack Создает пакет.
unpack Извлекает все файлы в указанном пакете в указанный выходной каталог.
bundle Создает пакет приложений.
unbundle Распаковка всех пакетов в подкаталог по указанному выходному пути с именем пакета или полного имени пакета.
encrypt Создает зашифрованный пакет приложения или пакет приложений из входного пакета приложения/пакета приложений по указанному выходному пакету приложения/пакету приложений.
расшифровка Создает расшифрованный пакет приложения или пакет приложений из входного пакета приложения/пакета приложений по указанному выходному пакету приложения/пакету приложений.

Этот список параметров применим ко всем командам:

Параметр Описание
/d Указывает входные или выходные данные либо каталог содержимого.
/l Используется для локализованных пакетов. Пути проверки по умолчанию для локализованных пакетов. Этот параметр отключает только указанную проверку, не требуя отключения всех проверок.
/kf Шифрует или расшифровывает пакет приложения или пакет приложений с помощью ключа из указанного файла ключа. Не может использоваться с /kt.
/kt Шифрует или расшифровывает пакет приложения или пакет приложений с помощью глобального тестового ключа. Не может использоваться с /kf.
/no Предотвращает перезапись выходного файла, если он существует. Если не указать этот параметр или параметр /o, пользователь должен подтвердить перезапись файла.
/nv Пропускает семантическую проверку. Если не указать этот параметр, средство выполняет полную проверку пакета.
/o Перезаписывает выходной файл, если он существует. Если не указать этот параметр или параметр /no, пользователь должен подтвердить перезапись файла.
/p Указывает пакет приложения или пакет приложений.
/v Включает вывод подробных сведений в журнал на консоли.
/? Отображает текст справки.

Следующий список содержит возможные аргументы:

Argument Описание
<output package name> Имя созданного пакета. Это имя файла, добавляемое с расширением MSIX или APPX.
<encrypted output package name> Имя созданного зашифрованного пакета. Это имя файла, добавляемое с помощью EMSIX или EAPPX.
<input package name> Имя пакета. Это имя файла, добавляемое с расширением MSIX или APPX.
<encrypted input package name> Имя зашифрованного пакета. Это имя файла, добавляемое с помощью EMSIX или EAPPX.
<output bundle name> Имя созданного пакета приложений. Это имя файла, добавленное с расширением .msixbundle или .appxbundle.
<encrypted output bundle name> Имя созданного зашифрованного пакета приложений. Это имя файла, добавленное с расширением EMSIXBUNDLE или EAPPXBUNDLE.
<input bundle name> Имя пакета приложений. Это имя файла, добавленное с расширением .msixbundle или .appxbundle.
<encrypted input bundle name> Имя зашифрованного пакета приложений. Это имя файла, добавленное с расширением EMSIXBUNDLE или EAPPXBUNDLE.
<content directory> Путь для содержимого пакета приложения или пакета приложений.
<mapping file> Имя файла, в котором указаны источник и назначение пакета.
<output directory> Путь к каталогу для выходных пакетов приложения и пакетов приложений.
<key file> Имя файла, содержащего ключ для шифрования или расшифровки.
<algorithm ID> Алгоритмы, используемые при создании сопоставления блоков. Допустимые алгоритмы: SHA256 (по умолчанию), SHA384, SHA512.

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

Пакет приложения — это полный набор файлов приложения, упакованных в ФАЙЛ пакета MSIX или APPX. Чтобы создать пакет приложения с помощью команды pack, необходимо предоставить каталог содержимого или файл сопоставления для расположения пакета. Вы также можете зашифровать пакет во время создания. Если вам требуется зашифровать пакет, необходимо использовать параметр /ep и указать, используете ли вы файл ключа (/kf) или глобальный тестовый ключ (/kt). Подробнее о создании зашифрованного пакета см. в разделе Шифрование и расшифровка пакета приложения или пакета приложений.

Параметры, относящиеся к команде pack:

Параметр Описание
/f Указывает файл сопоставления.
/h Указывает хэш-алгоритм, используемый при создании сопоставления блоков. Этот параметр можно использовать только с командой pack. Допустимые алгоритмы: SHA256 (по умолчанию), SHA384, SHA512.
/m Указывает путь к входному манифесту приложения, на основе которого будет создан выходной пакет приложения или манифест пакета ресурсов. При использовании этого параметра необходимо также использовать параметр /f и включить раздел [ResourceMetadata] в файл сопоставления, чтобы указать размеры ресурсов, которые будут включены в созданный манифест.
/nc Предотвращает сжатие файлов пакета. По умолчанию файлы сжимаются в зависимости от выявленного типа файлов.
/r Собирает пакет ресурсов. Этот параметр необходимо использовать с параметром /m, а также он предполагает использование параметра /l.

В следующих примерах использования показаны некоторые возможные варианты синтаксиса для команды pack:

MakeAppx pack [options] /d <content directory> /p <output package name>
MakeAppx pack [options] /f <mapping file> /p <output package name>
MakeAppx pack [options] /m <app package manifest> /f <mapping file> /p <output package name>
MakeAppx pack [options] /r /m <app package manifest> /f <mapping file> /p <output package name>
MakeAppx pack [options] /d <content directory> /ep <encrypted output package name> /kf <key file>
MakeAppx pack [options] /d <content directory> /ep <encrypted output package name> /kt

Далее приведены примеры командной строки для команды pack:

MakeAppx pack /v /h SHA256 /d "C:\My Files" /p MyPackage.msix
MakeAppx pack /v /o /f MyMapping.txt /p MyPackage.msix
MakeAppx pack /m "MyApp\AppxManifest.xml" /f MyMapping.txt /p AppPackage.msix
MakeAppx pack /r /m "MyApp\AppxManifest.xml" /f MyMapping.txt /p ResourcePackage.msix
MakeAppx pack /v /h SHA256 /d "C:\My Files" /ep MyPackage.emsix /kf MyKeyFile.txt
MakeAppx pack /v /h SHA256 /d "C:\My Files" /ep MyPackage.emsix /kt

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

Пакет приложений похож на пакет приложения, но он может сократить размер приложения, скачиваемого пользователями. Пакеты приложения полезны, к примеру, для ресурсов, связанных с конкретным языком, различных ресурсов с определенным масштабом изображений или ресурсов, которые применяются к конкретным версиям Microsoft DirectX. По аналогии с созданием зашифрованного пакета приложения, вы также можете зашифровать пакет приложений при его сборке. Чтобы зашифровать пакет приложений, используйте параметр /ep и укажите, используете ли вы файл ключа (/kf) или глобальный тестовый ключ (/kt). Подробнее о создании зашифрованного пакета приложений см. в разделе Шифрование и расшифровка пакета приложения или пакета приложений.

Параметры, относящиеся к команде bundle:

Параметр Описание
/bv Указывает номер версии пакета. Номер версии должен состоять из четырех частей, разделенных точками, в следующей форме: <Основная версия>.<Вспомогательная версия>.<Сборка>.<Редакция>.
/f Указывает файл сопоставления.

Обратите внимание, что если версия пакета не указана или указана в виде "0.0.0.0", пакет создается с использованием текущих даты и времени.

В следующих примерах использования показаны некоторые возможные варианты синтаксиса для команды bundle:

MakeAppx bundle [options] /d <content directory> /p <output bundle name>
MakeAppx bundle [options] /f <mapping file> /p <output bundle name>
MakeAppx bundle [options] /d <content directory> /ep <encrypted output bundle name> /kf MyKeyFile.txt
MakeAppx bundle [options] /f <mapping file> /ep <encrypted output bundle name> /kt

В следующем блоке содержатся примеры для команды bundle:

MakeAppx bundle /v /d "C:\My Files" /p MyBundle.msixbundle
MakeAppx bundle /v /o /bv 1.0.1.2096 /f MyMapping.txt /p MyBundle.msixbundle
MakeAppx bundle /v /o /bv 1.0.1.2096 /f MyMapping.txt /ep MyBundle.emsixbundle /kf MyKeyFile.txt
MakeAppx bundle /v /o /bv 1.0.1.2096 /f MyMapping.txt /ep MyBundle.emsixbundle /kt

Извлечение файлов из пакета приложения или пакета приложений

Помимо упаковки приложений в пакеты приложения или пакеты приложений, MakeAppx.exe также может распаковывать существующие пакеты. Вам потребуется предоставить каталог содержимого в качестве назначения для извлеченных файлов. При попытке извлечь файлы из зашифрованного пакета приложения или пакета приложений вы можете расшифровать и извлечь файлы одновременно с помощью параметра /ep. При этом необходимо указать способ расшифровки: с помощью файла ключа (/kf) или глобального тестового ключа (/kt). Подробнее о расшифровке пакета приложения или пакета приложений см. в разделе Шифрование и расшифровка пакета приложения или пакета приложений.

Параметры, относящиеся к командам unpack и unbundle:

Параметр Описание
/nd Не выполняет расшифровку при распаковке пакета приложения или пакета приложений.
/pfn Распаковка и распаковка всех файлов в подкаталог по указанному выходному пути с именем пакета или пакета с полным именем

В следующих примерах использования показаны некоторые возможные варианты синтаксиса для команд unpack и unbundle:

MakeAppx unpack [options] /p <input package name> /d <output directory>
MakeAppx unpack [options] /ep <encrypted input package name> /d <output directory> /kf <key file>
MakeAppx unpack [options] /ep <encrypted input package name> /d <output directory> /kt

MakeAppx unbundle [options] /p <input bundle name> /d <output directory>
MakeAppx unbundle [options] /ep <encrypted input bundle name> /d <output directory> /kf <key file>
MakeAppx unbundle [options] /ep <encrypted input bundle name> /d <output directory> /kt

В следующем блоке содержатся примеры использования команд unpack и unbundle:

MakeAppx unpack /v /p MyPackage.msix /d "C:\My Files"
MakeAppx unpack /v /ep MyPackage.emsix /d "C:\My Files" /kf MyKeyFile.txt
MakeAppx unpack /v /ep MyPackage.emsix /d "C:\My Files" /kt

MakeAppx unbundle /v /p MyBundle.msixbundle /d "C:\My Files"
MakeAppx unbundle /v /ep MyBundle.emsixbundle /d "C:\My Files" /kf MyKeyFile.txt
MakeAppx unbundle /v /ep MyBundle.emsixbundle /d "C:\My Files" /kt

Шифрование и расшифровка пакета приложения или пакета приложений

Средство MakeAppx.exe также может зашифровать или расшифровать существующий пакет приложения или пакет приложений. Просто укажите имя пакета, имя выходного пакета, а также способ шифрования или расшифровки: с помощью файла ключа (/kf) или глобального тестового ключа (/kt).

Шифрование и расшифровку нельзя выполнить через мастер упаковки Visual Studio.

Параметры, относящиеся к командам encrypt и decrypt:

Параметр Описание
/ep Указывает зашифрованный пакет приложения или пакет приложений.

В следующих примерах использования показаны некоторые возможные варианты синтаксиса для команд encrypt и decrypt:

MakeAppx encrypt [options] /p <package name> /ep <output package name> /kf <key file>
MakeAppx encrypt [options] /p <package name> /ep <output package name> /kt

MakeAppx decrypt [options] /ep <package name> /p <output package name> /kf <key file>
MakeAppx decrypt [options] /ep <package name> /p <output package name> /kt

Следующий блок содержит примеры использования команд encrypt и decrypt:

MakeAppx.exe encrypt /p MyPackage.msix /ep MyEncryptedPackage.emsix /kt
MakeAppx.exe encrypt /p MyPackage.msix /ep MyEncryptedPackage.emsix /kf MyKeyFile.txt

MakeAppx.exe decrypt /p MyPackage.msix /ep MyEncryptedPackage.emsix /kt
MakeAppx.exe decrypt p MyPackage.msix /ep MyEncryptedPackage.emsix /kf MyKeyFile.txt

Файлы ключей

Файлы ключей должны начинаться строкой, содержащей строку "[Keys]", за которой следуют строки с описанием ключей, используемых для шифрования каждого пакета. Каждый ключ представлен парой строк в кавычках, разделенных пробелами или табуляцией. Первая строка представляет собой идентификатор 32-байтового ключа в кодировке base64, а вторая — 32-байтовый ключ шифрования в кодировке base64. Файл ключа должен быть простым текстовым файлом.

Пример файла ключа:

[Keys]
"OWVwSzliRGY1VWt1ODk4N1Q4R2Vqc04zMzIzNnlUREU="    "MjNFTlFhZGRGZEY2YnVxMTBocjd6THdOdk9pZkpvelc="

Файлы сопоставления

Файлы сопоставления должны начинаться строкой, содержащей строку "[Files]", за которой следуют строки с описанием файлов, которые будут добавлены в пакет. Каждый файл описывается парой путей в кавычках, разделенных пробелами или табуляцией. Каждый файл представляет свой источник (на диске) и назначение (в пакете). Файл сопоставления должен быть простым текстовым файлом.

Пример файла сопоставления (без параметра /m):

[Files]
"C:\MyApp\StartPage.html"               "default.html"
"C:\Program Files (x86)\example.txt"    "misc\example.txt"
"\\MyServer\path\icon.png"              "icon.png"
"my app files\readme.txt"               "my app files\readme.txt"
"CustomManifest.xml"                    "AppxManifest.xml"

При использовании файла сопоставления вы можете выбрать, следует ли использовать параметр /m. Параметр /m позволяет пользователю указывать метаданные ресурса в файле сопоставления, которые будут включены в созданный манифест. Если вы используете параметр /m, файл сопоставления должен содержать раздел, начинающийся со строки "[ResourceMetadata]", а затем строки, указывающие "ResourceDimensions" и "ResourceId". Пакет приложения может содержать несколько resourceDimensions, но может быть только один "ResourceId".

Пример файла сопоставления (с параметром /m):

[ResourceMetadata]
"ResourceDimensions"                    "language-en-us"
"ResourceId"                            "English"

[Files]
"images\en-us\logo.png"                 "en-us\logo.png"
"en-us.pri"                             "resources.pri"

Выполнение семантической проверки средством MakeAppx.exe

MakeAppx.exe выполняет ограниченную семантическую проверку, которая предназначена для выявления наиболее распространенных ошибок разработки и помогает обеспечить допустимость пакета приложения. Если вам требуется пропустить проверку при использовании MakeAppx.exe, см. параметр /nv.

Эта проверка гарантирует следующее:

  • все файлы, ссылки на которые присутствуют в манифесте пакета, входят в состав пакета приложения;
  • в приложении нет двух идентичных ключей;
  • приложение не регистрирует запрещенный протокол из этого списка: SMB, FILE, MS-WWA-WEB, MS-WWA.

Это не полноценная семантическая проверка, так как она позволяет выявлять только распространенные ошибки. Готовность к установке пакетов, созданных с помощью MakeAppx.exe, не гарантируется.