擁有者

Fuchsia 中的每個檔案都有一組擁有者。而是在名為 OWNERS 的檔案中進行追蹤。其中一個檔案在存放區的根目錄中，而許多目錄也有自己的 OWNERS 檔案。

目錄

每個 OWNERS 檔案都會列出幾位熟悉的電子郵件地址，他們熟悉且可以針對該目錄的內容提供程式碼審查。

責任感

Fuchsia 要求變更的內容必須是 Code-Review +2 評論，而「OWNERS」檔案中的所有人皆可提供。此外，許多 OWNERS 檔案都含有 *，可讓任何人提供這類 +2。

工具

並有一個「建議擁有者」按鈕，可列出特定變更中修改的所有檔案的所有擁有者。詳情請參閱 Gerrit 程式碼擁有者外掛程式頁面。

格式

Fuchsia 針對 OWNERS 檔案使用 Gerrit 檔案語法。

以下是 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 新增至審查者清單，以要求擁有者覆寫。請盡量謹慎使用這項程序，且如果本機擁有者未造成工作負擔，或對開發人員造成負擔，建議採用此程序。