Список задач на Kotlin с базой Room
В портфеле Равиля Зарипова, разработчика из Алматы, кроссплатформенные проекты занимают центральное место. Его опыт охватывает Android, iOS, Windows, macOS и Linux, а стек включает Delphi, FireMonkey, Kotlin, Swift, PHP и базы данных. Локальный Android-проект хорошо показывает, как эти навыки применяются к небольшому приложению с понятной архитектурой.
Локальный список задач на Kotlin с Room Database начинается с небольшого набора функций: создание, редактирование, отметка выполнения и удаление записей. Каждая задача должна сохраняться между запусками, поэтому приложение получает собственную базу без сервера, учётных записей и синхронизации.
Room берёт на себя создание SQLite-хранилища, проверку запросов во время сборки и преобразование строк в объекты Kotlin. DAO изолирует SQL, репозиторий формирует правила работы с данными, а ViewModel управляет состоянием экрана. Вместе эти слои создают предсказуемый поток: пользователь меняет список, изменения попадают в Room, а Room сообщает интерфейсу о новом содержимом.
В качестве пользовательского интерфейса удобно взять Jetpack Compose: он поддерживает декларативные экраны, реактивное получение данных и проверяемые состояния элементов. Важно удержать пример небольшим: одна сущность, один DAO, репозиторий, модель представления и несколько composable-функций. Такой масштаб позволяет показать полный цикл разработки и качество тестирования.
Подготовка Android-проекта
В модуле приложения нужны room-runtime, room-ktx и компилятор аннотаций Room, подключённый через KSP. Для ViewModel и жизненного цикла добавляются соответствующие библиотеки AndroidX, а для Compose — Material 3 и инструменты тестирования. Версии зависимостей удобно фиксировать в каталоге версий, чтобы во всех модулях использовались совместимые транзитивные библиотеки.
Минимальная структура состоит из пакетов data, domain и ui. В data находятся сущность, DAO и реализация базы; domain хранит правила и репозиторий; ui содержит ViewModel, composable-функции и модели состояния. Экземпляр Room создаётся один раз и передаётся зависимостями в репозиторий, поэтому экраны не открывают соединения с базой самостоятельно.
Модель задачи и локальная база
Сущность Task помечается аннотацией @Entity и описывает одну пользовательскую задачу. В модели достаточно идентификатора, краткого названия, описания, признака выполнения и времени создания. Аннотация @PrimaryKey с параметром autoGenerate = true позволяет Room выдавать числовые идентификаторы без ручного расчёта.
Поле title получает ограничение длины, а createdAt хранит метку времени в миллисекундах. Такое представление легко сортировать и не зависит от локали. Если задачи придётся искать по названию или статусу, для соответствующих столбцов можно добавить индексы Room, не меняя API репозитория.
Класс TaskDatabase помечается аннотацией @Database, содержит версию схемы и ссылается на список сущностей. Для первого запуска достаточно версии 1; последующие изменения схемы потребуют миграции. Реализацию базы обычно создают как одиночный объект с ленивой инициализацией, чтобы не открывать файл SQLite до первого обращения к данным.
Операции над данными
Интерфейс TaskDao содержит методы для получения, вставки, изменения и удаления записей. Метод observeTasks() возвращает Flow<List<Task>>, а запрос SELECT с сортировкой по времени создания определяет порядок элементов. Операции записи объявляются как suspend-функции, поэтому вызовы не блокируют поток интерфейса.
Репозиторий предоставляет приложению понятные методы вроде addTask, updateTask, toggleCompleted и deleteTask. Он скрывает аннотации DAO и может проверять допустимость изменения. Для простого приложения преобразование Entity в отдельную доменную модель необязательно, однако разделение полезно, если бизнес-правила начнут усложняться.
ViewModel получает поток DAO и преобразует его в StateFlow с помощью stateIn. Пользовательские действия запускаются в viewModelScope, а ошибки сохраняются в состоянии экрана. Такой подход отделяет Android-компоненты от способа хранения: интерфейс знает о состоянии, но не управляет SQL-запросами напрямую.
Экран приложения и состояние
Jetpack Compose позволяет собрать список через LazyColumn, отображать название и описание задачи, а завершение показывать с помощью Checkbox. Наблюдение StateFlow выполняется через collectAsStateWithLifecycle, поэтому коллекция приостанавливается, когда экран недоступен. Пустое состояние получает отдельное сообщение вместо пустого контейнера.
Форма создания хранит редактируемый текст в состоянии ViewModel. Перед сохранением название обрезается от лишних пробелов и проверяется на минимальную длину. Ошибка остаётся рядом с полем, а диалог закрывается только после успешной записи в Room. Так пользователь не теряет введённые данные из-за неверного ввода.
Если позже появится очередь автосохранения на акторах, полезно изучить жизненный цикл ресурсов: материал показывает, где освобождать подписки и останавливать фоновые операции. Для базовой версии приложения достаточно жизненного цикла ViewModel и корректного сбора потоков Compose.
Тестирование и надёжность
DAO проверяют инструментальными тестами с базой Room в памяти. Тест создаёт временную базу, вставляет несколько задач, меняет их статус и проверяет порядок результата. Такой сценарий обнаруживает ошибки в запросах, ограничениях и преобразовании типов без запуска полноценного приложения.
Схему Room сохраняют в каталоге исходников проекта. Каждое изменение Entity или структуры таблицы увеличивает версию базы и сопровождается объектом Migration. Проверка через MigrationTestHelper создаёт старую версию схемы, применяет миграцию и сравнивает результат с новой. Удаление данных через fallbackToDestructiveMigration допустимо в учебных прототипах, но не подходит для хранения пользовательских записей.
Одновременные изменения обрабатываются последовательностью Room и транзакциями. Сложные операции, затрагивающие несколько таблиц, помечаются аннотацией @Transaction, чтобы промежуточное состояние не попало в базу. Дополнительно проверяются длинные названия, пустое описание, повторное нажатие кнопки сохранения и выход приложения во время записи.
Сравнение способов хранения
Room подходит для структурированных данных с запросами, но рядом существуют более простые варианты. SharedPreferences рассчитан на настройки, прямая работа с SQLite требует ручного управления курсорами и SQL, а JSON-файл удобен для небольшого экспорта. Эти варианты сравниваются по основному назначению, проверке запросов, реактивности и рискам.
| Критерий | Room | SharedPreferences | Прямой SQLite | JSON-файл |
|---|---|---|---|---|
| Основное назначение | Структурированные задачи с запросами | Настройки и простые значения | Ручное управление SQL и схемой | Небольшие архивы или экспорт |
| Проверка запросов | Во время сборки | Не предусмотрена | На стороне разработчика | На стороне приложения |
| Реактивные обновления | Flow и LiveData | Слушатели изменений | Собственные механизмы | Перечитывание файла |
| Сложность | Средняя | Низкая | Высокая | Низкая для чтения |
| Главный риск | Схема и миграции | Ограниченный набор данных | Ошибки и дублирование кода | Слабые запросы и конкурентная запись |
Для выбранного набора функций Room занимает разумную середину: он скрывает ручной SQL, проверяет DAO при компиляции и предоставляет реактивный поток. SharedPreferences здесь недостаточно выразителен, прямой SQLite увеличит объём служебного кода, а JSON усложнит поиск, обновление и защиту целостности данных.
Готовый проект можно собрать в debug- и release-вариантах, снабдить значком, опубликовать исходный код и показать результаты тестов в профиле GitHub. В портфеле Равиля Зарипова такой Android-кейс органично продолжает линию кроссплатформенной разработки и подтверждает умение связывать локальное хранение, интерфейс и жизненный цикл приложения в единый рабочий продукт.