Fuchsia SDK 貢獻者指南

本節提供說明文件,協助您為 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 提升至 prebuilthost_tool 類別

如要讓 API 可供 Fuchsia SDK 中的預先建構二進位檔或主機工具使用,API 必須分別位於 prebuilthost_tool SDK 類別中。API 必須遵循 API 演進指南,該指南著重於在維持相容性的同時,啟用 API 演進。

請注意,將 API 提升至 partner 時,可能需要考量其他因素,這可能會在相容性和長期可用性之間做出取捨。

當 API 可供審查時,請填寫這份表單:goto.google.com/fuchsia-api-calibration-request,表示這個 API 指定的是新類別。

如果您無法存取該表單,請傳送電子郵件至 api-council@fuchsia.dev,指出您想宣傳的特定程式庫,API 委員會會後續通知後續步驟。

將 API 升級至「partner」類別

如要將 API 納入 partnerpublic SDK 類別的 Fuchsia SDK,必須克服兩個障礙:必須有準備就緒且願意使用的客戶,且 API 必須經過API 校正

如要申請 API 校正,請填寫這份表單:goto.google.com/fuchsia-api-calibration-request