使用指南
发布版本
草稿与上线、回滚、删除语义,以及下载计数与趋势。
发布通过 CI 发布 里的 GitHub Action 或上传脚本完成,一般不需要手写上传协议。
草稿与上线
上传默认产生草稿:记录齐全,但不向用户开放,客户端看不到。
两种上线方式:
- 上传时直接发布,立即对用户开放。
- 事后在面板 Channels 标签页对草稿点 promote(admin / developer 角色)。草稿首次上线时记录发布时间,此后不可再变回草稿。
版本状态:
| 状态 | 含义 |
|---|---|
| 上传中 | 上传尚未完成,未产生版本 |
| 草稿 | 上传完成但未发布,面板可见、客户端不可见 |
| 当前 | channel 现在向用户开放的就是这一版 |
| 已发布非当前 | 仍可下载,老客户端不受影响 |
回滚
在面板把 channel 指回任意已发布版本即可。切换瞬间完成,客户端不会看到半新半旧。建议回滚而不是删除新版本。
删除语义
- 删除 version / channel / app 会同时删除它拥有的 S3 对象,不可撤销。
- 删除的是当前版本时,channel 回退到剩余最新已发布版本;无剩余则清空。
- 版本制品一经上传完成不可修改,只可删除。
下载计数与趋势
面板 Channels 标签页展示每个版本的下载与检查计数及趋势图(admin 与 content 角色可见)。