Zircon 貢獻者指南

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

程序

  • 請按照「貢獻變更」一文所述的 Fuchsia 修補程式程序操作。

  • 修補程式是透過 Gerrit Code Review 處理。

  • 請確保 Zircon 可針對所有主要目標 (x86-64arm64) 建構,使用 fx multi bringup-cq,讓 Zircon 可建構。詳情請參閱「為所有目標建構 Zircon」。

  • 避免中斷單元測試。啟動 Zircon 並執行測試,確認所有測試都通過。

  • 請勿加入空白字元或變更樣式。尤其是不要將樣式變更與包含其他變更的修補程式混用,因為樣式變更通常會造成干擾。使用 fx format-code 以一致的樣式設定程式碼格式。

  • 請盡可能避免一次變更多個模組。大部分變更應針對單一程式庫、驅動程式庫、應用程式等。

Zircon 說明文件

建議您編寫說明文件:

  • 說明文件應採用 Markdown 檔案格式。
  • Zircon 說明文件位於 /docs/concepts/kernel
  • 提交文件前,請確認 Markdown 轉譯結果正確無誤。

編輯或新增 syscallscmdlines 時,請更新下列項目:

附註

如何淘汰 #define 常數

您可以建立已淘汰的 typedef,並將常數定義轉換為該型別。系統產生的警告或錯誤訊息會包含已淘汰 typedef 的名稱。

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