0.2.2
Koharia v0.2.2
本次版本重点升级了 EPUB 书籍阅读器，并对漫画加载、书架管理、离线缓存、下载目录和旧版本升级兼容进行了优化。
下载
国内用户可优先选择夸克网盘或百度网盘下载。版本信息与更新说明以 GitHub Releases 为准。
- GitHub Releases：/changelogs//latest
- 夸克网盘：https://pan.quark.cn/s/f80624cde564?pwd=8tbp
提取码：8tbp - 百度网盘：https://pan.baidu.com/s/1DlOuovGpIkaQh6NSo7b4cw?pwd=6s2g
提取码：6s2g
EPUB 书籍阅读器重点更新
- 新增基于 Readium 的原生 EPUB 阅读器，为书籍提供独立于漫画的阅读体验。
- 支持分页、连续滚动、从左到右和从右到左等阅读方式。
- 新增目录、书签、全文搜索、章节切换、进度拖动和音量键翻页。
- 支持调整字号、字体、行距、段落间距、页边距、首行缩进和阅读区域。
- 支持自定义背景颜色、亮度、出版商样式以及屏幕刘海区域显示。
- 优化阅读进度恢复与服务器进度同步，减少错误跳转和重复提示。
- 新增当前页、总页数和视觉分页缓存；排版变化后会重新计算页面信息。
- 优化 EPUB 首屏加载、书籍缓存和按需资源读取，减少重复网络请求。
- 修复横竖屏切换、行距调整、出版商样式、文字方向和页面背景等问题。
- 优化 EPUB 下载、离线打开和缓存管理。
其他重点更新
- 优化漫画首屏加载，优先请求当前页面并双向预载相邻页面。
- 优化漫画快速翻页、页面缓存和网络较慢时的阅读体验。
- 书架可按服务器媒体库划分为“漫画”和“书籍”，也可以继续合并显示。
- 完善多服务器管理、服务器重命名、删除和重新添加流程。
- 优化下载目录结构，并兼容旧版本已经下载的内容。
- 区分手动下载、书籍缓存和漫画页面缓存，避免缓存状态与下载状态混淆。
- 完善旧版本数据库和单服务器配置迁移，提高直接升级的兼容性。
- 更新应用内帮助文档、隐私政策和中英文网站链接。
已知风险与问题反馈
v0.2.2 包含大量 EPUB 阅读器功能和底层加载流程调整。不同书籍排版、设备、Android WebView 版本和服务器环境之间可能仍存在一些 Bug。
如果遇到崩溃、白屏、排版异常、进度错误、加载缓慢或其他问题，欢迎通过 GitHub Issues 反馈：
https://github.com/Mister-album/Koharia/issues
提交问题时请尽量附上：
- 问题复现步骤
- Android 版本和设备型号
- 应用截图或录屏
- 应用生成的崩溃日志
- 涉及的文件类型和阅读模式
交流、反馈 QQ 群：[625289125](https://github.com/Mister-album/Koharia/commit/625289125)
升级异常处理
如果覆盖安装后出现无法启动、数据库迁移失败或旧设置冲突，可以在确认阅读进度已经同步、重要数据已经备份后：
- 卸载旧版本 Koharia。
- 下载并直接安装 v0.2.2 新版本。
- 重新添加服务器并恢复必要设置。
注意：卸载应用通常会清除本地设置、未同步的阅读进度及其他仅保存在 App 内的数据，请在操作前完成备份或同步。
Koharia v0.2.2
This release focuses on a major upgrade to the EPUB book reader, along with improvements to comic loading, library management, offline caching, download directories, and compatibility when upgrading from older versions.
Downloads
- GitHub Releases: https://github.com/Mister-album/Koharia/releases/latest
- Quark Drive: https://pan.quark.cn/s/f80624cde564?pwd=8tbp
Access code:8tbp - Baidu Netdisk: https://pan.baidu.com/s/1DlOuovGpIkaQh6NSo7b4cw?pwd=6s2g
Access code:6s2g
EPUB reader highlights
- Added a native Readium-based EPUB reader with a dedicated book-reading experience.
- Added paged and continuous scrolling modes with multiple reading directions.
- Added table of contents, bookmarks, full-text search, chapter navigation, progress seeking, and volume-key page turning.
- Added controls for font size, font family, line height, paragraph spacing, margins, first-line indentation, and the reading area.
- Added custom background colors, brightness control, publisher styles, and display cutout support.
- Improved local position restoration and server progress synchronization.
- Added visual page counts and pagination caching, with recalculation after layout changes.
- Improved first-screen loading, book caching, and on-demand resource access.
- Fixed issues involving orientation changes, line spacing, publisher styles, writing direction, and reader backgrounds.
- Improved EPUB downloads, offline opening, and cache management.
Other highlights
- Improved comic startup by prioritizing the current page and prefetching nearby pages in both directions.
- Improved rapid page turning, page caching, and reading on slower connections.
- Added optional Comics and Books library sections based on server library classification.
- Improved multiple-server management, renaming, removal, and re-adding behavior.
- Simplified download directories while preserving compatibility with existing downloads.
- Separated manual downloads, book cache, and comic page cache.
- Improved database and legacy single-server migrations for safer upgrades.
- Updated in-app documentation, privacy, and localized website links.
Known risks and feedback
Koharia v0.2.2 contains extensive EPUB reader features and underlying loading changes. Some bugs may still occur with particular book layouts, devices, Android WebView versions, or server environments.
If you encounter crashes, blank screens, layout problems, incorrect progress, slow loading, or other issues, please report them through GitHub Issues:
https://github.com/Mister-album/Koharia/issues
When possible, include:
- Steps to reproduce the problem
- Your Android version and device model
- Screenshots or screen recordings
- Crash logs generated by the app
- The affected file type and reading mode
Troubleshooting upgrades
If an in-place update causes startup failures, migration errors, or conflicts with older settings, first make sure important progress is synchronized or backed up. You can then:
- Uninstall the previous version of Koharia.
- Download and install Koharia v0.2.2 as a fresh installation.
- Add your servers again and restore any required settings.
Uninstalling the app normally removes local settings, unsynchronized reading progress, and other app-only data. Back up or synchronize important data before proceeding.
