将 Microsoft Game Development Kit 添加到现有桌面项目

注意

对于使用游戏运行时面向电脑桌面的游戏,可以随意使用 Direct3D 12、Direct3D 11 甚至是旧版 Direct3D 9。 请注意,使用旧版 DirectX SDK 组件(如 D3DX9、D3DX10、D3DX11 等)时,有一些特殊注意事项。有关更多详细信息,请参阅 DirectX Framework 包 文档。

注意

以下信息假定你已拥有 x64 桌面(Windows 电脑)项目和自定义引擎,并已安装 Microsoft 游戏开发工具包 (GDK)。 如果未安装此GDK,请参阅在未安装 Microsoft Game Development Kit 的情况下配置项目

遵循以下步骤将让你的项目:

  • 使用 Windows API 系列 WINAPI_FAMILY_DESKTOP_APP 和针对典型电脑库(包括 kernel32.libuser32.lib 等)的链接。
  • 包括所需的标头和库。
  • 包括 XGameRuntime.h 和指向 XGameRuntime.lib 的链接。 所有游戏运行时功能已可供使用,以及 Xbox Live API (XSAPI) 扩展库。
  • 能够基于你的 MicrosoftGame.config.mgc 文件,通过使用 F5 与完整的包标识来调试你的游戏。

将 GDK 添加到现有桌面项目

  1. 如果需要,请使用配置管理器创建新的调试和发布配置的副本,或修改现有配置。

  2. 关闭项目并在文本编辑器中打开它。 使用配合使用 x64 平台和 Microsoft 游戏开发工具包 (GDK) 中的详细说明来修改项目 GlobalsExtensionSettingsVC++ 目录ItemDefinitionGroups

  3. 关闭文本编辑器并在 Visual Studio 中打开项目。

  4. 设置 MicrosoftGameConfig.mgc:GDK 包含用于将 MicrosoftGameConfig.mgc 文件添加到项目的 Visual Studio 项模板。 要使用项模板添加文件,请执行以下操作:

  • 在项目上单击鼠标右键,然后选择“添加”->“新建项目”。
  • 可在 Visual C++->“游戏”- >“Microsoft 游戏开发工具包”->树的版本节点中查找 MicrosoftConfig 模板,如下所示。

MicrosoftGame.config Item Template

  • 右键单击“MicrosoftGameConfig.mgc”文件并将其设置为“自定义生成工具”,点击“确定”。
  • 在命令行中,单击“<编辑...>”并粘贴:
copy %(Identity) "$(OutDir)MicrosoftGame.config"
makepkg.exe localize /d "$(OutDir)" /pd "$(OutDir)" /gc "%(Identity)"
  • 对于输出,设置
$(OutDir)MicrosoftGame.config

MicrosoftGame.config 自定义生成

有关更多信息,请参阅 MicrosoftGame.config 概述