次の方法で共有

Microsoft Game Development Kit セットアップ ペイロードを抽出する

  • [アーティクル]

このドキュメントでは、インストールせずに利用できるMicrosoft Game Development Kit (GDK) を抽出して入手する手順を説明します。 このセクションでは、Microsoft Game Development Kit および Windows 10 SDK でこれを行う方法について説明します。 このプロセスは上級ユーザーを対象としています。

注意

ほとんどのシナリオでは、Microsoft ゲーム開発キット (GDK) をインストールする必要がなくなることはありません。 このプロセスにより、次のシナリオが可能になります。

  1. ビルド プロセスで使用するためにヘッダーとライブラリを抽出します。
  2. Microsoft Game Development Kit (GDK) の完全インストールを行わずに特定の Microsoft Game Development Kit (GDK) から xbprovision (NDA トピック) を実行できるように、Sideload フォルダーを抽出します。

この方法でセットアップ ペイロードを抽出した後で一部の Microsoft Game Development Kit (GDK) を実行できますが、この操作は公式にサポートされていないため、問題が発生する可能性があります。

抽出された Microsoft Game Development Kit をダウンロードする

上級ユーザー向けのオプションである、抽出された Microft Game Development Kit (GDK) では、完全な Microsoft Game Development Kit (GDK) をインストールせずに特定のファイルをビルド システムに統合できます。 抽出された Microsoft Game Development Kit (GDK) は、Xbox デベロッパーのダウンロード サイトで別のダウンロード オプションとして利用できます。 GDK インストーラー ダウンロードオプションと区別できるよう、タイトルに Extracted と付いたダウンロード オプションがリストに表示されます。

ヒント

このダウンロード オプションを使用すると、Microsoft Game Development Kit の手動抽出プロセスをスキップできます。 これは、推奨されているオプションです。

Microsoft Game Development Kit を手動で抽出する

抽出された Microsoft Game Development Kit (GDK) をダウンロードする代わりに、通常の Microsoft Game Development Kit (GDK) インストーラーから手動でファイルを抽出することができます。 通常版の Microsoft Game Development Kit (GDK) をダウンロードしたら、Windows インストーラー (msiexec.exe) を使用して各インストーラー パッケージを抽出し、個々のファイルにアクセスできます。

ヒント

次の手順では、Windows インストーラー (msiexec.exe) の具体的な使用方法を示します。 msiexec.exe の詳細については、「Windows インストーラー」を参照してください。

すべての Microsoft Game Development Kit (GDK) MSI の内容の抽出 (ExtractXboxOneDKs.cmd を使用)

  1. Xbox デベロッパーのダウンロード サイトで Microsoft Game Development Kit インストーラーをダウンロードします。 または、公開されている Microsoft Game Development Kit (GDK) インストーラーを GitHub レポジトリからダウンロードします (PC 開発のみサポート)。 ダウンロードしたファイルには、GDK_03_2022.zip などの名前が付けられます。 コンピューターでのファイルの場所を記録しておきます。
  2. ローカルの .zip ファイルの内容を抽出します。
  3. コマンド プロンプトを開き、内容の抽出先のフォルダー (C:\GDKDownload\SetupScripts など) 内の SetupScripts ディレクトリに移動します。
    • このディレクトリの ExtractXboxOneDKs.cmd スクリプトを使用して、GDK を抽出できます。 使用法は次のとおりです。
      • ExtractXboxOneDKs.cmd MSI_Source_Folder Target_Directory
      • 例えば、MSI_Source_Folder は .zip ファイルが展開された場所 (つまり C:\GDKDownload) です。 ターゲット ディレクトリは、抽出されたコンテンツの移動先 (つまり、C:\ExtractedGDK\220300) です。
  4. ExtractXboxOneDKs.cmd スクリプトを実行した後、抽出されたファイルはターゲット ディレクトリ (つまり、C:\ExtractedGDK\220300) に存在します。
  5. ターゲット ディレクトリに移動し、抽出された GDK ファイルをビルド システムで必要な場所にコピーします。

注意

ターゲット ディレクトリには、抽出の一部として、.msi ファイルのセットと Windows Kits フォルダーが含まれています。 これらは無視する必要があり、削除できます。 Microsoft GDK フォルダーは、抽出ターゲット ディレクトリ内で保持する必要がある唯一のフォルダーです。

すべての Microsoft Game Development Kit (GDK) MSI の内容の抽出 (手動)

  1. GDK を解凍 (上のセクションの手順 1 ～ 2) したら、Windows インストーラー (msiexec.exe) を使用して各インストーラー パッケージを抽出し、個々のファイルにアクセスできます。

  2. コマンド プロンプト ウィンドウで、.zip ファイルから抽出したファイルがあるフォルダーに移動し、次のコマンド ラインを実行します。

    for /F "delims=" %G in ('dir /b /s "installation_folder\*.msi"') DO (
start /wait msiexec.exe /a "%G" TARGETDIR="msi_extraction_path" /qb
)

    installation_folder は GDK のダウンロードでダウンロードされたファイルへのパスであり、msi_extraction_path は Windows インストーラー (.msi) ファイルの抽出先のフォルダーです。 次に例を示します。

    for /F "delims=" %G in ('dir /b /s "C:\GDKDownload\*.msi"') DO (
start /wait msiexec.exe /a "%G" TARGETDIR="C:\ExtractedGDK\220300\" /qb
)

    注意

    このコード例を、コマンド ラインから直接実行するのではなく、スクリプト内で使用する場合は、%G を %%G に置き換える必要があります。

  3. msi_extraction_path に移動し、抽出された GDK ファイルをビルド システムで必要な場所にコピーします。

Windows 10 SDK の抽出

Windows 10 SDK セットアップ ペイロードの手動での抽出は上級ユーザー向けのオプションであり、完全な Windows SDK をインストールせずに特定のファイルをビルド システムに統合できます。 Microsoft Game Development Kit (GDK) を抽出して使用する場合は、Windows 10 SDK がシステムにインストールされている限り、この手順は必要ありません。

すべての Windows 10 SDK MSI の内容の抽出 (ExtractXboxOneDKs.cmd を使用)

注意

2020 年 5 月の GDK の時点で、GDK には Windows 10 SDK (バージョン 10.0.19041.0) の 20H1 バージョンが必要です。

注意

2023 年 10 月の GDK の時点で、GDK には Windows 11 SDK (バージョン 10.0.22000.0) 以降が必要になりました。

  1. Windows デベロッパー センターから Windows SDK インストーラーをダウンロードします。 ダウンロードしたファイルには、winsdksetup.exe などの名前が付けられます。 コンピューターでのファイルの場所を記録しておきます。

  2. コマンド プロンプトを開き、exe がダウンロードされたディレクトリで winsdksetup.exe /layout C:\WinSDKDownload を実行します (これにより、exe から msi ファイルが抽出されます)。

  3. UI を順に実行し、すべてのチェック ボックスをオンのままにして、すべてのファイルをダウンロードします。

  4. C:\WinSDKDownload に移動して、.msi ファイルが存在することを確認します。

    ヒント

    または、Windows SDK をダウンロードすることもできます。ISO を取り付けます。 このファイルには、手順 1 から 4 で作成したものと同じ .msi ファイルが含まれます。

  5. 上記のすべての Microsoft Game Development Kit (GDK) MSI の抽出内容 (ExtractXboxOneDKs.cmd を使用) に記載されているスクリプトを使用して、MSI_Source_Folderの msi フォルダー (つまり、C:\WinSDKDownload) と、抽出されたコンテンツが移動するターゲット ディレクトリの別のフォルダー (C:\ExtractedWinSDK) をポイントします。

    注意

    含まれるファイルのパスが長いため、ソース ディレクトリとターゲット ディレクトリ (抽出のみ) を 45 文字以下 (ドライブ文字を含む) に制限することを推奨します。 それらは抽出が完了した後に移動できます。 フォルダー パスが 45 文字を超えると、ファイル パスの長さが最大値を超えるため、抽出エラーが発生します。

  6. ExtractXboxOneDKs.cmd スクリプトを実行すると、抽出されたファイルがターゲット ディレクトリ (C:\ExtractedWinSDK) に存在します。

  7. ターゲット ディレクトリに移動し、抽出された Windows SDK ファイルをビルド システムで必要な場所にコピーします。

    注意

    この抽出後には、多数のファイル/フォルダーがターゲット ディレクトリに存在します。 Windows Kits\10 フォルダーは、この例でビルド システムの参照に使用されるフォルダーです。 必要な操作によっては、他のフォルダーが必要になることがあります。

すべての Windows 10 SDK MSI の内容の抽出 (手動)

  1. winsdksetup.exe から .msi ファイルのセットを取得 (上のセクションの手順 1 ～ 4) したら、Windows インストーラー (msiexec.exe) を使用して各インストーラー パッケージを抽出し、個々のファイルにアクセスできます。

  2. コマンド プロンプト ウィンドウで、.zip ファイルから抽出したファイルがあるフォルダーに移動し、次のコマンド ラインを実行します。

    for /F "delims=" %G in ('dir /b /s "installation_folder\*.msi"') DO (
start /wait msiexec.exe /a "%G" TARGETDIR="msi_extraction_path" /qb
)

    installation_folder は WIn10 SDK のダウンロードでダウンロードされたファイルへのパスであり、msi_extraction_path は Windows インストーラー (.msi) ファイルの抽出先のフォルダーです。 次に例を示します。

    for /F "delims=" %G in ('dir /b /s "C:\WinSDKDownload\*.msi"') DO (
start /wait msiexec.exe /a "%G" TARGETDIR="C:\ExtractedWinSDK" /qb
)

    注意

    このコード例を、コマンド ラインから直接実行するのではなく、スクリプト内で使用する場合は、%G を %%G に置き換える必要があります。

  3. msi_extraction_path に移動し、抽出された Windows SDK ファイルをビルド システムで必要な場所にコピーします。

Microsoft Game Development Kit の抽出時は、タイトルをビルドするときにアクセスする共有の場所またはソース管理システムにこのフォルダーが配置されることを前提としています。 複数のバージョンの Microsoft Game Development Kit (GDK) が必要な場合があります。 このシナリオでは、複数の抽出された Microsoft Game Development Kit (GDK) バージョンのレイアウトに関する推奨事項は次のとおりです。

  • ...\ExtractedGDK\211000\Microsoft GDK...
  • ...\ExtractedGDK\220300\Microsoft GDK...

これにより、各バージョンに完全なペイロードが存在するようになります。 ビルド環境変数を使用してバージョンを切り替え、ビルドのコンパイル プロセスで使用されるバージョンを定義することをお勧めします。

関連項目

Microsoft Game Development Kit (GDK) をインストールしないでビルド環境を構成する

インストールせずに Microsoft Game Development Kit (GDK) を使用する