アプリパッケージツール (MakeAppx.exe)

[アーティクル]
07/18/2024

Note

このツールの使用に関する UWP のガイダンスについては、「MakeAppx.exe ツールを使用してアプリパッケージを作成する」を参照してください。

アプリパッケージャー (MakeAppx.exe) は、ディスク上のファイルからアプリパッケージを作成するか、アプリパッケージからディスクにファイルを抽出します。 Windows 8.1 以降、アプリパッケージャーは、ディスク上のアプリパッケージからアプリパッケージバンドルを作成したり、アプリパッケージバンドルからディスクにアプリパッケージを抽出したりすることもできます。これは、Microsoft Visual Studio と、Windows 8 の Windows ソフトウェア開発キット (SDK) または Windows 8.1 以降の Windows ソフトウェア開発キット (SDK) に含まれています。開発者向けのダウンロードにアクセスして入手してください。

MakeAppx.exe ツールは、通常、オペレーティングシステムのバージョン固有の場所にあります。

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

ここで、<architecture> = x86、x64、arm、ar64、または chpe。または、次の場所に配置されている場合があります。

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

ディレクトリ構造を使用してパッケージを作成するには
マッピングファイルを使用してパッケージを作成するには
SignTool を使ってアプリパッケージに署名するには
パッケージからファイルを抽出するには
ディレクトリ構造を使用してパッケージバンドルを作成するには
マッピングファイルを使用してパッケージバンドルを作成するには
バンドルからパッケージを抽出するには
キーファイルを使用してパッケージを暗号化するには
グローバルテストキーを使用してパッケージを暗号化するには
キーファイルを使用してパッケージを復号化するには
グローバルテストキーを使用してパッケージを復号化するには
使用方法

アプリパッケージャーの使用

Note

相対パスは、ツール全体でサポートされています。

ディレクトリ構造を使用してパッケージを作成するには

アプリのすべてのペイロードファイルを含むディレクトリのルートに AppxManifest.xml を配置します。アプリパッケージ用に同一のディレクトリ構造が作成され、展開時にパッケージが抽出されるときに使用できるようになります。

すべてのファイルを 1 つのディレクトリ構造に配置し、必要に応じてサブディレクトリを作成します。
有効なパッケージマニフェスト AppxManifest.xml を作成し、ルートディレクトリに配置します。
次のコマンドを実行します。

MakeAppx pack /d input_directorypath /p filepath.appx

マッピングファイルを使用してパッケージを作成するには

有効なパッケージマニフェスト AppxManifest.xml を作成します。
マッピングファイルを作成します。最初の行には文字列 [Files] が含まれており、次の行で引用符で囲まれた文字列でソース (ディスク) パスと宛先 (パッケージ) パスを指定します。
```
[Files]
"C:\MyApp\StartPage.htm"     "default.html"
"C:\MyApp\readme.txt"        "doc\readme.txt"
"\\MyServer\path\icon.png"   "icon.png"
"MyCustomManifest.xml"       "AppxManifest.xml"
```
次のコマンドを実行します。

MakeAppx pack /f mapping_filepath /p filepath.appx

SignTool を使ってアプリパッケージに署名するには

証明書を作成します。マニフェストに一覧表示されている発行元は、署名証明書の発行元のサブジェクト情報と一致する必要があります。署名証明書の作成についての詳細は、「アプリパッケージ署名証明書を作成する方法」を参照してください。
SignTool.exe を実行してパッケージに署名する:

SignTool sign /a /v /fd hashAlgorithm /f certFileName filepath.appx

hashAlgorithm は、アプリがパッケージ化されたときにブロックマップを作成するために使用されるハッシュアルゴリズムと一致する必要があります。 MakeAppx パッケージ化ユーティリティでは、既定の Appx ブロックマップハッシュアルゴリズムは SHA256 です。 SHA256 を指定して、ファイルダイジェスト (/fd) アルゴリズムとして SignTool.exe を実行します。

SignTool sign /a /v /fd SHA256 /f certFileName filepath.appx

パッケージへの署名についての詳細は、「SignToolを使ってアプリパッケージに署名する方法」をご覧ください。

パッケージからファイルを抽出するには

次のコマンドを実行します。

MakeAppx unpack /p file.appx /d output_directory
解凍されたパッケージの構造は、インストールされているパッケージと同じです。

ディレクトリ構造を使用してパッケージバンドルを作成するには

bundle コマンドを使用して、<コンテンツディレクトリ> (サブフォルダーを含む) からすべてのパッケージを追加することで、<出力バンドル名>でアプリバンドルを作成します。 <コンテンツディレクトリ>にバンドルマニフェスト (AppxBundleManifest.xml) が含まれている場合は、無視されます。

すべてのパッケージを 1 つのディレクトリ構造に配置し、必要に応じてサブディレクトリを作成します。
次のコマンドを実行します。

MakeAppx bundle /d input_directorypath /p filepath.appxbundle

マッピングファイルを使用してパッケージバンドルを作成するには

bundle コマンドを使用して、<マッピングファイル>内のパッケージの一覧からすべてのパッケージを追加することで、<出力バンドル名>でアプリバンドルを作成します。 <マッピングファイル>にバンドルマニフェスト (AppxBundleManifest.xml) が含まれている場合は、無視されます。

<マッピングファイル>を作成します。最初の行には文字列 [Files] が含まれており、次の行はバンドルに追加するパッケージを指定します。各パッケージは、引用符で囲まれたパスのペアで、スペースまたはタブで区切られます。パスのペアは、パッケージのソース (ディスク上) と宛先 (バンドル内) を表します。すべての宛先パッケージ名には、.appx 拡張子が必要です。
```
    [Files]
    "C:\MyApp\MyApp_x86.appx"                 "MyApp_x86.appx"
    "C:\Program Files (x86)\ResPack.appx"    "resources\resPack.appx"
    "\\MyServer\path\ResPack.appx"           "Respack.appx"
    "my app files\respack.appx"              "my app files\respack.appx"
```
次のコマンドを実行します。

MakeAppx bundle /f mapping_filepath /p filepath.appxbundle

バンドルからパッケージを抽出するには

次のコマンドを実行します。

MakeAppx unbundle /p bundle_name.appxbundle /d output_directory
解凍されたバンドルの構造は、インストールされているパッケージバンドルと同じです。

キーファイルを使用してパッケージを暗号化するには

キーペアを作成します。キーファイルは、文字列「[Keys]」を含む行で始まり、その後にパッケージを暗号化するためのキーを説明する行が続く必要があります。各キーは、スペースまたはタブで区切られた引用符で囲まれた文字列のペアで記述されます。最初の文字列はキー ID を表し、2 番目の文字列は 16 進形式の暗号化キーを表します。
```
    [Keys]
    "0"                 "1AC4CDCFF1924D2885A0607269787BA6BF09B7FFEBF74ED4B9D86E423CF9186B"
```
次のコマンドを実行します。

MakeAppx.exe encrypt /p package_name.appx /ep encrypted_package_name.eappx /kf keyfile_name.txt
入力パッケージは、提供されたキーファイルを使用して、指定された暗号化パッケージに暗号化されます。

グローバルテストキーを使用してパッケージを暗号化するには

次のコマンドを実行します。

MakeAppx.exe encrypt /p package_name.appx /ep encrypted_package_name.eappx /kt
入力パッケージは、グローバルテストキーを使用して、指定された暗号化されたパッケージに暗号化されます。

キーファイルを使用してパッケージを復号化するには

キーペアを作成します。キーファイルは、文字列「[Keys]」を含む行で始まり、その後にパッケージを暗号化するためのキーを説明する行が続く必要があります。各キーは、スペースまたはタブで区切られた引用符で囲まれた文字列のペアで記述されます。最初の文字列は、base64 でエンコードされた 32 バイトのキー ID を表し、2 番目の文字列は、base64 でエンコードされた 32 バイトの暗号化キーを表します。
```
    [Keys]
    "OWVwSzliRGY1VWt1ODk4N1Q4R2Vqc04zMzIzNnlUREU="                 "MjNFTlFhZGRGZEY2YnVxMTBocjd6THdOdk9pZkpvelc="
```
次のコマンドを実行します。

MakeAppx.exe decrypt /p package_name.appx /ep unencrypted_package_name.eappx /kf keyfile_name.txt
入力パッケージは、提供されたキーファイルを使用して、指定された非暗号化パッケージに復号化されます。

グローバルテストキーを使用してパッケージを復号化するには

次のコマンドを実行します。

MakeAppx.exe decrypt /p package_name.appx /ep unencrypted_package_name.eappx /kt
入力パッケージは、グローバルテストキーを使用して、指定された暗号化されていないパッケージに復号化されます。

使用方法

コマンドライン引数 /p は常に必須で、/d、/f、または /ep のいずれかです。 /d、/f、、および /ep は相互に排他的であることに注意してください。

MakeAppx パック [オプション] /p <出力パッケージ名> /d <コンテンツディレクトリ>

MakeAppx パック [オプション] /p <出力パッケージ名> /f <マッピングファイル>

MakeAppx アンパック [オプション] /p <入力パッケージ名> /d <出力ディレクトリ>

MakeAppx バンドル [オプション] /p <出力バンドル名> /d <コンテンツディレクトリ>

MakeAppx bundle [オプション] /p <出力バンドル名> /f <マッピングファイル>

MakeAppx アンバンドル [オプション] /p <入力バンドル名> /d <出力ディレクトリ>

MakeAppx 暗号化 [オプション] /p <入力パッケージ名> /ep <出力パッケージ名>

MakeAppx 復号化 [オプション] /p <入力パッケージ名> /ep <出力パッケージ名>

コマンドライン構文

MakeAppx のコマンドラインの一般的な使用構文を次に示します。

MakeAppx は、パッケージ内のファイルをパックまたは解凍したり、バンドル内のパッケージをバンドルまたはバンドル解除したり、指定された入力ディレクトリまたはマッピングファイル内のアプリパッケージまたはバンドルを暗号化または復号化したりします。 MakeAppx pack、MakeAppx unpack、MakeAppx bundle、MakeAppx unbundle、MakeAppx encrypt、または MakeAppx decrypt に適用されるパラメーターの一覧を次に示します。

/l

このオプションは、ローカライズされたパッケージに使用されます。ローカライズされたパッケージのデフォルト検証トリップ。このオプションは、すべての検証を無効にする必要はなく、特定の検証のみを無効にします。

/o

出力ファイルが存在する場合は上書きします。このオプションまたは /no オプションを指定しない場合、ユーザーはファイルを上書きするかどうかを尋ねられます。

このオプションと /no を同時に使用することはできません。

/no

出力ファイルが存在する場合は上書きを防止します。このオプションまたは /o オプションを指定しない場合、ユーザーはファイルを上書きするかどうかを尋ねられます。

このオプションと /o を同時に使用することはできません。

/nv

セマンティック検証をスキップします。このオプションを指定しない場合、ツールはパッケージの完全な検証を実行します。

/v

コンソールへの詳細ログ出力を有効にします。

$

ヘルプテキストを表示します。

MakeAppx pack、MakeAppx unpack、MakeAppx bundle、MakeAppx unbundle、MakeAppx encrypt、および MakeAppx decrypt は相互に排他的なコマンドです。各コマンドに特に適用されるコマンドラインパラメーターを次に示します。

MakeAppx pack [h]

パッケージを作成します。

/h アルゴリズム

ブロックマップの作成時に使用するハッシュアルゴリズムを指定します。 アルゴリズムの有効な値を次に示します。

SHA256 (既定値)

SHA384

SHA512

このオプションを unpack コマンドで使用することはできません。

MakeAppx unpack [pfn]

指定したパッケージのすべてのファイルを指定した出力ディレクトリに抽出します。出力のディレクトリ構造はパッケージと同じです。

/pfn: パッケージの完全名で名前が付けられたディレクトリを指定します。このディレクトリは、指定された出力場所の下に作成されます。このオプションを pack コマンドで使用することはできません。

MakeAppx unbundle [pfn]

すべてのパッケージを、バンドルの完全名に基づいて名前を付けた、指定された出力パスの下のサブディレクトリに解凍します。出力は、インストールされたパッケージバンドルと同じディレクトリ構造になります。

/pfn: パッケージバンドルの完全名で名前が付けられたディレクトリを指定します。このディレクトリは、指定された出力場所の下に作成されます。このオプションを bundle コマンドで使用することはできません。

MakeAppx encrypt [kf、kt]

指定された入力アプリパッケージから、指定された出力パッケージに暗号化されたアプリパッケージを作成します。

/kf <キーファイル>: 指定されたキーファイルのキーを使用してパッケージまたはバンドルを暗号化します。このオプションと kt を同時に使用することはできません。
/kt: グローバルテストキーを使用してパッケージまたはバンドルを暗号化します。このオプションと kf を同時に使用することはできません。

MakeAppx decrypt [kf、kt]

指定された入力アプリパッケージから、指定された出力パッケージに暗号化されていないアプリパッケージを作成します。

/kf <キーファイル>: 指定されたキーファイルのキーを使用してパッケージまたはバンドルを復号化します。このオプションと kt を同時に使用することはできません。
/kt: グローバルテストキーを使用してパッケージまたはバンドルを復号化します。このオプションと kf を同時に使用することはできません。

MakeAppx によって実行されるセマンティック検証

MakeAppx は、最も一般的な展開エラーを検出し、アプリパッケージが有効であることを確認するように設計された限定的なセマンティック検証を実行します。

この検証により、次のことが保証されます。

パッケージマニフェストで参照されるすべてのファイルは、アプリパッケージに含まれます。
アプリケーションに同じキーが 2 つありません。
アプリケーションは、このリストの禁止されたプロトコル (SMB、FILE、MS-WWA-WEB、MS-WWA) を登録しません。

このセマンティック検証は完了していないため、MakeAppx によってビルドされたパッケージがインストール可能であることは保証されていません。

次の方法で共有

アプリパッケージツール (MakeAppx.exe)

アプリパッケージャーの使用

ディレクトリ構造を使用してパッケージを作成するには

マッピングファイルを使用してパッケージを作成するには

SignTool を使ってアプリパッケージに署名するには

パッケージからファイルを抽出するには

ディレクトリ構造を使用してパッケージバンドルを作成するには

マッピングファイルを使用してパッケージバンドルを作成するには

バンドルからパッケージを抽出するには

キーファイルを使用してパッケージを暗号化するには

グローバルテストキーを使用してパッケージを暗号化するには

キーファイルを使用してパッケージを復号化するには

グローバルテストキーを使用してパッケージを復号化するには

使用方法

コマンドライン構文

MakeAppx によって実行されるセマンティック検証

フィードバック

その他のリソース

次の方法で共有

アプリ パッケージ ツール (MakeAppx.exe)

アプリ パッケージャーの使用

ディレクトリ構造を使用してパッケージを作成するには

マッピング ファイルを使用してパッケージを作成するには

SignTool を使ってアプリ パッケージに署名するには

パッケージからファイルを抽出するには

ディレクトリ構造を使用してパッケージ バンドルを作成するには

マッピング ファイルを使用してパッケージ バンドルを作成するには

バンドルからパッケージを抽出するには

キー ファイルを使用してパッケージを暗号化するには

グローバル テスト キーを使用してパッケージを暗号化するには

キー ファイルを使用してパッケージを復号化するには

グローバル テスト キーを使用してパッケージを復号化するには

使用方法

コマンドライン構文

MakeAppx によって実行されるセマンティック検証

フィードバック

その他のリソース

アプリパッケージツール (MakeAppx.exe)

アプリパッケージャーの使用

マッピングファイルを使用してパッケージを作成するには

SignTool を使ってアプリパッケージに署名するには

ディレクトリ構造を使用してパッケージバンドルを作成するには

マッピングファイルを使用してパッケージバンドルを作成するには

キーファイルを使用してパッケージを暗号化するには

グローバルテストキーを使用してパッケージを暗号化するには

キーファイルを使用してパッケージを復号化するには

グローバルテストキーを使用してパッケージを復号化するには