GDKX のヘッダーとライブラリのディレクトリ構造

この記事で説明するディレクトリ構造は、October 2025 GDK で導入された簡略化された (クロスプラットフォーム) レイアウトです。October 2026 GDK 以降、簡略化されたレイアウトが既定でインストールされます。従来のレイアウトは、移行にさらに時間が必要なチーム向けに、オプションの非推奨の互換性パスとして引き続き利用できます。従来のレイアウトは、April 2027 GDK リリース以降はサポートされなくなり、インストーラーから削除されます。

Microsoft Game Development Kit (GDK) の現在のバージョンでは、レイアウトはコード共有を中心に最適化され、特定のプラットフォームに重点を置いていました。このレイアウトのビルド統合は、MSBuild カスタムプラットフォームで複雑さを隠すことに大きく依存していました。新しいレイアウトでは、統合の簡素化、増え続けるターゲットプラットフォームのサポート、標準の MSBuild プラットフォームと Microsoft 以外のビルドシステムの両方のサポートの向上に重点を置いています。

以前のヘッダーとライブラリのレイアウト

Microsoft GDK の既存のファイルレイアウトの概要は次のとおりです。

251000\
    GRDK\
        ExtensionLibraries\
            Xbox.Services.API.C\
                ExtensionLibrary.props
                DesignTime\CommonConfiguration\Neutral\
                    Include\
                    Lib\
                    Redist\
            ...
        GameKit\
            Include\
            Lib\
                amd64\

    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 の April 2025 バージョンを参照してください。 October 2025 および April 2026 の GDK リリースには、簡略化されたレイアウトと従来のレイアウトの両方が含まれています。October 2026 GDK 以降、セットアップでは既定で簡略化されたレイアウトのみがインストールされます。従来のレイアウトは引き続きオプションのインストールとして選択できますが、非推奨であり、推奨される開発パスではなくなりました。従来のレイアウトは、April 2027 GDK リリース以降はサポートされなくなり、インストーラーから削除されます。

新しいヘッダーとライブラリのレイアウト

October 2025 GDK リリースでは、ヘッダーとライブラリの代替レイアウトが提供されるようになりました。これにより、プラットフォームの統合がはるかに容易になり、今後追加のプラットフォームにも対応できるようになります。

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 プロパティを設定することで新しいレイアウトにオプトインできます。

<PropertyGroup Label="Globals">
...
  <GDKCrossPlatform>true</GDKCrossPlatform>
</PropertyGroup>

これにより、以前のレイアウトで使用されていたさまざまな複雑なパスではなく、適切な include/lib パスがプロジェクトに追加されます。この新しい簡略化された統合では、拡張ライブラリのメカニズムは使用されなくなりました。すべてのコンテンツは、既定でビルド時に include/lib パスで利用できます。その後、プロジェクトは使用する追加のライブラリにリンクする必要があります。以前の GDK プロジェクトテンプレートに基づいてビルドされたプロジェクトには、次のようなステートメントが含まれているはずです。

<AdditionalDependencies>uuid.lib;$(Console_Libs);%(XboxExtensionsDependencies);%(AdditionalDependencies)</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 を示していますが、個々のプロジェクトで必要なのはその一部だけです。

  <PropertyGroup>
    <GDKCrossPlatformPath Condition="'$(GDKCrossPlatformPath)'==''">$(GameDKCoreLatest)</GDKCrossPlatformPath>
    <GDKCrossPlatformPath Condition="'$(GDKCrossPlatformPath)'==''">$(GameDKXboxLatest)</GDKCrossPlatformPath>
  </PropertyGroup>

  <ItemGroup Condition="'$(Platform)'=='Gaming.Desktop.x64'">
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)windows\bin\x64\libHttpClient.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)windows\bin\x64\XCurl.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)windows\bin\x64\GameChat2.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)windows\bin\x64\Party.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)windows\bin\x64\PartyXboxLive.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)windows\bin\x64\PlayFabCore.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)windows\bin\x64\PlayFabGameSave.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)windows\bin\x64\PlayFabMultiplayer.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)windows\bin\x64\PlayFabServices.dll" />
  </ItemGroup>

  <ItemGroup Condition="'$(Platform)'=='Gaming.Xbox.Scarlett.x64'">
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\libHttpClient.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\XCurl.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\GameChat2.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\Party.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\PartyXboxLive.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\PlayFabCore.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\PlayFabGameSave.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\PlayFabMultiplayer.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\PlayFabServices.dll" />
  </ItemGroup>

  <ItemGroup Condition="'$(Platform)'=='Gaming.Xbox.XboxOne.x64'">
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\libHttpClient.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\XCurl.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\GameChat2.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\Party.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\PartyXboxLive.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\PlayFabCore.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\PlayFabGameSave.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\PlayFabMultiplayer.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\PlayFabServices.dll" />
  </ItemGroup>

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 という名前のファイルに配置します。これにより、新しいレイアウトにオプトインし、プロジェクトで使用されていない場合でも、ほとんどまたはすべての拡張ライブラリが含まれます。

GDKCrossPlatform を true に設定してビルドする場合、GDKExtLibNames プロパティは MSBuild ルールで使用されません。以前の MSBuild ルールでのビルド用に既に存在しているため、この props ファイルでは、レイアウト内の一部の追加 DLL にオプトインする方法として使用しています。

<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

  <PropertyGroup>
    <GDKCrossPlatform>true</GDKCrossPlatform>
    <GDKCrossPlatformPath Condition="'$(GDKCrossPlatformPath)'==''">$(GameDKCoreLatest)</GDKCrossPlatformPath>
    <GDKCrossPlatformPath Condition="'$(GDKCrossPlatformPath)'==''">$(GameDKXboxLatest)</GDKCrossPlatformPath>
    <AllExtensionLibs>Appnotify.lib;winhttp.lib;crypt32.lib;libHttpClient.lib;XCurl.lib;GameChat2.lib;PlayFabCore.lib;PlayFabServices.lib;PlayFabMultiplayer.lib;Party.lib;PartyXboxLive.lib;PlayFabGameSave.lib</AllExtensionLibs>
    <AllExtensionLibs Condition="'$(Configuration)'=='Debug'">Microsoft.Xbox.Services.142.C.Debug.lib;$(AllExtensionLibs)</AllExtensionLibs>
    <AllExtensionLibs Condition="'$(Configuration)'!='Debug'">Microsoft.Xbox.Services.142.C.lib;$(AllExtensionLibs)</AllExtensionLibs>
  </PropertyGroup>

  <ItemDefinitionGroup Condition="'$(Platform)'=='Gaming.Desktop.x64'">
    <Link>
      <AdditionalDependencies>$(AllExtensionLibs);%(AdditionalDependencies)</AdditionalDependencies>
    </Link>
  </ItemDefinitionGroup>

  <!--
    We use XboxExtensionsDependencies because of a hack in our Gaming.Xbox.*.x64 platforms which forces
    AdditionalDependencies to xgameplatform.lib, but means we can't use AdditionalDependencies this early.
  -->

  <ItemDefinitionGroup Condition="'$(Platform)'=='Gaming.Xbox.Scarlett.x64' OR '$(Platform)'=='Gaming.Xbox.XboxOne.x64'">
    <Link>
      <XboxExtensionsDependencies>$(AllExtensionLibs);%(XboxExtensionsDependencies)</XboxExtensionsDependencies>
    </Link>
  </ItemDefinitionGroup>

  <!--
    Makes sure we deploy all the libs we need. We use the 'old layout' GDKExtLibNames property as a way to test
    what is requested to try to reduce the over-inclusion of unused DLLs.
  -->

  <ItemGroup Condition="'$(Platform)'=='Gaming.Desktop.x64'">
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)windows\bin\x64\libHttpClient.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)windows\bin\x64\XCurl.dll" />
  </ItemGroup>

  <ItemGroup Condition="'$(Platform)'=='Gaming.Desktop.x64' AND $(GDKExtLibNames.Contains('Xbox.Game.Chat.2.Cpp.API'))">
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)windows\bin\x64\GameChat2.dll" />
  </ItemGroup>

  <ItemGroup Condition="'$(Platform)'=='Gaming.Desktop.x64' AND $(GDKExtLibNames.Contains('PlayFab'))">
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)windows\bin\x64\Party.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)windows\bin\x64\PartyXboxLive.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)windows\bin\x64\PlayFabCore.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)windows\bin\x64\PlayFabGameSave.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)windows\bin\x64\PlayFabMultiplayer.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)windows\bin\x64\PlayFabServices.dll" />
  </ItemGroup>

  <ItemGroup Condition="'$(Platform)'=='Gaming.Xbox.Scarlett.x64' OR '$(Platform)'=='Gaming.Xbox.XboxOne.x64'">
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\libHttpClient.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\XCurl.dll" />
  </ItemGroup>

  <ItemGroup Condition="('$(Platform)'=='Gaming.Xbox.Scarlett.x64' OR '$(Platform)'=='Gaming.Xbox.XboxOne.x64') AND $(GDKExtLibNames.Contains('Xbox.Game.Chat.2.Cpp.API'))">
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\GameChat2.dll" />
  </ItemGroup>

  <ItemGroup Condition="('$(Platform)'=='Gaming.Xbox.Scarlett.x64' OR '$(Platform)'=='Gaming.Xbox.XboxOne.x64') AND $(GDKExtLibNames.Contains('PlayFab'))">
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\Party.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\PartyXboxLive.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\PlayFabCore.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\PlayFabGameSave.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\PlayFabMultiplayer.dll" />
    <ReferenceCopyLocalPaths Include="$(GDKCrossPlatformPath)xbox\bin\x64\PlayFabServices.dll" />
  </ItemGroup>

</Project>

MSBuild x64 プラットフォームでの新しいレイアウトの使用

Gaming.Desktop.x64 プラットフォームを使用する代わりに、標準の x64 プラットフォームを使用して PC 向けにビルドできます。以前のレイアウトでは、Microsoft Game Development Kit (GDK) での x64 プラットフォームの使用で説明されているように、拡張ライブラリ用の <Import Project="...\ExtensionLibrary.props"> ステートメントを追加する必要がありました。新しいレイアウトでは、統合の手順が簡素化されています。

  <PropertyGroup>
    <GDKCrossPlatformPath Condition="'$(GDKCrossPlatformPath)'==''">$(GameDKCoreLatest)</GDKCrossPlatformPath>
    <GDKCrossPlatformPath Condition="'$(GDKCrossPlatformPath)'==''">$(GameDKXboxLatest)</GDKCrossPlatformPath>
  </PropertyGroup>

<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">
  <ExecutablePath>$(GameDK)bin;$(GDKCrossPlatformPath)windows\bin\x64;$(ExecutablePath)</ExecutablePath>
  <IncludePath>$(GDKCrossPlatformPath)windows\Include;$(IncludePath);</IncludePath>
  <LibraryPath>$(GDKCrossPlatformPath)windows\lib\x64;$(LibraryPath)</LibraryPath>
</PropertyGroup>

<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|x64'">
  <ExecutablePath>$(GameDK)bin;$(GDKCrossPlatformPath)windows\bin\x64;$(ExecutablePath)</ExecutablePath>
  <IncludePath>$(GDKCrossPlatformPath)windows\Include;$(IncludePath);</IncludePath>
  <LibraryPath>$(GDKCrossPlatformPath)windows\lib\x64;$(LibraryPath)</LibraryPath>
</PropertyGroup>

必要なすべての拡張ライブラリを、元のリストと共に AdditionalDependencies に追加します。

<AdditionalDependencies>xgameruntime.lib;gameinput.lib;d3d12.lib;dxgi.lib;dxguid.lib;uuid.lib;kernel32.lib;user32.lib;%(AdditionalDependencies)</AdditionalDependencies>

オプトインした拡張ライブラリの DLL は、前述のように、カスタムビルドアクションを使用するか、最終的なレイアウト用の ReferenceCopyLocalPaths 項目グループを使用して、バイナリディレクトリにコピーする必要があります。 PreprocessorDefinitions と、画像アセットを含む .mgc ファイルの処理に関する残りの手順は変更されていません。

CMake での新しいレイアウトの使用

CMake で Microsoft Visual Studio ジェネレーターを使用し、Gaming.*.x64 カスタム MSBuild プラットフォームを使用する場合、新しいレイアウトは次のように有効にします。

set_property(TARGET ${PROJECT_NAME} PROPERTY VS_GLOBAL_GDKCrossPlatform "true")

CMakeGDKExample で、VS_GLOBAL_GDKExtLibNames の使用を削除し、次のコードに置き換えて (CMake 3.21 以降を想定)、使用する拡張 DLL をレイアウトにコピーします。

add_custom_command(TARGET ${PROJECT_NAME} POST_BUILD
    COMMAND ${CMAKE_COMMAND} -E $<IF:$<BOOL:$<TARGET_RUNTIME_DLLS:${PROJECT_NAME}>>,copy,true>
    $<TARGET_RUNTIME_DLLS:${PROJECT_NAME}> $<TARGET_FILE_DIR:${PROJECT_NAME}>
    COMMAND_EXPAND_LISTS
    )

カスタムビルドシステムでの新しいレイアウトの使用

GDK を使用して Windows x64 向けにビルドするには、次が必要です。

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) 向けにビルドするには、次が必要です。

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) 向けにビルドするには、次が必要です。

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 ツールをビルドするには、次が必要です。

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 ツールをビルドするには、次が必要です。

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 ツールをビルドするには、次が必要です。

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 の例を次に示します。

$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)

以前のレイアウトで <edition>\flatDeployment の下にあった MSBuild カスタムビルドプラットフォームファイルは、パスが短縮されて <edition>\xbox\build の下に配置されるようになりました。たとえば、VS 2022 用の BWOI MSBuild ルールフォルダーをセットアップするには、次のコマンドを使用します。

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 で、この結合されたフォルダーを指すようにプロパティを設定します。

<PropertyGroup Condition="'$([System.Text.RegularExpressions.Regex]::IsMatch('$(Platform)', 'Gaming\..+\.x64'))">
   <VCTargetsPath17>c:\temp\msbuildgdk\v170\</VCTargetsPath17>
   <VCTargetsPath16>c:\temp\msbuildgdk\v160\</VCTargetsPath16>
</PropertyGroup>

GDK and Game Engines Integration

Steam porting guide

Core Features

Console Features

Game Principles

GDKX のヘッダーとライブラリのディレクトリ構造

以前のヘッダーとライブラリのレイアウト

新しいヘッダーとライブラリのレイアウト

MSBuild カスタムプラットフォームでの新しいレイアウトの使用

Directory.Build.props の使用

MSBuild x64 プラットフォームでの新しいレイアウトの使用

CMake での新しいレイアウトの使用

カスタムビルドシステムでの新しいレイアウトの使用

PC コンテンツツールでの新しいレイアウトの使用

インストールされたファイルからのビルドエディションの読み取り

インストールなしのビルド (BWOI)

​以前のヘッダーとライブラリのレイアウト

​新しいヘッダーとライブラリのレイアウト

​MSBuild カスタム プラットフォームでの新しいレイアウトの使用

​Directory.Build.props の使用

​MSBuild x64 プラットフォームでの新しいレイアウトの使用

​CMake での新しいレイアウトの使用

​カスタム ビルド システムでの新しいレイアウトの使用

​PC コンテンツ ツールでの新しいレイアウトの使用

​インストールされたファイルからのビルド エディションの読み取り

​インストールなしのビルド (BWOI)

以前のヘッダーとライブラリのレイアウト

新しいヘッダーとライブラリのレイアウト

MSBuild カスタムプラットフォームでの新しいレイアウトの使用

Directory.Build.props の使用

MSBuild x64 プラットフォームでの新しいレイアウトの使用

CMake での新しいレイアウトの使用

カスタムビルドシステムでの新しいレイアウトの使用

PC コンテンツツールでの新しいレイアウトの使用

インストールされたファイルからのビルドエディションの読み取り

インストールなしのビルド (BWOI)