OronBox

一个又好看又快的 VelaOS / ZeppOS 可穿戴设备管理软件，使用 Flutter 构建

English · 简体中文

快速入口

• 下载最新版本
• 用户文档
• 开发文档
• 问题反馈

OronBox 是什么？

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 VelaOS

设备/系列	状态
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	✅ 已支持

ZeppOS

设备/系列	状态
Amazfit ZeppOS 设备	✅ 已支持
Xiaomi Smart Band 7	✅ 已支持

功能支持

功能	说明
连接 VelaOS 与 ZeppOS 设备	管理已配对设备及其连接状态
查看设备状态与资源概览	展示电量、存储空间、应用和表盘信息
安装表盘和应用资源	将表盘、应用安装到设备
调整设备应用顺序	修改设备启动器中的应用排列
设置设备应用布局	调整设备应用列表的展示方式
管理设备闹钟	支持新增、编辑和删除
双向查找设备	支持穿戴设备发起找手机响铃和手机发起查找设备使穿戴设备响铃或震动
检查或安装设备固件	支持完整/增量包下载安装和本地固件安装
后台定时同步数据	每15分钟检查一次，每1小时同步一次
同步音乐到设备	将 MP3 文件传输到设备音乐
同步并导出设备录音	从设备取回录音并保存
接收并保存手表截图	保存到用户图片目录
同步城市天气数据到设备	为设备更新选定城市的天气信息
登录小米账号并支持 2FA	提供 GNSS 星历数据下载和设备 authkey 获取能力
从小米运动健康日志读取 authkey	从本地小米运动健康应用日志中解析并读取设备 authkey
同步小米设备 GNSS 星历	支持手表发起星历更新请求，需要登录小米账号
访问 AstroBox-Repo 与米坛资源	浏览和获取社区资源
通过 OAuth 登录米坛社区	获取米坛社区资源
从创作者中心发布资源	支持同步发布到米坛和 AstroBox-Repo

CLI 使用

OronBox 提供功能完整且可脚本化的命令行界面，可在无 GUI 模式下管理设备、安装资源、访问社区源以及控制后台任务，用法参见 OronBox 文档站

从源码构建

环境准备

• Flutter stable（推荐用 fvm 管理，仓库根目录的 .fvmrc 已指定版本），然后 flutter pub get
• 各平台额外依赖：
  • Linux：gtk3 webkit2gtk-4.1 bluez libblkid libasound2（构建时为 libasound2-dev）xz；打包工具按需：dpkg-deb（deb）、rpmbuild（rpm）、makepkg（arch）、linuxdeploy 或 appimagetool（AppImage）、flatpak-builder 与 GNOME SDK（Flatpak）
  • Linux ARM64：还需 libflac-dev libogg-dev libopus-dev libvorbis-dev；flutter_soloud 的配套 Xiph .so 只有 amd64 版本，ARM64 会自动切换并使用系统库，ARM64 产物也会声明对应运行时依赖
  • Android：Flutter 标配的 Android SDK/NDK
  • Windows：Visual Studio 2022（C++ 桌面工作负载）；WebView2 SDK 可通过脚本安装：windows/scripts/install_webview2_sdk.ps1
  • macOS：Xcode，仅可在 macOS 主机构建
  • Web：无额外依赖

一键构建

tool/build_all.sh [--dev]

构建 Android + Web + 当前宿主桌面平台，产物统一输出到 build/release/，并生成 sha256sums.txt

分平台构建

# Android
tool/build_android.sh [--format apk|appbundle|all] [--abi arm64-v8a|armeabi-v7a|x86_64]

# Linux
tool/build_linux.sh [--format tar.gz|deb|rpm|arch|appimage|flatpak|all] [--abi x86_64|aarch64]

# macOS（仅 macOS 主机）
tool/build_macos.sh

# Windows（任选其一）
tool\build_windows.bat [--dev]
powershell -File tool/build_windows.ps1 [-Dev] [-SkipWebView2Sdk] [-WebView2SdkVersion <版本>]

# Web
tool/build_web.sh

• --format / --abi 缺省时构建全部格式 / 全部 ABI；Linux --abi 缺省取宿主架构
• Android 发布签名通过环境变量配置：ORONBOX_KEYSTORE_PATH、ORONBOX_KEYSTORE_PASSWORD、ORONBOX_KEY_ALIAS、ORONBOX_KEY_PASSWORD；未设置时使用 debug 签名
• Linux 交叉编译 aarch64（x86_64 宿主）需将 ORONBOX_LINUX_ARM64_SYSROOT 指向包含 gtk3/webkit2gtk/alsa/flac/ogg/opus/vorbis 等开发包的 arm64 sysroot；交叉模式只产出 tar.gz / deb / rpm / arch

版本与产物约定

• 版本号取自 pubspec.yaml 的 version 字段
• 默认要求 git 工作区干净；加 --dev 允许脏工作区并在版本号后附加 git 元数据（如 1.0.0.dirty.abc1234）
• 产物命名：oronbox-<version>-<platform>[-<arch>].<ext>，符号表随包一并归档

AI 开发声明

本项目使用了 AI Agent 工具协助开发

使用情况：

模型	协助的部分
GPT 5.5/5.6-Sol	Dart 蓝牙连接行为/协议、后端逻辑重写、部分前端
GPT 5.6-Luna	GitHub CI / Release 脚本重写与修复、运动健康实现
Kimi K3	OOBE、创作者相关逻辑
Kimi K2.6	部分前端、UI/UX、初版后端

鸣谢

OronBox 参考和使用了来自以下优秀项目的部分代码：

项目	参考的内容
AstroBox-Public	界面结构、资源流程与交互设计
AstroBox-NG-Module-Core	小米设备协议、安装流程与传输行为
AstroBox-NG-Module-Bluetooth	蓝牙连接行为
AstroBox-NG-Module-Account	小米账号登录、设备同步与 authkey 获取
AstroBox-NG-Module-Provider	社区资源索引、CDN 与清单解析
AstroBox-NG-Module-AppWasm	Web Serial 与浏览器端连接流程
Gadgetbridge	ZeppOS 与可穿戴设备协议研究
Kazumi	Material Design 组件与界面设计

许可证

OronBox 采用 GNU Affero General Public License v3.0 许可证

Star History