> ## Documentation Index > Fetch the complete documentation index at: https://docs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # GDKX のヘッダーとライブラリのディレクトリ構造 > GDKX のヘッダーとライブラリの新しいディレクトリ レイアウトについて説明します。 > [!NOTE] > > この記事で説明するディレクトリ構造は、October 2025 GDK で導入された**簡略化された (クロスプラットフォーム) レイアウト**です。 > > October 2026 GDK 以降、簡略化されたレイアウトが既定でインストールされます。従来のレイアウトは、移行にさらに時間が必要なチーム向けに、オプションの非推奨の互換性パスとして引き続き利用できます。 > > 従来のレイアウトは、April 2027 GDK リリース以降はサポートされなくなり、インストーラーから削除されます。 Microsoft Game Development Kit (GDK) の現在のバージョンでは、レイアウトはコード共有を中心に最適化され、特定のプラットフォームに重点を置いていました。このレイアウトのビルド統合は、MSBuild カスタム プラットフォームで複雑さを隠すことに大きく依存していました。新しいレイアウトでは、統合の簡素化、増え続けるターゲット プラットフォームのサポート、標準の MSBuild プラットフォームと Microsoft 以外のビルド システムの両方のサポートの向上に重点を置いています。 ## 以前のヘッダーとライブラリのレイアウト Microsoft GDK の既存のファイル レイアウトの概要は次のとおりです。 ```text theme={null} 251000\ GRDK\ ExtensionLibraries\ Xbox.Services.API.C\ ExtensionLibrary.props DesignTime\CommonConfiguration\Neutral\ Include\ Lib\ Redist\ ... GameKit\ Include\ Lib\ amd64\ ``` ```text theme={null} GXDK\ gameKit\ Include\ XboxOne\ Scarlett\ Lib\ amd64\ XboxOne\ Scarlett\ ToolKit\ Include\ XboxOne\ Scarlett\ Lib\ amd64\ XboxOne\ Scarlett\ ``` **Gaming.Desktop.x64**、**Gaming.Xbox.Scarlett.x64**、および **Gaming.Xbox.XboxOne.x64** カスタム MSBuild プラットフォームは、これらすべてのコンテンツをさまざまな方法で組み合わせる include/lib パスを構築するためのすべてのロジックを実装しています。CMake またはカスタムの make ソリューションを使用していた場合は、このロジックをそこにも実装する必要がありました。詳細な例については、[CMakeExample](https://github.com/microsoft/Xbox-GDK-Samples/tree/apr2025/Samples/Tools/CMakeExample) の April 2025 バージョンを参照してください。 October 2025 および April 2026 の GDK リリースには、簡略化されたレイアウトと従来のレイアウトの両方が含まれています。October 2026 GDK 以降、セットアップでは既定で簡略化されたレイアウトのみがインストールされます。従来のレイアウトは引き続きオプションのインストールとして選択できますが、非推奨であり、推奨される開発パスではなくなりました。 従来のレイアウトは、April 2027 GDK リリース以降はサポートされなくなり、インストーラーから削除されます。 ## 新しいヘッダーとライブラリのレイアウト October 2025 GDK リリースでは、ヘッダーとライブラリの代替レイアウトが提供されるようになりました。これにより、プラットフォームの統合がはるかに容易になり、今後追加のプラットフォームにも対応できるようになります。 ```text theme={null} 251000\ windows\ bin\ arm64 x64\ include\ lib\ arm64 x64\ redist xbox\ bin\ gen8\ gen9\ devpctools\ gen8\ gen9\ x64\ x64\ build\ include\ lib\ redist\ source\ ``` ## MSBuild カスタム プラットフォームでの新しいレイアウトの使用 既存の **Gaming.\*.x64** MSBuild プラットフォームは既定で以前のレイアウトを使用しますが、**GDKCrossPlatform** プロパティを設定することで新しいレイアウトにオプトインできます。 ```xml theme={null} ... true ``` これにより、以前のレイアウトで使用されていたさまざまな複雑なパスではなく、適切な include/lib パスがプロジェクトに追加されます。 この新しい簡略化された統合では、拡張ライブラリのメカニズムは使用されなくなりました。すべてのコンテンツは、既定でビルド時に include/lib パスで利用できます。 その後、プロジェクトは使用する追加のライブラリにリンクする必要があります。以前の GDK プロジェクト テンプレートに基づいてビルドされたプロジェクトには、次のようなステートメントが含まれているはずです。 ```xml theme={null} uuid.lib;$(Console_Libs);%(XboxExtensionsDependencies);%(AdditionalDependencies) ``` 新しいレイアウトでは、**Console\_Libs** プロパティに必要なコア ライブラリが一覧表示されます。 | プラットフォーム | コア ライブラリ | | - | - | | Gaming.\*.x64 | xgameruntime.lib d3d12.lib dxguid.lib dxgi.lib gameinput.lib | | Gaming.Xbox.Scarlett.x64 | xgameruntime.lib xgameplatform.lib d3d12\_xs.lib xg\_xs.lib pixevt.lib xmem.lib | | Gaming.Xbox.XboxOne.x64 | xgameruntime.lib xgameplatform.lib d3d12\_x.lib xg\_x.lib pixevt.lib xmem.lib | 拡張ライブラリはそれぞれ "オプトイン" であるため、プロジェクトは使用する拡張ライブラリを **AdditionalDependencies** に追加する必要があります。 | プラットフォーム | コア ライブラリ | | - | - | | Xbox.LibHttpClient | libHttpClient.lib | | Xbox.XCurl.API | XCurl.lib | | Xbox.Game.Chat.2.Cpp.API | GameChat2.lib | | Xbox.Services.API.C (Debug) | Appnotify.lib winhttp.lib crypt32.lib Microsoft.Xbox.Services.142.C.Debug.lib | | Xbox.Services.API.C (Release) | Appnotify.lib winhttp.lib crypt32.lib Microsoft.Xbox.Services.142.C.lib | | PlayFab.Party.Cpp | Party.lib | | PlayFab.PartyXboxLive.Cpp | PartyXboxLive.lib | | PlayFab.Services.C | PlayFabCore.lib PlayFabGameSave.lib PlayFabServices.lib | | PlayFab.Multiplayer.Cpp | PlayFabMultiplayer.lib | また、プロジェクトは使用する追加の DLL をレイアウトにコピーする必要があります。これは、多くの DLL ライブラリ統合で一般的なカスタム ビルド ステップを使用するか、vcxproj を編集するか props ファイルを追加して **ReferenceCopyLocalPaths** 項目グループ リストを使用することで実行できます。次の MSBuild では使用可能なすべての DLL を示していますが、個々のプロジェクトで必要なのはその一部だけです。 ```xml theme={null} $(GameDKCoreLatest) $(GameDKXboxLatest) ``` > [!NOTE] > > `GameDKLatest` は、Microsoft GDK with XBOX Extensions によってのみ設定されます。そのため、両方のバージョンの Microsoft GDK のサイドバイサイド インストールを完全にサポートする新しい環境変数を導入しました。`GameDKCoreLatest` は Microsoft GDK によって設定されます。`GameDKXboxLatest` は Microsoft GDK with XBOX Extensions によって設定されます。 ### Directory.Build.props の使用 新しいレイアウトを使用して既存の GDK Gaming.\*.x64 プロジェクトをすばやく検証する方法として、次の内容をソース ツリー内の Directory.Build.props という名前のファイルに配置します。これにより、新しいレイアウトにオプトインし、プロジェクトで使用されていない場合でも、ほとんどまたはすべての拡張ライブラリが含まれます。 > [!NOTE] > > **GDKCrossPlatform** を true に設定してビルドする場合、**GDKExtLibNames** プロパティは MSBuild ルールで使用されません。以前の MSBuild ルールでのビルド用に既に存在しているため、この props ファイルでは、レイアウト内の一部の追加 DLL にオプトインする方法として使用しています。 ```xml theme={null} true $(GameDKCoreLatest) $(GameDKXboxLatest) Appnotify.lib;winhttp.lib;crypt32.lib;libHttpClient.lib;XCurl.lib;GameChat2.lib;PlayFabCore.lib;PlayFabServices.lib;PlayFabMultiplayer.lib;Party.lib;PartyXboxLive.lib;PlayFabGameSave.lib Microsoft.Xbox.Services.142.C.Debug.lib;$(AllExtensionLibs) Microsoft.Xbox.Services.142.C.lib;$(AllExtensionLibs) $(AllExtensionLibs);%(AdditionalDependencies) $(AllExtensionLibs);%(XboxExtensionsDependencies) ``` ## MSBuild x64 プラットフォームでの新しいレイアウトの使用 **Gaming.Desktop.x64** プラットフォームを使用する代わりに、標準の **x64** プラットフォームを使用して PC 向けにビルドできます。以前のレイアウトでは、[Microsoft Game Development Kit (GDK) での x64 プラットフォームの使用](https://docs.xbox.com/ja-jp/tools/tools-pc/visualstudio/gr-vs-templates.md#using-the-x64-platform-with-the-microsoft-game-development-kit-gdk)で説明されているように、拡張ライブラリ用の `` ステートメントを追加する必要がありました。 新しいレイアウトでは、統合の手順が簡素化されています。 ```xml theme={null} $(GameDKCoreLatest) $(GameDKXboxLatest) ``` ```xml theme={null} $(GameDK)bin;$(GDKCrossPlatformPath)windows\bin\x64;$(ExecutablePath) $(GDKCrossPlatformPath)windows\Include;$(IncludePath); $(GDKCrossPlatformPath)windows\lib\x64;$(LibraryPath) ``` ```xml theme={null} $(GameDK)bin;$(GDKCrossPlatformPath)windows\bin\x64;$(ExecutablePath) $(GDKCrossPlatformPath)windows\Include;$(IncludePath); $(GDKCrossPlatformPath)windows\lib\x64;$(LibraryPath) ``` 必要なすべての拡張ライブラリを、元のリストと共に **AdditionalDependencies** に追加します。 ```xml theme={null} xgameruntime.lib;gameinput.lib;d3d12.lib;dxgi.lib;dxguid.lib;uuid.lib;kernel32.lib;user32.lib;%(AdditionalDependencies) ``` オプトインした拡張ライブラリの DLL は、前述のように、カスタム ビルド アクションを使用するか、最終的なレイアウト用の **ReferenceCopyLocalPaths** 項目グループを使用して、バイナリ ディレクトリにコピーする必要があります。 **PreprocessorDefinitions** と、画像アセットを含む .mgc ファイルの処理に関する残りの手順は変更されていません。 ## CMake での新しいレイアウトの使用 CMake で Microsoft Visual Studio ジェネレーターを使用し、**Gaming.\*.x64** カスタム MSBuild プラットフォームを使用する場合、新しいレイアウトは次のように有効にします。 ```text theme={null} set_property(TARGET ${PROJECT_NAME} PROPERTY VS_GLOBAL_GDKCrossPlatform "true") ``` [CMakeGDKExample](https://github.com/microsoft/Xbox-GDK-Samples/tree/apr2025/Samples/Tools/CMakeGDKExample) で、`VS_GLOBAL_GDKExtLibNames` の使用を削除し、次のコードに置き換えて (CMake 3.21 以降を想定)、使用する拡張 DLL をレイアウトにコピーします。 ```text theme={null} add_custom_command(TARGET ${PROJECT_NAME} POST_BUILD COMMAND ${CMAKE_COMMAND} -E $>,copy,true> $ $ COMMAND_EXPAND_LISTS ) ``` ## カスタム ビルド システムでの新しいレイアウトの使用 GDK を使用して Windows x64 向けにビルドするには、次が必要です。 ```cmd theme={null} set INCLUDE=%GameDKXboxLatest%windows\include;%INCLUDE% set LIB=%GameDKXboxLatest%windows\lib\x64;%LIB% set PATH=%GameDK%bin;%GameDKXboxLatest%windows\bin\x64;%PATH% ``` XBOX Series X|S (別名 *Gaming.Xbox.Scarlett.x64*) 向けにビルドするには、次が必要です。 ```cmd theme={null} set INCLUDE=%GameDKXboxLatest%xbox\include\gen9;%GameDKXboxLatest%xbox\include;%INCLUDE% set LIB=%GameDKXboxLatest%xbox\lib\gen9;%GameDKXboxLatest%xbox\lib\x64;%LIB% set PATH=%GameDK%bin;%GameDKXboxLatest%xbox\bin\gen9;%GameDKXboxLatest%xbox\bin\x64;%PATH% ``` XBOX One (別名 *Gaming.Xbox.XboxOne.x64*) 向けにビルドするには、次が必要です。 ```cmd theme={null} set INCLUDE=%GameDKXboxLatest%xbox\include\gen8;%GameDKXboxLatest%xbox\include;%INCLUDE% set LIB=%GameDKXboxLatest%xbox\lib\gen8;%GameDKXboxLatest%xbox\lib\x64;%LIB% set PATH=%GameDK%bin;%GameDKXboxLatest%xbox\bin\gen8;%GameDKXboxLatest%xbox\bin\x64;%PATH% ``` ## PC コンテンツ ツールでの新しいレイアウトの使用 本体開発では、一部の種類のコンテンツの "クッキング" が、XTF API、XMA2 エンコード ライブラリ、カスタムの Direct3D 12.X ツールの一部またはすべてを使用して開発 PC 上で行われます。このコンテンツにアクセスするには、特定のビルド セットアップが必要です。 XBOX One と XBOX Series X|S の両方を対象とする PC ツールをビルドするには、次が必要です。 ```cmd theme={null} set INCLUDE=%GameDKXboxLatest%xbox\include\devpctools;%GameDK%\toolKit\include;%INCLUDE% set LIB=%GameDKXboxLatest%xbox\lib\devpctools\x64;%GameDK%\toolKit\lib\amd64;%LIB% set PATH=%GameDK%bin;%PATH% ``` XBOX Series X|S のグラフィックスを対象とする PC ツールをビルドするには、次が必要です。 ```cmd theme={null} set INCLUDE=%GameDKXboxLatest%xbox\include\devpctools\gen9;%GameDKXboxLatest%xbox\include\devpctools;%GameDK%\toolKit\include;%INCLUDE% set LIB=%GameDKXboxLatest%xbox\lib\devpctools\gen9;%GameDKXboxLatest%xbox\lib\devpctools\x64;%GameDK%\toolKit\lib\amd64;%LIB% set PATH=%GameDKXboxLatest%xbox\devpctools\bin\gen9;%GameDK%bin;%PATH% ``` XBOX One のグラフィックスを対象とする PC ツールをビルドするには、次が必要です。 ```cmd theme={null} set INCLUDE=%GameDKXboxLatest%xbox\include\devpctools\gen8;%GameDKXboxLatest%xbox\include\devpctools;%GameDK%\toolKit\include;%INCLUDE% set LIB=%GameDKXboxLatest%xbox\lib\devpctools\gen8;%GameDKXboxLatest%xbox\lib\devpctools\x64;%GameDK%\toolKit\lib\amd64;%LIB% set PATH=%GameDKXboxLatest%xbox\devpctools\bin\gen8;%GameDK%bin;%PATH% ``` ## インストールされたファイルからのビルド エディションの読み取り 新しいレイアウトには、`grdk.ini` ファイルまたは `gxdk.ini` ファイルが含まれていません。ファイルを解析してエディション情報を確認するには、`grdk.h` または `gxdk.h` を使用します。 以前の GDK リリースでも動作する PowerShell の例を次に示します。 ```powershell theme={null} $result = Get-ChildItem -Path $env:GameDKXboxLatest -Filter "gxdk.h" -Recurse if ($result.Count -eq 0) { $result = Get-ChildItem -Path $env:GXDKLatest -Filter "gxdk.h" -Recurse } if ($result.Count -eq 0) { Write-Error "##[error]Failed to find gxdk.h in either GameDKXboxLatest or GXDKLatest" -ErrorAction Stop } $content = Get-Content -Path $result[0].FullName if (-not ([string]$content -match '#define\s+_GXDK_EDITION\s+([0-9][0-9][0-9][0-9][0-9][0-9])')) { Write-Error "##[error]Failed to find edition define" -ErrorAction Stop } $xbld_edition = $Matches[1] if (-not ([string]$content -match '#define\s+_GXDKVER_PRODUCTBUILDVER_FULL\s+([0-9]+\.[0-9]+\.([0-9]+)\.[0-9]+)')) { Write-Error "##[error]Failed to find full version define" -ErrorAction Stop } $xbld_full_productbuild = $Matches[1] $xbld_build = $Matches[2] if (-not ([string]$content -match '#define\s+_GXDK_MM_NUM\s+([0-9]{1,2})')) { Write-Error "##[error]Failed to find month define" -ErrorAction Stop } $month = $Matches[1] if (-not ([string]$content -match '#define\s+_GXDK_FULLYY\s+([0-9]{4})')) { Write-Error "##[error]Failed to find full year define" -ErrorAction Stop } $year = $Matches[1] Write-Output ("_xbld_name={0} {1} GXDK" -f (Get-Culture).DateTimeFormat.GetMonthName([int]$month), $year) Write-Output ("_xbld_edition={0}" -f $xbld_edition) Write-Output ("_xbld_full_productbuild={0}" -f $xbld_full_productbuild) Write-Output ("_xbld_build={0}" -f $xbld_build) ``` ## インストールなしのビルド (BWOI) 以前のレイアウトで `\flatDeployment` の下にあった MSBuild カスタム ビルド プラットフォーム ファイルは、パスが短縮されて `\xbox\build` の下に配置されるようになりました。 たとえば、VS 2022 用の BWOI MSBuild ルール フォルダーをセットアップするには、次のコマンドを使用します。 ```cmd theme={null} rd /q /s c:\temp\msbuildgdk md c:\temp\msbuildgdk xcopy "%VSInstallDir%\MSBuild\Microsoft\VC" /s c:\temp\msbuildgdk xcopy "%GameDKXboxLatest%\xbox\build\VS2022\gen8" c:\temp\msbuildgdk /s xcopy "%GameDKXboxLatest%\xbox\build\VS2022\gen9" c:\temp\msbuildgdk /s xcopy "%GameDKXboxLatest%\xbox\build\VS2022\pc" c:\temp\msbuildgdk /s ``` 次に、BWOI に使用する Directory.Build.props で、この結合されたフォルダーを指すようにプロパティを設定します。 ```xml theme={null} c:\temp\msbuildgdk\v170\ c:\temp\msbuildgdk\v160\ ``` ## Related topics - [GDK のヘッダーとライブラリのディレクトリ構造](https://docs.xbox.com/ja-jp/build/gdk-and-engines/guides/gdk-directory-structure.md) - [XSAPI C の概要](https://docs.xbox.com/ja-jp/services/xbox-services/fundamentals/xbox-services-api/live-xsapi-flat-c.md) - [Linux getting started](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/linux-specific-requirements.md) - [XBOX 本体での GameInput](https://docs.xbox.com/ja-jp/build/core-features/common/input/overviews/input-xbox.md) - [XBOX GDK コンソール開発向け NDA トピック インデックス](https://docs.xbox.com/ja-jp/nda/nda-overview.md)