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

# XVC 包

> 在 Partner Center 上传适用于 XBOX 主机的 GDK 生成的 XVC 包，包括 EKB、ContentId、布局文件、Submission Validator 日志和符号。

XVC 包是只能在 XBOX 主机设备上运行的特殊类型的包。这些包是使用[游戏开发套件 (GDK)](https://learn.microsoft.com/en-us/gaming/gdk) 创建的。

要使用 GDK 为 XBOX 主机创建游戏，你必须是 Microsoft 的托管创作者。有关详细信息，请参见[入门介绍](https://docs.xbox.com/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-onboarding-new-creator.md)。

## 上传 XVC 包

如果你拥有正确的权限，可以通过 Partner Center 的 **包** 页面上传 XVC 包，就像上传其他任何包一样。但是，在上传 XVC 包后，将出现一个新部分用于额外文件上传和包的其他详细信息。

* **EKB**（加密密钥 Blob）是用于加密 XVC 包的文件。此文件在你创建 XVC 包时生成。若要上传此文件，请选择 **上传 EKB**。上传文件后，可以通过选择 **更改 EKB** 进行替换。如果未提供 EKB，XVC 文件上传将停止处理。
* **ContentId** 是标识包的 GUID（全局唯一标识符），并且对于该包的每个版本都相同。
* 如果 XVC 包将在物理光盘上分发，并需要多张光盘或将使用 Intelligent Delivery，则需要提供 **布局文件**。此文件描述游戏文件将位于光盘的哪些位置，以及要为客户的硬件和区域设置下载的特定分块。若要上传布局文件，请选择 **上传布局文件**。上传后，可以通过选择 **更改布局文件** 进行替换。
* 如果安装了随 GDK 一起提供的 Submission Validator 工具，则 **Submission Validator** 日志文件会在打包过程中创建。有关详细信息，请参见本主题中的[Submission Validator](#submission-validator)。
* 可以上传 **符号** zip 文件夹，以便在游戏的运行状况报告中启用详细的崩溃数据。有关详细信息，请参见本主题中的[符号](#symbols)。

> [!NOTE]
>
> Layout.xml 提供有关包布局的详细信息。这与光盘布局文件不同，光盘布局文件提供有关在创建光盘时应如何配置包的信息。不要将 layout.xml 文件上传为光盘布局。

如果需要删除包，请选择 **删除**。请注意，如果误删了包，必须重新上传，或者如果可能，从另一个分支导入。

### Submission Validator

对于你提交进行认证的每个 XVC 包，都必须提供 Submission Validator 日志文件。未包含此文件将延迟认证。如果随 GDK 安装了该工具的有效版本，则日志文件会在 makepkg 过程中由 Submission Validator 工具生成。构建包时，你应始终使用最新版本的 Submission Validator。从[游戏开发资源 | Microsoft Game Dev](https://developer.microsoft.com/en-us/games/resources/) 下载最新版本的 Submission Validator。有关最新 Submission Validator 版本更改的详细信息，请参见[Submission Validator 更新](https://aka.ms/subvalupdates)。

在将包上传到 Partner Center 之前，我们强烈建议打开 Submission Validator 日志文件并查看任何标记为 **warning** 或 **failure** 的元素。在提交包进行认证之前，必须解决任何失败或意外的警告，否则提交将失败。

### 符号

为了使我们能够在[运行状况报告](https://learn.microsoft.com/windows/apps/publish/health-report)中向你显示详细的崩溃数据，你需要提供 **符号文件**。详细崩溃数据包括过去一个月的失败命中次数，以及列出发生详细信息（日期、包版本、设备类型、设备型号、操作系统版本等）的失败日志。符号文件必须为 .zip 格式，并且应包含 .pdb 文件才能成功索引符号。zip 文件夹可能会在包创建过程中自动生成。若要上传符号文件，请选择 **上传符号文件**。上传文件后，可以通过选择 **更改符号文件** 进行替换。

## 查看包属性

若要查看 XVC 包的更多属性，请选择 **显示详细信息**：

* **XvcProductId** 类似于产品实例的 **Product Id**。此值在 Partner Center 引入 XVC 包时生成。
* **Red Package** 是只能在开发主机上运行的 XVC 包版本。当你将产品发布到开发沙盒时，会创建此版本。
* **Green Package** 是只能在零售主机上运行的版本。当你发布到 CERT 或 RETAIL 沙盒时，会创建此版本。

有关 XVC 包、EKB 和布局文件的信息，请参见[打包概述](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/packaging/overviews/packaging)。

## 后续步骤

> [card] [如何为游戏包配置包飞行版本](https://docs.xbox.com/zh-CN/publishing/game-publishing/how-to/how-to-package-flights-for-xvc-packages.md)

## 另请参见

* [审阅并发布](https://docs.xbox.com/zh-CN/publishing/game-publishing/concepts/modular-submission.md)
* [运行状况报告](https://learn.microsoft.com/windows/apps/publish/health-report)


## Related topics

- [包的高级设置](https://docs.xbox.com/zh-CN/publishing/game-publishing/how-to/how-to-manage-advanced-settings-for-packages.md)
- [如何为游戏包配置包外部测试](https://docs.xbox.com/zh-CN/publishing/game-publishing/how-to/how-to-package-flights-for-xvc-packages.md)
- [XBOX 主机游戏打包入门](https://docs.xbox.com/zh-CN/build/core-features/common/packaging/overviews/packaging-getting-started-for-console.md)
- [PC 版 Unity 开发入门（内容）](https://docs.xbox.com/zh-CN/build/gdk-and-engines/unity/unity.md)
- [XBOX 游戏发布准备清单](https://docs.xbox.com/zh-CN/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-game-publishing-readiness-checklist.md)