一个又好看又快的 VelaOS / ZeppOS 可穿戴设备管理软件,使用 Flutter 构建
English · 简体中文
OronBox 是一款跨平台可穿戴设备管理工具,无需官方客户端,即可连接、管理 VelaOS / ZeppOS 设备,并为其安装资源、同步运动健康和天气等数据
我们首先希望您的设备支持蓝牙,如果你正在使用 Ubuntu,我们希望它的版本最好是 24.04+
| 平台 | 状态 | 说明 |
|---|---|---|
| Android | ✅ 已支持 | Android 7+ |
| Linux | ✅ 已支持 | x86_64 / aarch64 |
| Web | ✅ 已支持 | 浏览器需要支持 Web Serial / Bluetooth |
| macOS | ✅ 已支持 | macOS 12+ |
| Windows | ✅ 已支持 | Windows 10+,小米账号 2FA 登录需 WebView2 |
| iOS | ❌ 暂不支持 | 我们没有用于调试和测试的实机! |
| 设备/系列 | 状态 |
|---|---|
| Xiaomi Smart Band 8 Pro / 9 / 9 Pro / 10 / 10 Pro | ✅ 已支持 |
| Xiaomi Watch S1 Pro / S3系列 / S4系列 / S5 | ✅ 已支持 |
| REDMI Watch 4 / 5 / 5 eSIM / 6 | ✅ 已支持 |
| 设备/系列 | 状态 |
|---|---|
| Amazfit ZeppOS 设备 | ✅ 已支持 |
| Xiaomi Smart Band 7 | ✅ 已支持 |
| 功能 | 说明 |
|---|---|
| 连接 VelaOS 与 ZeppOS 设备 | 管理已配对设备及其连接状态 |
| 查看设备状态与资源概览 | 展示电量、存储空间、应用和表盘信息 |
| 安装表盘和应用资源 | 将表盘、应用安装到设备 |
| 调整设备应用顺序 | 修改设备启动器中的应用排列 |
| 设置设备应用布局 | 调整设备应用列表的展示方式 |
| 管理设备闹钟 | 支持新增、编辑和删除 |
| 双向查找设备 | 支持穿戴设备发起找手机响铃和手机发起查找设备使穿戴设备响铃或震动 |
| 检查或安装设备固件 | 支持完整/增量包下载安装和本地固件安装 |
| 后台定时同步数据 | 每15分钟检查一次,每1小时同步一次 |
| 同步音乐到设备 | 将 MP3 文件传输到设备音乐 |
| 同步并导出设备录音 | 从设备取回录音并保存 |
| 接收并保存手表截图 | 保存到用户图片目录 |
| 同步城市天气数据到设备 | 为设备更新选定城市的天气信息 |
| 小米设备 eSIM 管理 | 支持标准 GSMA LPA eSIM 配置文件下载、启用、停用与删除 |
| 小爱同学语音协同与语音转文字 | 监听设备小爱语音唤醒与音频流,支持本地与云端 ASR 接管解析 |
| Wi-Fi 凭据协同同步 | 响应手表 Wi-Fi 扫描与网络认证请求,完成设备 Wi-Fi 快速配网 |
| 手机辅助定位协同 | 手机后台为无独立 GPS 设备实时下发定位数据,辅助轨迹记录 |
| 登录小米账号并支持 2FA | 提供 GNSS 星历数据下载和设备 authkey 获取能力 |
| 从小米运动健康日志读取 authkey | 从本地小米运动健康应用日志中解析并读取设备 authkey |
| 同步小米设备 GNSS 星历 | 支持手表发起星历更新请求,需要登录小米账号 |
| 访问 AstroBox-Repo 与米坛资源 | 浏览和获取社区资源 |
| 通过 OAuth 登录米坛社区 | 获取米坛社区资源 |
| 从创作者中心发布资源 | 支持同步发布到米坛和 AstroBox-Repo |
| 本地 API 服务 | 为外部开发与自动化工具提供局域网 HTTP / SSE 服务,支持 mDNS 自动发现与 Ed25519 签名质询认证 |
OronBox 提供独立的跨平台官方命令行客户端 OronBox-CLI 在 OronBox 客户端开启【设置】->【高级设置】->【本地 API 服务】后,即可在计算机终端通过局域网免密质询连接,执行穿戴设备管理、应用与表盘安装、实时系统诊断日志导出等操作:
# 全局安装(推荐)
npm install -g oronbox-cli
# 自动发现并配对
oronbox-cli pair
# 或无需安装直接执行
npx oronbox-cli pair详细用法参见 OronBox-CLI 仓库 及其使用指南与 API 规范
Flutter stable 与 Rust stable 是所有平台的前提:
- Flutter stable:版本见
.fvmrc,可用 fvm 安装,装好后flutter pub get - Rust stable:用 rustup 安装;WASM 运行库在首次构建时从源码编译
Debian / Ubuntu 依赖:
sudo apt install libsecret-1-dev clang cmake ninja-build pkg-config zip curl \
libgtk-3-dev libblkid-dev liblzma-dev libasound2-dev libwebkit2gtk-4.1-dev \
libbluetooth-dev libayatana-appindicator3-dev dpkg-dev rpm flatpak flatpak-builderARM64 另需音频库(flutter_soloud 自带的 Xiph .so 仅 amd64,ARM64 改用系统库):
sudo apt install libflac-dev libogg-dev libopus-dev libvorbis-dev其他发行版按对应包名安装同等依赖与打包工具:gtk3、webkit2gtk-4.1、bluez、libblkid、libasound2、xz,以及 dpkg-deb / rpmbuild / makepkg / linuxdeploy / appimagetool / flatpak-builder
Windows:Visual Studio 2022(C++ 桌面工作负载);WebView2 SDK 可用 windows/scripts/install_webview2_sdk.ps1 安装
macOS:Xcode,仅能在 macOS 主机上构建
Android / Web:无额外依赖
tool/build_all.sh [--dev]构建 Android + Web + 当前宿主桌面平台,产物统一输出到 build/release/,并生成 sha256sums.txt
tool/build_android.sh [--format apk|appbundle|all] [--abi arm64-v8a|armeabi-v7a|x86_64]--format/--abi缺省时构建全部格式 / 全部 ABI- 发布签名通过环境变量配置:
ORONBOX_KEYSTORE_PATH、ORONBOX_KEYSTORE_PASSWORD、ORONBOX_KEY_ALIAS、ORONBOX_KEY_PASSWORD;未设置时使用 debug 签名
tool/build_linux.sh [--format tar.gz|deb|rpm|arch|appimage|flatpak|all] [--abi x86_64|aarch64]- 缺省时打包全部可用格式,
--abi缺省取宿主架构 - 交叉编译 aarch64(x86_64 宿主)需将
ORONBOX_LINUX_ARM64_SYSROOT指向包含 gtk3/webkit2gtk/alsa/flac/ogg/opus/vorbis 等开发包的 arm64 sysroot;交叉模式产出 tar.gz / deb / rpm / arch
tool/build_macos.shpowershell -File tool/build_windows.ps1 [-Dev] [-SkipWebView2Sdk] [-WebView2SdkVersion <版本>]或在 CMD 中执行批处理:
tool\build_windows.bat [--dev]tool/build_web.sh本项目使用了 AI Agent 工具协助开发
OronBox 使用或参考了以下项目:
| 项目 | 来源性质 |
|---|---|
| AstralSightStudios/AstroBox-Public | 界面结构与交互设计参考 |
| AstralSightStudios/AstroBox-NG-Module-Core | 小米设备协议与传输层,移植改写 |
| AstralSightStudios/AstroBox-NG-Module-Pb | 小米 wear 协议定义,逐字采用 |
| AstralSightStudios/AstroBox-NG-Module-Bluetooth | 蓝牙连接流程参考 |
| AstralSightStudios/AstroBox-NG-Module-Account | 小米账号登录与 authkey 获取流程参考 |
| AstralSightStudios/AstroBox-NG-Module-Provider | 社区资源索引与清单解析流程参考 |
| AstralSightStudios/AstroBox-NG-Module-AppWasm | Web Serial 连接流程参考 |
| Gadgetbridge | ZeppOS 协议实现,移植改写 |
| Kazumi | Material Design 组件与界面设计 |
GNU Affero General Public License v3.0 · 附加条款 · 第三方声明