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