从零到一：小米手环 9 (Vela OS) 快应用开发避坑与优化实战总结

Thu, 02 Jul 2026 00:00:00 GMT

在智能穿戴设备日益普及的今天，为手环等超轻量级可穿戴设备开发应用成为了一项有趣的挑战。最近，我为 小米手环 9（搭载 Vela OS，使用快应用 QuickApp 框架）开发和重构了两个数学/物理计算器应用（「初中物理计算器」与「云学计算器」）。

手环开发看似与传统的移动端前端开发类似（都是 HTML/CSS/JS），但由于其极度苛刻的硬件资源限制（JerryScript 引擎）以及特殊的椭圆胶囊屏形态，实际开发中隐藏着无数的“深坑”。

本文将倾囊相授我在开发过程中的核心避坑指南、性能优化方案以及 UI 适配经验。

🛠️ 一、穿戴设备的“戴着镣铐跳舞”：硬件与编译约束

小米手环 9 的底层快应用 environment 运行在 JerryScript 引擎上。这与我们熟知的 V8 引擎有着天壤之别，它的资源限制可以用“苛刻”来形容：

内存极小：JerryScript 引擎的堆内存往往只有几百 KB。未压缩混淆的 JS 代码如果在解析阶段体积过大，会直接触发 OOM（Out of Memory） 导致手环系统闪退或重启。
RPK 包体积限制：虽然官方上限更大，但在实际开发中，RPK 包编译压缩后的大小建议严格控制在 300KB 以下，越小加载越快、运行越安全。

⚠️ 避坑 1：编译报错 `PseudoClassSelector unsupport`

快应用的 CSS 编译器对伪类选择器的支持非常有限。如果你在 CSS 中写了类似于：

.btn:active {
  background-color: #333;
}

编译链会直接抛出 Selector type unsupport PseudoClassSelector, name: active 的报错并导致构建中断。

解决方案：剔除所有不被支持的 :active 伪类样式。如果需要点击态反馈，应该依靠快应用组件的 active 属性或者在 JS 中动态绑定 Class，或者使用系统自带的震动反馈（system.vibrator）来替代视觉点击态。

🛑 二、避坑指南：手环真机“点进去啥都没有”与黑屏卡死

在模拟器上运行良好的代码，侧载到真机上经常会遇到“进入页面一片空白”或者“直接卡死黑屏”的现象。这主要是由于以下两个原因：

1. 致命的 `<list>` 组件与 `<block>` 条件渲染冲突

在很多前端框架中，我们习惯用 <list> 结合条件渲染标签 <block> 来动态展示组件：

<!-- ❌ 坏代码：会导致真机列表完全空白 -->
<list>
  <block if="{{currentFormula === 1}}">
    <list-item type="input">...</list-item>
  </block>
</list>

原因分析：Vela OS 的 <list> 属于惰性按需渲染组件。其内部只允许 <list-item> 作为直系子元素。如果将其包在 <block> 中，列表渲染引擎会在高度计算和节点挂载时发生严重错乱，导致列表项渲染为 0，页面呈现一片死黑/空白。
黄金法则：在手环快应用开发中，尽量放弃使用 <list> 布局，全面改用 <scroll scroll-y="true"> 滚动容器 + 普通 <div> 容器进行排版。<scroll> 属于静态流式布局，渲染绝对稳定，而且支持顺滑的上下滑动，没有任何数据懒加载的内存副作用。

2. ES6 模板字符串（反引号）导致语法解析崩溃

我们习惯在 JS 中写这种优雅的模板字符串：

// ❌ 坏代码：会导致 JerryScript 解析失败，脚本静默挂起（页面白屏）
const substitution = `${mSI}kg × ${g}N/kg`;

原因分析：手环的 JerryScript 引擎对 ES6 的反引号（）以及 ${}` 插值的支持存在缺陷。当它在初始化阶段遇到反引号时，会静默抛出解析错误，导致页面关联 of JS 脚本完全不执行。
解决方案：在手环项目中，永远使用传统的 ES5 字符串拼接（+ 运算符）：
```
const substitution = mSI + "kg × " + g + "N/kg";
```

⚡ 三、体积与内存的极致优化：第三方轮子的裁减

为了提升输入体验，我引入了一个非常优秀的第三方全键盘输入法轮子（Vela_input_method），但遇到到了严重的体积问题：

引入后，RPK 包大小直接从 70KB 暴涨到 614KB！
究其原因，是输入法自带了用于拼音匹配的 dic.js（中文词库）和日文罗马字匹配的 dic_jp.js，大小达数百 KB。这些字典在手环启动加载时，会直接撑满 JerryScript 堆栈引起 OOM 崩溃。

💡 核心优化方案（按需裁剪）

由于我们的应用是“计算器”，用户在输入框中只需要输入数字、小数点和基本运算符，根本不需要中文和日语汉字联想。

重写查词逻辑：修改输入法的 dicUtil.js，将其中的查词函数直接 mock 掉，使其直接返回空数组，断开对大字典文件的依赖。
彻底删除垃圾文件：直接删掉 dic.js 和 dic_jp.js 两个大文件。
成果：包体积瞬间从 614 KB 锐减至 241 KB，完全退回到安全线以内，运行极其顺畅，彻底消除了 OOM 隐患。

📱 四、胶囊屏（椭圆屏）的 UX 视觉与触控适配

小米手环 9 采用的是 192×490px 的胶囊形屏幕，这种屏幕在顶部和底部具有非常明显的圆角弧度遮挡。

┌──────────────┐
│  ❌ 0-20px   │  ← 顶部椭圆边缘（无法显示完整字，触控盲区）
├──────────────┤
│              │
│  ✅ 20-470px │  ← 安全交互触控区（平坦，好点）
│              │
├──────────────┤
│  ❌ 470-490px│  ← 底部圆角遮挡区
└──────────────┘

为了给用户提供 premium（高级）的交互质感，我们遵循了以下适配规范：

1. 彻底解决“上下边缘遮挡”

顶部防碰: 页面的 Header 部分统一设置 margin-top: 32px;，确保返回按钮和标题完全避开顶部 20px 的物理弧度截断区。
底部弹跳: 当输入法键盘弹起时，底部 Spacer 高度由 200px 拓宽至 280px，这保证了用户可以把任意一个当前正在输入的输入框，轻松地滚动到屏幕正中央的“平坦区”进行打字，绝对不会被下边缘遮挡。
列表留白: 滚动列表的最底端设置 60px 的占位 Spacer，使得最后一项内容能被推上去，不被下圆角切边。

2. 扩大交互热区（防盲操点错）

手环屏幕极小，如果按钮做得很精致，用户会点得非常痛苦。

页面的返回按钮热区扩大为 48×48px，设置 line-height 居中，极大方便了大拇指侧向返回。
输入框与按钮的高度统一设为 52px（接近官方最舒适的 55px 限制），宽度拉伸至 180px（两侧仅留 6px 呼吸空置），最大化触控面积。
字号适当放大：主标题使用 20px，输入文字使用 16px，确保在手臂晃动时也能看清。

3. 右滑返回防止应用卡死

快应用如果不支持右滑返回，用户在某些特殊界面可能因为找不到返回键而卡死在应用内。

做法：在每个页面的根 div 上绑定 @swipe="handleSwipe" 事件，一旦检测到 direction === 'right'，立即触发 router.back()，给用户最自然的原生体验。

五、进阶炫技：手环上的 Canvas 动态绘图

在重构「云学计算器」的函数图像模块（pages/func）时，为了让应用显得非常高级，我利用了快应用的 <canvas> 画布组件：

在手环上渲染出了一个 $10 \times 10$ 格的动态坐标轴网格。
通过在特定区间内（如 $x \in [-5, 5]$）以 18 像素为 1单位进行高精度点采样，计算 $y = f(x)$ 的值，最后在画布上连接成线，绘制出了一条条平滑的二次函数、三次函数和三角函数几何曲线。

在 192px 宽的微型屏幕上看着函数曲线随着输入的改变而实时重绘，这种视觉震撼感是传统极简计算器完全无法比拟的。

📝 结语

开发手环应用是一个“做减法”的过程。它需要开发者：

精准控制每一行 JS 的大小，避开 ES6 的语法陷阱。
警惕 <list> 布局在低端虚拟机上的解析缺陷，多使用 <scroll> 自适应容器。
充分考虑胶囊圆角屏的物理遮挡，把所有重要的交互区域保留在屏幕正中，并加宽加高交互热区。

希望这篇实战总结能为准备涉足 Vela OS 快应用开发的开发者们提供一些有价值的参考，少走弯路！

第一篇博客

Fri, 16 Jan 2026 00:00:00 GMT

写在前面

这是我博客的第一篇文章。

一直想搭一个属于自己的博客，把折腾过的东西、踩过的坑、学到的技术记录下来，于是有了这个站点。

为什么要写博客？

对我来说，写博客主要有几个目的：

把零散的知识系统化
记录折腾过程，避免重复踩坑
给未来的自己留下些什么

有些东西当下觉得“记住了”，过一段时间就忘了，写下来反而更踏实。

这个博客会写什么？

接下来这个博客主要会记录：

Web 技术学习笔记
网站部署、优化、踩坑记录
一些个人思考与阶段总结

不追求更新频率，只希望每一篇对自己有用。

结语

第一篇博客就先写到这里。

如果你正在阅读这段文字，希望这里的内容也能对你有所帮助。

毅白の博客