Repository navigation
wanBox v3.0.7-preview.9
Pre-release
Pre-release
wanBox 3.0.7-preview.9 · Root 模块安装修复
作者:雾晚
本次变更
- 修复模块更新时安装器仍在写入文件、热切换却已开始的竞态。现在等待安装进程退出及更新标记就绪,再校验暂存包并切换代码。
- 兼容管理器收尾时移除安装脚本与说明文件;核心、控制程序等运行文件仍严格校验。成功后移走已应用的暂存包,避免下次开机重复覆盖。
- 等待超时或暂存包被替换时不切换旧代码;启动失败使用已有回滚流程,保留持久配置和恢复副本。热更新会短暂重启运行中的核心。
- 删除纯 Root 模块下不适用的六项设置及帮助入口:唤醒锁、休眠后重置连接、切网后重置连接、按流量计费网络、通知显示分组、系统 HTTP 代理绕过列表。历史设置值保留。
- 保持原界面风格、节点/订阅/路由、磁贴与快捷方式。包名、原发布签名、数据格式和 sing-box v1.15.0-alpha.10 不变。
- 提供带管理 APK、不带管理 APK 两个模块包及独立签名 APK;公开文件为 arm64-v8a,最低 Android 12,APK versionCode=1750。
安装与升级
请先导出备份。仅安装 APK 不能连接,需要配套 Root 模块。
- 在 Magisk/KernelSU 管理器安装
wanbox-root-module-with-manager-arm64-v8a.zip(带 APK)或wanbox-root-module-arm64-v8a.zip(不带 APK)。首次安装前停止其他接管 TUN 的模块。 - 等管理器安装完成后稍候,模块会尝试热切换,无需主动重启手机。等待期间不要再次覆盖模块。未完成热更新时保留管理器暂存包,仍可按管理器标准流程重启应用更新。
- 不带 APK 的包需要手动覆盖安装配套 APK;带 APK 的自动安装被系统拒绝时也可手动安装。打开管理 App,允许 Root 后连接。
默认更新保留全部数据。需要全新安装或仅保留节点/订阅时,先到管理 App「设置 → 模式与入站设置 → 模块更新数据」确认处理,再安装 ZIP。这会同时处理 App 和模块数据并保存恢复备份;处理中断可从同页继续。模块持久数据仍位于 /data/adb/wanbox,不随代码更新清除。
验证
本地 221 项 Android 单元测试、Preview Debug 构建、32 项模块 Go 测试、Go vet、3 项打包测试、安全契约检查和 ARM64 控制程序编译通过。发布流程另外执行 Linux race、原签名覆盖升级及 API 35 模拟器数据更新回归,并在这些检查成功后发布。
模块仍为实验预览;上述自动测试不代表所有 Root 管理器和设备的安装、SELinux、休眠与切网行为均已验证。
实现依据与失败边界见 安装方式对照。