> ## 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.

# PC Bootstrapper

> 了解 PC Bootstrapper GamingServicesUI.exe 如何通过启动画面、更新检查、云存档同步与单实例限制来改进 MSIXVC PC 游戏的启动体验。

PC Bootstrapper 通过提供一致性、传达启动状态、确保已安装游戏为最新版本、同步云存档以及防止多个游戏实例同时运行,改善了 MSIXVC 打包 PC 游戏的启动体验。它会在旁加载(side-loaded)开发工作流中,以及在零售场景下启动已安装的 MSIXVC 打包作品时呈现。

在 2022 年 5 月 Gaming Runtime Services(GRTS)版本之前,以下问题会影响 PC 游戏的启动体验:

* 最终用户在游戏窗口显示之前无法得知启动状态。
* 开发者需要确保已安装游戏为最新版本。
* 云存档在游戏进程启动之前不会同步。
* 开发者需要防止游戏被多次启动。

从 2022 年 5 月 GRTS 版本开始,PC Bootstrapper 通过以下方式解决上述启动问题:

* 用户尝试启动游戏后立即显示启动画面,以传达进程已开始。
* 在游戏进程启动之前,确保已安装的游戏已更新到 Partner Center 中提供的最新版本。你也可以按照“检查更新”中的步骤手动检查并应用更新。
* 在游戏进程启动之前自动同步云存档。
* 通过自动将其限制为单个实例来防止已安装游戏被多次启动。

对于使用 Simplified User Mode(从 2022 年 6 月 GDK 起可用)的开发者,即使在未调用主 PC Bootstrapper 流程的松散部署(loose deploy)场景中,运行时也会执行相应的强制策略。

## 它是什么

PC Bootstrapper 是一个 Gaming Runtime 实用工具(**GamingServicesUI.exe**),它有助于在游戏进程开始之前确保 MSIXVC 打包的 PC 游戏处于健康状态。

每当已安装的 MSIXVC 打包 PC 游戏被启动时(通过 XBOX 应用、开始菜单、桌面快捷方式或命令行工具),Gaming Runtime Services(GRTS)会首先调用 PC Bootstrapper。一旦 PC Bootstrapper 确认满足启动前的要求,PC Bootstrapper 进程就会启动游戏。

自 2022 年 5 月 GRTS 版本起,PC Bootstrapper 已成为通过 XBOX App 或 Microsoft Store 获取的所有 MSIXVC 打包 PC 游戏的启动流程的一部分。

对于使用 wdapp.exe install 旁加载的开发者包,必须包含 /bootstrapper 标志。

请注意,当调试启用了 PC Bootstrapper 的 MSIXVC 打包作品时,游戏进程将是另一个辅助进程的子进程。

## 工作方式

以下是 PC Bootstrapper 工作方式的摘要:

* 当 MSIXVC 打包的 PC 游戏被启动时,PC Bootstrapper 首先检查游戏是否已在运行。如果游戏正在运行,PC Bootstrapper 会尝试将游戏窗口带到前台,然后退出 PC Bootstrapper 进程。(注意:此时不会启动游戏的新实例。)
* 如果没有其他游戏实例在运行,PC Bootstrapper 会在启动时立即显示 SplashScreenImage(在 MicrosoftGame.config 文件中指定),以反馈游戏正在尝试启动。
* 启动画面可见后,它会启动游戏进程。PC Bootstrapper 会一直运行,直到游戏窗口可见。
* 游戏窗口可见后,PC Bootstrapper 的工作完成,PC Bootstrapper 进程随即退出。

## 优点

以下是 PC Bootstrapper 优点的摘要:

* 将游戏进程的当前工作目录设置为游戏安装位置的根目录。
  * 确保已安装游戏目录中同时只有一个可执行进程在运行。
* 如果已有实例在运行,会将该可执行文件的窗口带到前台。
* 增加了启动体验,使得从启动游戏到游戏主窗口可见期间的进展更加清晰。

## Gaming Runtime Services(GRTS)依赖

PC Bootstrapper 依赖 Gaming RunTime Service(GRTS),GRTS 会自动分发到所有 Windows 10/11 PC 上。如果开发 PC 上的 GRTS 版本过时,在尝试登录时可能会生成错误(E\_FAIL)。

为确保你的 PC 上安装了最新版本的 Gaming Services:

1. 确认你的 Windows 10/11 开发环境已设置为 [RETAIL 模式,而不是开发者沙盒](https://learn.microsoft.com/windows/apps/get-started/developer-mode-features-and-debugging)。
2. 关闭所有其他游戏和应用。
3. 通过此链接前往 Microsoft Gaming Services 的 Microsoft Store 页面(如有需要,选择 "More details" 展开商店页面):[https://www.microsoft.com/store/productId/9MWPM2CQNLHN](https://www.microsoft.com/store/productId/9MWPM2CQNLHN)
4. 确认它是最新版本,并且没有提示需要更新。
5. 此外,前往 Microsoft Store 应用中的 Library 视图,更新所有应用与组件。

## 疑问或反馈

如果你对 PC Bootstrapper 有疑问或反馈,请在 [XBOX Developer Forums](https://forums.xboxlive.com/index.html) 上发帖,或联系你的客户经理。

## 参见

* [MicrosoftGame.config 参考(示例 MicrosoftGame.config 与架构)](https://learn.microsoft.com/gaming/gdk/_content/gc/reference/system/microsoftgameconfig/microsoftgameconfig-schema)
* [使用 Microsoft Gaming Development Kit 工具安装和启动你的 PC 作品](https://learn.microsoft.com/gaming/gdk/_content/gc/tools/tools-pc/launching-on-pc)


## Related topics

- [使用 GDK 工具安装并启动 PC 游戏](/zh-CN/tools/tools-pc/launching-on-pc.md)
- [在 GameMaker 中使用 GDK](/zh-CN/build/gdk-and-engines/gamemaker.md)
- [使用 wdapp.exe 注册 PC 游戏](/zh-CN/tools/tools-pc/title-registration-pc.md)
- [创建、检查和测试内容更新](/zh-CN/build/core-features/common/packaging/packaging-testing-updates.md)
- [Microsoft 游戏开发工具包用户模型](/zh-CN/build/core-features/common/user/gamecore-user-models.md)