> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 使用 GDK 项目模板启动新的 PC 作品

> 使用五个 GDK Visual Studio 项目模板启动新的 PC Desktop 作品,涵盖 Direct3D 12、Gaming Runtime、静态库、DLL 以及 makefile 构建。

本主题介绍如何使用 GDK 项目模板开始开发一款新作品。

<Note>
  面向使用 Gaming Runtime 的 PC Desktop 游戏,你可以自由使用 Direct3D 12、Direct3D 11,甚至旧版 Direct3D 9。请注意,如果使用旧版 DirectX SDK 组件(例如 D3DX9、D3DX10、D3DX11 等),会有一些特殊的注意事项。有关更多详细信息,请参阅 [DirectX Framework 包](/build/core-features/common/packaging/packaging-framework-packages)文档。
</Note>

## 通过 Visual Studio 项目模板开始使用 Gaming Runtime

当 Microsoft Game Development Kit(GDK)与 Visual Studio 一同安装在开发 PC 上时,会安装五个面向 PC Desktop 的项目模板,如下表所示。

| 目标平台    | 模板                                 | 说明                                                                                              |
| ------- | ---------------------------------- | ----------------------------------------------------------------------------------------------- |
| Desktop | Direct3D 12 Desktop Game (Classic) | 在 Visual Studio 项目系统中创建一个项目,使用 Gaming Runtime 与标准 x64 MSBuild 平台构建独立的 PC 游戏可执行文件。               |
|         | Direct3D 12 Desktop Game           | 在 Visual Studio 项目系统中创建一个项目,用于构建独立的 PC 游戏可执行文件。                                                 |
|         | Direct3D 12 Desktop Game Makefile  | 创建一个项目,适用于通过命令提示符使用 `makefile` 构建 PC Desktop 游戏。                                                |
|         | Desktop Static Library             | 在 Visual Studio 项目系统中创建一个项目,使用 Gaming.Desktop.x64 自定义 MSBuild 平台构建静态库。适合包含在面向 PC Desktop 的游戏中。  |
|         | Desktop DLL                        | 在 Visual Studio 项目系统中创建一个项目,使用 Gaming.Desktop.x64 自定义 MSBuild 平台构建 DLL。适合包含在面向 PC Desktop 的游戏中。 |

要访问这些模板:

1. 打开 Visual Studio。
2. 选择 **File** > **New** > **Project**。将出现 **New Project** 对话框。
3. 在 **New Project** 对话框中,将 **All Languages** 筛选器设为 **C++**,将 **All Platforms** 筛选器设为 **Windows**,并将 **All Project Types** 设为 **Games**。你也可以搜索上述项目名称。
4. 在 Microsoft Game Development Kit 项目模板列表中,选择你想要的项目模板。
5. 选择 **OK**。

## 使用合适的模板

### 仅面向 PC Desktop 的游戏

如果你正在开发一款仅面向 PC 设备的游戏,Direct3D 12 Desktop Game 模板是常见的起点。此模板的一些关键方面包括:

* 使用 Windows API 系列 `WINAPI_FAMILY_DESKTOP_APP`,并链接典型的 PC Desktop 库,包括 *kernel32.lib*、*user32.lib* 等。因此,可以在游戏中使用完整的 PC Desktop API。
* 包含必要的头文件和库,以便模板可以随时添加与 PC Desktop 兼容的 Direct3D 12 图形实现。该模板提供了简单的交换链、Direct3D 设备以及基本的游戏更新与渲染循环。
* 链接 *XGameRuntime.lib* 并包含必要的头文件,使所有 Gaming Runtime 功能都可以随时使用。
* 默认还提供 XBOX Live API(XSAPI)扩展库。还可以添加其他 Microsoft Game Development Kit(GDK)扩展库。
* 声明一个基于“标准”x64 平台或自定义 MSBuild 平台 Gaming.Desktop.x64 的构建配置,构建 x64 目标,预期你会通过本地调试器在本地(开发 PC 上)迭代游戏。
* 创建一个包含占位符信息的 *MicrosoftGameConfig.mgc* 文件,你可以用来自 Partner Center 的作品信息进行填充。

## 参见

* [MicrosoftGame.Config 概览](/build/core-features/common/game-config/MicrosoftGameConfig-Overview)
* [Gaming Runtime 入门](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/archive/gr-get-started-with-pc-dev-toc)


## Related topics

- [开发一款新的 GDK 游戏](/zh-CN/home/build-first-title/developing-new-titles.md)
- [用于 PC 游戏开发的 Visual Studio 项目模板](/zh-CN/tools/tools-pc/visualstudio/gr-vs-templates.md)
- [面向 XBOX 开发的 Visual Studio 项目模板](/zh-CN/tools/tools-console/visualstudio/durango-visual-studio-templates.md)
- [XBOX 游戏开发文档](/zh-CN/index.md)
- [Visual Studio(目录)](/zh-CN/tools/tools-pc/visualstudio/gr-visualstudio-toc.md)