koreader 中文文档 下载 App

安装或更新失败 —— 各平台常见错误与修复

通用排查流程

遇到安装或更新问题，先做三件事：

  1. 确认版本匹配：安装包是否对应设备和架构？（Kindle 选了 Kobo 的包？Android arm64 选成了 armv7？）
  2. 确认下载完整：SHA256 校验值是否对得上？
  3. 检查依赖：Kindle 有没有装 KUAL？Kobo 有没有装 NickelMenu？

Android 安装失败

"解析软件包时出现问题"

APK 损坏或架构不匹配：

  1. 重新下载 APK（换个下载源，不要用第三方网盘镜像）
  2. 确认架构（绝大多数现代手机用 arm64）
  3. 检查 APK 文件大小是否在合理范围（27~30 MB）

安装后闪退

F-Droid 版装不上

先在 F-Droid 里卸载旧版，再装新版。或在系统设置里允许安装来自未知来源的应用后改用 APK 直装。

Kindle 安装问题

找不到 kindlehf / kindlepw2 包

固件 5.16.3 及以上必须用 kindlehf 包。早期 Kindle 用 kindlepw2 或 kindle 包。不确定时先在 MobilRead 论坛发帖问。

KUAL 启动器找不到 KOReader

检查安装路径：

  1. KOReader 有没有正确部署到 extensions 目录？
  2. KUAL 有没有正确识别 extensions？
  3. 重启 Kindle 再看

越狱后装不上新 KOReader

越狱方法和 KOReader 安装包要对应你的 Kindle 型号 + 固件版本。去 MobilRead 论坛的 KOReader 专区确认你的组合是否被社区验证过。

Kobo 安装问题

NickelMenu 里没有 KOReader 入口

检查 .adds/koreader/ 目录：

  1. KOReader 包是不是完整解压的？（解压后直接能看到 koreader.sh 和 frontend/）
  2. 有没有多一层嵌套目录？（错误：.adds/koreader/koreader-v2025/... → 正确：.adds/koreader/koreader.sh）
  3. NickelMenu 有没有重启过？

启动 KOReader 闪退/白屏

尝试换安装包：

PocketBook 安装问题

复制 zip 后没自动安装

有些 PocketBook 机型需要手动触发：

  1. 设置 → 应用管理 → 手动安装 → 选择 KOReader zip
  2. 检查 zip 是否在根目录（不是子文件夹里）

启动后立刻退出

常见原因：机型不兼容。去 GitHub Issues 搜索你的 PocketBook 型号 + "KOReader" 看有没有已知问题。

reMarkable 安装问题

aarch64 包启动失败

reMarkable 2 和 Paper Pro 必须用 remarkable-aarch64 包。传统架构的 remarkble 包在这些机型上无法启动。

Toltec 找不到 KOReader

确认 Toltec 已经更新到最新版，然后：

toltec update
toltec install koreader

更新失败

OTA 下载完成后安装崩溃

手动覆盖安装：

  1. 从 GitHub Releases 下载最新安装包
  2. 按对应平台的安装方式重新部署
  3. 覆盖安装不会丢失配置和数据

跨大版本后界面全乱了？

某些配置文件在大版本更新后可能不兼容。临时解决：

  1. 备份配置目录
  2. 删除配置目录下的 setting.dat 和 profile.lua
  3. 重启 KOReader（会恢复默认设置）
  4. 手动重新配置

求助方式

遇到上面没覆盖的问题，按以下优先级找帮助：

  1. KOReader GitHub Issues：搜索关键词 + 你的设备型号
  2. MobilRead 论坛 KOReader 专区：社区最活跃的地方
  3. KOReader 中文社区：搜索相关帖子或发帖

求助时务必提供：

继续阅读