Fuchsia 中的每個檔案都有一組擁有者。透過檔案追蹤
名為 OWNERS
。其中一個檔案位於
和許多目錄都有各自的 OWNERS
檔案。
目錄
每個 OWNERS
檔案都會逐一列出個別使用者 (依電子郵件地址)
並可針對該目錄的內容提供程式碼審查。
職責
Fuchsia 需要變更「Code-Review +2
」的評論,
「OWNERS」檔案此外,有很多 OWNERS
檔案。
包含 *
,允許任何人提供此類 +2
。
工具
蓋瑞有「建議擁有者」這個按鈕會列出所有 特定變更中修改的檔案詳情請參閱 Gerrit code-owners 外掛程式網頁。
格式
Fuchsia 將 Gerrit 檔案語法用於 OWNERS
檔案。
以下是 OWNERS
的範例檔案:
# These users are owners
validuser1@example.com
validuser2@example.com
# Users listed elsewhere are also owners
include /path/to/another/OWNERS
# This user is only an owner of the listed file
per-file main.c = validuser3@example.com
最佳做法
OWNERS
檔案中必須至少有兩位使用者。設有區域 會導致單一擁有者的 Fuchsia 帳單發生單點故障。擁有多個 業主確保 Fuchsia 的職場人員互相分享知識和擁有權。- 在適當的情況下,
include
來自其他檔案的擁有者,而非列出個別使用者。 這會產生較少「可靠資料來源」並簡化 OWNERS 的維護工作
擁有者覆寫
在某些情況下,變更的作者可能會想覆寫 OWNERS 通過核准。這主要會發生在 大部分都屬於機械,但接觸大部分的程式碼集, 例如對常用 API 簽章進行微幅變更CL 作者可將 owner-override@fuchsia.dev 加入評論者清單 要求擁有者覆寫設定請謹慎運用這項程序 一般而言,我們建議當地擁有者進行審查; 減輕開發人員負擔