パッケージの作成 (makepkg.exe)

アプリ パッケージとアプリ パッケージのメタデータを作成します。

makepkg command[/updcompat 3] [/pc] [/gameos <gameos file>] [/priorpackage <prior package file>] [/f <file name>] [/d <content directory>] [/pd <output directory>] [/l | /lk <secret_key.lekb>] [/contentid <ID>] [/productid <ProductIDGUID>] [/nocrashdump] [/resw <resw directory>] [/t <xml output directory>] [/v] [/?]

コマンド

genmap

ターゲット フォルダーの内容に基づいて、pack コマンドで使用する XML ファイルを構築します。 生成されたファイルには、1 つのチャンクが含まれています。 ファイルを編集してチャンクに分割したり、必要に応じてタグを追加したりできます。

makepkg genmap /f <targetXmlFile> /d <contentdirectory>

genid

製品 ID GUID とストア ID の間で変換します。 生成された GUID は、製品の提出時に提供された製品 ID と一致します。 製品 ID GUID を Store ID に変換できます。

makepkg genid /storeid <storeId> | /productid <productId>

pack

ディスク上のファイルから新しいアプリ パッケージを作成します。

makepkg pack /f <mapping file> /d <content directory> /pd <output package directory> /productid <ProductIDGUID> [/l | /lk <secret_key.lekb>]

マッピング ファイル内に指定されたファイルを追加して、出力パッケージ ディレクトリにアプリ パッケージを作成します。 たとえば、a.txt、b.txt、game.exe の 3 つのファイルが格納されたディレクトリの内容をパッケージ化するには、次のマッピング ファイルを使用します:

<Package>
    <Chunk Id="1000" Marker="Launch">
        <FileGroup DestinationPath="\" SourcePath=".\" Include="a.txt"/>
        <FileGroup DestinationPath="\" SourcePath=".\" Include="b.txt"/>
        <FileGroup DestinationPath="\" SourcePath=".\" Include="game.exe"/>
    </Chunk>
</Package>

マッピング ファイル スキーマの詳細については、「配置パッケージのスキーマ」をご覧ください。 /d で指定するコンテンツ ディレクトリには、MicrosoftGame.config という名前の有効なゲーム構成ファイルが含まれている必要があります。このファイルは、アプリの Visual Studio プロジェクトのビルド出力ディレクトリにあります。 ゲーム構成スキーマの詳細については、「MicrosoftGame.config スキーマ」を参照してください。

既定の makepkg pack では、テストのために、すべての開発キットによって認識される既知の暗号キーを使用して、パッケージが暗号化されます。(/lt 暗号化スイッチとも呼ばれます)。 これらのパッケージは、暗号で保護されているものと考えないでください。 安全なアップロードのためにパッケージ ファイルを保護するには /lk<ローカル EKB ファイル> スイッチ (本体の開発と申請におすすめ) または /l スイッチを使用します。これにより、既定の動作がオーバーライドされます。

MakePkg.exe は、パッケージ内の特定のファイルをスキャンし、それらを特別な registration チャンクに移動します。 これらのファイルには、MicrosoftGame.config 内で参照されているイメージ、および Resources.pri (存在する場合) があります。

注: Resources.pri ファイルを生成するには、makepkg localize を使用します。 より高度なシナリオについては、「パッケージ リソース インデックスの作成 (makepri.exe)」のコマンドライン ツールのトピックを参照してください。
これらのファイルを含むチャンクの ID 属性に "Registration" を指定することで、layout.xml ファイルにそれらを手動でレイアウトできます。

注: makepkg では、実行可能セクション内からの再配置を含むバイナリは拒否されます。 このような再配置は、読み込み時に実行可能セクションに対する変更が必要であり、これはコードへの変更を可能としてしまいます。 このため、makepkg ではそのような性質を持つバイナリを提供された場合は失敗します。 これを回避する一般的な方法の 1 つは、バイナリにコンパイルするときに、別の実行可能セクションに読み取り専用データのセクションをマージしないことです。

validate

パッケージを作成せずに検証手順を実行します。 手順には、パッケージの提出に関する問題を文書化するログ ファイルを生成するサブミッション バリデーターが含まれます。 省略可能な mapfile を除き、makepkg pack と同じパラメーターを取ります。

makepkg validate [options] [/f <mapping file>] /d <content directory> /pd <output package directory>

localize

コンテンツ ディレクトリ内の PNG ファイルと RESW ファイルから Resources.pri ファイルを生成します。 ローカライズされた情報を検出するためには、ディレクトリ内に MicrosoftGame.config ファイルが存在している必要があります。 このファイルでは、シェルのローカライズ用の言語定義とイメージ ファイルを指定する必要があります。 生成された Resources.pri は、出力ディレクトリが指定されている場合はそのルートに配置され、出力ディレクトリが指定されていない場合はコンテンツ ディレクトリに配置されます。 一時ディレクトリが指定されている場合は、手動検証のために、その一時ディレクトリ内に Resources.pri ファイルの XML 変換が生成されます。 Resources.pri ファイルの使用方法の詳細については、「MicrosoftGame.config のローカリゼーション」を参照してください。

makepkg localize [/d <content directory>] /pd <destinationdir> /resw <resw directory> /t <xml output directory> /gc <game config path>

genkey

ローカルのエスクロー キー BLOB (LEKB) を生成します。 コマンドは、ランダムなコンテンツ キーを作成し、LEKB ファイルに格納します。

makepkg pack /lk 暗号化スイッチで LEKB を使用します。 一般に、必要なすべての信頼境界に対して genkey を使用します。 たとえば、パッケージにアクセスできるユーザーに応じて、genkey を 1 回使用してスタジオ全体で 1 つのキーを使用したり、製品ごとに 1 つのキーを使用したりできます。

LEKB を生成するには

makepkg genkey /ekb <The path to save the generated LEKB file.>

LEKB を使用してパッケージを暗号化するには、/lk 暗号化スイッチを使用します:

makepkg pack /lk <The path to your LEKB file created by the genkey command.>

LEKB ファイルは、パッケージの作成中に安定した暗号化キー (/lk 暗号化) を使用するように makepkg pack のオプションとして提供する必要があります。 このキーには、次の 4 つの主な利点があります:

1. packageutil compare は、(/l と異なり) 正確な更新サイズの予測を生成できます。
2. (/l とは異なり) 本体と PC でコンテンツ アップデートのダウンロードに使用するのと同じアルゴリズムを使用して、パートナー センターへの差分アップロードをセキュリティで保護された形で実行できます。
3. (/l とは異なり) 開発キットにインストールできます。
4. これは、セキュリティで保護された暗号化キーを使用し、(/lt とは異なり) 特定の環境でのみ暗号化を解除できます。

LEKB ファイルの内容はわずかに難読化されているにすぎません。 アクセスをセキュリティで保護することで、コンテンツ パッケージのセキュリティを確保するのはユーザーの責任です。 LEKB ファイルと makepkg pack パックによって出力されたコンテンツ パッケージ ファイルを所有しているすべてのユーザーがその内容を解読できます。

注: makepkg pack によって生成された .ekb ファイルと区別するために、genkey によって作成されたローカル EKB ファイルの .lekb 拡張を使用してください。 "l" は、"ローカルに作成された" ことを表します。

オプション

解説

makepkg pack を実行すると、このプロセスでは、Xbox 仮想コンテナー (XVC) と呼ばれるバイナリ パッケージ ファイルが作成されます。 本体用の XVC はファイル名拡張子 .xvc を使用し、PC 用の XVC はファイル名拡張子 .msixvc を使用します。 さまざまな拡張子と共に、パッケージ名には、Xbox One ファミリ (_x) パッケージと Xbox Series X|S ファミリ (_xs) パッケージを区別するサフィックスが含まれています。

makepkg pack または makepkg validate を実行すると、プロセスにより、一連の検証テストが実行されます。 これらのテストにかかる時間は、タイトルのサイズとファイルの数によって異なります。

検証テストの結果は、アプリ パッケージの出力と同じ出力ディレクトリの XML ファイルに記録されます。 ログには、タイトルを検証に合格させるために修正する必要がある、すべてのエラーが列記されます。 検証テストでは、これまでの経験的にインジェストおよびサーティフィケーション プロセスで遅延や拒否につながる一般的なエラーを確認します。

makepkg によって設定される終了コードは次のとおりです。

このプロセスでは、より広範な情報も stderr に記録されます。

関連項目

配置パッケージのスキーマ

パッケージ リソース インデックスの作成 (makepri.exe)

MicrosoftGame.config