為 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))