修訂訊息選項

將變更上傳至 Fuchsia 的 Gerrit 執行個體時,有許多選項可以變更預先提交的行為。這些選項會以特殊字串的形式,加到變更的提交訊息中。

本頁面說明 Fuchsia 預先提交可用的選項。

Buganizer 問題選項

這些選項可控管 Buganizer 中的相關錯誤。

錯誤

Bug: # 提交變更時,在指定的 Buganizer 問題中新增註解。

例如:

Bug: 372314445

上述程式碼行會產生這個註解

固定

Fixed: # 新增註解,並標示為「已修正」,提交變更時會提供指定的 Buganizer 問題。

例如:

Fixed: 297456438

上述程式碼行會在問題中產生這則留言,並變更狀態。

依附變更選項

Depends-on

Depends-on: <other-change-id> 將變更標示為依附於另一項變更 (可能位於不同的存放區)。

所有依附元件都提交後,才能提交含有 Depends-on 頁尾的變更,且預先提交測試期間也會修補所有依附元件。

例如:

Depends-on: Idc82d1483b4be8480aaa87bb48af8d03cfa45858

測試選項

這些選項可控制測試的執行方式。

乘號

Multiply: <test name> 會多次執行指定測試。 這有助於確認特定測試是否穩定。這項規定適用於由 CQ 觸發的建構工具,以及使用「選擇 Tryjobs」下拉式選單手動觸發的建構工具。

例如:

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」下拉式選單,即可查看所有可用的建構工具。