提交消息选项

将更改上传到 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> 将多次运行给定测试。这有助于确认特定测试是否不稳定。

例如:

Multiply: socket-integration

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

Run-All-Tests

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

Cq-Include-Trybots

除了默认的一组提交前构建器之外,Cq-Include-Trybots <list> 还会在提交前运行给定构建器来检查更改。

例如:

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

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

使用 Gerrit 中的 Choose Tryjobs 下拉菜单查看完整的可用构建器列表。