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

# XVC 包

> 在合作伙伴中心上传适用于 XBOX 主机的 GDK 生成的 XVC 包，包括 EKB、ContentId、布局文件、提交验证程序日志和符号。

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

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

## 上传 XVC 包

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

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

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

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

### 提交验证程序

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

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

### 符号

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

## 查看包属性

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

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

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

## 后续步骤

<CardGroup cols={1}>
  <Card title="如何为游戏包配置包飞行版本" href="/publishing/game-publishing/how-to/how-to-package-flights-for-xvc-packages" />
</CardGroup>

## 另请参见

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