mirrors/SDL
1
0
Fork 0
mirror of https://github.com/libsdl-org/SDL.git synced 2026-08-24 23:51:38 +00:00
Code Issues Packages Projects Releases Wiki Activity

gdk: Update to GDK April 2026 Update 3 (#16134)

Browse Source
This commit is contained in:
Caleb Cornett
2026-08-18 10:51:48 -04:00
committed by GitHub
parent c80d68fde5
commit f2c4ef111d
15 changed files with 91 additions and 91 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
docs/README-gdk.md
View File

@@ -9,8 +9,8 @@ Windows (GDK) and Xbox One/Xbox Series (GDKX) are both supported and all the re
Requirements
------------
* Microsoft Visual Studio 2022 (in theory, it should also work in 2017 or 2019, but this has not been tested)
* Microsoft GDK October 2023 Update 1 or newer (public release [here](https://github.com/microsoft/GDK/releases/tag/October_2023_Update_1))
* Microsoft Visual Studio 2022 (in theory, it should also work in 2019 or 2026, but this has not been tested)
* Microsoft GDK April 2026 Update 3 or newer (public release [here](https://github.com/microsoft/GDK/releases/tag/April-2026-Update-3-v2604.3.7874))
* For Xbox, you will need the corresponding GDKX version (licensed developers only)
* To publish a package or successfully authenticate a user, you will need to create an app id/configure services in Partner Center. However, for local testing purposes (without authenticating on Xbox Live), the test identifiers used by the GDK test programs in the included solution work.
@@ -76,7 +76,7 @@ While the Gaming.Desktop.x64 configuration sets most of the required settings, t
* Under Linker > Input > Additional Dependencies, you need the following:
* `SDL3.lib`
* `xgameruntime.lib`
* `../Microsoft.Xbox.Services.GDK.C.Thunks.lib`
* `Microsoft.Xbox.Services.C.Thunks.lib`
* Note that in general, the GDK libraries depend on the MSVC C/C++ runtime, so there is no way to remove this dependency from a GDK program that links against GDK.
### 4. Setting up SDL_main ###
@@ -88,10 +88,9 @@ Rather than using your own implementation of `WinMain`, it's recommended that yo
The game will not launch in the debugger unless required DLLs are included in the directory that contains the game's .exe file. You need to make sure that the following files are copied into the directory:
* Your SDL3.dll
* "$(Console_GRDKExtLibRoot)Xbox.Services.API.C\DesignTime\CommonConfiguration\Neutral\Lib\Release\Microsoft.Xbox.Services.GDK.C.Thunks.dll"
* Microsoft.Xbox.Services.C.Thunks.dll
* XCurl.dll
You can either copy these in a post-build step, or you can add the dlls into the project and set its Configuration Properties > General > Item type to "Copy file," which will also copy them into the output directory.
* libHttpClient.dll
### 6. Setting up MicrosoftGame.config ###
@@ -199,3 +198,14 @@ Furthermore, confirm that your PC is set to the correct sandbox.
#### "The current user has already installed an unpackaged version of this app. A packaged version cannot replace this." error when installing
Prior to June 2022 GDK, running from the Visual Studio debugger would still locally register the app (and it would appear on the start menu). To fix this, you have to uninstall it (it's simplest to right click on it from the start menu to uninstall it).
### Missing headers / linker errors after updating to April 2026 GDK or newer
Existing projects using the "old layout" of GDK may need to add the following to their vcxproj in order for GDK system headers and libraries to be found:
```
<PropertyGroup>
<LibraryPath>$(Console_SdkLibPath);$(LibraryPath)</LibraryPath>
<IncludePath>$(Console_SdkIncludeRoot);$(IncludePath)</IncludePath>
</PropertyGroup>
```
See SDL.vcxproj for an example of this.