- 启动后自动检查一次,发现更高版本或同版本号的新构建时弹窗提示;同一个构建只提示一次,之后不重复打扰。首次启动若已是最新或三路都查询失败,会短暂提示一次检查结果。此外只在用户进入“设置 → 检查更新”并点击按钮后发起请求。没有后台轮询、定时任务或自动下载。
- 只读取版本清单,不上传设备标识、卡号、BIN、证件信息或使用统计。
- 只使用 HTTPS;应用 Manifest 中的
INTERNET权限仅用于更新检查和预览版 / 开发版的局域网读卡桥接服务。 - 下载在浏览器中完成,应用不静默安装 APK。
| 来源 | 清单地址 | 下载根路径 |
|---|---|---|
| 官网 | https://superreader.828696.xyz/data/releases.json |
https://superreader.828696.xyz/ |
| GitHub | https://raw.githubusercontent.com/ZSOF-Rui/SuperReader/main/site/data/releases.json |
https://raw.githubusercontent.com/ZSOF-Rui/SuperReader/main/site/ |
| 镜像站 | https://superreader-update-ch09cuq83vg.qoder.website/data/releases.json |
https://superreader-update-ch09cuq83vg.qoder.website/ |
三处读取同一份 site/data/releases.json。应用并发请求,连接超时 8 秒、读取超时 10 秒,允许 HTTPS 重定向;任一来源成功即可返回结果,三处都失败才显示失败。
部分网络会阻断 raw.githubusercontent.com,此时 GitHub 路径可能返回连接错误;官网或镜像站仍可完成检查。应用会分别显示三个来源的状态,不会把“某一路失败”误报成“已是最新”。镜像站只保留最新两个安装包,旧版本下载仍以官网与 GitHub 为准。
{
"schemaVersion": 1,
"channels": {
"stable": {
"label": "正式版",
"packageName": "com.superreader.app",
"latest": {
"versionName": "2.0.1",
"versionCode": 21,
"releasedAt": "2026-11-09T20:50:00+08:00",
"buildId": "20261109T124543Z",
"builtAt": 1794228343605,
"file": "downloads/SuperReader-2.0.1.apk",
"sizeBytes": 13787682,
"sha256": "3d52c2ad4e31f0584c9dc9469e9b9c9f47bd56d3a5c40789e1b4998a07983eb9",
"notes": ["…"]
},
"history": []
}
}
}schemaVersion目前为1。- 应用按构建渠道读取
stable或preview;预览版不会拿正式版清单比较。 - 正式版只接受
packageName = com.superreader.app,预览版只接受com.superreader.app.preview;开发版跳过包名校验。 versionCode必须为正整数;大于当前安装版本时直接视为更新。buildId是构建标识,builtAt是构建时间的 Unix 毫秒;两者可选。versionCode相同时,只有buildId与已安装版本不同且builtAt更大才提示更新;缺少任一字段时同版本不提示。- 应用按
versionCode:buildId记录已提示的构建,同一个构建只弹一次;旧的仅按versionCode去重记录仍兼容没有buildId的清单。 file必须是downloads/下的相对路径,以.apk结尾,不能包含..、反斜杠或绝对路径。sha256必须是 64 位小写十六进制;格式不合法时仍显示版本,但不展示哈希。sizeBytes、notes缺失时降级显示,不影响检查。
- 多个来源都解析成功后,选择
versionCode更大的版本;versionCode相同时选择builtAt更大的构建,再相同则按官网、镜像站、GitHub 的顺序取下载地址。 - 只有
versionCode更大,或版本号相同但buildId不同且builtAt更大时,才判定为可更新。 - 部分来源失败时使用其余来源,并在对话框中显示每个来源的状态。
- 三个来源都失败或都没有当前渠道时显示“检查失败”,提供重试与官网下载入口。
- 公开版本与当前构建相同,或版本号相同但没有更新的构建标识时,显示“已是最新”。
| 现象 | 含义 |
|---|---|
官网:Unable to resolve host |
当前网络无法解析自定义域名(DNS 已配置好,通常是本地网络、代理或 DNS 问题) |
GitHub:HTTP 404 |
仓库或 main 分支上的清单路径不存在 |
镜像:HTTP 5xx |
镜像站暂不可用,官网与 GitHub 仍可完成检查 |
清单中没有可用的 stable 通道 |
清单可访问,但渠道或字段不合法 |
检查失败 |
三个来源都没有返回可用版本 |
更新安装包后,必须同时更新以下三处,否则检查结果与站点下载会不一致:
site/downloads/中的 APK;site/data/releases.json的版本号、大小、SHA-256;若版本号不变重发,还要更新buildId与builtAt(builtAt必须比上一构建更大);site/index.html展示的版本号、大小与 SHA-256。
同版本重发只用于修复必须尽快到达已安装用户的缺陷。普通功能更新仍应递增 versionCode,避免用户误以为没有变化。
最后运行 node scripts/check-site.mjs。站点检查会拒绝大小或哈希不匹配的清单。
镜像站是仓库之外的独立产物目录:把同一份 releases.json 与最新正式版、预览版 APK 复制进去,重新发布后再抽查远端清单与 APK 哈希。镜像只保留最新两个包,整体不超过 50 MiB。