表盘快应用安装报错处理

表盘推送到一半卡住、资源装完没反应、详情页提示「未适配」——本篇汇总 AstroBox 安装资源时最常见的几种报错与对应处理。相关文档：小米手环装第三方表盘的完整流程 · 手环手表连接不上的排查思路

一、先确认前提

安装类报错大多出在前提上，先过一遍：

1. 设备已连接：没连接时只能浏览资源，点「下载」推不到手环。连接排查见手环手表连接不上的排查思路。
2. 设备在支持清单里：小米手环 9 系列起、Watch S3 起、REDMI Watch 5 起完整支持；更早的机型不在清单内，装不上属正常。
3. 传输队列没堵：安装与传输进度在任务管理里逐条可查，卡住的条目先取消再重推。

二、提示「资源未适配当前设备」

不要点强制安装——强制安装可能带来异常，重则影响设备正常使用。正确做法：

1. 先向资源作者确认哪个版本能在你的设备上运行；
2. 在资源详情页右侧切换到确认可用的版本；
3. 重新点左侧「下载」推送。

注意右侧「更多设备下载」只负责选资源，不触发安装。第三方源没有适配校验，装前自己核对。

三、快应用装不上或装到一半失败

最常见的两个原因：

• 数量到顶：多数小米设备快应用安装数约 20 个为上限，小米手环 10 Pro 与小米 Watch S5 系列没有上限；装满后先卸载一部分再装。
• 分包传输中断：安装包是分包发给手环的，发送间隔可在设置里调整（默认 5ms）；个别安装失败时把「发包间隔」调大一点再试，能解决一部分传输不稳的情况。

四、本地文件拖不进去或装不了

本地离线安装支持 .rpk（快应用）、.face（表盘）、.bin（通用资源）三类，走三条路：设备页发起、传输队列添加、文件直接拖进窗口。装不上时检查：

• 扩展名是否在支持范围内（改过名的文件先改回真实扩展名）；
• 文件是否完整（传输中被截断的包会解析失败，重新取一份完整的）；
• 插件装完是否重启过——装插件后工具会提示重启，不重启新源和新能力不生效。

五、推送成功了但手环上没变化

• 表盘装完要在手环上手动切换才会生效（部分机型装完自动套用）；
• 快应用装完在手环的应用列表里找，列表是满的情况下新装的可能挤掉了最旧的；
• 还是不对就重启手环再看——重启能刷新资源列表。

六、还没解决

翻一遍 AstroBox 介绍站 的常见疑问区，或按下面顺序找更深层的排查：先确认工具是较新版本（旧版对新型号的适配跟不上），再核对设备型号拼写（Xiaomi Watch S5、REDMI Watch 5、Xiaomi Watch 5 是三个不同产品），最后带着现象去社区提问，描述里写清设备型号与工具版本。