以下是 Zircon 修補程式的一般準則。
程序
請按照「貢獻變更」一文所述的 Fuchsia 修補程式程序操作。
修補程式是透過 Gerrit Code Review 處理。
請確保 Zircon 可針對所有主要目標 (
x86-64、arm64) 建構,使用fx multi bringup-cq,讓 Zircon 可建構。詳情請參閱「為所有目標建構 Zircon」。避免中斷單元測試。啟動 Zircon 並執行測試,確認所有測試都通過。
請勿加入空白字元或變更樣式。尤其是不要將樣式變更與包含其他變更的修補程式混用,因為樣式變更通常會造成干擾。使用
fx format-code以一致的樣式設定程式碼格式。請盡可能避免一次變更多個模組。大部分變更應針對單一程式庫、驅動程式庫、應用程式等。
Zircon 說明文件
建議您編寫說明文件:
- 說明文件應採用 Markdown 檔案格式。
- Zircon 說明文件位於
/docs/concepts/kernel。 - 提交文件前,請確認 Markdown 轉譯結果正確無誤。
編輯或新增 syscalls 或 cmdlines 時,請更新下列項目:
- 核心
cmdline選項清單,位於/docs/reference/kernel/kernel_cmdline.md。
附註
如何淘汰 #define 常數
您可以建立已淘汰的 typedef,並將常數定義轉換為該型別。系統產生的警告或錯誤訊息會包含已淘汰 typedef 的名稱。
typedef int ZX_RESUME_NOT_HANDLED_DEPRECATION __attribute__((deprecated));
#define ZX_RESUME_NOT_HANDLED ((ZX_RESUME_NOT_HANDLED_DEPRECATION)(2))