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

# Microsoft Game Development Kit (GDK) 新增功能

> 重点介绍受支持的 Microsoft Game Development Kit 版本中引入的功能、工具和文档。

> [tab] GDK 2610
>
> ## 2026 年 10 月 Microsoft Game Development Kit 新增功能
>
> Microsoft Game Development Kit (GDK) 是一整套工具、API、扩展和编程模型，可用于当前和未来的 Microsoft 游戏平台与计划。GDK 的设计和功能取决于你对自己喜欢的游戏开发方式所提供的反馈。有关完整介绍，请参阅[欢迎使用 Microsoft Game Development Kit](https://docs.xbox.com/zh-CN/home/setup-install/get-started.md)。
>
> 除了修复许多 bug 之外，此版本还包含以下新功能。
>
> ## 目录
>
> [打包](#packaging)\
> [开发人员工具](#developer-tools)\
> [GDK](#gdk)\
> [AMD FSR™ Upscaling 4](#amd-fsr-upscaling-4)\
> [示例](#samples)
>
> ***
>
> ### 打包
>
> #### 适用于 PC 游戏的 MSIXVC2
>
> MSIXVC2 现在是默认的 PC 打包格式。在 2026 年 4 月 (2604) GDK 中推出的预览版基础上，MSIXVC2 现已成为使用 Microsoft GDK 生成的游戏的默认格式，并在发布、引入、许可和下载整个技术栈中获得全面支持。
>
> 正式发布 (GA) 版本的主要改进包括：
>
> * **版本感知许可**。按版本划分的加密密钥通过 CELS 和 Catalog 传递。
> * **生产规模的引入**。强化了重复数据删除、版本验证、完整性检查和扫描工作流的规模。
> * **平台正式发布**。在 PC 上提供可用于零售的下载、安装和更新，并与 Gaming Services 完全集成。
> * **遥测一致性**。安装和网络速度报告除 MSIXVC1 外还涵盖 MSIXVC2。
> * **中间件支持**。Unity 和 Unreal 引擎提供 MSIXVC2 打包路径。 
> * **XPlaytest 支持**。试玩发布管道端到端支持 MSIXVC2 包。
>
> #### Publisher Content 包
>
> PC 和主机游戏现在可以附带 Publisher 托管的内容。这是一种新的包类型，可让游戏发行商在自己的 CDN 上托管和更新内容，同时由平台继续管理安装、后台下载、完整性和用户体验。
>
> 有关详细信息，请参阅 [Publisher Content 包](https://docs.xbox.com/zh-CN/build/core-features/common/packaging/packaging-publisher-content.md)。
>
> ***
>
> ### 开发人员工具
>
> #### XBOX Test Account CLI
>
> `XblTestAccount.exe` 是 2026 年 10 月 GDK 中新增的工具，它只需将 XBOX 测试帐户登录到沙盒一次，即可缓存凭据，然后无需任何 UI 即可读取或更改该帐户的权限和隐私设置。你可以使用它编写受限帐户测试脚本，例如阻止权限 254（多人游戏会话）以检查游戏的响应方式，或者提前登录帐户，以便 `XblPlayerDataReset.exe` 能够在无人值守的情况下运行。
>
> #### PIX
>
> 新的命令行工具 `convertpevt.exe` 可将来自 XBOX Series X|S 主机的 `.pevt` 脱机计时捕获转换为 `.xpix` 捕获，而无需打开 PIX，因此可以在自动化工作流中处理使用 `PIXBeginCapture` 以编程方式获取的捕获。该工具安装在 GDK `bin` 文件夹中；运行 `convertpevt --help` 可查看用法、选项和退出代码。此工具在 2026 年 4 月 GDK 更新 3 中也可用。\[62625022]
>
> ***
>
> ### GDK
>
> #### GDK 布局弃用
>
> 2025 年 10 月和 2026 年 4 月的 GDK 版本同时包含简化布局和旧版布局。从 2026 年 10 月 GDK 开始，安装程序默认仅安装简化布局。旧版布局仍可作为可选安装项进行选择，但它已被弃用，不再是推荐的开发路径。
>
> 从 2027 年 4 月 GDK 版本开始，旧版布局将不再受支持，并将从安装程序中移除。
>
> #### GDK 中的 AMD Compiler (ACO)
>
> 基于 Mesa 中的 ACO、适用于 XBOX 主机 (XBOX Series X|S) 的实验性新着色器编译器
>
> XBOX 正在通过一款实验性新着色器编译器，为游戏开发人员的着色器编译和运行时性能带来进一步优化。开发人员可以将此编译器用作优化工具，与标准 XBOX 着色器编译器相比，可能会发现编译和运行时性能有显著提升。在我们的初步测试和评估中，开发人员看到的提升幅度在 2% 到 16% 之间，具体取决于游戏引擎、内容和当前的着色器瓶颈。有关详细信息，请参阅文档和[示例](https://docs.xbox.com/zh-CN/home/setup-install/samples.md)，并通过开发人员论坛或你的开发人员客户经理与我们联系。
>
> ***
>
> ### AMD FSR™ Upscaling 4
>
> 新的 [AMD FSR GDK 示例](https://docs.xbox.com/zh-CN/home/setup-install/samples.md)演示了如何利用 [AMD FSR™ Upscaling 4.1.2](https://gpuopen.com/amd-fsr-upscaling/)，首次将 AMD 基于机器学习的超分辨率技术引入 XBOX Series X|S。它包括 AMD 的 Full INT8 模型和新的 Lite INT8 模型，后者的大小不到前者的一半，超分辨率开销也更低，因此 XBOX 开发人员可以为每款游戏选择最合适的 GPU 性能与视觉质量平衡。XBOX 与 AMD 合作，针对两款主机优化了实现，在提供出色性能的同时，保留了两个模型的完整功能以及相较于 AMD FSR 3 更出色的图像质量。这些 XBOX 专属优化在运行相同 Full INT8 模型时，每 teraflop 的超分辨率吞吐量高于 AMD RDNA 2 架构的 PC GPU，为开发人员提供了一种将低分辨率渲染转换为高质量最终帧的高效方法。 
>
> ***
>
> ### 示例
>
> 有关 Microsoft Game Development Kit (GDK) 中所含示例的完整列表，请参阅 [Microsoft Game Development Kit 示例](https://docs.xbox.com/zh-CN/home/setup-install/samples.md)。

> [tab] GDK 2604
>
> ## 2026 年 4 月 Microsoft Game Development Kit 新增功能
>
> Microsoft Game Development Kit (GDK) 是一整套工具、API、扩展和编程模型，可用于当前和未来的 Microsoft 游戏平台与计划。GDK 的设计和功能取决于你对自己喜欢的游戏开发方式所提供的反馈。有关完整介绍，请参阅[欢迎使用 Microsoft Game Development Kit](https://docs.xbox.com/zh-CN/home/setup-install/get-started.md)。
>
> 除了修复许多 bug 之外，此版本还包含以下新功能。
>
> ## 2026 年 4 月目录
>
> [开发人员工具](#developer-tools)\
> [打包](#packaging)\
> [系统](#system)\
> [示例](#samples)
>
> ***
>
> ### 开发人员工具
>
> #### Visual Studio 2026 GDK 支持
>
> 从 2026 年 4 月 GDK 开始，GDK 开发现已支持 Visual Studio 2026。Professional 版和 Enterprise 版均受支持。
>
> Visual Studio 项目模板的获取方式如下。
>
> * 主机开发模板由 GDK 安装。
> * PC 开发模板可从 [Microsoft GDK Templates](https://aka.ms/gdktemplates) 安装。
>
> Visual Studio 2026 引入了一种新的服务和支持模型，该模型基于每年一次的版本发布和两年的服务时间线。有关详细信息，请参阅 [Visual Studio 产品生命周期和服务](https://docs.xbox.com/zh-CN/visualstudio/releases/2026/servicing-vs)。
>
> 有关 Visual Studio 2026 的详细信息，请参阅 [Visual Studio 2026 is here: faster, smarter, and a hit with early adopters](https://devblogs.microsoft.com/visualstudio/visual-studio-2026-is-here-faster-smarter-and-a-hit-with-early-adopters/)。
>
> #### MSIXVC2 打包格式预览版
>
> MSIXVC2 是一种适用于使用 GDK 生成的 PC 游戏的新打包格式。与原始 MSIXVC 格式相比，它可以显著缩小基础游戏包和内容更新的大小，加快打包速度，并简化上传工作流。从 2026 年 4 月 GDK 开始，MSIXVC2 以预览版形式提供。
>
> 主要改进包括：
>
> * **更小的内容更新**。字节级更改跟踪消除了对齐填充和区块边界约束，与 MSIXVC 相比，更新大小减少了 64% 到 94%。
> * **更快的打包速度**。makepkg2 pack 可将速度提升 2 到 8 倍，具体取决于游戏大小。
> * **更低的包开销**。固定哈希树开销降低了 90% 以上；支持部分下载，而无需在每次更新时完整重新下载。
> * **内置压缩**。以透明方式压缩资产以便传输和存储；在玩家设备上以未压缩形式安装。
> * **一条命令完成上传**。使用 makepkg2 upload 将打包和上传合并为一个步骤。
>
> 有关详细信息，请参阅 [PC 打包改进](https://docs.xbox.com/zh-CN/build/core-features/common/packaging/overviews/packaging-msixvc2-overview.md)。
>
> > [!NOTE]
> >
> > 我们建议不要在生产环境中使用这种新打包格式。在正式发布 (GA) 版本推出之前，面向公众的 MSIXVC2 提交将被认证测试阻止，GA 版本目前计划在 2026 年 10 月 GDK 中推出。
>
> #### Submission Validator 更新
>
> Submission Validator 版本 10.0.26100.7798 现已推出。请从 [https://aka.ms/currentsubvalzip](https://aka.ms/currentsubvalzip) 下载最新版本。
>
> > [!NOTE]
> >
> > 从此版本开始，位于 aka.ms/gdkdl 的旧下载位置已停用。Submission Validator 现在仅可从 [https://aka.ms/currentsubvalzip](https://aka.ms/currentsubvalzip) 获取。上一版本 (10.0.26100.6877) 在 2026 年 4 月 30 日之前仍然有效。
>
> > [!NOTE]
> >
> > 正如 2025 年 3 月所宣布的，Submission Validator 的更新现已简化。可以直接在管道中进行无需身份验证的编程更新。有关下载和更新说明，请参阅[更新 Submission Validator](https://docs.xbox.com/zh-CN/build/core-features/common/packaging/subval/submissionvalidator.md#updating-submission-validator)。
>
> 此版本包含以下更改。
>
> * **MSIXVC2 开发人员预览版包现在会报告 FAILURE。** 在预览期间，不支持将 MSIXVC2 包提交认证。这与上文 [MSIXVC2 打包格式预览版](#msixvc2-packaging-format-preview)一节中所述的认证测试阻止措施保持一致。
> * 对于 Arm64EC（仿真兼容）二进制文件，`ILI_ArchitectureArm64Mismatch` 不再报告 FAILURE。
> * `ILI_ArchitectureAmd64Mismatch` 和 `ILI_ArchitectureX86Mismatch` 警告现在仅适用于 MicrosoftGame.config 文件中列出的可执行文件。
> * 如果 Submission Validator 在符号捆绑期间遇到崩溃，它现在会报告 `ILI_SymbolHandlingInitError` INFO 消息并继续验证，而不是提前退出。
>
> #### XblPcSandbox.exe 命令行工具改进
>
> `XblPcSandbox.exe` 命令行工具现在提供了多项提升使用便利性的改进，以增强 PC 游戏开发人员的沙盒切换体验。
>
> 主要改进包括：
>
> * **更清晰的沙盒切换输出**。`XblPcSandbox.exe` 现在会在切换操作前后显示当前沙盒值。通过此显示，可以立即看出是否应用了预期的沙盒。此外，现在还提供了不确定进度旋转图标，用于显示工具何时正在工作。 
> * **新增 /retail 开关**。现在提供了专用的 `/retail` 命令行选项，可以更轻松地将 PC 切换回 RETAIL 模式。以前，文档中仅说明可以将 RETAIL 作为沙盒名称传递，这一点很容易被忽略。
> * **自动更正沙盒名称大小写**。沙盒切换逻辑现在会自动更正沙盒名称的大小写（例如，将 retail 更正为 RETAIL）。此逻辑可减少因区分大小写而导致的错误。大多数沙盒名称全部采用大写字母。
> * **新增 /feedback 开关**。现在提供了 `/feedback` 选项，可直接深层链接到反馈中心，从而更轻松地报告问题或提供有关沙盒切换体验的反馈。
> * **增强的帮助文本，包含故障排除指导**。帮助用法文本现在包含故障排除建议以及指向故障排除文档的链接。现在可以直接从命令行获取常见沙盒问题的解决方案。
>
> 有关详细信息，请参阅 [PC Sandbox Switcher (XblPCSandbox.exe)](https://docs.xbox.com/zh-CN/tools/tools-services/live-pc-sandbox-switcher.md)。
>
> #### XBOX PIX 支持 DirectStorage 事件中的文件映射
>
> XBOX PIX 现在支持 DirectStorage 事件中的打包文件映射。这与现有的文件 IO 事件映射行为一致，并会正确地为文件列表及其偏移量和描述编制索引。
>
> #### 灵活的 MicrosoftGame.config 编辑器
>
> MicrosoftGame.config 编辑器在打开文件时不再强制执行游戏配置架构验证。如果文件是有效的 XML，即使配置本身无效，编辑器也会尝试使用正确的节点结构加载该文件。这样就可以在编辑器中打开并修复无效的配置文件，而不会出现加载失败。
>
> ***
>
> ### 系统
>
> #### 原生 ARM64 生成 GDK 支持预览版
>
> GDK 现在支持为 GDK 附带的二进制文件提供原生 ARM64 生成库的预览版。这些二进制文件包括 [PlayFab Unified SDK (v2)](https://docs.xbox.com/zh-CN/gaming/playfab/sdks/unified-sdk/overview)、XBOX Services API、XBOX Authentication Library、Game Chat 2 和 `xCurl`。借助此支持，你可以生成完全原生的 ARM64 游戏版本。
>
> 有关详细信息，请参阅[简化的 GDK 目录结构](https://docs.xbox.com/zh-CN/build/gdk-and-engines/guides/gdk-directory-structure.md)。
>
> > [!NOTE]
> >
> > 此预览版仅用于测试。我们建议不要在生产环境中使用它。
>
> #### GDK 布局弃用
>
> 2025 年 10 月和 2026 年 4 月的 GDK 版本同时包含简化布局和旧版布局。从 2026 年 10 月 GDK 开始，安装程序默认仅安装简化布局。旧版布局仍可作为可选安装项进行选择，但它已被弃用，不再是推荐的开发路径。
>
> 从 2027 年 4 月 GDK 版本开始，旧版布局将不再受支持，并将从安装程序中移除。
>
> ***
>
> ### 示例
>
> 有关 Microsoft Game Development Kit (GDK) 中所含示例的完整列表，请参阅 [Microsoft Game Development Kit 示例](https://docs.xbox.com/zh-CN/home/setup-install/samples.md)。

> [tab] GDK 2510
>
> ## 2025 年 10 月 Microsoft Game Development Kit 新增功能
>
> Microsoft Game Development Kit (GDK) 是一整套工具、API、扩展和编程模型，可用于当前和未来的 Microsoft 游戏平台与计划。GDK 的设计和功能取决于你对自己喜欢的游戏开发方式所提供的反馈。有关完整介绍，请参阅[欢迎使用 Microsoft Game Development Kit](https://docs.xbox.com/zh-CN/home/setup-install/get-started.md)。
>
> 观看以下视频，快速了解 2025 年 10 月 GDK 中的新增功能。
>
> > [观看 GDK 更新视频](https://aka.ms/GDK-WhatsNewVideo)
>
> GDK 当前版本的发行说明可以在 XBOX 开发人员论坛上的 [GDK/XDK 发行说明空间](https://aka.ms/gdkreleasenotes)中找到。
>
> 除了修复许多 bug 之外，此版本还包含以下新功能。
>
> > [!NOTE]
> >
> > 本文包含公开功能。有关需要 NDA 访问权限的新增功能信息，请参阅 [2025 年 10 月 Microsoft Game Development Kit 新增功能 - NDA 功能](https://learn.microsoft.com/en-us/gaming/gdk/docs/gdk-dev/whatsnew/2510/whats-new-nda-2510)。
>
> ## 2025 年 10 月目录
>
> [开发人员工具](#developer-tools)\
> [输入](#input)\
> [系统](#system)\
> [Microsoft Azure PlayFab](#microsoft-azure-playfab)\
> [示例](#samples)
>
> ***
>
> ### 开发人员工具
>
> #### Submission Validator 自动更新
>
> 在 `MakePkg` 上使用 `/updatesubval` 标志可检查是否有新版本的 Submission Validator。如果有新版本，则会下载并解压缩 .zip 文件，并将新版本的 SubmissionValidator.dll 复制到 `bin` 目录（如果指定了 `/subvalpath`，则复制到备用位置）。
>
> #### XBOX Game Package Manager
>
> XBOX Game Package Manager (XGPM) 是一款新的桌面应用，可简化 XBOX 游戏的打包（XVC 和 MSIXVC 格式均支持）以及将其上传到 Microsoft 合作伙伴中心的流程。
>
> **功能**
>
> * **统一的工具：** 将 `MakePkg` 和 `PackageUploader` 的功能合并到一个直观的 UI 中。
> * **智能打包：** 使用已安装的 GDK 从松散文件自动生成包，为打包创建默认布局，并支持自定义替代。
> * **简化的上传：** 选择包、分支和市场组，然后使用基于浏览器的身份验证上传，无需客户端密码或证书。
> * **多租户支持：** 非常适合共同开发 XBOX 游戏的场景。
> * **辅助功能和本地化：** 完全支持讲述人、高对比度和 Tab 键索引导航。提供 en-US、ja-JP、zh-CN 和 ko-KR 本地化 UI。
>
> #### wdcapturesession PC 命令行工具
>
> `wdcapturesession` 是一款新的 PC 命令行工具，用于在游戏测试期间录制实时视频捕获。此工具使用 H264/高效视频编码 (HEVC)，以每秒 30 帧 (fps) 的速率在 PC 上开始和停止游戏捕获。
>
> #### MicrosoftGame.config 架构更新
>
> MicrosoftGame.config 文件的架构已更新，支持在游戏包中同时指定 ARM64 二进制文件和 x64 二进制文件。
>
> `Executable` 元素中新增了 `architecture` 属性，用于指定可执行文件是 ARM64 二进制文件还是 x64 二进制文件。Microsoft Game Config Editor 已更新，以支持这一新属性。
>
> #### Visual Studio 2026 Insiders 编译器和链接器
>
> [Visual Studio 2026 Insiders](https://devblogs.microsoft.com/visualstudio/visual-studio-2026-insiders-is-here/) 现已推出。2025 年 10 月 GDK 提供了一组 MSBuild 文件，用于使用 Visual Studio 2026 Insiders 编译器和链接器生成游戏。这些文件位于 `<GDK edition>\xbox\build\vs2026` 文件夹中。
>
> #### Visual Studio 项目模板
>
> Visual Studio 项目模板已从 GDK 安装程序中移除。现在可以从 [https://aka.ms/GDKVSExtensions](https://aka.ms/GDKVSExtensions) 下载功能相当的新式替代项。
>
> ***
>
> ### 输入
>
> #### 主机上的 GameInput 已更新
>
> 主机上的 `GameInput` 已更新，以支持 PC 上提供的最新功能。有关详细信息，请参阅 [GameInput 概述](https://aka.ms/gameinput)。
>
> ***
>
> ### 系统
>
> #### 跨平台游戏运行时
>
> 跨平台游戏运行时使不同商店（例如 Steam）和设备
> （例如 Steam Deck）上的游戏能够轻松地将 Microsoft Gaming Services 整合到游戏中。
> 跨平台游戏运行时允许开发人员将一个模块链接到游戏中，以启用：
>
> * XBOX 登录
> * XBOX 个人资料信息
> * XBOX 好友列表
> * XBOX 在线状态
> * XBOX 游戏邀请
>
> 跨平台游戏运行时还支持使用
> **PlayFab Game Saves** 实现跨平台进度同步。在 Windows 设备上，游戏存档会在游戏生命周期之外
> 无缝上传。在其他不支持游戏外生命周期上传的设备（例如 Steam Deck）上，
> 上传会在游戏内使用相同的 API 调用进行。
> PlayFab Game Saves 支持 XBOX、Steam 和基于发行商的玩家身份。
>
> > [!NOTE]
> >
> > 在非 Microsoft 商店中使用 XBOX 跨平台服务时，游戏可能需要征得商店所有者的许可。
>
> #### GDK 安装程序目录结构布局 UX
>
> 此版本的 GDK 包含 GDK 安装程序的新目录结构布局 UX，以简化开发人员体验并支持未来的扩展性。它简化了集成，支持不断增加的目标平台列表，并改进了对标准 MSBuild 平台和非 Microsoft 生成系统的支持。
>
> 2025 年 10 月和 2026 年 4 月的 GDK 版本同时包含简化布局和旧版布局。从 2026 年 10 月 GDK 开始，安装程序默认仅安装简化布局。旧版布局仍可作为可选安装项进行选择，但它已被弃用，不再是推荐的开发路径。
>
> 从 2027 年 4 月 GDK 版本开始，旧版布局将不再受支持，并将从安装程序中移除。
>
> ***
>
> ### Microsoft Azure PlayFab
>
> #### PlayFab Unified SDK
>
> PlayFab Unified SDK 现已包含在 GDK 中。此 SDK 将以前各自独立的 SDK 中的组件合并到一个现代化的包中。它提供一致的 API、新式内存和线程处理以及自动令牌刷新。
>
> 此 SDK 以 2023 PlayFab Services C/C++ SDK 中引入的改进为基础，并将这些改进扩展到所有 PlayFab 组件。PlayFab Unified SDK 采用模块化设计。这使你可以仅集成项目所需的功能，同时提供更简化、更可靠的开发体验。
>
> 有关详细信息，请参阅 [PlayFab Unified SDK](https://docs.xbox.com/zh-CN/gaming/playfab/sdks/unified-sdk/overview)
>
> #### PlayFab Game Saves
>
> PlayFab Game Saves 现已推出，首先支持 XBOX 和 Steam。此功能使玩家在切换平台、设备和商店时，能够在保留进度的情况下继续游戏。
>
> Game Saves 负责处理文件同步和冲突解决，帮助玩家保持单一的进度点，并完全支持脱机游戏。若要申请 Game Saves 访问权限，请在 [PlayFab Game Manager](https://developer.playfab.com/) 中选择你的游戏，导航到 Progression | Game Saves，然后加入等候名单。有关详细信息，请参阅 [Game Saves 文档](https://aka.ms/playfab-game-saves)。
>
> ***
>
> ### 示例
>
> 有关 GDK 中所含示例的完整列表，请参阅 [Microsoft Game Development Kit 示例](https://docs.xbox.com/zh-CN/home/setup-install/samples.md)。


## Related topics

- [Microsoft Game Development Kit (GDK) 发行说明](https://docs.xbox.com/zh-CN/announcements/gdk/release-notes.md)
- [在主机版 Microsoft Game Development Kit (GDK) 中使用 Clang](https://docs.xbox.com/zh-CN/tools/tools-console/visualstudio/vs-clang.md)
- [使用 Microsoft Game Development Kit (GDK) 工具安装并启动 PC 游戏](https://docs.xbox.com/zh-CN/tools/tools-pc/launching-on-pc.md)
- [提取 Microsoft Game Development Kit (GDK) 安装负载](https://docs.xbox.com/zh-CN/build/console-features/build-without-install/extract-setup-payload.md)
- [在 Microsoft Game Development Kit (GDK) 中使用 Clang](https://docs.xbox.com/zh-CN/tools/tools-pc/visualstudio/gr-vs-clang.md)