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

# 从认证测试中检索游戏保存文件

> 使用 XblConnectedStorage、xbstorage 和 xgamesaveutil 从 XBOX Live CERT 沙盒拉取游戏保存文件，并将其应用到你的开发测试帐户。

## 那么，你的认证报告中列出了崩溃？

这并不罕见，尤其是在所有 bug 被解决之前的可选认证测试通过期间。挑战通常在于在工作室内的开发构建中重现这些问题。

如果崩溃转储不可用或没有帮助，也许来自认证使用的帐户的保存文件可以派上用场。通过将来自认证测试帐户的保存文件应用于你的开发沙盒测试帐户，你可能能够更迅速地聚焦于问题所在。

本文将向你展示如何做到这一点。

## 如何从 CERT 获取保存文件并将其应用到你的测试帐户

[XblConnectedStorage](/tools/tools-services/live-connected-storage-tool) 将从 XBOX Live CERT 沙盒获取保存 blob。

[Xbstorage](/tools/tools-console/commandlinetools/xbstorage) 将用于将保存文件应用到控制台开发沙盒中的测试帐户。

[Xgamesaveutil](/tools/tools-pc/commandlinetools/gr-xgamesaveutil) 将用于将保存文件应用到 PC 开发沙盒中的测试帐户。

### 先决条件

1. 在所使用的 PC 上安装 [GDK 或 GDK Tools](https://aka.ms/gdkdl)
2. 用于发布游戏的合作伙伴中心帐户登录凭据
   * 具有该游戏产品的 XBOX Live "Tools Access" 权限（[权限文档](https://learn.microsoft.com/windows/apps/publish/partner-center/assign-product-level-custom-permissions-to-account-users#xbox-live-)）
   * 如果登录帐户是访客帐户，则需要该帐户作为访客所在的 Microsoft Entra 租户名称（可能采用 ?.onmicrosoft.com 的形式）。
3. 来自合作伙伴中心中游戏设置/身份详细信息部分的游戏 XBOX 服务配置 ID (SCID)。
4. 同一位置的游戏包系列名称 (PFN)。
5. 认证团队提供的你希望检索保存文件的帐户玩家代号。
6. 认证所使用的沙盒名称：CERT 或 CERT.DEBUG。
7. 你希望将保存文件应用到的测试帐户的电子邮件地址。

### 从 XBOX Live 检索保存 blob

1. 打开 GDK 命令提示符窗口
2. 使用 [xbldevaccount](/tools/tools-services/live-dev-account-tool) 登录到先决条件 #2 的合作伙伴中心帐户，例如：
   <pre>C:\temp>xbldevaccount signin --name [billyray@mylovelygamecompany.com](mailto:billyray@mylovelygamecompany.com)</pre>

   如果你以另一个租户的访客身份登录，请使用 --tenant 选项，例如：

   <pre>C:\temp>xbldevaccount signin --name [billyray@mylovelygamecompany.com](mailto:billyray@mylovelygamecompany.com) --tenant sombodyelseslovelygamecompany.onmicrosoft.com</pre>
3. 使用 XblConnectedStorage 命令行从 XBOX Live 拉取保存文件，例如：
   <pre>C:\temp>xblconnectedstorage --scid 00000000-0000-0000-0000-000012345678 -s CERT --gamertag "2 SomeCertAccount" --output .\GameSaveFrom2SomeCertAccount.xml
   Using Dev account [billyray@mylovelygamecompany.com](mailto:billyray@mylovelygamecompany.com) from WindowsDevCenter
   Operation complete. Downloaded 4 save containers to .\GameSaveFrom2SomeCertAccount.xml.</pre>

如果一切成功，你现在应该在你指定的 xml 文件中拥有保存 blob。你应该能够看到其中的 base64 编码的二进制 blob。有关文件格式的更多信息可在[此处（NDA 主题）](/tools/tools-console/commandlinetools/xbstorage#xbstorage_fileformat)获取。

### 将保存文件应用到测试帐户（控制台）

按照 xbstorage 文档中的说明将 xml 文件应用到存储空间，例如：

<pre>C:\temp>xbstorage import .\GameSaveFrom2SomeCertAccount.xml /msa:[MLGC-MyTestAccount0000@xboxtest.com](mailto:MLGC-MyTestAccount0000@xboxtest.com) /replace /verbose</pre>

### 将保存文件应用到测试帐户（PC）

按照 XGameSaveUtil 文档中的说明将 xml 文件应用到存储空间，例如：

<pre>C:\temp>xgamesaveutil import .\GameSaveFrom2SomeCertAccount.xml /pfn:mygame\_xxxxxx /replace</pre>

## 注意事项

### 时间

由于认证的测试方式，帐户可能在问题发生后仍会继续被使用。认证报告通常在测试完成后发布。

这可能导致 XBOX Live 上的保存文件比问题发生时使用的保存文件更新。

### Xblconnectedstorage 输出目录

如果你未向 xblconnectedstorage.exe 提供 --output，它将尝试输出到当前工作目录。如果你刚刚启动了 GDK 命令提示符，那可能会是你的 Windows 系统目录，因此 xblconnectedstorage 将失败。建议显式提供 --output 参数以指向可写入位置。

### 现代玩家代号

此过程目前尚未使用现代玩家代号进行测试。


## Related topics

- [沙盒](/zh-CN/services/xbox-services/fundamentals/sandboxes/live-sandboxes-nav.md)
- [最常见的失败 XBOX 认证测试](/zh-CN/publishing/certification/xr-top-failing.md)
- [认证 PC BVT 指南](/zh-CN/publishing/game-publishing/concepts/certification/certification-pc-bvt-guide.md)
- [PC 和移动游戏的 XBOX 要求测试用例](/zh-CN/publishing/certification/pc-policy-tests.md)
- [XGameSaveFiles](/zh-CN/reference/system/xgamesavefiles/xgamesavefiles_members.md)
