目录

Developers

为 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 生命周期 页面。

版本: sha256:2acc9d0cf757a7a0ce571045545b8099ccdd61cc08bfb8999dd9f0a8992a41fd 编辑此页