开发一款新的 GDK 游戏

这是引导路径的第 3 步。在开始本页之前,请先按照设置并安装 GDK 完成 GDK 安装并构建一个示例。 每款 GDK 游戏都从一个 Visual Studio 项目开始。你需要根据希望游戏在哪里运行来选择一个模板:仅 Windows PC、仅 XBOX 主机,或从同一份代码同时面向两者。你不必现在就做出最终决定,因为之后可以再添加另一个目标。

​

项目模板

安装 GXDK 会在 Visual Studio 中新增九个 GDK 项目模板:五个用于 PC,四个用于 XBOX 主机。

​

创建项目

1. 打开 Visual Studio。
2. 转到 File > New > Project。
3. 在 All Languages 中选择 C++。在 All Platforms 中选择 XBOX 或 Windows。在 All Project Types 中选择 Games。你也可以按模板名称搜索。
4. 选择一个模板,然后选择 OK。

​

选择模板

​

仅 PC

从 Direct3D 12 Desktop Game 开始。

• 使用 WINAPI_FAMILY_DESKTOP_APP,并链接完整的 PC 库集合,包括 kernel32.lib 和 user32.lib。
• 包含 D3D12 的头文件与库。提供简单的交换链、D3D 设备以及更新/渲染循环。
• 包含 XGameRuntime.h 并链接 XGameRuntime.lib。所有 GDK Gaming Runtime 功能均已就绪。
• 默认可用 XSAPI 扩展库。
• 可基于原生 x64 平台或自定义的 Gaming.Desktop.x64 平台进行构建。
• 创建一个包含 Partner Center 身份占位符的 MicrosoftGameConfig.mgc 文件。

​

仅 XBOX

从 Direct3D 12 XBOX Game 开始。

• 使用 WINAPI_FAMILY_GAMES 并链接 XGamePlatform.lib。
• 包含已为 XBOX D3D12.x 扩展做好准备的 D3D12 头文件。
• 包含 XGameRuntime.h 并链接 XGameRuntime.lib。
• 默认可用 XSAPI 扩展库。
• 使用 Gaming.XBOX.XboxOne.x64 MSBuild 平台,并按照远程调试的方式配置。
• 创建带占位符的 MicrosoftGameConfig.mgc 文件。

​

PC 与 XBOX(共享代码库)

从一个模板开始,例如 Direct3D 12 Desktop Game,然后添加第二个面向 Gaming.XBOX.XboxOne.x64 的构建配置(反之亦然)。 通过 #define 或 #ifdef 守卫来调整源代码,或者将平台相关代码拆分到独立的 DLL 中:

• PC 配置使用标准 D3D12。
• XBOX 配置使用 D3D12.x。

切换当前的构建配置会自动切换调试器、链接的库以及其他工具设置。

​

在开发套件上端到端发布

在选择更深入的路径之前,请先完成主机上手实战演练。它会以你刚刚创建的 Direct3D 12 XBOX Game 模板为基础,在 XBOX 开发套件上以松散部署方式运行,并最终产出一个可安装的 XVC。

​

后续步骤

你已经完成项目构建。请选择与你所要发布的游戏最匹配的精选路径。指南会引导你进入需要的更深入文档(Build、Services、Optimize、Publishing 与 API References)。

​

参见

• 移植指南:移植主题的技术索引(ERA 至 GDK、着色器、GameInput 与 Steamworks 映射)。
• MicrosoftGame.config 概览。
• 打包你的游戏。