本節包含針對 Fuchsia API 介面和 IDK 做出貢獻的說明文件。
根據技術層面,可能更適合用來呼叫本「IDK 貢獻者指南」,因為構成 API Surface 的 API 和程式庫會先新增至 IDK,接著再轉換為 SDK 發布。不過在口頭和程式碼中,我們幾乎只會說「SDK」。無論如何,如果您想以某種方式「變更 SDK」,就可能是在正確的位置。
提供給 SDK 中的 API
如要為 Fuchsia API Surface 做出貢獻,請按照下列步驟操作:
評估變化幅度大至小。
- 如果您對 API 進行了微幅的增量變更,請完成「在 Gerrit 中建立變更」一文中的步驟提供變更,做法如同對任何 Fuchsia 原始碼變更一樣。
對 API 進行重大變更 (也就是對 API 函式大幅擴充或大幅修改 API 的變更),請執行以下操作:
建立 RFC,說明修改 API 的設計。
這項 RFC 應透過一般 RFC 程序檢查。相關領域的 API 審查人員應是 RFC 中的相關人員。請參閱 Fuchsia API Council Charter 以識別 API 審查人員。
核准 API RFC 後,請完成「在 Gerrit 中建立變更」一文中的步驟,進行所有 Fuchsia 原始碼變更。
向 API 委員會成員要求審查程式碼。根據要修改的 Fuchsia API 區域,選取 API 委員會審查人員。如需 API 委員會成員及其重點領域清單,請參閱 Fuchsia API 議會憲章中的會員資格。
將 API 升級為 partner_internal
類別
如果 API 要納入 partner_internal
SDK 類別的 Fuchsia SDK,必須遵守 API 演進指南,該指南旨在在維持相容性的同時實現 API 演進。
請注意,將 API 升級為合作夥伴時,還需要考量其他事項,這或許有助您在相容性和長期使用性之間做出取捨。
API 準備好進行審查後,請填寫這份表單要求 API 校正:goto.google.com/fuchsia-api-calibration-request,表示這個 API 適用於 partner_internal
類別。
如果您無法存取該表單,請傳送電子郵件至 api-council@fuchsia.dev 指出您要宣傳的特定程式庫或程式庫,API 委員會會後續處理後續步驟。
將 API 升級為 partner
類別
如果要將 API 納入 partner
或 public
SDK 類別的 Fuchsia SDK,就必須清除以下兩個面向:必須準備就緒且願意的客戶,且 API 必須通過 API 校正。
如要提出 API 校正申請,請填寫這份表單:goto.google.com/fuchsia-api-calibration-request。