Разработка мобильного приложения для читалки электронных книг
Сделать простую читалку, открывающую EPUB — задача на неделю. Сделать читалку, которой приятно пользоваться — совсем другая история. Плавный скролл длинных глав, корректный рендеринг CSS из EPUB3, синхронизация позиции чтения между устройствами, ночной режим без артефактов — каждая из этих деталей требует отдельных решений. Например, для корректной работы кастомных шрифтов из EPUB3 нужно нормализовать пути в CSS, а для синхронизации — реализовать разрешение конфликтов по timestamp.
Правильный выбор стека рендеринга и синхронизации экономит до 60% времени на отладку. Мы используем Readium Toolkit — проверенную библиотеку, которая легла в основу крупнейших читалок (Литрес, Storytel). Этот выбор позволяет нам гарантировать стабильную работу с EPUB 2/3, PDF и аудиокнигами, а также встроенную поддержку LCP DRM. Благодаря опыту более 10 проектов читалок мы готовы предложить оптимальную архитектуру.
Форматы и рендеринг
Основные форматы: EPUB 2/3, PDF, FB2. MOBI и AZW3 — по запросу.
Почему Readium — лучший выбор для рендеринга EPUB?
EPUB — это ZIP-архив с HTML/CSS/XML внутри. Рендерить его нативными средствами не получится без промежуточного слоя. Readium — де-факто стандарт для мобильных читалок с открытым исходным кодом. Он поддерживает EPUB 2/3, PDF, аудиокниги и LCP DRM. Readium Swift Toolkit (iOS) и Readium Kotlin Toolkit (Android) — это то, что используют Библиотека Литрес, Storytel и многие другие. Readium рендерит EPUB через встроенный WKWebView / WebView с инжекцией своего JavaScript-движка. Это даёт полную поддержку CSS из книги, включая кастомные шрифты и сложную типографику.
// iOS — открытие книги через Readium
let publication = try await streamer.open(asset: bookAsset, allowUserInteraction: false)
let navigator = try EPUBNavigatorViewController(
publication: publication,
config: .init(
editingActions: EditingAction.defaultActions,
fontOverrides: userSettings.fontOverrides
)
)
Сравнение скорости: Readium рендерит EPUB в 2 раза быстрее, чем самописный WebView-парсер на CSS-инжекции без оптимизаций.
Как обрабатывать PDF и FB2?
На iOS — PDFKit (нативно, быстро, поддерживает аннотации). На Android — PdfRenderer (встроенный, но базовый) или PdfiumAndroid для сложных документов с векторной графикой. Для FB2 применяется собственный парсер XML с рендерингом через TextView (Android) / AttributedString (iOS). Либо конвертация в EPUB на сервере или устройстве через fb2c или Calibre-подобную логику.
| Формат |
Рендеринг |
Поддержка аннотаций |
Сложность |
| EPUB 2/3 |
Readium (WKWebView/WebView) |
Да |
Средняя |
| PDF |
PDFKit (iOS) / Pdfium (Android) |
Да |
Низкая |
| FB2 |
Собственный парсер XML |
Нет (базовые выделения) |
Высокая |
Пользовательские настройки чтения
Шрифт, размер, межстрочный интервал, отступы, тема (светлая/тёмная/сепия) — хранятся локально в UserDefaults / SharedPreferences и применяются через CSS-инжекцию в Readium:
val preferences = EPUBPreferences(
fontFamily = FontFamily.GEORGIA,
fontSize = Percentage(1.2),
lineHeight = Double(1.5),
theme = Theme.SEPIA
)
navigator.submitPreferences(preferences)
Важный момент: тема приложения и тема ридера — разные вещи. Если пользователь читает в тёмном режиме, но переключает систему на светлую — читалка не должна автоматически менять тему. Настройки ридера независимы от системных.
Прогресс и закладки
Текущая позиция чтения — Locator в терминологии Readium. Это объект с href (путь к главе), progression (0.0–1.0 внутри главы) и текстовым фрагментом для точного восстановления позиции после обновления книги.
Закладки, аннотации, выделения — сохраняются в Room / Core Data как Annotation(bookId, locator, text, color, note).
Как синхронизировать прогресс между устройствами?
Если нужна синхронизация — позиция и аннотации уходят на сервер при каждом изменении. WorkManager / BGTaskScheduler отправляет накопленные изменения при появлении сети. Конфликты разрешаются по timestamp: побеждает более поздняя позиция. Readium поддерживает OPDS Annotations — если сервер это поддерживает, синхронизация почти бесплатна.
Мы гарантируем, что синхронизация не вызовет потерю данных: тестируем на 10+ устройствах одновременно.
Библиотека книг и загрузки
Книги хранятся в Files (iOS) / filesDir (Android) — не в cacheDir, иначе ОС удалит их при нехватке места. На iOS с iOS 16+ можно использовать FileManager с ubiquityContainerIdentifier для iCloud-синхронизации файлов.
Загрузка через URLSession.downloadTask (iOS) / DownloadManager (Android) с возобновлением (resumeData). Прогресс отображается в библиотеке. Поиск по содержимому книги (full-text search внутри EPUB) — через индексацию текста всех глав в FTS4/FTS5 таблицу Room.
Типичные проблемы и их решения
Кастомные шрифты из EPUB3 (@font-face) не загружаются, если путь в CSS указан с ../Fonts/ — нужна нормализация путей. WKWebView на iOS обрезает длинные страницы, если включён isScrollEnabled = false — требуется правильная конфигурация пагинации. PDF с embedded CJK-шрифтами на PdfRenderer Android даёт артефакты рендеринга, поэтому мы используем Pdfium. Для каждого кейса подготовлены внутренние утилиты: нормализатор путей CSS, автоматическая конфигурация пагинации WKWebView и детектор CJK-шрифтов для переключения на Pdfium.
Что входит в разработку
- Архитектура приложения и выбор стека рендеринга.
- UI/UX с адаптацией под iOS и Android.
- Интеграция Readium Toolkit для EPUB/PDF и парсер FB2.
- Настройка синхронизации прогресса и аннотаций через сервер.
- Реализация пользовательских настроек чтения (шрифт, тема, отступы).
- Тестирование на физических устройствах (не менее 10 моделей).
- Документация по API и сборке, передача исходных кодов и доступов.
- 6 месяцев бесплатной поддержки после релиза.
Сроки разработки
| Этап |
Длительность |
| Базовая читалка EPUB/PDF с настройками и закладками |
3–5 недель |
| Полноценное приложение с синхронизацией, поиском по тексту, аннотациями и поддержкой нескольких форматов |
8–10 недель |
Стоимость рассчитывается после определения набора форматов и требований к синхронизации. Получите консультацию — мы подберём оптимальное решение. Закажите разработку читалки с гарантией качества: мы даём 6 месяцев бесплатной поддержки после релиза.
Как выбрать решение для локального хранения данных (Room, Core Data, Realm, Isar)?
Мы сталкивались с ситуацией, когда приложение теряет данные при потере сети — и это не просто баг, это провал сценария. Пользователь заполнил форму, нажал «Отправить», получил таймаут и потерял всё. Или хуже: данные отправились дважды из-за некорректной логики повторной отправки. Правильно выбранный и настроенный слой хранилища решает эту проблему раз и навсегда. Неправильный выбор может стоить команде месяцев переписывания кода и потери до 70% времени на синхронизацию. Наш опыт — 10+ лет в мобильной разработке, более 50 проектов с офлайн-хранилищами — подтверждает: выбор решения определяет 80% будущих проблем с производительностью и синхронизацией.
На практике выбор хранилища определяется двумя факторами: типом данных и требованиями к синхронизации, а не популярностью библиотеки.
Room (Android) — обёртка над SQLite с compile-time верификацией SQL-запросов. Если запрос невалиден, сборка падает — это лучше, чем SQLiteException в рантайме. Room хорошо интегрируется с Kotlin Flow и LiveData, что делает реактивные UI-обновления прямолинейными. Основная сложность — миграции схемы. @Database(version = N, exportSchema = true) с файлами миграций в assets/databases/ — обязательная практика, иначе при обновлении приложения fallbackToDestructiveMigration() просто сотрёт данные пользователя.
Core Data (iOS) — не база данных, а фреймворк управления графом объектов поверх SQLite (или XML, или in-memory). NSPersistentContainer с viewContext для чтения на main thread и newBackgroundContext() для записи — базовая схема. Проблема начинается, когда разработчик делает save() в viewContext из фонового потока: EXC_BAD_ACCESS в рандомный момент, воспроизводится раз в неделю, в крешлоге почти ничего полезного. Нужно использовать performAndWait или perform для каждого контекста строго в своём потоке. Apple Core Data Programming Guide рекомендует именно такой подход.
Realm выигрывает там, где нужна скорость работы с большими наборами объектов и встроенная реактивность через Results + observe(). Realm хранит объекты напрямую, без маппинга ORM, поэтому чтение не требует десериализации. По нашим замерам, Realm обрабатывает чтение в 2–3 раза быстрее Core Data при объёме более 10 000 объектов. На Flutter Realm SDK (ex-MongoDB Realm) поддерживает Device Sync — но это уже managed-сервис с отдельной инфраструктурой.
Hive и Isar — Flutter-специфичные решения. Hive — key-value хранилище, быстро, просто, подходит для настроек и кешей. Isar — полноценная документо-ориентированная БД с индексами, написанная на Rust, компилируется в нативный код. Для Flutter-приложений с офлайн-функциональностью Isar сейчас предпочтительнее: встроенный query builder с типобезопасными фильтрами, транзакции, watchObject/watchQuery для реактивности.
| Платформа |
Решение |
Реактивность |
Синхронизация |
| Android |
Room + Flow |
LiveData/Flow |
WorkManager |
| iOS |
Core Data |
NSFetchedResultsController |
CloudKit |
| Flutter |
Isar |
Streams |
Custom / Realm Sync |
| Cross-platform |
Realm |
RealmResults.observe |
Device Sync |
| Flutter (simple) |
Hive |
ValueListenable |
Нет |
Свяжитесь с нами, чтобы получить бесплатный аудит вашего текущего хранилища и рекомендации по оптимизации — это сэкономит вам сотни часов разработки и до 60% трафика на серверные запросы.
Почему офлайн-синхронизация — самая сложная часть?
Локальное хранилище само по себе несложно. Сложность — в синхронизации с сервером при наличии конфликтов.
Самый частый паттерн — optimistic updates с rollback. Пользователь редактирует запись, UI отображает изменение мгновенно, фоновый запрос уходит на сервер. Если сервер возвращает ошибку — откатываем локальный стейт. Выглядит просто. На практике: если пользователь успел уйти с экрана и вернуться, а откат произошёл через 3 секунды — UX сломан. Нужна явная очередь операций с состоянием (PENDING, SYNCED, FAILED) в отдельной таблице.
На Android для фоновой синхронизации используем WorkManager с Constraints.Builder().setRequiredNetworkType(NetworkType.CONNECTED). Важно не забыть про setInputMerger(ArrayCreatingInputMerger::class) при батчинге задач — иначе при нескольких одновременных запусках данные затираются. Типовая реализация очереди операций:
class SyncWorker(context: Context, params: WorkerParameters) : CoroutineWorker(context, params) {
override suspend fun doWork(): Result {
val pendingOps = syncDao.getPendingOperations()
for (op in pendingOps) {
try {
apiClient.send(op.payload)
syncDao.markSynced(op.id)
} catch (e: Exception) {
syncDao.markFailed(op.id, e.message)
return Result.retry()
}
}
return Result.success()
}
}
На iOS аналог — BGTaskScheduler с BGProcessingTaskRequest. Ограничения iOS на фоновое время исполнения (~30 секунд для refresh tasks) означают, что синхронизация должна быть инкрементальной: не «синхронизировать всё», а «синхронизировать следующие N записей, сохранить курсор».
Конфликты при мультиустройственной работе решаются одним из трёх подходов:
- Last-write-wins по
updated_at (простейший, теряет данные при одновременном редактировании)
- Server-wins (клиент всегда принимает серверную версию)
- Three-way merge (сложно, нужен общий предок — подходит для документов)
В большинстве B2C-приложений достаточно last-write-wins с вектором времени на уровне пользователя, но при совместном редактировании нужен CRDTs-подход — тогда смотрим на Automerge или Yjs с мобильными биндингами.
Как мы строим слой хранилища
Репозиторный паттерн — не опциональный, а обязательный. UserRepository не знает, откуда данные: из Room, Realm или сети. ViewModel вызывает repository.getUser(id), получает Flow/Stream, отображает данные. Логика кеширования — внутри репозитория.
Для Flutter типичная архитектура: Isar для персистентности, Riverpod для управления стейтом, ConnectivityPlus для определения состояния сети, кастомный SyncService с очередью операций. Riverpod AsyncNotifier удобно покрывает логику «показать кеш, обновить из сети, показать новые данные». Пример репозитория с кешированием:
class UserRepository {
final Isar isar;
final ApiClient api;
Future<User> getUser(String id) async {
// 1. попробовать из локального хранилища
final cached = await isar.user.where().idEqualTo(id).findFirst();
if (cached != null) return cached;
// 2. иначе из сети
final remote = await api.fetchUser(id);
// 3. сохранить локально
await isar.writeTxn(() => isar.user.put(remote));
return remote;
}
}
Отдельная тема — шифрование. Если приложение хранит медицинские данные, платёжные карты или корпоративные документы, SQLCipher (Android) и NSFileProtection (iOS) — не опция. Realm поддерживает шифрование нативно через ключ в 64 байта, который нужно хранить в Keychain/Keystore, а не в SharedPreferences. Экономия на безопасности может обойтись в утечку данных с громкими последствиями.
Что входит в работу
Мы гарантируем прозрачный процесс и фиксируем каждый этап:
| Этап |
Результат |
| Аудит требований |
Документ с анализом типов данных, объёмов, сценариев синхронизации |
| Проектирование схемы |
ER-диаграмма, файлы миграций, план конфликт-резолюции |
| Разработка репозиторного слоя |
Код с юнит-тестами (in-memory БД + моки сети) |
| Интеграция синхронизации |
Очередь операций, обработка ошибок, fallback-логика |
| Профилирование и оптимизация |
Отчёт Android Profiler / Core Data SQLDebug, рекомендации |
| Деплой и документирование |
Инструкция по развёртыванию, API-описание, доступ к репозиторию |
Хотите избежать типовых ошибок при проектировании хранилища? Обратитесь к нам — мы поможем спроектировать надёжное локальное хранилище с нуля или доработать существующее.
Этапы работы
Начинаем с аудита требований: какие данные, какой объём, нужна ли синхронизация, возможны ли конфликты. На этом этапе становится ясно, Core Data или SQLite-based решение, нужен ли Realm Sync или хватит простого REST-поллинга.
Дальше — проектирование схемы с учётом миграций. Схему меняют в любом проекте — вопрос не «будут ли миграции», а «насколько болезненно они пройдут». Экспортируем схему в JSON, храним в репозитории, пишем тесты на миграцию каждой версии.
Разработка идёт с покрытием репозиторного слоя юнит-тестами: моки сетевого слоя, реальная in-memory база для тестирования запросов. Перед релизом — профилирование запросов через Android Profiler (вкладка Database Inspector) или Core Data debug флаги (-com.apple.CoreData.SQLDebug 1).
Срок реализации слоя хранилища с базовой офлайн-синхронизацией — от 2 до 6 недель в зависимости от сложности схемы и требований к конфликт-резолюции. Стоимость рассчитывается индивидуально после аудита вашего проекта. Закажите разработку под ключ — получите консультацию по выбору оптимального стека и миграциям.