為 Zircon 貢獻心力

以下是 Zircon 修補程式的一般準則。

程序

  • 按照「貢獻變更」中所述的 Fuchsia 修補程式程序進行。

  • 修補程式會透過 Gerrit 程式碼審查進行處理。

  • 確保每次變更時，所有主要目標 (x86-64、arm64) 都能建構 Zircon。使用 fx multi bringup-cq 即可建構 Zircon。詳情請參閱針對所有目標建構 Zircon。

  • 避免破壞單元測試。啟動 Zircon 並執行測試，確認所有測試都通過。

  • 請避免使用空白字元或樣式變更。特別要注意的是，請勿將樣式變更與包含其他變更的修補程式混合使用，因為樣式變更往往會讓人分心。使用 fx format-code 即可採用一致的樣式設定程式碼格式。

  • 請盡量避免一次輕觸多個模組的變更。大部分的變更應著重於單一程式庫、驅動程式庫、應用程式等。

Zircon 的說明文件

撰寫說明文件是不錯的點子，建議您撰寫：

  • 說明文件應儲存在 Markdown 檔案中。
  • Zircon 說明文件位於 /docs/concepts/kernel。
  • 提交說明文件之前，請確認 Markdown 能正確顯示。

編輯或新增 syscalls 或 cmdlines 時，請更新以下項目：

附註

如何淘汰 #define 常數

您可以建立已淘汰的 typedef，並將常數定義轉換為該類型。產生的警告或錯誤包含已淘汰的 typedef 名稱。

typedef int ZX_RESUME_NOT_HANDLED_DEPRECATION __attribute__((deprecated));
#define ZX_RESUME_NOT_HANDLED ((ZX_RESUME_NOT_HANDLED_DEPRECATION)(2))