提交消息选项

将更改上传到 Fuchsia 的 Gerrit 实例时,有多种选项可以更改预提交的行为。这些选项通过添加到更改的提交消息中的特殊字符串来表示。

本页面介绍了可用于 Fuchsia 预提交的选项。

Buganizer 问题选项

这些选项用于控制 Buganizer 中的关联 bug。

bug

Bug: # 会在提交更改时针对给定的 Buganizer 问题添加评论。

例如:

Bug: 372314445

上述行导致了此评论

固定

Fixed: # 添加注释,并在提交更改时将指定的 Buganizer 问题标记为“已修复”。

例如:

Fixed: 297456438

上述行导致了问题上的此评论和状态更改。

依赖性变更选项

Depends-on

Depends-on: <other-change-id> 将相应更改标记为依赖于另一项更改(可能位于单独的代码库中)。

在提交所有依赖项之前,带有 Depends-on 页脚的更改将无法提交,并且在预提交测试期间,所有依赖项也会被修补。

例如:

Depends-on: Idc82d1483b4be8480aaa87bb48af8d03cfa45858

测试选项

这些选项用于控制测试的执行方式。

乘号

Multiply: <test name> 将多次运行给定的测试。 这有助于确认特定测试是否可靠。这适用于由 CQ 触发的构建器,也适用于使用选择 Tryjob 下拉菜单手动触发的构建器。

例如:

Multiply: socket-integration

上述命令会多次重新运行“socket-integration”测试。

运行所有测试

Run-All-Tests: true 运行所有测试,即使静态分析将它们标记为不受更改影响。当所做的更改可能会隐式影响整个系统时,此选项非常有用,例如对 Zircon 内核、组件框架、测试管理器或诊断功能所做的更改。

Cq-Include-Trybots

Cq-Include-Trybots <list> 除了默认的预提交 build 之外,还会在更改的预提交过程中运行给定的 build。

例如:

Cq-Include-Trybots: luci.fuchsia.try:fuchsia-coverage-absolute

上述行强制执行 fuchsia-coverage-absolute 以及预提交的其他作业。

使用 Gerrit 中的 Choose Tryjobs 下拉菜单可查看所有可用的构建器。