Partner Center から製品 ID 情報を取得する
パッケージは、パブリッシャー ID、PackageFamilyName、MSAAppId、および TitleId を含む、Partner Center でゲームに割り当てられた製品 ID を参照します。製品をセットアップし、MicrosoftGame.config で使用するために、Game Setup | Identity ページからこの情報を取得します。- まだの場合は、ID@XBOX プログラムに登録 し、Partner Center アカウントを作成 します。
- Partner Center でゲームの 初期製品定義を作成 します。
- 製品の Game Setup | Identity ページで、上記に記載された ID 値を見つけます。
残りのゲームコンテンツと共にルートフォルダーに MicrosoftGame.config ファイルを作成する
サンプルの MicrosoftGame.config XML ファイルは、この記事の後半に含まれています。このサンプルは、.config ファイルの作成を効率化し、Partner Center プロジェクトから ID と名前の値を自動的に同期できる MicrosoftGame.config Editor と共に参照として使用してください。シェルと Microsoft Store パッケージに表示するアイコンを作成する
以下の MicrosoftGame.config サンプルにリストされている各画像について、指定されたサイズにスケーリングされた対応するファイルをゲームのルートフォルダーに配置します。あるいは、画像アセットをサブディレクトリに配置し、ShellVisuals のアイコンパスをそれに合わせて調整することもできます。MicrosoftGame.config Editor では、単一のソース画像を入力としてこれらの画像を生成できます。
Microsoft Game Development Kit (GDK) (makepkg.exe パッケージングツールを含む) をインストールする
既定では、Microsoft Game Development Kit (GDK) コマンドプロンプトは次のフォルダーにあります:C:\Program Files (x86)\Microsoft GDK\Command Prompts
パッケージレイアウトマッピングファイルを作成する
すべてのゲームコンテンツを含む単一のフォルダーがあるフォルダーで Microsoft Game Development Kit (GDK) コマンドプロンプトを開き、次のコマンドを実行します。makepkg genmap /f layout.xml /d <Your_Game_Folder>
パッケージを作成する
パッケージの作成方法
/lk 暗号化パッケージを作成するには、以下の手順に従います。
- 1 回:
makepkg genkey /ekb SECRET_KEY.lekbを実行してSECRET_KEY.lekbファイルを作成します。このファイルは、パッケージを暗号化する安定したコンテンツキーを保存する Local Escrowed Key Blob (LEKB) です。必要な人だけがアクセスできる安全な場所に保存してください。理想的なセットアップでは、公式ビルドマシンとアカウントのみがそれにアクセスできるべきです。 - パッケージ作成:
makepkg pack /lk SECRET_KEY.lekb /f layout.xml /d <Your_Game_Folder_Name> /pd <Output_Folder_Name>を実行します。このコマンドは、SECRET_KEY.lekb ファイルに保存されているキーを使用して暗号化されたパッケージを作成します。
パッケージ暗号化に関する重要な注意事項
makepkg の /lk スイッチは、makepkg genkey コマンドが作成する安定した (常に同じ) キーを使用してパッケージを暗号化します。タイトルパッケージに加えて、makepkg /lk は PackageFullName_licenseName_GUID.EKB および PackageFullName_licenseName_GUID.CEKB 形式のファイルを生成します。(アンダースコア (_) 文字の使用に注意してください。)
コンソールでの開発キットテストおよび提出には /lk 暗号化を使用します。テスト暗号化 (/lt) および提出暗号化 (/l) と比較して次の利点があります。
packageutil compareは正確な更新サイズ推定を生成できます (/lと異なり)。- コンソールと PC がコンテンツ更新をダウンロードするのと同じアルゴリズムを使用して、Partner Center への安全なデルタアップロードを可能にします。
- 開発キットにインストールできます (
/lと異なり)。 - 安全な暗号化キーマテリアルを使用し、特定の環境でのみ復号化できます (
/ltと異なり)。
パッケージインストールをテストする
次のコマンドを使用してパッケージインストールをテストします。xbapp install <Your_Package>
パッケージが Intelligent Delivery Feature を使用している場合、/i オプションを使用して、小売のエンドユーザーエクスペリエンスをテストするためにどのパッケージ Feature をインストールするかを選択するインタラクティブシェル UI を呼び出します。
xbapp install /i <Your_Package>
パッケージインストールに関する重要な注意事項
xbapp install は、パッケージを XBOX 開発キットにロードするために必要な CEKB ファイルを自動的にインストールします。ツールベースのインストール (ゲームディスク、外部ストレージ、コンソールからコンソールへの転送) 以外のインストールシナリオをテストしている場合は、CEKB ファイルのみをインストールするために xbapp installkey コマンドを使用できます。詳細については xbapp.exe を参照してください。
2021 年 4 月の GDK より前に生成された LEKB ファイルは CEKB ファイルを作成しません。新しい開発キットサイドロード機能を使用するには、LEKB ファイルを 2021 年 4 月以降の GDK ツールで再作成する必要があります。
パッケージのディスクを作成する予定の場合は、次の記事を参照してください
テストコンピレーションディスクの作成 クロスジェネレーションテストディスクの作成パッケージを Microsoft Partner Center に提出する
以前の makepkg.exe コマンドを使用して作成したパッケージは、/lk フラグが使用されているため、テストと提出の両方に使用できます。また、このパッケージをアップロードする際にデルタアップロードの恩恵も受けます。XVC および EKB ファイルは通常通り Partner Center にアップロードされます。LEKB および CEKB ファイルはアップロードされません。
