Создание простого трекера привычек на Kotlin для Android
Привычки легче закрепить, когда результат виден сразу: одна отметка превращает абстрактное намерение в конкретное действие. Простой трекер должен быстро добавлять запись, показывать текущую серию и хранить историю без регистрации, рекламы и постоянного подключения к интернету. Именно эти ограничения определяют небольшой набор экранов и делают мобильное приложение понятным даже при первом запуске.
Я Равиль Зарипов, разработчик из Алматы. Мой рабочий стек включает Delphi, FireMonkey, Kotlin, Swift, PHP и базы данных, а проекты охватывают Android, iOS, Windows, macOS и Linux. Для этой задачи я выбрал Kotlin и Jetpack Compose: декларативный интерфейс ускоряет сборку экранов, а знакомые архитектурные принципы помогают отделить бизнес-логику от Android-компонентов.
| Критерий | Room | DataStore | Серверное API |
|---|---|---|---|
| Основное назначение | Структурированные записи и связи | Настройки и простые значения | Обмен данными между устройствами |
| Работа без сети | Полная | Полная | Ограниченная |
| Сложность внедрения | Умеренная | Высокая для хранения истории | Высокая |
| Роль в приложении | Привычки, отметки, статистика | Темы и флаги | Синхронизация и резервное копирование |
Архитектура и границы приложения
Для небольшого приложения достаточно архитектуры MVVM: Compose-экраны принимают состояние и отправляют события, ViewModel преобразует намерения в вызовы репозитория, а репозиторий скрывает Room от пользовательского интерфейса. Контейнер внедрения зависимостей можно подключить позже, поскольку на старте зависимости создаются вручную и их легко заменить при тестировании.
Такое разделение особенно полезно при расширении продукта. Опыт разработки под разные операционные системы подсказывает, какие правила стоит вынести в общий слой, а какие оставить платформенными. Материалы о моих подходах и проектах собраны в каталоге ресурсов. Здесь можно увидеть, как архитектурные решения переносятся между мобильным и настольным программным обеспечением.
Первый экран приложения отображает список привычек, кнопку отметки и краткую статистику. Нажатие открывает карточку с историей и текущей серией. Добавление выполняется через диалоговое окно, поэтому отдельный экран для формы не требуется. Такая структура оставляет достаточно места для будущих функций, не перегружая первую версию.
Проект Gradle и структура данных
В Android Studio создаётся новый проект с плагинами Android, Kotlin и Compose. Параметры compileSdk и targetSdk выбираются по актуальным требованиям платформы, а minSdk определяется аудиторией. В зависимости добавляются Compose BOM, Activity Compose, Navigation Compose, Lifecycle ViewModel, Room и Kotlin Coroutines. Kotlin DSL делает конфигурацию сборки прозрачной и позволяет хранить версии зависимостей в одном месте.
Для хранения нужны две связанные сущности. Привычка содержит название и дату создания, а отметка связывает её с конкретным днём. Дату удобно представить числом epochDay: такой формат легко сортировать, сравнивать и переводить в LocalDate, не сохраняя строки с разными региональными настройками.
@Entity(tableName = "habits")
data class HabitEntity(
@PrimaryKey(autoGenerate = true)
val id: Long = 0,
val title: String,
val createdAt: Long
)
@Entity(
tableName = "habit_completions",
primaryKeys = ["habitId", "epochDay"],
foreignKeys = [
ForeignKey(
entity = HabitEntity::class,
parentColumns = ["id"],
childColumns = ["habitId"],
onDelete = ForeignKey.CASCADE
)
],
indices = [Index("habitId")]
)
data class HabitCompletionEntity(
val habitId: Long,
val epochDay: Long
)
Доступ к данным оформляется через DAO — интерфейс с аннотациями Room. Запросы отметок возвращают Flow, поэтому изменения в базе сразу передаются в ViewModel. Уникальный составной ключ не позволяет создать две отметки за один день, а внешний ключ с каскадным удалением автоматически очищает историю удалённой привычки. Изменения отметки и связанных данных выполняются внутри транзакции.
Добавление привычек и навигация
Навигация строится на NavHost с маршрутами для списка и карточки привычки. Единственная Activity размещает Compose-интерфейс, а Scaffold提供 общую структуру экрана: верхнюю панель, основное содержимое и плавающую кнопку добавления. Список реализуется через LazyColumn, поэтому создание большого количества карточек не расходует память.
ViewModel хранит состояние в StateFlow, а экран собирает его с помощью collectAsStateWithLifecycle. Такая связка останавливает сбор значений, когда интерфейс находится в фоновом режиме, и исключает обращения к жизненному циклу экрана из слоя данных. До загрузки списка показывается индикатор, после неё — привычки либо понятное сообщение об отсутствии записей.
Добавление формы содержит поле названия и кнопку подтверждения. Пустая строка и название из одних пробелов отклоняются до вызова базы данных. После успешного сохранения диалог закрывается, а список обновляется автоматически. Ошибка вставки показывается через Snackbar, не прерывая работу пользователя. Такой сценарий сохраняет ввод в памяти компонента и не требует отдельной формы Activity.
Отметки, серии и статистика
Для отметки выбранного дня вычисляется LocalDate.now().toEpochDay(), после чего создаётся HabitCompletionEntity. Операция вставки использует стратегию игнорирования конфликтов, поэтому повторное нажатие не создаёт дубликат. Повторное касание снимает отметку, что позволяет исправить случайное действие без отдельного режима редактирования.
Статистика вычисляется из отсортированных дат. Текущая серия равна количеству последовательных дней с отметками, а её начало допускается во вчерашнем дне, если сегодняшняя отметка ещё не сделана. Самая длинная серия находится полным проходом по истории. Процент выполнения за последние семь дней сравнивает число отмеченных дней с доступным периодом существования привычки.
Потоки Room объединяются в репозитории и преобразуются в единое состояние ViewModel. После любой операции интерфейс получает обновлённые данные без ручного перезапуска экрана. Вычисление статистики для небольшой личной базы можно выполнять в Kotlin: это проще тестировать и позволяет сразу работать с LocalDate. Для крупных объёмов данных запросы лучше переносить в SQL с агрегатными функциями.
Тесты, сборка и развитие продукта
Проверка начинается с модульных тестов ViewModel: они проверяют добавление, отмену повторной отметки и обработку ошибок. DAO проверяется инструментальными тестами с базой в памяти. UI-тесты Compose используют семантические метки вместо координат, чтобы проверка не зависела от размера экрана. Историю лучше тестировать с фиксированной текущей датой, иначе результат может измениться посреди проверки.
Релизная сборка включает ресурсное сжатие и минификацию кода, правильные версии приложения, иконки и собственную подпись. Секреты не помещаются в исходный код, а журналирование ошибок не должно сохранять названия привычек. Поскольку первая версия работает локально, ей не нужны разрешения на доступ к сети, контактам или геолокации. Это уменьшает объём проверки и упрощает политику конфиденциальности.
Следующие версии могут включать экспорт данных в JSON, резервную копию через системный выбор файла и необязательную синхронизацию с учётной записью. Общие правила расчёта серий имеет смысл вынести в модуль Kotlin Multiplatform, если появится версия для iOS, Windows, macOS или Linux. Готовый трекер при этом остаётся компактным: он хранит историю, показывает прогресс и позволяет зафиксировать ежедневное действие в одно касание.