跳转到主要内容
程序包是 Partner Center 已接收并处理的游戏生成。package 命令可列出和获取游戏的程序包,以便你检查某个程序包是否已准备好用于 游戏测试。若要上传程序包,请参阅上传程序包。 这些命令属于实验性命令:其选项和输出可能会更改。请参阅 实验性命令。它们需要对该游戏具有 Partner Center 的程序包“读取”权限,开发人员角色包含此权限。

命令

参数和选项

卖家来自 --seller-id 或你已保存的卖家;请参阅上下文。如果两者都没有,命令会使用你唯一的卖家;如果你属于多个卖家,则会要求提供 --seller-id。 --xbox-title-id 始终需要卖家。

列出程序包

package list 写入游戏 Main 分支的 ID 以及一个 packages 数组,其中包含服务返回的每个字段。package get 以相同的结构写入一个程序包。摘录如下:
当以下所有条件都为 true 时,程序包即可用于游戏测试:
  • processingState 为 Processed。它会从 PendingUpload 经过 Uploaded 和 Processing 变为 Processed,或者变为 ProcessFailed。
  • validationItems(Partner Center 在处理程序包时发现的问题)中没有严重性为 Error 的项。
  • isAvailableForPlaytest 为 true。
--output table 包含 PACKAGE ID、VERSION、PLATFORM、STATE、PLAYTEST 和 CREATED 列。它不显示验证结果,因此请在 JSON 中检查 validationItems。

上传程序包

CLI 不会上传程序包。请使用 XBOX Game Development Kit (GDK) 中的 makepkg 上传程序包;请参阅 makepkg 参考; 对于从持续集成 (CI) 上传,请参阅 Package Uploader。 然后运行 package list 以检查程序包是否已准备就绪。

错误

无论 --output 是什么,错误都会以文本形式输出到 stderr,其中包含关联 ID。--verbose 会添加响应正文。失败时会以 1 退出。

示例

最后修改于 2026年11月19日