跳转到主要内容
命令在不同版本之间可能发生多大的变化,取决于 CLI 的版本以及帮助是否将该命令标记为 [Experimental]。命令组上的标签适用于该组中的每个命令。

1.0 之前

在 1.0 版本发布之前,XBOX CLI 处于预览阶段,任何命令都可能在版本之间发生更改或被删除,无论它是否标记为“实验性”。这包括其路径、参数、选项、默认值、结构化输出和退出代码。对于自动化,请固定使用经过测试的 CLI 版本,并在升级之前测试你的工作流。

自 1.0 起

自 1.0 版本发布起,未标记为“实验性”的命令会保持其记录的约定。会破坏自动化的更改只会出现在声明其为中断性更改的版本中。 该约定涵盖:
  • 命令和子命令路径。
  • 参数和选项的名称及含义。
  • 哪些输入是必需的。
  • 记录的默认值。
  • 记录的 JSON 输出,包括字段名称和含义。
  • 记录的退出代码。
新的命令、选项和 JSON 属性可能出现在任何版本中,因此你的脚本必须忽略无法识别的 JSON 属性。面向人员编写的输出(例如文本和表格)不属于该约定。

API 直通

当命令按原样返回服务的响应时(就像 xbox playfab api 那样),该响应遵循服务自己的兼容性约定,而不是 CLI 的约定。CLI 的输入、退出代码以及它添加的输出(例如 --data-only 会删除的响应信封)仍在该约定的涵盖范围内。

实验性

实验性命令的发布目的是收集对其接口的反馈。即使在 1.0 之后,其路径、选项、默认值、输出和行为也可能发生更改,或者这些命令可能被删除,因此请勿依赖使用它们的自动化保持兼容。 实验性命令已完成并经过测试,并且遵循与其他所有命令相同的安全性和安全规则,包括在执行破坏性操作之前进行确认。它们的运行方式与其他任何命令相同;你无需启用它们。
最后修改于 2026年11月19日