本節提供說明文件,協助您為 Fuchsia API 介面和 IDK 做出貢獻。
從技術層面來說,這個指南更適合稱為「IDK 貢獻者指南」,因為組成 API 介面的 API 和程式庫會先加入 IDK,然後再轉換為 SDK 發行版本。不過,在口語和程式碼中,我們幾乎只會說「SDK」。無論如何,如果您想以某種方式「變更 SDK」,這裡應該是您要找的地方。
在 SDK 中貢獻 API
如要為 Fuchsia API Surface 做出貢獻,請按照下列步驟操作:
評估變更幅度。
- 如果您對 API 有小幅的漸進式變更,請完成「在 Gerrit 中建立變更」一文中的步驟,以便貢獻變更,就像對任何 Fuchsia 原始碼變更一樣。
如果您對 API 進行重大變更,也就是大幅擴充 API 功能或大幅修改 API 的變更,請採取以下行動:
建立 RFC,說明您對 API 所做的修改設計。
這項 RFC 應透過一般 RFC 程序進行審查。相關領域的 API 審查人員應是 RFC 的利益相關者。請參閱 Fuchsia API 委員會章程,瞭解如何找出 API 審查人員。
在 API RFC 獲得核准後,請按照「在 Gerrit 中建立變更」一文中的步驟提交變更,就像提交任何 Fuchsia 原始碼變更一樣。
向 API 委員會成員申請程式碼審查。根據您要修改的 Fuchsia API 領域,選取 API 委員會審查員。如需 API 委員會成員名單和他們專注的領域,請參閱 Fuchsia API 委員會章程中的「會員」一節。
將 API 提升至 prebuilt
或 host_tool
類別
如要讓 API 可供 Fuchsia SDK 中的預先建構二進位檔或主機工具使用,API 必須分別位於 prebuilt
或 host_tool
SDK 類別中。API 必須遵循 API 演進指南,該指南著重於在維持相容性的同時,啟用 API 演進。
請注意,將 API 提升至 partner
時,可能需要考量其他因素,這可能會在相容性和長期可用性之間做出取捨。
當 API 可供審查時,請填寫這份表單:goto.google.com/fuchsia-api-calibration-request,表示這個 API 指定的是新類別。
如果您無法存取該表單,請傳送電子郵件至 api-council@fuchsia.dev,指出您想宣傳的特定程式庫,API 委員會會後續通知後續步驟。
將 API 升級至「partner
」類別
如要將 API 納入 partner
或 public
SDK 類別的 Fuchsia SDK,必須克服兩個障礙:必須有準備就緒且願意使用的客戶,且 API 必須經過API 校正。
如要申請 API 校正,請填寫這份表單:goto.google.com/fuchsia-api-calibration-request。