全局选项
命令
info- 显示包元数据。compare- 比较两个包并报告差异。license- 显示签名密钥信息。osinfo- 显示 game OS 信息。chunkinfo- 显示 chunk 详细信息。fileinfo- 显示文件详细信息。extract- 从包中提取文件。set- 更改 PackageUtil 设置。
info
提供包信息,包括版本号、ContentID、ProductID、GameOS 版本和加密密钥 ID。参数
compare
比较基础包与更新包,报告差异,包括更新大小和更改的段。参数
选项
PackageUtil 会生成从基础包更新到更新包时所下载内容的 HTML 报告,其中包含估计的更新下载大小。
两个包都必须使用
/lk 加密或默认加密模式。请勿使用 /l,因为对于使用唯一内容许可证的包,比较结果不准确。
license
显示包上所使用签名密钥的信息,也可用于检查 EKB 文件是否与包匹配。 该命令报告以下值之一:- Submission signed (
/l) - 仅用于提交到合作伙伴中心。 - Test signed (
/lt) - 允许旁加载且未加密保护。
当前,
packageutil license 会将 /lk 签名的包报告为 /l 签名的包。参数
osinfo
提供 game OS 的相关信息,包括其 GUID 和四段版本号。参数
chunkinfo
提供包中 chunk 的相关信息,包括 chunk ID、chunk 大小和 Intelligent Delivery 修饰符。参数
fileinfo
提供包中文件的相关信息,包括文件名、大小和段详细信息。参数
extract
从包中将一个或多个文件提取到输出目录。Extract 仅支持 MSIXVC2 包。
Extract 只能从未加密的包中提取。例如,无法从 XBOX CDN 上的包文件提取。
选项
用法示例:
set
更改 PackageUtil 设置。使用set msixvc2 在当前设备上打开或关闭 MSIXVC2 开发者模式。
面向中间件和自定义工具的 JSON 输出
运行compare 时,PackageUtil 会在生成 HTML 报告的同时创建一个 JSON 伴随文件。中间件、引擎和自定义工具可利用此文件检查包布局、定位包二进制文件中的文件位置、验证对齐或提取结构信息,而无需解压包。
fileinfo 命令也会生成适合机器处理的结构化输出。
JSON 输出使用缩写字段名以保持文件较小。
