Issues and limitations
The following is a list of known issues and limitations with the Microsoft GDK Tools package.
Issues
- The Microsoft GDK Tools package does not currently support the Windows build setting
Create Visual Studio Solution
. - You must manually create or copy a valid
MicrosoftGame.config
file alongside the installed Unity.exe in order to use the GDK inEditMode
. - The Unity Editor might require a restart to recognize changes to the
MicrosoftGame.config
file when used in combination with the built in editor player. - The Define MICROSOFT_GDK_SUPPORT setting (Edit > Project Settings > Microsoft GDK) only takes effect at build time which might lead to some unexpected script errors.
- When creating a package build, you must manually increment the version number in the Identity element of the
MicrosoftGame.config
file. Make sure the version number follows Microsoft's guidelines on Package Version Numbering. - When targetting headless CI
EditorUserBuildSettings.GetBuildLocation(StandaloneWindows64)
can return an empty string in some situations causingMakePri.exe
to fail a work-around is to callEditorUserBuildSettings.SetBuildLocation(buildTarget, buildPath)
first before starting the build process.