Rays 安装失败排查全流程
提示"解析包时出错"
原因
多半是安装包不完整或与机型架构不匹配。
排查步骤
- 确认下载的是 arm64 版本（近几年主流机型都是这个架构）
- 删掉已下载的包，重新下载一次 —— 下载中途断网或网盘缓存会导致文件不完整
- 换个下载工具试试（比如换一个浏览器、或用网盘 App 下载而不是浏览器直接下）
快速验证
下载完成后检查文件体积是否在正常范围（最新版约 19.5 MB）。如果明显偏小或偏大，说明下载有问题。
点安装没反应，或提示被禁止
原因
这是未知来源安装许可没开。
排查步骤
- 弹窗里直接给了去开启的入口——点进去
- 找到你用来下载安装包的那个具体来源（浏览器、文件管理器或网盘 App）
- 给这个来源打开"允许安装应用"的许可
- 返回继续安装
不需要做的事
不要去改系统全局设置里的"允许未知来源应用"开关。只给具体来源开一次安装许可，更安全。
装完打开就闪退
排查顺序（从简单到复杂）
- 强行停止后重新打开 —— 设置 → 应用 → Rays → 强行停止，再点开
- 清缓存 —— 设置 → 应用 → Rays → 存储 → 清除缓存。清缓存不动你的表情包库，可以放心操作
- 导出数据后卸载重装 —— 别直接卸载！先打开 Rays 导出数据文件，卸载重装后导入回来
什么时候需要重装
做完前两步还是闪退，而且这个闪退是每次打开都闪退（不是偶发），那大概率是安装过程中损坏了。卸载重装能解决绝大多数情况。
什么时候该等下一个版本
如果你重装之后还是闪退，而且这个闪退只在你的手机上出现（去 GitHub Issues 搜没人反馈相同机型的问题），那可能是当前版本和你的设备有兼容性 bug。暂时先用着，等作者修复。
版本不匹配导致的问题
如果你的系统低于 Android 7.0，安装包可能根本装不上，或者装上就闪退。这种情况没法靠排查解决——系统版本是硬门槛。
还不行怎么办
Rays 是开源项目，遇到问题可以去 GitHub Issues 提。提之前先搜一下有没有人遇到过类似问题，问题描述里记得带上你的手机品牌、型号、Android 版本、Rays 版本号。