Windows 10 バージョンの最小要件を確認する
MSIXVC ベースパッケージのデプロイテストには、Windows 10 バージョン 18362 以降が必要です。パッケージのニーズを評価する
パッケージに次のプロパティのいずれかがある、または次の機能のいずれかが必要な場合は、この記事の後半の その他のパッケージング上の考慮事項と高度な機能 セクションを参照してください。- Framework パッケージ依存関係 アプリが再配布可能なソフトウェアに依存している場合、Microsoft から事前パッケージ化されたこれらの前提条件の多くを使用でき、依存関係として宣言して自動的にインストールできます。
- カスタムインストールアクション アプリが Framework パッケージがない再配布可能ソフトウェアに依存している場合、これらの依存関係をチェーンインストールできます。
コンテンツを準備する
タイトルのすべてのソースマテリアルを単一のディレクトリに配置します。MSIXVC パッケージシステムがサポートしていない、または小売パッケージでの出荷に不適切なファイルは削除します。- Program database (PDB) ファイル。
- AppxSignature.p7x や AppxBlockMap.xml を含む、Universal Windows Platform (UWP) と APPX フットプリントファイル。以前に Microsoft Store で UWP として出荷した場合、APPX または MSIX パッケージに関連付けられたこれらのファイルの一部を持っているかもしれません。これらのファイルを削除してください。
- 他の PC ゲームストア (アセット、バイナリなど) への参照。
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 XML ファイルを作成し、残りのゲームコンテンツを作成する
サンプルの MicrosoftGame.config xml ファイルは、この記事の後半に含まれています。このサンプルは、.config ファイルの作成を効率化し、Partner Center プロジェクトから ID と名前の値を自動的に同期する MicrosoftGame.config Editor と共に参照として使用してください。Visual C/C++ ランタイム依存関係を特定する
パッケージの Visual C/C++ ランタイム依存関係を特定します。それらが MicrosoftGame.config で依存関係としてリストされているか、パッケージペイロードに明示的にコピーされていることを確認します。詳細については、Framework パッケージ依存関係 を参照してください。シェルとストアパッケージに表示するアイコンを作成する
以下の MicrosoftGame.config サンプルにリストされている各画像について、指定されたサイズにスケーリングされた対応するファイルをゲームのルートフォルダーに配置します。あるいは、画像アセットをサブディレクトリに配置し、ShellVisuals のアイコンパスをそれに合わせて調整することもできます。MicrosoftGame.config Editor では、単一のソース画像を入力としてこれらの画像を生成できます。MakePkg.exe パッケージングツールを含む Microsoft Game Development Kit をインストールする
既定では、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>
このコマンドは layout.xml (このファイル名は推奨名ですが、任意の名前を使用できます) というファイルを作成します。パッケージング手順中にこのファイルを使用します。パッケージングツールの詳細については、Make package (makepkg.exe) を参照してください。
Intelligent Delivery を使用してインストールサイズを削減する方法を判断する
layout.xml ファイル内のコンテンツにタグを付けることでインストールサイズを削減する方法については、Intelligent Delivery の概要 を参照してください。ローカライズされた大きなアセットや、既定でインストールされるべきではないがゲームによってトリガーされたときにダウンロード可能であるべきコンテンツがある場合は、Intelligent Delivery の使用を検討してください。パッケージを作成する
次のコマンドを使用してパッケージを作成します。MakePkg pack /f layout.xml /lt /d <Your_game_folder_name> /nogameos /pc /pd <Output_Folder_Name>
ゲーム内ストアや試用版などのライセンス依存シナリオでは、実際のコンテンツ ID を持つ makepkg を使用します。Partner Center はパッケージを最初に取り込むときにこの実際のコンテンツ ID を生成します。Packages ページで提出されたパッケージの詳細で見つけることができます。
ターゲット PC で開発者モードを有効にする
- Settings を開きます。
- 検索フィールドに Developer と入力します。表示されるオプションから、Use developer features を選択します。
- Developer mode を選択します。システムがいくつかの機能を追加していることを伝えるダイアログボックスが表示されます。このステップを超えて進む前に、このプロセスが完了するのを待ちます。
アプリインストールをテストする
次のコマンドを実行します:Wdapp install <Your_Package.msixvc>
パッケージは開発 PC のローカルドライブ、またはドライブレターにマップされたネットワークの場所に存在する必要があります。Universal Naming Convention (UNC) 共有からのインストールはまだサポートされていません。進行状況が表示されない場合は、Microsoft Store アプリを開き、アプリの右上隅にある下向き矢印で示される Downloads and updates セクションの下で進行状況を表示できます (存在する場合)。省略記号 (…) を選択してから Downloads and updates を選択することもできます。
2022 年 3 月の Microsoft Game Development Kit (GDK) 以降、MSIXVC パッケージは変更およびアクセス可能なフラットファイルとしてレイアウトされた [drive]:\XboxGames フォルダーにインストールされます。このドライブの場所は Application Management (wdapp.exe) を使用して構成できます。フラットファイルインストール機能の詳細については、フラットファイルインストールの概要 を参照してください。
最終パッケージを準備し、Partner Center に提出する
以前の MakePkg.exe コマンドを使用して作成したパッケージは、テストまたは開発キーを使用して暗号化する /LT パラメーターを使用していました。最大のセキュリティのために、/LK フラグで安定したキーを使用して暗号化するか、/L フラグで一意のキーを使用して暗号化する MakePkg.exe コマンドを再度実行します。/LK で作成されたパッケージはローカルサイズデルタ比較に使用でき、Partner Center に提出する際にデルタアップロード最適化の恩恵を受けるため、/L よりも /LK を使用してください。
サンプル MicrosoftGame.config
MicrosoftGame.config という名前のファイルを作成します。ゲームコンテンツのルートディレクトリで次の内容を使用し、必要のない項目のコメントを削除します。 MicrosoftGame.config を手動で作成することもできますが、このファイルを作成する最善の方法は MicrosoftGame.config Editor を使用することです。このツールでは、Partner Center プロジェクトから ID と ID 値を直接同期することも簡単に行えます。その他のパッケージング上の考慮事項と高度な機能
一般的なソフトウェア依存関係用の Framework パッケージ
アプリが再配布可能なソフトウェアに依存しており、そのソフトウェアが Framework パッケージとして Microsoft Store で利用可能な場合、再配布可能をチェーンインストールする代わりに、Framework パッケージへの依存関係を宣言します。 たとえば、アプリが従来は Microsoft ダウンロードサイトから再配布された dxsetup.exe を使用して満たされていたレガシー DirectX ランタイムを使用している場合、以下のように Windows.Universal と Windows.Desktop の標準的な依存関係と並んで Framework パッケージへの依存関係を宣言します。Framework パッケージは Microsoft Store 経由で自動的に更新でき、カスタムインストールアクションはインストールプロセスの一部として管理者の承認と確認プロンプトを必要とするため、カスタムインストールアクションを使用して redist を直接インストールするよりもこのアプローチが好まれます。Mod サポート
2022 年 3 月の Microsoft Game Development Kit (GDK) 以降、Mod は既定でサポートされています。詳細については、Mod を参照してください。カスタムインストールアクション
アプリのインストール時に他のインストーラー (.exe または .msi ファイル) をチェーンインストールする必要がある場合、CustomInstallActions 要素を使用してこの手順を構成します。 再配布可能については、VC ランタイムや DirectX 再配布可能 .exe または .msi ファイルなどにカスタムインストーラーを使用することを決定する前に、Framework パッケージが利用可能で必要な前提条件を含んでいるかどうかを確認してください。カスタムインストールアクションの詳細については、カスタムインストールアクション を参照してください。制限された機能権限
MicrosoftGame.config ファイルを正しい要素を含むように構成することに加えて、次の機能を使用するためにタイトルの権限を設定するには、アカウントマネージャーにメールを送信してください。- カスタムインストールアクション (CustomInstallActions 要素)。
