XBOX Gaming Project Control

GDK は Visual Studio シェルに XBOX Gaming Project Control というツールウィンドウをインストールします。このツールウィンドウは、XBOX 固有のすべてのプロジェクト設定を管理するための中央の場所を提供します。XBOX プロジェクト設定の管理を一元化することに加え、XBOX Gaming Project Control は設定が正しく、正常なデプロイとデバッグセッションが得られるようサポートします。個々の設定は入力時に正しさが検証されます。設定の値が構成間で異なる場合も指摘されます。これらの不一致を特定することは、異なる構成で意図せず異なる値に設定された設定を事前に見つけるのに役立ちます。たとえば、XBOX Gaming Project Control は、Debug、Release、Profile の構成間でデプロイ方法が異なるケースを強調表示します。 XBOX Gaming Project Control にアクセスするには、[XBOX] メニューを使用します。次の図に示すように、[XBOX] メニューは Visual Studio の [拡張機能] メニューの下にあります。

概要ページには、現在選択されている構成とプラットフォームが表示され、以下の設定を構成するために使用する詳細ページへアクセスするためのボタンのセットが用意されています。

Deployment
MicrosoftGameConfig.mgc の割り当て
Command Arguments
Module Loads のログ出力
Break on Suspend Timeout

Advanced Controls ドロップダウンは、Deploy from OutDir、OutDir、LayoutDir、LayoutExtensionFilter プロパティの編集ページへのアクセスを提供します。

設定ボタンの緑色のチェックマークは、そのカテゴリの設定の値が検証済みで、すべての構成にわたって同じであることを示します。赤色の感嘆符は、設定の値にエラーがあるか、設定の値がすべての構成にわたって同じでないことを示します。次の図では、Command Arguments の設定は有効で一貫していますが、Deployment の設定はそうではありません。

Inconsistent settings in the XBOX Gaming Project Control

構成によって値が異なる設定が必ずしも設定が不正であることを意味しないことに注意してください。たとえば、構成ごとに異なるコマンドライン引数を持つことは一般的です。対照的に、構成ごとに異なるデプロイ方法を使用することは一般的ではないため、デプロイ設定が意図せず不一致となっている可能性があります。赤色の感嘆符は、設定が正しくないという絶対的な指示ではなく、設定を確認したい場合があるという指示です。 XBOX Gaming Project Control を使用してプロパティに加えた変更は、直ちにプロジェクトファイルに書き込まれます。OK や [適用] ボタンといった追加のアクションは不要です。すべての編集は Visual Studio の元に戻す/やり直しスタックと完全に統合されています。Visual Studio ツールバーまたは標準の Ctrl-Z および Ctrl-Y キーシーケンスを使用して、元に戻す/やり直しスタックにアクセスします。次の図は、XBOX Gaming Project Control で編集されたいくつかのプロパティを含む元に戻すスタックを示しています。

An undo stack with XBOX Gaming Project Control property edits

XBOX Gaming Project Control を使用して編集できるプロパティは、Visual Studio の C++ プロジェクトのプロパティページを使用して編集することもできます。編集が行われると、すべてのプロパティの値は 2 つのウィンドウ間で同期して保持されます。

Deployment 設定

Deployment ページを使用して、アクティブな構成およびプラットフォームのデプロイ方法と方法固有の設定を指定します。Push、RfPC、または External のボタンのいずれかを選択してデプロイ方法を選択します。現在選択されているデプロイ方法は、対応するデプロイ方法ボタンの周囲の緑色のハイライトで示されます。デプロイ方法固有の設定は、選択された方法に基づいて表示されます。次の図では、RfPC デプロイ方法が選択されています。起動文字列を変更したり、省略可能な資格情報を入力したりするための編集ボックスが用意されています。

デプロイ方法がすべての構成で同じでない場合、その違いの理由がデプロイ方法ボタンの右側にあるコントロールに表示されます。次の図では、デプロイページは現在、Profile 構成のデプロイ設定を編集しており、そのデプロイ方法は RfPC に設定されています。しかし、デプロイの違いコントロールに示されているように、Release 構成のデプロイ方法は Push に設定されています。

Different deploy methods per configuration

必要に応じて、Align ボタンを使用して構成間でデプロイ設定を同期できます。この場合、Align ボタンをクリックすると、Release 構成のデプロイ方法が Push から現在の構成およびプラットフォームで使用されている方法 (この場合は RfPC) に変更されます。

MicrosoftGameConfig.mgc 設定

Visual Studio プロジェクトシステムおよび msbuild ファイルには、各ビルド構成に対して異なる MicrosoftGameConfig.mgc ファイルを指定するためのサポートが含まれています。MicrosoftGameConfig.mgc ファイルは、プロジェクトのビルド時に出力ディレクトリにコピーされる際、MicrosoftGame.config に名前が変更されます。 [MicrosoftGame.config の割り当て] ボタンをクリックすると、各ビルド構成に使用する MicrosoftGameConfig.mgc ファイルを指定できるページが開きます。既定の MicrosoftGameConfig.mgc ファイルも指定できます。この既定のファイルは、明示的にオーバーライドされない限り、すべての構成に使用されます。次の図に示すように、[プロジェクトの既定] ドロップダウンを使用して既定の MicrosoftGameConfig.mgc ファイルを指定します。プロジェクトが Microsoft Game Development Kit (GDK) テンプレートを使用して最初に作成された場合、既定の MicrosoftGameConfig.mgc が暗黙的に設定されることに注意してください。