将更改上传到 Fuchsia 的 Gerrit 实例时,有各种选项可以更改提交前的行为。这些选项由添加到更改的提交消息中的特殊字符串表示。
本页介绍了可用于 Fuchsia 预提交的选项。
Buganizer 问题选项
这些选项用于控制 Buganizer 中的关联 bug。
bug
Bug: #
会在提交更改时为给定的 Buganizer 问题添加评论。
例如:
Bug: 372314445
上述代码行会导致此注释。
固定
Fixed: #
会在提交更改时为给定的 Buganizer 问题添加评论,并将其标记为“已修复”。
例如:
Fixed: 297456438
上面一行生成了此注释,并生成了该问题的状态更改。
测试选项
这些选项用于控制测试的执行方式。
乘号
Multiply: <test name>
将多次运行给定测试。这有助于确认特定测试是否不稳定。
例如:
Multiply: socket-integration
上述代码行会多次重新运行“套接字集成”测试。
运行所有测试
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 中的选择 tryjobs 下拉列表,查看全部可用的构建器。