快应用安装指南——.rpk 格式资源的安装与使用
什么是快应用
快应用（Quick App）是穿戴设备上的轻量级程序——体积小、启动快，不需要像完整 APP 那样安装。社区里有各种有趣的快应用：
- 手环斗地主
- 手环水平仪
- 赛博算卦
- 番茄钟
- 倒计时工具
快应用的标准分发格式是 .rpk（Rust Package）。
快应用 vs 表盘
| 特性 | 表盘 | 快应用 |
|---|---|---|
| 格式 | .dwz / .mwz | .rpk |
| 主要功能 | 显示时间 + 一些小组件 | 完整应用逻辑（游戏、工具等） |
| 复杂度 | 低（图片 + 布局配置） | 高（完整程序） |
| 安装数量 | 一般可装十几个 | 取决于设备内存 |
| 运行方式 | 待机页面常驻 | 需要手动启动 |
安装步骤
方式一：官方源安装
和表盘一样：
- 全部资源页筛选「快应用」类型
- 浏览找到心仪的快应用
- 进入详情页点击下载
- 连接的设备适配的话自动推送
方式二：本地文件安装
桌面端最快捷：直接把 .rpk 文件拖进 AstroBox 窗口。
全平台通用：
- 设备页 → 点「快应用」卡片
- 点右上角加号
- 选择本地
.rpk文件
方式三：插件接入的快应用源
部分插件提供了专属的快应用源，安装插件后在源选择器里切换即可。
iOS 注意：安卓伪装
如果你用 iOS 连接 REDMI Watch 5 / 小米 Watch S3：
- 快应用最初为安卓设计
- iOS 直接安装可能失败
- 需要先开启「安卓伪装」（见 iOS 安卓伪装）
小米手环 9 / 9 Pro 不受影响，iOS 直接能装。
快应用传数据
AstroBox 有一个特别重要的能力：代理网络请求。
快应用在穿戴设备上直接联网的能力很有限（蓝牙链路带宽有限，也容易被设备厂商限制）。AstroBox 作为中间代理，可以：
- 让快应用通过 AstroBox 的网络连接传数据
- 配合 AstroBox 插件实现更复杂的网络交互
- 快应用本身不需要知道具体的网络实现细节
这就是为什么 AstroBox 插件系统对快应用生态很重要——很多有趣的功能（比如把快应用的数据传到服务器）都需要插件配合。
在设备上启动快应用
安装完成后，在穿戴设备上：
- 找到「应用列表」或「全部应用」
- 找到新装的快应用图标
- 点击启动
具体的入口因设备型号而异：
- 小米手环 9/9 Pro：在主页面上滑 → 找到应用列表图标
- REDMI Watch 5：主页面 → 长按或上滑进入应用菜单
- 小米 Watch S3：主页面 → 上滑进入应用列表
管理已安装的快应用
- AstroBox 设备页 → 快应用卡片
- 列出所有已安装的快应用
- 可以删除、更新或查看详细信息
快应用和插件的关系
虽然快应用本身就是独立程序，但它和 AstroBox 的插件系统有密切关系：
| 场景 | 角色 |
|---|---|
| 快应用直接装到设备上 | 快应用自己 |
| 快应用需要联网传数据 | AstroBox 作为代理 |
| 需要额外功能（比如付费验证） | AstroBox 插件协助 |
常见问题
装完快应用设备上找不到
- 不同设备型号快应用入口位置不同，多找找
- 或者在设备的设置 → 应用管理里看看有没有新装的应用
- 重启一下设备，新装的应用有时需要重启才会在列表里出现
快应用闪退
- 可能是设备内存不足，试试关掉一些后台应用
- 也可能是快应用版本太旧，更新到最新版本
- 如果是 iOS 设备，确认是否正确开启了安卓伪装
快应用传数据没反应
- 确认 AstroBox 的网络代理功能已开启
- 确认 AstroBox 和设备蓝牙连接正常
- 检查快应用本身是否支持数据传输功能