安装时提示解析错误或安装包损坏

报错现象

点开 APK 文件后，系统弹出「解析错误」「安装包损坏」或「无法安装」的提示。安装界面根本没打开就被系统拒绝了。

逐步排查

第一步：确认系统版本

Novella 1.x 要求 Android 7.0（API 24）及以上。在手机设置里找「关于手机」或「系统版本」，确认 Android 版本号是否 ≥ 7.0。低于这个版本只能换更高系统版本的设备，没有办法绕过。

第二步：重新下载 APK

最常见原因是下载过程中文件损坏。Novella 的安装包约 84MB，网络不稳定时容易在下载中出现文件截断或字节错误。

解决：

1. 删掉手机上已经下载的那个 APK 文件。
2. 换一个下载渠道重新下载（比如从 GitHub Releases 下过不行，试试夸克网盘的版本）。
3. 下载完后对比 GitHub Releases 上公布的 SHA256 校验值。

第三步：检查架构匹配

Novella 提供了 arm64-v8a、armeabi-v7a 和 x86_64 三种架构的安装包。绝大多数手机用的是 arm64-v8a（2018 年后的安卓手机基本是这个架构），但极个别设备（比如某些 x86 模拟器）可能需要其他架构的包。

可以用 AIDA64 或 Device Info HW 等工具查一下手机的 CPU 架构，下载对应架构的 APK。如果下载的是 universal 包（包含所有架构）则不需要担心这个。

第四步：清除安装缓存

有些 Android 系统的安装器会缓存之前失败的安装尝试，导致成功的 APK 也被判定为损坏。解决：

1. 进入设置 → 应用管理 → 找到「软件包安装程序」或「Package Installer」。
2. 点「清除缓存」（不要清除数据，否则会影响所有应用安装）。
3. 重新点开 APK 安装。

第五步：国行 ROM 的纯净模式

部分国产 ROM（小米 MIUI/HyperOS、华为 HarmonyOS、OPPO ColorOS 等）对非应用商店来源的安装有额外安全检查，有时即使 APK 没问题也会被拦截。处理：

• 临时关闭纯净模式 / 安装守护 / 安全检测。
• 在拦截弹窗里选「允许」「仍要安装」或「信任此来源」。
• 装完后安全功能可以正常开回来。

如果以上都试了还不行

最后一招：用 ADB 命令安装 绕过系统安装器的部分校验：

adb install -r sh.celia.novella.apk

如果 ADB 也返回 failure，说明 APK 文件本身确实有问题，回到第一步重新下载。