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

​
Deployment 設定

Deployment ページを使用して、アクティブな構成およびプラットフォームのデプロイ方法と方法固有の設定を指定します。Push、RfPC、または External のボタンのいずれかを選択してデプロイ方法を選択します。現在選択されているデプロイ方法は、対応するデプロイ方法ボタンの周囲の緑色のハイライトで示されます。 デプロイ方法固有の設定は、選択された方法に基づいて表示されます。次の図では、RfPC デプロイ方法が選択されています。起動文字列を変更したり、省略可能な資格情報を入力したりするための編集ボックスが用意されています。 デプロイ方法がすべての構成で同じでない場合、その違いの理由がデプロイ方法ボタンの右側にあるコントロールに表示されます。次の図では、デプロイ ページは現在、Profile 構成のデプロイ設定を編集しており、そのデプロイ方法は RfPC に設定されています。しかし、デプロイの違いコントロールに示されているように、Release 構成のデプロイ方法は Push に設定されています。 必要に応じて、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 が暗黙的に設定されることに注意してください。 ドロップダウンの値が [未選択] の構成は、既定の MicrosoftGameConfig.mgc ファイルを使用します。次の図に示すように、ドロップダウンからファイルを選択して、特定の構成の既定ファイルをオーバーライドします。

​
Command Arguments

Command Arguments ページを使用して、各ビルド構成の引数を編集します。各構成に対して別々の編集ボックスが用意されています。

​
Module Loads のログ出力

[Logging of Module Loads] ボタンを使用して、モジュール読み込み情報を含む詳細なデバッグ出力を有効にします。ボタン自体のスライダーは、アクティブなビルド構成のプロパティを切り替えます。 ボタンをクリックすると、すべてのビルド構成に対する値を指定できるページが開きます。

​
Break on Suspend Timeout

[Break execution on suspend timeout] ボタンを使用して、デバッガがアタッチされているときに 1 秒のサスペンド タイムアウトを再有効化 します。 ボタン自体のスライダーは、アクティブなビルド構成のプロパティを切り替えます。 ボタンをクリックすると、すべてのビルド構成に対する値を指定できるページが開きます。

​
Advanced Controls

Advanced controls ドロップダウンを使用して、Deploy from Outdir、LayoutDir、LayoutExtensionFilter、および OutDir プロパティの編集ページにアクセスします。 各構成のプロパティ値を編集するために、個別の編集ボックスまたはスライダー コントロールが用意されています。

​
関連項目

Visual Studio XBOX 開発向けの Visual Studio プロパティ
最終更新日 2026年8月24日