はじめに
MakePkg.exe は、コンテンツを XBOX Virtual Container (XVC) と呼ばれるバイナリ パッケージ ファイルに配置するツールです。コンソール向けのパッケージにはファイル拡張子 .xvc が、PC 向けのパッケージには .msixvc が付きます。拡張子の違いに加えて、XBOX One Family (_x) と XBOX Series X|S Family (_xs) のパッケージを区別するために、パッケージ名にサフィックスが追加されます。 MakePkg.exe は、タイトルのコンテンツとマッピング ファイルを入力として使用して、既知のテスト キー、ランダムに生成されたキー、または暗号化に安全な安定したキーのいずれかを使用して暗号化されたパッケージを生成します。暗号化に使用されるキーは、パッケージがローカル テスト用か、公開のために Microsoft への提出用かによって異なります。以下のセクションで使用例を詳述します。 マッピング ファイル 内の XML には 2 つの目的があります。1 つ目は、実行時にタイトルが利用できるファイルの場所を指定することです。2 つ目は、各ファイルが属するチャンク ファイルを指定することです。起動セット と呼ばれるチャンクのセットは、タイトルの実行が許可される前に常にインストールされます。残りのチャンクは、タイトルの実行中にインストールされます。チャンクのインストール進行状況を照会し、まだインストールされていないチャンクのインストール順序を変更するための API が利用可能です。 この記事の内容:- パッケージング中のステップ
- 開発中のパッケージングの推奨手順
- ストリーミング インストール パッケージのテスト
- ベスト プラクティス
- 開いているデータ接続によるパッケージングの失敗
- リソースとガイダンス
- 関連項目
パッケージング中のステップ
MakePkg のパッケージング プロセスには複数のステップが含まれます。MicrosoftGame.config とファイル存在の検証
makepkg コマンドは、コンテンツ ソース ディレクトリ内の MicrosoftGame.config ファイルが有効で、インストール可能であることをチェックします。
makepkg pack コマンドを実行すると、MicrosoftGame.config 内で参照されるファイルがソース ディレクトリにあることが保証されます。これらのファイルが起動セット用のパッケージに含まれていることを検証します。この検証には、バイナリ、画像ファイル、およびその他のリソースが含まれます。
バイナリ署名
XBOX Code Integrity (XCI) はタイトル内のファイルをスキャンして署名します。このプロセスの一環として、ファイル内で検出された PE ヘッダーをパッケージ ファイルに書き込む前に変更します。署名が失敗すると、エラー メッセージが報告されます。このメッセージには、署名失敗の詳細を収集するために xcihash.exe を手動で再実行するためのコマンドが含まれます。パッケージの作成
MakePkg は事前検証ステップが完了するとすぐにパッケージ ファイルを作成します。その後、MakePkg は署名された実行可能ファイルを含むソース ファイルを、XML マップ ファイルで指定されたチャンク内のパッケージ ファイルにコピーします。コンソールのみ: パッケージ作成の最後のステップでは、Game OS ファイル (GameOs.xvd) を埋め込みます。このファイルは Microsoft Game Development Kit (GDK) の一部で、ゲームの実行可能ファイルの隣のレイアウト ディレクトリに存在する必要があります。
/gameos フラグは、Game OS ファイルの代替ソース ロケーションを指定します。暗号化
テスト署名 (既定の暗号化)
MakePkg の既定の動作はテスト署名されたパッケージを作成することですが、makepkg pack を呼び出す際に /lt スイッチを使用しても同じことを示します。テスト署名は、既知のテスト暗号化キーを使用して生成されたパッケージ ファイルを暗号化し、XBOX および PC でのパフォーマンス テスト検証を目的としています。リアルタイム パッケージ復号の影響はタイトルに対して透過的になるように設計されていますが、これにより、タイトルの認定と最終公開の前に暗号化に起因する可能性のあるパフォーマンス問題が発見されるようになります。テスト署名されたパッケージは、暗号化に固定キーを使用するため、コンテンツを暗号学的に保護するためのものではありません。テスト署名されたパッケージは、xbapp install を使用して開発キットに、wdapp install を使用して開発 PC にインストールできます。
ランダム キー暗号化 (/l スイッチ)
MakePkg の /l スイッチは、ランダムに生成された暗号化キーでパッケージ ファイルを暗号化します。タイトル パッケージに加えて、MakePkg /l は PackageFullName_licenseName_GUID.EKB の形式の名前のファイルを出力します。(アンダースコア (_) 文字の使用に注意してください。) /l スイッチで作成されたパッケージは、開発キットや開発 PC にはインストールできません。タイトルがすべてのチェックと提出前テストに合格するまで、テスト署名されたパッケージを使用してタイトルをテストする必要があります。その状態に達した後、Microsoft への最終提出の前に、/l スイッチを付けて MakePkg を実行します。
推奨 - 安定キー暗号化 (Genkey + /lk スイッチ)
Makepkg の/lk スイッチは、makepkg genkey コマンドによって作成された安定した (常に同じ) キーでパッケージを暗号化します。タイトル パッケージに加えて、makepkg /lk は PackageFullName_licenseName_GUID.EKB および PackageFullName_licenseName_GUID.CEKB の形式の名前のファイルを出力します。(アンダースコア (_) 文字の使用に注意してください。) /lk スイッチで作成されたパッケージは開発キットにインストールできますが、開発 PC にはインストールできません。PC の場合は、タイトルがすべてのチェックと提出前テストに合格するまで、テスト署名されたパッケージを使用してタイトルをテストする必要があります。
これは、以下の利点により、開発キットのテストおよび提出に推奨される暗号化モードです。
- packageutil compare が正しい更新サイズ推定値を生成できます (
/lとは異なります)。 - コンソールと PC がコンテンツ更新をダウンロードするのに使用するのと同じアルゴリズムを使用して Partner Center へのセキュアな差分アップロードを可能にします。
- デブキットにインストールできます (
/lとは異なります)。 - セキュアな暗号化キー マテリアルを使用し、特定の環境でのみ復号できます (
/ltとは異なります)。
/lt および /l 暗号化モードとは異なり、/lk モードを使用するには追加の一度きりの手順が必要です。
- 一度限り:
makepkg genkey /ekb SECRET_KEY.lekbを実行して SECRET_KEY.lekb ファイルを作成します。これは、パッケージを暗号化する安定したコンテンツ キーを格納する Local Escrowed Key Blob (LEKB) です。これは、必要な担当者のみがアクセスできる安全な場所に保管する必要があります。理想的な設定では、正式なビルド マシン/アカウントのみがそれにアクセスできる必要があります。 - パッケージの作成:
makepkg pack /lk SECRET_KEY.lekb ...を実行します。これにより、SECRET_KEY.lekb ファイルに格納されているキーを使用して暗号化されたパッケージが作成されます。 - パッケージのアップロード: XVC および EKB ファイルは通常どおり Partner Center にアップロードされます。LEKB および CEKB ファイルはアップロードされません。
xbapp install は、XBOX デブキットにパッケージを読み込むために必要な CEKB ファイルを自動的にインストールします。ツールベースのインストール以外のインストール シナリオ (ゲーム ディスク、外部ストレージ、コンソール間転送) をテストする場合は、xbapp installkey コマンドを使用して CEKB ファイルのみをインストールします。
その内容を復号できます。
自分のデブキットにパッケージをインストールでき、パッケージを起動でき、xbcp でパッケージからファイルを取り出せます。
提出検証
MakePkg は、パッケージを作成した後、タイトル ファイルに対して自動的に Submission Validator (SubmissionValidator.dll) を実行します。Submission Validator の目標は、Microsoft の取り込み、提出、または認定プロセスの後半で、あるいは今後のコンテンツ更新でタイトルに問題を引き起こす可能性のあるエラーや問題を確認することです。Partner Center にアップロードするための署名済みパッケージを生成する前に、検出されたすべての問題を修正する必要があります。 提出検証プロセスは、失敗の性質と場所を詳述する XML ログ ファイルを生成します。プロセスはこのログ ファイルを、パッケージ ファイルの出力用に MakePkg の/pd パラメーターで指定された同じ場所に書き込みます。このログには失敗または警告が含まれる可能性があります。パッケージを Microsoft に提出する前に失敗に対処する必要があります。タイトルがポリシーと XBOX 要件 (XR) ガイダンスに準拠していることを確認するために、警告も是正することを検討してください。
パッケージを Partner Center にアップロードして取り込みプロセスのために提出すると、検証チェックが再度実行されます。このプロセスにより、タイトルが最新バージョンの Submission Validator を使用してチェックされ、可能な限り早く問題が検出されるようになります。
提出検証テスト
Microsoft が新しい問題を特定するにつれて、特定のテストは時間とともに進化します。Submission Validator のチェックに合格したことは、取り込みと認定のプロセス中にタイトルの提出に関して他の問題が発生しないことを示すものではありません。むしろ、その意図は、予測可能なエラーに起因する拒否の時間とコストを削減することのみです。加えて、Submission Validator は特定のセキュリティ関連の問題をチェックできますが、タイトルのセキュリティ テストと見なすべきではありません。
Submission Validator の最新バージョンは、XBOX Game Developer (XGD) サイトからダウンロードできます。このツールは XBOX One Software Development Kit のリリースとは異なるペースで進化する可能性があるため、提出プロセスで検証失敗による拒否を回避するために、最新バージョンを使用していることを確認してください。最新バージョンを入手するには、XBOX Developer Downloads->XBOX One->Submission Validator を参照してください。
Submission Validator の詳細については、GDK ドキュメントの Submission Validator (SubmissionValidator.dll) を参照してください。
検証プロセスに関する質問がある場合は、Microsoft アカウント担当者にお問い合わせください。
開発中のパッケージングの推奨手順
開発中にパッケージを作成するには、次の手順を使用します。PC を対象とする場合はxbapp の代わりに wdapp を使用します。
- テスト署名されたパッケージと開発 PC からの xbapp install を使用して、ローカルで反復します。 MakePkg.exe pack /f Mapfile /d LooseContentDir /pd OutputFolder 始めるには、XBOX Developer Downloads を参照してください。
- シェルから起動するか、xbapp launch を使用してタイトルを実行します。 xbapp install local-XVC-path または xbapp install http-URI ストリーミング インストールの代替オプションをテストするには、この記事の後半にある ストリーミング インストール パッケージのテスト を参照してください。
- ルート フォルダーで Blu-ray Disc に焼かれたテスト署名されたパッケージを使用して、光学ドライブからのタイトル インストールをテストします。ディスクを XBOX 開発キットに挿入した後、次のコマンドを実行します。 xbapp install XO:\XVC-file-name
-
テスト署名されたパッケージと同じパッケージング コマンドを使用して、最終提出を準備しますが、
/lフラグを追加します。
ストリーミング インストール パッケージのテスト (PC)
wdapp コマンドを使用して、テスト PC にパッケージをインストールします。
現時点では、テスト MSIXVC パッケージはテスト PC 上の物理ドライブまたは Web サーバー上に存在する必要があります。将来の更新で、Universal Naming Convention (UNC) 共有からのインストールが追加される予定です。
ストリーミング インストール パッケージのテスト (コンソール)
テスト署名されたストリーミング インストール パッケージのインストールを 4 つの方法でテストできます。開発 PC からのストリーミング
開発 PC からのストリーミングは、スループット スロットリングをサポートしていません。インストールの速度は、開発 PC のプロセッサと I/O 特性、および開発 PC と開発キット間のネットワーク接続の帯域幅に依存します。機械式ハード ドライブを備えた現代の開発 PC からギガビット イーサネット接続経由で、300 Mbps (約 36 MiB/s) 以上の速度が期待できます。 xbapp install dev-pc-path-to-XVC コマンドラインからのインストール XBOX Manager からのインストールWeb サーバーでパッケージをホストする
Web サーバーが帯域幅スロットリングの構成をサポートしている場合、パッケージを Web サーバーでホストすると、さまざまなネットワーク配信速度をシミュレートできます。XBOX One プラットフォームは、接続失敗と再試行ロジックを処理します。タイトルは、速度を除けば、インターネット ソースからインストールしたときと光ディスクからインストールしたときで同じように動作するはずです。 xbapp install http-URI-to-package コマンドラインからのインストール XBOX Manager からのインストールパッケージをディスクに焼き、コマンドラインからインストールする
ルート ディレクトリに XVC を含む光ディスクを焼き、次のコマンドを使用してパッケージをインストールします。 xbapp install XO:\XVC-file-nameパッケージをディスクに焼き、シェル経由でインストールする
パッケージを含む MSXC という名前のフォルダーを含む光ディスクを焼きます。 実行中の開発キットにディスクを挿入します。シェルは自動的にタイトルのインストールを開始し、開発キットは起動セットのインストール後に通知を表示し、タイトルを起動できるようになります。ベスト プラクティス
サブファイル コンテンツ更新の使用
コンテンツ更新のサイズを削減するサブファイル コンテンツ更新を使用します。将来の最適なコンテンツ更新を確保するため、パッケージ レイアウトを作成します。 最適な更新のためのパッケージ作成に関する詳細は、コンテンツ更新のベスト プラクティス を参照してください。XBOX 要件 034 (XR-034: ストリーミング インストール初期プレイ マーカー)
初期プレイヤー マーカーを含めることは任意ですが、強く推奨されます。これにより、ユーザーはタイトルが完全にインストールされる前に、バックグラウンドでインストールを継続しながらタイトルを実行できます。XR-034: ストリーミング インストール初期プレイヤー マーカーに従って、初期プレイ マーカーを含むタイトルは、初期プレイ マーカーから起動されたときにゲームプレイ体験を提供する必要があります。タイトルのテスト
タイトルがさまざまなソースから、さまざまな速度でインストールされている間に、タイトルをテストします。最新の Submission Validator を使用する
常に最新バージョンの Submission Validator を使用してください。 Submission Validator の最新バージョンは、XBOX Developer Downloads->XBOX One->Submission Validator から入手できます。開いているデータ接続によるパッケージングの失敗
xbapp install /w を使用してパッケージをインストールする場合、または XBOX Manager が Keep data connection open オプション (Intelligent Delivery および chunk-on-demand シナリオで使用) を有効にしてパッケージをインストールする場合、インストールが完了した後もコンソールと PC 上のパッケージ ファイルの間のデータ パイプが開いたままになります。この開いた接続はパッケージ ファイルをロックします。
このパイプが開いている間にタイトルを再ビルドまたは再パッケージ化しようとすると、makepkg はロックされたパッケージ ファイルに書き込めないため、共有違反で失敗します。
この問題を解決するには、再ビルドの前に開いているデータ接続を閉じます。
- XBOX Manager: XBOX Manager アプリで、インストールされているパッケージを見つけて Keep data connection open オプションのチェックを外すか、そのオプションを有効にせずにパッケージをアンインストールして再インストールします。
- xbapp install: インストール後にパイプを開いたままにする必要がない場合は、
/wフラグを省略します。開発中のテストで、タイトルが実行時に追加のチャンクを要求する必要がある場合にのみ/wを使用します。 - XBOX Manager を閉じる: XBOX Manager を完全に閉じると、パッケージ ファイルに対して保持している開いているファイル ハンドルが解放されます。
リソースとガイダンス
詳細については、次の記事を参照してください。- System > Overviews > ストリーミング インストールと Intelligent Delivery: 概要
- System > Overviews > Streaming Installation > チャンクの動的な並べ替え
- System > Overviews > Streaming Installation > ストリーミング インストール: ステータス
- Test, Automation, and Publishing > Tools > Streaming Installation > デプロイ パッケージ スキーマ
- Test, Automation, and Publishing > Tools > Streaming Installation > Make Package (makepkg.exe)