為 registry 做貢獻
公共 registry 位於 bricoop-releases,保存每一個已發布的 application 和 provider manifest。貢獻一個整合意味著撰寫 manifest、在本機校驗它,並提交一個可審查的拉取請求;合併後會發布一個 release manifest,Bricoop Desktop 會自動取得它。無論新增整合還是更新既有整合,流程都相同。
儲存庫結構
bricoop-releases 包含 applications/ 和 providers/ 目錄。每個整合有自己的子目錄,其中包含一個 metadata.yaml(顯示與歸屬資訊)、一個 stable.yaml(Bricoop 執行時讀取的固定 manifest)以及校驗器使用的 schema 檔案。新增一個整合意味著新增一個子目錄;更新一個整合意味著編輯既有的檔案。
驗證
提交前執行倉庫的校驗。校驗器會按 schema 檢查 manifest,驗證穩定 ID 與目錄匹配,並拒絕任何未知欄位,因為 schema 是 strict 的。在開啟拉取請求前修復每一個回報的問題;同樣的校驗會在 CI 中執行,並在 manifest 不乾淨前阻止合併。
拉取請求與發佈
帶著你的 manifest 變更向 bricoop-releases 提交一個可審查的拉取請求。維護者會審查 PR;合併後,發布流水線會發布一個新的 release manifest,Bricoop Desktop 在下一次更新檢查時取得它。整合如何從提案、維護到棄用與移除,見 registry 生命週期 頁面。