VelaBand Smart Band

项目简介

VelaBand Smart Band 是一个基于 Xiaomi Vela JS 快应用框架实现的智能手环演示应用。

功能展示

表盘

心率监测

步数统计

功能

• 表盘显示 — 展示时间、日期和当前心率等核心信息
• 心率监测 — 基于模拟心率数据，展示当前值、平均值、最低值和最高值
• 步数统计 — 基于模拟计步数据，展示步数、距离和卡路里信息
• 数据持久化 — 通过 @system.storage 保存步数相关数据

环境要求

• Windows 10/11
• Node.js >= 8.10
• npm
• AIoT-IDE
• Vela Virtual Device

快速开始

执行：

npm run demo

该命令完成：

1. 检查 Node.js 和 npm 环境
2. 按需安装项目依赖
3. 构建 Vela JS 快应用
4. 生成 debug RPK 应用包

构建完成后，可以按以下步骤在Vela Virtual Device环境中运行：

1. 在 AIoT-IDE 中打开项目
2. 选择 Vela Virtual Device
3. 点击 Debug 运行应用

构建产物

构建成功后生成：

dist/
└── *.debug.rpk

其中 RPK 文件为 Vela 快应用运行包，可通过 AIoT-IDE 加载并运行。

数据模拟说明

传感器相关数据采用模拟模式：

• 心率：随机游走方式生成动态数据
• 步数：在模拟环境下生成计步数据

项目结构

VelaBandApp-MLSG
├── src/
│   ├── common/        # 服务层
│   ├── components/    # UI组件
│   ├── pages/         # 页面
│   └── i18n/          # 多语言
├── scripts/
├── docs/
│   ├── architecture.md
│   ├── reproduction.md
│   └── exception.md
├── package.json
└── README.md

系统设计

项目采用服务层、页面层和组件层分离结构。

详细设计参见：

• 架构说明：docs/architecture.md

文档索引

• 架构说明：docs/architecture.md
• 运行复现指南：docs/reproduction.md
• 异常处理：docs/exception.md