Skip to content

wanBox v3.0.7-preview.9

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 08 Oct 08:32

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 模块。

  1. 在 Magisk/KernelSU 管理器安装 wanbox-root-module-with-manager-arm64-v8a.zip(带 APK)或 wanbox-root-module-arm64-v8a.zip(不带 APK)。首次安装前停止其他接管 TUN 的模块。
  2. 等管理器安装完成后稍候,模块会尝试热切换,无需主动重启手机。等待期间不要再次覆盖模块。未完成热更新时保留管理器暂存包,仍可按管理器标准流程重启应用更新。
  3. 不带 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、休眠与切网行为均已验证。

实现依据与失败边界见 安装方式对照。