Skip to main content
创建应用程序包、将包上传到合作伙伴中心,并执行相关的打包操作。makepkg 支持 XVC、MSIXVC 和 MSIXVC2 包格式。使用 /msixvc2 选项生成 MSIXVC2 格式的包。

全局选项

命令

  • pack - 使用磁盘上的文件创建新的应用程序包。
  • upload - 将包或文件目录上传到合作伙伴中心。
  • genkey - 生成用于 pack /lk 的加密密钥。
  • genid - 在 Product ID GUID 与 Store ID 之间转换。
  • genmap - 基于磁盘上的内容生成映射 XML 文件。
  • validate - 在不创建包的情况下运行验证。
  • updatesubval - 单独更新 SubmissionValidator.dll,不运行其他操作。
  • localize - 基于磁盘上的内容生成 Resources.pri 文件。

pack

使用磁盘上的文件创建新的应用程序包。
用法示例:

选项

备注

默认情况下,makepkg pack 使用所有开发工具包都识别的众所周知的测试加密密钥加密 XVC 或 MSIXVC 包。这些包并未加密保护。 为了在上传时提供额外保护,XVC 和 MSIXVC 包可以使用 /l/lk。使用 /l 的包上传前不能安装到开发工具包或 PC 上。使用 /lk 的包可在上传前安装到开发工具包上。无论使用哪种上传加密模式,XBOX 服务都会使用 Microsoft 管理的加密密钥重新加密包以进行分发。 MSIXVC2 包不使用客户端上传加密。XBOX 服务会处理用于分发的加密。 有关映射文件架构的信息,请参阅部署包架构

upload

将包上传到合作伙伴中心。对于 MSIXVC2,指定 /dupload 命令还可将散文件打包并在一次操作中上传。散文件上传需要 /msixvc2 选项。 如果未指定分支或飞行版,包将上传到 main 分支。 EKB 文件和 Submission Validator 日志文件应与包位于同一目录中,并会自动上传。存在符号包时也会一并上传。Store ID 会从包中提取,若生成包时未提供 Store ID,也可通过参数提供。
用法示例(上传已构建的包):
用法示例(打包并上传散文件):

包来源选项

目标选项

身份验证选项

验证与符号选项

身份验证方法

genkey

生成用于 pack /lk 的本地托管密钥数据块 (LEKB)。
在包创建过程中将 LEKB 文件提供给 makepkg pack /lk,可使用稳定的加密密钥。此密钥:
  1. 允许 packageutil compare 生成准确的更新大小估算。
  2. 使用主机和 PC 下载内容更新时相同的算法,向合作伙伴中心进行安全增量上传。
  3. 生成可安装到开发工具包上的包。
  4. 使用只能在特定环境中解密的安全加密密钥材料。
LEKB 文件包含轻度混淆的加密密钥材料。任何同时持有 LEKB 文件和相应包的人都能解密该包,因此需要妥善保管该文件。

genid

在 Product ID GUID 与 Store ID 之间转换。

genmap

基于磁盘上的内容生成映射 XML 文件。生成的文件包含一个块,可以编辑以将内容拆分为多个块或添加 Intelligent Delivery 标签。

validate

在不创建包的情况下运行包验证。使用此命令可在执行完整 pack 操作前验证内容和配置。
validate 命令接受与 pack 相同的选项。

updatesubval

下载、验证并安装最新的 SubmissionValidator.dll,且不创建、验证或上传包。

选项

备注

如果 SubmissionValidator.dll 已是最新版本,命令会报告文件为最新并成功退出而不进行下载。如果文件缺失,命令会进行安装。成功时,命令会显示磁盘上 SubmissionValidator.dll 的版本。 与打包或验证过程中使用的 /updatesubval 选项不同,独立的 updatesubval 命令在更新失败时返回非零退出码。作为选项使用时,更新失败并非致命的,打包或验证操作会继续使用已安装版本的 SubmissionValidator.dll。

localize

基于磁盘上的内容生成 Resources.pri 文件。
有关详细信息,请参阅 MicrosoftGame.config 本地化

相关主题

MSIXVC2 打包概述 针对 PC 的 MSIXVC2 入门 部署包架构 XBOX Game Package Manager 自动化包上传
最后修改于 2026年8月24日