跳转到主要内容
MSIXVC2 自 2026 年 10 月 GDK 起正式可用。 MSIXVC2 是新一代 PC 打包格式,提供大幅缩减的更新、更快的打包以及简化的上传工作流。如果你正在启动新的 PC 游戏或评估打包选项,请参阅 MSIXVC2 打包概述和针对 PC 的 MSIXVC2 入门。本页面的步骤适用于原始 MSIXVC 格式,该格式仍完全受支持。
按照以下步骤创建可在目标测试开发 PC 上旁加载测试的 MSIXVC 包,然后提交到 Partner Center 进行发布。

检查 Windows 10 版本的最低要求

MSIXVC 包的部署测试需要 Windows 10 版本 18362 或更高版本。

评估打包需求

如果你的包具有以下任一属性或需要以下任一功能,请参阅本文后面的其他打包考虑事项与高级功能一节。
  • 框架包依赖 如果你的应用依赖可再分发软件,可以使用 Microsoft 提供的许多此类先决条件的预打包版本,并将其声明为依赖项以便自动安装。
  • 自定义安装操作 如果你的应用依赖没有可用框架包的可再分发软件,可以链式安装这些依赖。

准备内容

将你游戏的所有源材料放入一个目录。移除 MSIXVC 打包系统不支持或不适合在零售包中发行的文件。
  • 程序数据库 (PDB) 文件。
  • 通用 Windows 平台 (UWP) 和 APPX 的 footprint 文件,包括 AppxSignature.p7x 和 AppxBlockMap.xml。如果你之前以 UWP 形式在 Microsoft Store 发行,可能会有一些与 APPX 或 MSIX 包相关的此类文件。请移除它们。
  • 对其他 PC 游戏商店的任何引用:资源、二进制文件等。

从 Partner Center 获取产品身份信息

你的包会引用在 Partner Center 中分配给你游戏的产品身份,包括发行商身份、PackageFamilyName、MSAAppId 和 TitleId。设置你的产品,然后从 Game Setup | Identity 页面获取这些信息以在 MicrosoftGame.config 中使用。
  1. 如果尚未注册,请注册 ID@XBOX 项目并创建 Partner Center 账户。
  2. 在 Partner Center 为你的游戏创建初始产品定义。
  3. 在产品的 Game Setup | Identity 页面上,查找上述身份值。

在根文件夹中创建 MicrosoftGame.config XML 文件,然后创建其余游戏内容

本文后面提供了一个 MicrosoftGame.config xml 示例文件。可将此示例与 MicrosoftGame.config 编辑器结合参考使用,该编辑器可简化 .config 文件的创建,并自动从 Partner Center 项目同步 ID 和名称值。

识别所有 Visual C/C++ 运行时依赖项

识别包的 Visual C/C++ 运行时依赖项。确保它们已作为依赖项列在你的 MicrosoftGame.config 中或明确复制到包负载中。有关详细信息,请参阅框架包依赖。

创建用于在 shell 和商店包中显示的图标

对于以下 MicrosoftGame.config 示例中列出的每个图像,请将相应文件按指定尺寸缩放后放入游戏的根文件夹。或者,将图像资源放入子目录中,并相应调整 ShellVisuals 图标路径。MicrosoftGame.config 编辑器可从单个源图像生成这些图像。

安装包含 MakePkg.exe 打包工具的 Microsoft Game Development Kit

默认情况下,Microsoft Game Development Kit (GDK) 命令提示符位于以下文件夹:C:\Program Files (x86)\Microsoft GDK\Command Prompts

创建打包布局映射文件

在包含单一游戏内容文件夹的目录中打开 Microsoft Game Development Kit (GDK) 命令提示符,然后运行以下命令: MakePkg genmap /f layout.xml /d <Your_game_folder> 此命令会创建名为 layout.xml 的文件(此文件名为建议名,你也可以使用其他名称)。在打包步骤中使用此文件。有关打包工具的更多信息,请参阅 Make package (makepkg.exe)。

使用 Intelligent Delivery 判断如何缩减安装大小

要了解如何通过在 layout.xml 文件中为内容打标签来缩减安装大小,请参阅 Intelligent Delivery 概述。如果你有较大的本地化资源,或有默认不安装、需要由游戏触发下载的内容,可考虑使用 Intelligent Delivery。

创建包

使用以下命令创建包: MakePkg pack /f layout.xml /lt /d <Your_game_folder_name> /nogameos /pc /pd <Output_Folder_Name> 对于依赖许可证的场景(例如游戏内商店和试用),请对 makepkg 使用实际的内容 ID。Partner Center 在首次接收包时会生成此真实内容 ID。你可以在包页面上已提交包的详细信息中找到它。

在目标 PC 上启用开发者模式

  1. 打开设置。
  2. 在搜索字段输入 Developer。在显示的选项中选择 Use developer features。
  3. 选择 Developer mode。系统会出现一个对话框,提示正在添加某些功能。请等待此过程完成后再继续。

测试应用安装

运行以下命令:Wdapp install <Your_Package.msixvc> 包必须位于开发 PC 的本地驱动器上,或已映射到驱动器盘符的网络位置。尚不支持通过 UNC 共享安装。如果看不到进度,可打开 Microsoft Store 应用,在应用右上角向下箭头指示的下载和更新部分查看进度(如可用);也可选择省略号 (…),然后选择下载和更新。 自 2022 年 3 月的 Microsoft Game Development Kit (GDK) 起,MSIXVC 包安装到 [drive]:\XboxGames 文件夹,并以平铺文件方式布置,你可直接修改和访问。此驱动器位置可通过应用程序管理 (wdapp.exe)配置。有关平铺文件安装功能的更多信息,请参阅平铺文件安装概述。

准备最终包,然后提交到 Partner Center

之前使用 MakePkg.exe 命令创建的包使用了 /LT 参数,这会使用测试或开发密钥加密。为获得最大安全性,请再次运行 MakePkg.exe 命令并使用 /LK 标志(使用稳定密钥加密)或 /L 标志(使用唯一密钥加密)。使用 /LK 而非 /L,因为使用 /LK 创建的包可用于本地大小差异比较,并在向 Partner Center 提交时受益于增量上传优化。

MicrosoftGame.config 示例

创建名为 MicrosoftGame.config 的文件。在游戏内容的根目录中使用以下内容,然后移除你不需要项目的注释。 虽然你可以手动创建 MicrosoftGame.config,但最佳方式是使用 MicrosoftGame.config 编辑器。此工具还可轻松地直接从 Partner Center 项目同步身份和 ID 值。

其他打包考虑事项与高级功能

面向常见软件依赖的框架包

如果你的应用依赖某种可再分发软件,且该软件在 Microsoft Store 中作为框架包提供,请声明对该框架包的依赖,而不是链式安装可再分发组件。 例如,如果你的应用使用旧版 DirectX 运行时(以前通过 Microsoft 下载站点的 dxsetup.exe 提供),请与标准的 Windows.Universal 和 Windows.Desktop 依赖一起声明对该框架包的依赖,如下所示。此方式优于通过自定义安装操作直接安装 redist,因为框架包可通过 Microsoft Store 自动更新,而自定义安装操作需要管理员批准并会在安装过程中产生确认提示。
有关已知依赖的完整列表,请参阅 MicrosoftGame.config 元素 - KnownDependency的文档。 安装时,操作系统和 Microsoft Store 会确保此包依赖与你的应用一同安装。有关详细信息(包括 DirectX 和 Visual Studio C/C++ 运行时框架包依赖),请参阅框架包依赖。

mod 支持

自 2022 年 3 月的 Microsoft Game Development Kit (GDK) 起,默认支持 mod。有关详细信息,请参阅 mod。

自定义安装操作

如果你的应用依赖其他必须在应用安装时链式安装的安装程序(.exe 或 .msi 文件),请使用 CustomInstallActions 元素配置此步骤。 对于可再分发组件,在决定为诸如 VC 运行时或 DirectX 可再分发 .exe 或 .msi 文件使用自定义安装程序之前,请检查是否存在包含所需先决条件的框架包。有关自定义安装操作的详细说明,请参阅自定义安装操作。

受限能力权限

除了配置 MicrosoftGame.config 文件以包含正确元素之外,还需要发邮件给你的客户经理启用为你的游戏使用以下功能的权限。
  • 自定义安装操作 (CustomInstallActions 元素)。

相关打包文章

MSIXVC2 打包概述 针对 PC 的 MSIXVC2 入门 XBOX 主机游戏打包入门 MicrosoftGame.Config 利用 Microsoft Game Development Kit 工具安装并启动 PC 游戏 PC 引导程序
最后修改于 2026年10月20日