Microsoft Game Development Kit をインストールしないでビルド環境を構成する
このトピックでは、抽出された Microsoft Game Development Kit (GDK) 内でのビルド環境とコマンド プロンプトの構成について説明します。これは、Microsoft Game Development Kit (GDK) が正常に動作するように抽出された後に追加の手順が必要になるためです。
環境変数コマンド ファイル
Microsoft Game Development Kit (GDK) には、環境変数の定義に使用される一連の .cmd ファイルが含まれています。 コマンド ラインの操作 (MSBuild を使用したビルドなど) にアクセスするためのコマンド プロンプトを適切に作成する必要があります。
これらの .cmd ファイルには 2 つのインスタンスがあります。 これらは、以下の例のような、ファイルの展開先にあります。
- C:\ExtractedGDK\220300\Microsoft GDK\Command Prompts\GamingXboxVars.cmd
- C:\ExtractedGDK\220300\Microsoft GDK\Command Prompts\GamingDesktopVars.cmd
これらのファイルを調べると、環境変数の定義と検出の方法について理解を深めるために役立ちます。 ほとんどの環境変数は、IF NOT チェックに基づいて設定されるため、実行前に設定することにより、オーバーライドできます。
最初の入力変数 %1 は、プラットフォームと Visual Studio のバージョンを決定するために使用されます。 これに使用できる値は以下のとおりです。
- GamingXboxVS2019
- GamingXboxVS2022
- GamingXboxScarlettVS2019
- GamingXboxScarlettVS2022
- GamingDesktopVS2019
- GamingDesktopVS2022
この (コマンド ラインでの) 使用例は、GamingXboxVars.cmdGamingXboxVS2022 です。
これにより、Xbox と Visual Studio 2022 で動作するように定義された環境変数でコマンド プロンプトが設定されます。 次のセクションでは、抽出されたキット ファイルを参照するコマンド プロンプトを設定するためにオーバーライドする必要がある環境変数について詳しく説明します。
Gaming.Xbox.XboxOne.x64 と Gaming.Xbox.Scarlett.x64 の環境変数の構成
Microsoft Game Development Kit (GDK) コマンド プロンプトで GamingXboxVars.cmd を呼び出す前に、次の環境変数を設定して、抽出された場所を参照し、ローカル インストールチェックをオーバーライドする必要があります。
- GXDKEDITION: ゲーム Xbox 開発キット (GXDK) のエディション番号。 たとえば、220300 は March 2022 Microsoft Game Development Kit (GDK) を指します。
- GameDK: Microsoft Game Development Kit (GDK) のルートの場所。
- GameDKLatest: ルートの場所の下にある最新エディション番号のフォルダー。
- WindowsSdkDir: Windows 10 SDK の場所。
- GamingGRDKBuild: ゲーム ランタイム開発キット (GRDK) 固有のファイルの場所。
- GamingGXDKBuild: Microsoft Game Development Kit (GDK) 固有のファイルの場所。
- VSInstallDir: Visual Studio インストールの場所。
これらの環境変数が展開先のファイルの例をポイントするように設定するコマンドの例を以下に示します。
SET GXDKEDITION=220300
SET "GameDK=C:\ExtractedGDK\%GXDKEDITION%\Microsoft GDK\"
SET "GameDKLatest=%GameDK%%GXDKEDITION%\"
SET "WindowsSdkDir=C:\ExtractedWin10SDK\Windows Kits\10\"
SET "GamingGRDKBuild=%GameDKLatest%GRDK\"
SET "GamingGXDKBuild=%GameDKLatest%GXDK\"
SET "VSInstallDir=C:\Program Files\Microsoft Visual Studio\2022\Enterprise\"
前のセクションで説明した GamingXboxVars.cmd 入力変数を使用して、Xbox One と Xbox Series X|S 環境を切り替えます。
Gaming.Desktop.x64 の環境変数の構成
Microsoft Game Development Kit (GDK) コマンド プロンプトで GamingDesktopVars.cmd を呼び出す前に、次の環境変数を設定して、抽出された場所を参照し、ローカル インストールチェックをオーバーライドする必要があります。
- GRDKEDITION: ゲーム ランタイム開発キット (GRDK) のエディション番号。 たとえば、220300 は March 2022 Microsoft Game Development Kit (GDK) を指します。
- GameDK: Microsoft Game Development Kit (GDK) のルートの場所。
- GameDKLatest: ルートの場所の下にある最新エディション番号のフォルダー。
- WindowsSdkDir: Windows 10 SDK の場所。
- GamingGRDKBuild: ゲーム ランタイム開発キット (GRDK) のファイルの場所。
- VSInstallDir: Visual Studio インストールの場所。
これらの環境変数が展開先のファイルの例をポイントするように設定するコマンドの例を以下に示します。
SET GRDKEDITION=220300
SET "GameDK=C:\ExtractedGDK\%GRDKEDITION%\Microsoft GDK\"
SET "GameDKLatest=%GameDK%%GRDKEDITION%\"
SET "WindowsSdkDir=C:\ExtractedWin10SDK\Windows Kits\10\"
SET "GamingGRDKBuild=%GameDKLatest%GRDK\"
SET "VSInstallDir=C:\Program Files\Microsoft Visual Studio\2022\Enterprise\"
コマンド プロンプトのセットアップ
コマンド プロンプトは、Microsoft Game Development Kit (GDK) のインストール時に、適切な Microsoft Game Development Kit (GDK) コマンド プロンプトの .cmd ファイルへのショートカットとして作成されます。 この例は次のとおりです。
C:\Windows\System32\cmd.exe /k "C:\ExtractedGDK\220300\Microsoft GDK\Command Prompts\GamingXboxVars.cmd" GamingXboxVS2022
前述の内容でショートカットを作成すると、インストール済みのコマンド プロンプト スクリプトと同じ環境設定が提供されます。 これを構成するための推奨される方法は、上記の環境変数を設定するスクリプトをラップし、適切な入力変数を使用してこれを実行することです。
Microsoft Game Development Kit (GDK) からの Lib と Include の参照
環境変数スクリプトは、Lib と Include のパスとして次の場所を設定します。 Gaming.Xbox.Scarlett.x64 の以下の例は、参照用に提供されているため、オーバーライドしないでください (この例の MSVC ツールのバージョンは、VCToolsVersoin 環境変数から派生しています)。
INCLUDE=C:\Program Files (x86)\Windows Kits\10\Include\um;C:\Program Files (x86)\Windows Kits\10\Include\shared;C:\Program Files (x86)\Windows Kits\10\Include\winrt;C:\Program Files (x86)\Windows Kits\10\Include\cppwinrt;C:\Program Files (x86)\Windows Kits\10\Include\ucrt;C:\ExtractedGDK\220300\Microsoft GDK\220300\GXDK\gamekit\include\Scarlett;C:\ExtractedGDK\220300\Microsoft GDK\220300\GXDK\gamekit\include;C:\ExtractedGDK\220300\Microsoft GDK\220300\GRDK\gamekit\include;C:\Program Files\Microsoft Visual Studio\2022\Enterprise\VC\Tools\MSVC\14.30.30705\INCLUDE;
LIB=C:\Program Files (x86)\Windows Kits\10\Lib\um\x64;C:\Program Files (x86)\Windows Kits\10\Lib\ucrt\x64;C:\ExtractedGDK\220300\Microsoft GDK\220300\GXDK\gamekit\lib\amd64\Scarlett;C:\ExtractedGDK\220300\Microsoft GDK\220300\GXDK\gamekit\lib\amd64;C:\ExtractedGDK\220300\Microsoft GDK\220300\GRDK\gamekit\lib\amd64;C:\Program Files\Microsoft Visual Studio\2022\Enterprise\VC\Tools\MSVC\14.30.30705\lib\x64;
LIBPATH=C:\Windows\Microsoft.NET\Framework\v4.0.30319;C:\Program Files\Microsoft Visual Studio\2022\Enterprise\VC\
Windows 10 SDK からの Lib と Include の参照
環境変数スクリプトは、Windows 10 SDK の Lib と Include のパスとして次の場所を設定します。 以下の例は参照用として提供されています。これらをオーバーライドしないでください。
WindowsIncludeRoot=C:\Program Files (x86)\Windows Kits\10\Include\
WindowsLibRoot=C:\Program Files (x86)\Windows Kits\10\Lib\