Skip to content

October 2021 GDK Public Release

Compare
Choose a tag to compare
@FLY1NGSQU1RR3L FLY1NGSQU1RR3L released this 19 Nov 19:14
· 71 commits to Main since this release
cb006c2

GDK development samples are now publicly available: https://github.com/microsoft/Xbox-GDK-Samples/!
GDK public documentation available here: https://aka.ms/gamedevdocs

2021.11.10 Release Notes

  • This is the last major GDK release of 2021. This standalone installer package replaces and includes up to the June 2021 GDK Update 5 release.
  • For more information about the GDK and how to start developing games for Xbox consoles or Xbox Game Pass for PC on Windows 10/11, view the ReadMe.MD.

Resolved Issues

Common Components Between Windows 10/11 & Xbox Consoles

Networking | MsQuic

MsQuic is now supported for GDK games starting with the October 2021 GDK. Titles considering using the QUIC protocol, or that are looking for a protocol to support real-time game data traffic from client to server, are encouraged to use MsQuic. It's tailored for Game Core titles and is available on other platforms.

MsQuic provides binaries for GDK PC and console platforms that are newly available with the v1.9.0 prerelease. For more information, see Releases: microsoft/msquic (github.com)

Networking | Update PlayFab Party to version 1.7.5 for GDK console and PC

This release resolves the following issues:

  • Addressed an issue where some 16 kHz microphones didn't work.
  • PlayFab Party now detects and handles microphone permission changes on Windows 10.
  • A memory leak has been fixed in some CreateNewNetwork failure conditions.
  • An occasional crash in GetEndpointStatistics has been fixed

Developer Tools | Improved handling of long file paths in packaged workflows

This release fixes an issue that was causing long file paths (beyond MAX_PATH length) to fail when a package tried to open a file at runtime. We've also provided better warnings in cases where long files will change behavior in package creation, loose deployment, and Submission Validation.

Windows 10/11

Networking | Transport Layer Security (TLS) versioning.

Starting in the October 2021 GDK, TLS 1.3 support has been added for consoles. Windows 11 brings TLS 1.3 support to desktop PC while also deprecating TLS 1.0 and TLS 1.1.

Networking | Windows desktop behavior.

When using WinHTTP or any other Microsoft HTTP stack, such as WinInet/IXmlHttpRequest, the underlying OS version determines the TLS versions that are supported. Windows 10 supports TLS 1.0, TLS 1.1, and TLS 1.2 with some recent versions supporting TLS 1.3. Windows 11 deprecated support for TLS 1.0 and TLS 1.1 and supports only TLS 1.2 and TLS 1.3. By default, without any change to your client code, the OS sends a TLS client "hello" based on the highest supported TLS version and doesn't allow the server to negotiate a downgrade to deprecated TLS versions. This might necessitate updates or changes to your server libraries.

The XNetworkingQuerySecurityInformationForUrl[Utf16]Async functions detects the supported TLS versions by the OS and returns appropriate TLS 1.2 and TLS 1.3 flags in the XNetworkingSecurityInformation::enabledHttpSecurityProtocolFlags field given the OS capabilities and GDK version, shown as follows. If you're specifying these flags via the WinHTTP WINHTTP_OPTION_SECURE_PROTOCOLS option, the OS is restricted to the TLS versions in the following table for the purposes of TLS client "hello" versions and downgrade negotiations.

OS Version / GDK Version Pre-October 2021 GDK October 2021 GDK
Windows 10 TLS 1.2 TLS 1.2
Windows 11 TLS 1.2 TLS 1.2, TLS 1.3

Xbox (available in GDKX - GDK w/ Xbox Extensions)

32 Notable Fixes in this release: Dev Tools/Environment: 11, Networking: 7, Graphics: 12, Audio: 2

Note: Changes proprietary to Xbox console hardware, graphics, memory management, storage, and security features are only documented in the GDKX release notes published to the private/NDA-only Xbox Developer Forums. See ReadMe for more details about the GDKX.


Known Issues (PC Development / Common)

Issue #18 | [Developer Tools] Visual Studio 2019 Lifecycle update

Issue #17 | [Developer Tools] GDK Visual Studio 2022 Preview Support

Issue #11 | [System] GameInput on PC isn’t yet available

Workarounds Available

Issue #16 | [Graphics] PIX Timing Capture file format change

Issue #15 | [Graphics] Instrumenting PC titles with PIX events requires the WinPixEventRuntime package

Issue #14 | [Developer Tools] MicrosoftGame.config files added by using the item template in the GDK might not set the Item Type property correctly

Issue #13 | [Developer Tools] MicrosoftGame.config files added by using the item template in the GDK might have the file extension changed

Issue #12 | [Developer Tools] Newly added MicrosoftGame.config files don’t appear in Xbox Gaming Project Control

Issue #10 | [Developer Tools] Using version 20348 of the Windows10 SDK and version 22000 of the Windows 11 SDK with the GDK

Issue #8 | [Developer Tools] Gaming Services may be removed or fail to install during GDK installation

Issue #7 | [Developer Tools] .NET Core 2.1 updates delivered through Microsoft Update can block GDK installation