使用 Visual Studio 调试电脑项目

从 2022 年 6 月版本的 Microsoft 游戏开发工具包 (GDK) 开始,作为 Visual Studio 一部分附带的本机代码调试器用于调试电脑游戏项目。 若要在本地电脑上进行调试,请从 Visual Studio 工具栏上的调试器下拉列表中选择“本地 Windows 调试器 ”,如下图所示。

标准调试器用于项目

若要在远程电脑上进行调试,请选择“远程 Windows 调试器”,然后按照 在远程电脑上调试游戏 中所述的步骤进行操作。

注意

在 2022 年 6 月之前使用 Microsoft 游戏开发工具包 (GDK) 版本的项目使用的调试器名为本地计算机。 2022 年 6 月之前的 Microsoft 游戏开发工具包 (GDK) 版本不支持远程调试。

将项目升级到 2022 年 6 月版本的 Microsoft 游戏开发工具包 (GDK) 时,可能会将调试器属性设置为 “不受支持的调试”选项 ,如下图所示。 如果发生这种情况,必须使用调试工具栏、项目属性页或通过将 DebuggerFlavor msbuild 属性设置为 WindowsLocalDebugger(完全删除 DebuggerFlavor 属性也会导致使用本地 Windows 调试器)将调试器属性重置为本地 Windows 调试器。

升级后不受支持的调试器

从 2022 年 6 月版本的 Microsoft 游戏开发工具包 (GDK) 开始,电脑项目不再需要部署步骤。 Visual Studio 的“配置服务器”对话框中的“部署”复选框处于禁用状态。

在零售中启动游戏时,将使用中间启动器进程。 此引导程序过程在游戏呈现前显示初始屏幕、检查游戏更新、预同步云保存、预登录用户等。 这些行为不会在松散文件调试方案中执行。 使用 打包的内部版本 来测试或调试游戏,就像在零售版中启动一样。

调试打包版本

在调试打包的生成之前,必须使用 wdapp 安装 来安装包。 安装后,可以使用 Visual Studio 中的“调试安装的应用包”功能调试游戏。 使用“调试”菜单显示调试对话框,如下图所示。

Visual Studio 中的“调试安装的应用包”菜单项

若要调试游戏,请在对话框中搜索它,将“调试此代码类型”设置为“仅本机” ,然后单击“开始”按钮。

Visual Studio 中的“调试安装的应用包”对话框

若要调试在零售环境中启动的游戏,请将 /bootstrapper 标志添加到 wdapp 安装 命令行。 以这种方式安装的游戏将由引导程序进程启动。 在这种情况下,调试需要 Visual Studio 中的 子进程调 试扩展。 使用“管理扩展”对话框安装扩展。

安装子进程调试 Visual Studio 扩展

安装后,使用“调试”菜单查看 子进程调试 设置。

Visual Studio 中的“子进程调试”菜单

单击设置页上的“启用子进程调试”复选框。

在 Visual Studio 中配置子进程调试

启用子进程调试后,“调试安装的应用包”对话框现在会将调试器附加到游戏而不是引导程序进程。

在远程电脑上调试游戏

在远程电脑上调试游戏需要 Visual Studio 远程工具。 安装工具并配置远程调试器,如 Visual Studio 中的 C++ 项目远程调试 中所述。

在项目的属性页上,从要启动的调试器下拉列表中选择 远程 Windows 调试器。 输入游戏的可执行文件的名称、所需的工作目录等。 默认情况下,Visual Studio 将部署游戏的可执行文件和二进制依赖项。 若要调试远程 Microsoft 游戏开发工具包 (GDK) 游戏,还需要部署其他文件,包括 MicrosoftGame.config 文件和徽标文件。 使用 远程 Windows 调试器 属性页上的 部署附加文件 指定要部署的附加文件,如下图所示。

在远程电脑方案中部署 MicrosoftGame.config 和其他文件

另请参阅

Visual Studio