【免费下载链接】BBPlayer一款简约、好用的 BiliBili 音乐播放器。项目地址https://gitcode.com/gh_mirrors/bbpl/BBPlayer点击查看免费下载BBPlayer 是一款简约好用的 BiliBili 音乐播放器其热更新系统基于自托管的 Expo Updates 服务搭建通过 bsdiff 增量补丁与 Cloudflare R2 对象存储配合让 JS 代码更新无需等待应用商店审核即可触达用户。本文将带你完整拆解这套开源热更新方案的架构、补丁原理与部署实战。为什么自托管音乐播放器的双层更新机制BBPlayer 把更新拆成了两层各司其职原生大版本APK / 原生能力升级走应用市场客户端从远程 update.json 拉取版本号、更新日志与强制更新标记由 apps/mobile/src/lib/services/updateService.ts 中的checkForAppUpdate做 semver 比较后提示下载JS 热更新OTA绝大多数 Bug 修复与界面调整只涉及 JS bundle通过 Expo Updates v1 协议直接下发分钟级生效。自托管 Expo Updates 的核心收益在于分发状态、溯源与遥测数据全部落在自己的 PostgreSQL 里不可变的 bundle 全部落在 R2既没有按请求计费的依赖也拿到了完整的分发观测能力补丁命中率、节省字节数、启动成功率。架构总览一个镜像、三个进程、两种存储整个更新服务端由 apps/update-server/docker-compose.yml 编排共 5 个服务服务职责postgres只存分发状态、channel 历史、溯源与遥测见 00001_initial.sqlmigrate一次性运行内嵌的 Goose 迁移必须在 api/worker 之前完成api对外提供 Expo 协议路由/api/manifest、/api/assets、/api/events与管理面/admin/*worker独立进程计算 bsdiff 增量补丁update-server-webnginx 托管 Web 管理后台并把/admin/*、/api/*、/health反代到 api网络设计上只有两个 docker 网络internal内网隔离不对外暴露任何端口与egress仅供 api/worker 访问 R2 的 S3 endpoint。唯一的宿主机入口是 nginx 的127.0.0.1:8080再套一层你自己的 HTTPS 反向代理。⚙️ 关键决策bsdiff 的 CPU / 内存开销很高所以补丁计算被刻意拆成独立的worker进程绝不拖慢 manifest 响应。bsdiff 增量补丁下载量最少能省 90%每次新发布后服务端会为上一个可见的 channel head → 新 head创建异步 bsdiff 任务核心逻辑在 apps/update-server/internal/patchworker/worker.go从 R2 读取新旧两个完整 Hermes bundle写入临时目录执行bsdiff --formatbsdiff40生成增量补丁再用bspatch把旧包还原出来逐字节比对还原结果与目标 bundle不一致直接判失败补丁必须携带BSDIFF40魔数头且尺寸至少要比目标 bundle 小 10%minimumSaving 0.10否则标记为not_beneficial——客户端此时会继续收到完整 bundle绝不拿假增量浪费请求校验通过才上传到 R2 的patches/from/to.bsdiff并记录 sha256 与节省比例。两个工程细节值得注意补丁认领有 10 分钟租约worker 被中断时 channel 不会永久卡在processing新 worker 可以接管任务未就绪期间客户端持续收到完整 bundle可用性不受影响构建期自检Docker 构建固定住 Expo 的 bsdiff 源码若产出的补丁无法被配套 bspatch 逐字节还原构建直接失败把问题拦在部署之前。移动端接入expo-updates 的 manifest 请求客户端侧只需在 apps/mobile/app.config.ts 中声明updates配置manifest 地址指向自托管的/api/manifest并通过requestHeaders预置expo-channel-name渠道与x-bbplayer-installation-id安装级匿名 ID启动时由 updateTelemetry.ts 写入真实 UUID两个请求头。服务端的 manifest 处理器api_manifest.go按 Expo 协议工作根据expo-platform/expo-runtime-version/expo-channel-name查 channel head命中则返回 manifest无更新返回带expo-protocol-version的 204head 为embedded模式时下发rollBackToEmbedded指令一键回滚到内嵌版本只有启动用的 Hermes bundle 走 API URL——因为 expo-updates 仅在此时携带A-IM: bsdiff头做 HTTP 内容协商由服务端在完整对象与补丁对象之间二选一其余普通资源直接由 R2 自定义域名提供完全绕过 Go 进程静态资源零 API 压力每次 manifest 请求还会顺带记录启动/崩溃观测updateTelemetry.ts 的launch_succeeded/launch_failed事件最终上报到/api/events构成回滚决策的数据基础。一键发布实战hot-update-cli发布侧是 TypeScript 编写的 hot-update-cli在apps/mobile下执行pnpm hot-update它会交互式询问 channel 与发布说明并自动完成一整条流水线见 publish.tsgit rev-parse HEAD记录 commit 溯源脏工作区会先警告非交互模式直接拒绝除非--allow-dirty调用 Expo 的expo/fingerprint生成 Android runtimeVersionappVersion策略下自动取公开配置的version运行expo export导出 Android bundle写入公开 Expo 配置后打包成 zip以 multipart 形式 POST 到/admin/publishrequestJSON archive归档同时携带 commit 溯源与 fingerprint 报告。首次成功后服务器 URL 与 token 会保存到项目的.bbplayer-updates/credentials.json目录权限 700Git 已忽略后续优先使用命令行参数与环境变量。CI 场景使用完全相同的命令pnpm hot-update -- publish --non-interactive --channel production --message 修复歌词解析运维还有配套管理命令list查更新组、channel --action history看渠道变更历史、insights查看 bsdiff 命中率与节省字节数、source --action compare对比两组发布之间的源码差异。Docker Compose R2 四步部署构建两个镜像运行时不编译任何东西全部提前产出docker build -t bbplayer-updates:VERSION apps/update-server docker build -t bbplayer-updates-web:VERSION -f apps/update-server/web/Dockerfile .准备环境变量必填项包括POSTGRES_PASSWORD、DATABASE_URL、R2 的桶名/账号/S3 凭据与R2_PUBLIC_BASE_URL自定义域名、PUBLIC_BASE_URL以及相互独立的ADMIN_TOKEN与INSTALLATION_HMAC_KEY启动栈docker compose up -dmigrate 先行api/worker 等待迁移成功nginx 等待 api 健康检查通过接入共享反向代理生产叠加 docker-compose.prod.yml 移除宿主机端口、把 nginx 挂到共享proxy网络外层 Caddy/nginx 做 TLS 终结。注意外层 nginx 需为/admin/publish放开 256 MiB 上传限制否则会返回413 Request Entity Too Large。本地可以用 MinIO 模拟 R2并跑一遍端到端套件验证 Expo 协议实现docker compose -f docker-compose.e2e.yml up -d E2E_DATABASE_URLpostgres://updates:updates-test127.0.0.1:55432/updates?sslmodedisable \ go test ./internal/server -run TestE2EExpoProtocol -count1 -v该套件事先模拟 manifest 与资源请求、校验不可变资源的 hash并验证事件信封的版本号与幂等性。可观测性结构化日志与分钟级指标api、worker、migrate三个进程都以结构化日志写到 stderr级别由LOG_LEVEL控制每个补丁任务都会记录认领、耗时、补丁大小与节省百分比格式上就是级别 标签键值对这种一目了然的样式指标后端刻意选用了 PostgreSQL 而非 Prometheus请求数、5xx 与耗时按分钟聚合到service_metric_minutes启动 bundle 与 bsdiff 分发聚合到delivery_metric_minutes普通资源留在 R2不计入 API 指标。WebUI 登录页输入ADMIN_TOKEN后可直接查询/admin/metrics/service、/admin/metrics/delivery与更新组生命周期接口窗口默认 7 天、最多 90 天。原始事件保留 35 天worker 每天清理过期数据。小结BBPlayer 的自托管热更新方案给出了一个可复用的范式PostgreSQL 管状态、R2 管不可变对象、独立 worker 算 bsdiff、内容协商在完整包与增量补丁之间自动切换、遥测闭环驱动回滚决策。配合 hot-update-cli 的一键发布与 CI 非交互模式一个 React Native 团队就能在完全自主可控的前提下把 JS 更新的触达时间压缩到分钟级。更多细节可参考 apps/update-server/README.md 与 apps/update-server/DESIGN.md。赞分享【免费下载链接】BBPlayer一款简约、好用的 BiliBili 音乐播放器。项目地址https://gitcode.com/gh_mirrors/bbpl/BBPlayer点击查看免费下载相关推荐Quasar Capacitor 应用 Live UpdatesOTA 热更新接入指南Capgo 自托管与 Capawesome Cloud 实战Quasar Capacitor 应用 Live UpdatesOTA 热更新接入指南Capgo 自托管与 Capawesome Cloud 实战 导读前端UI组件跨平台Immich自托管照片管理系统完全部署指南Immich自托管照片管理系统完全部署指南 在数字化时代照片和视频已成为我们最珍贵的数字资产。传统的云存储服务虽然方便但数据隐私和长期成本问题日益凸显。Im后端前端移动开发音视频计算机视觉Thonny环境下ESP8266 WeMos D1刷写MicroPython固件的解决方案Thonny环境下ESP8266 WeMos D1刷写MicroPython固件的解决方案 问题背景 在使用Thonny IDE为ESP8266 WeMos D区块链创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考