Откройте для себя современные Android-репозитории: MVI, Compose, Hilt и многомодульность

Ваш гид по Kotlin-проектам с передовой архитектурой, включая Compose Destinations, без KMP.

В современной Android-разработке выбор правильной архитектуры и стека технологий играет решающую роль. Вы ищете Kotlin-проекты, которые не только используют многомодульный подход (с разделением на app, feature и core модули), но и в своих feature-модулях применяют паттерн MVI (Model-View-Intent), декларативный UI фреймворк Jetpack Compose, библиотеку Compose Destinations для навигации и Hilt для внедрения зависимостей, при этом не являясь Kotlin Multiplatform (KMP) проектами. Найти репозитории, идеально соответствующие всем этим критериям, может быть непросто, особенно с явным использованием Compose Destinations. Однако существует множество проектов, которые либо близки к этому, либо служат отличной основой для интеграции недостающих компонентов.

Ключевые моменты

Многомодульная архитектура (app, feature, core) способствует лучшей организации кода, повышает его переиспользуемость, ускоряет время сборки и облегчает параллельную разработку командами.
Сочетание MVI для управления состоянием, Jetpack Compose для создания пользовательского интерфейса и Hilt для внедрения зависимостей является мощным и современным стеком для создания масштабируемых и тестируемых Android-приложений.
Compose Destinations — это популярная библиотека, которая упрощает навигацию в Jetpack Compose, делая ее типобезопасной и сокращая количество шаблонного кода. Не все проекты могут явно ее использовать, но многие из них легко адаптируются для ее интеграции.
Все рассматриваемые проекты ориентированы исключительно на Android и написаны на Kotlin, без использования Kotlin Multiplatform.

Что если Compose Destinations не указан явно?

Многие качественные проекты, использующие MVI, Compose и Hilt в многомодульной среде, могут применять стандартную библиотеку Jetpack Compose Navigation. Compose Destinations создана для упрощения работы с ней, предлагая генерацию кода и типобезопасность. Если понравившийся вам репозиторий не использует Compose Destinations, его часто можно интегрировать:

Убедитесь, что проект использует Jetpack Compose Navigation.
Добавьте зависимости Compose Destinations и KSP (Kotlin Symbol Processing) плагин.
Аннотируйте ваши Composable-функции экранов с помощью @Destination.
Создайте навигационный граф с помощью @NavGraph или @RootNavGraph.

Официальный репозиторий raamcosta/compose-destinations и его документация являются лучшими источниками информации по интеграции.

Официальный репозиторий Compose Destinations

Официальная документация Compose Destinations

Визуализация архитектурных компонентов

Представленная ниже ментальная карта иллюстрирует ключевые компоненты и их взаимосвязи в запрашиваемой архитектуре Android-приложения. Она показывает, как многомодульность структурирует проект, и какие технологии используются в рамках feature-модулей.

mindmap root["Современная Android Архитектура на Kotlin"] id1["Многомодульность"] id1_1["app (Основной модуль приложения)"] id1_2["feature (Функциональные модули)"] id1_2_1["MVI (Model-View-Intent)"] id1_2_2["Jetpack Compose (Пользовательский интерфейс)"] id1_2_3["Compose Destinations (Навигация)"] id1_2_4["Hilt (Внедрение зависимостей)"] id1_3["core (Общие модули: утилиты, базовые классы, DI)"] id2["Ключевые технологии"] id2_1["Kotlin (Язык программирования)"] id2_2["Android (Платформа, не KMP)"] id3["Преимущества"] id3_1["Масштабируемость"] id3_2["Тестируемость"] id3_3["Поддерживаемость"] id3_4["Разделение ответственностей"]

Ментальная карта современной Android-архитектуры.

Сравнение аспектов архитектуры

Радарная диаграмма ниже представляет собой обобщенное сравнение различных аспектов архитектуры для гипотетических типов проектов. Это помогает визуализировать, как различные проекты могут соответствовать идеальным критериям или какие области могут потребовать доработки. Оценки (от 1 до 5, где 5 – наилучший показатель) являются иллюстративными и основаны на общем понимании подобных архитектур.

Радарная диаграмма, сравнивающая ключевые архитектурные аспекты.

Глубже в Навигацию с Compose Destinations

Библиотека Compose Destinations значительно упрощает реализацию навигации в Jetpack Compose. Она использует аннотации и кодогенерацию (через KSP) для создания типобезопасных навигационных путей, устраняя необходимость в ручном определении строк маршрутов и обработке аргументов. Это особенно полезно в многомодульных проектах, где навигация между различными feature-модулями может стать сложной. Встроенное видео ниже подробно рассказывает об использовании Compose Destinations.

Видеоурок по использованию Compose Destinations для навигации в Jetpack Compose.

Преимущества выбранного стека технологий

Выбор многомодульной архитектуры в сочетании с MVI, Jetpack Compose, Compose Destinations и Hilt предоставляет разработчикам мощный инструментарий для создания современных, поддерживаемых и масштабируемых Android-приложений. Каждый компонент этого стека вносит свой вклад в общую эффективность и качество разработки.

Пример графа зависимостей в многомодульном проекте

Пример графа зависимостей, иллюстрирующий связи между модулями в многомодульном Android-приложении.

В таблице ниже представлено краткое описание каждой технологии и ее преимуществ в контексте данного архитектурного стека.

Технология / Принцип	Описание	Преимущества в данном стеке
Многомодульность (app, feature, core)	Разделение проекта на независимые, но связанные модули, каждый из которых отвечает за определенную функциональность или слой.	Улучшенная организация и структура кода, повышение переиспользуемости компонентов, сокращение времени сборки за счет компиляции только измененных модулей, возможность параллельной разработки.
MVI (Model-View-Intent)	Архитектурный паттерн, основанный на однонаправленном потоке данных (unidirectional data flow) и неизменяемом состоянии (immutable state).	Обеспечивает предсказуемое управление состоянием, упрощает отладку, повышает тестируемость логики представления и бизнес-логики, четко разделяет ответственности.
Jetpack Compose	Современный декларативный UI-фреймворк от Google для создания нативных пользовательских интерфейсов Android.	Ускоряет и упрощает разработку UI, требует меньше шаблонного кода по сравнению с XML, предоставляет мощные возможности для создания кастомных и анимированных интерфейсов, отлично интегрируется с Kotlin.
Compose Destinations	Библиотека, упрощающая навигацию в Jetpack Compose за счет использования аннотаций и кодогенерации KSP.	Обеспечивает типобезопасную навигацию, автоматически генерирует навигационный код, упрощает передачу аргументов между экранами, сокращает количество boilerplate-кода для навигации.
Hilt	Библиотека для внедрения зависимостей (Dependency Injection) для Android, построенная на основе Dagger.	Упрощает настройку и использование DI в Android-проектах, легко интегрируется с компонентами Jetpack (например, ViewModel), сокращает объем шаблонного кода для DI, улучшает тестируемость.

Часто задаваемые вопросы (FAQ)

В чем заключаются преимущества многомодульной архитектуры (app, feature, core)?

Почему стоит использовать архитектурный паттерн MVI в связке с Jetpack Compose?

Что такое Compose Destinations и какие проблемы он решает в навигации?

Какую роль играет Hilt в проектах с такой архитектурой?

Можно ли легко интегрировать Compose Destinations в проект, если он изначально использует стандартную Jetpack Compose Navigation?

Да, интеграция Compose Destinations в проект, который уже использует стандартную Jetpack Compose Navigation, обычно проходит достаточно гладко, так как Compose Destinations работает поверх нее. Основные шаги включают:

Добавление зависимостей: Подключите библиотеку Compose Destinations и плагин KSP (Kotlin Symbol Processing) в ваши `build.gradle` файлы.
Аннотирование экранов: Замените ручное определение маршрутов аннотированием ваших Composable-функций экранов с помощью аннотации @Destination. Укажите маршрут, тип навигации (например, для диалогов), и аргументы.
Создание навигационного графа: Определите навигационные графы с помощью аннотаций @NavGraph или @RootNavGraph на Composable-функции, которая будет содержать ваш `NavHost` (или его аналог от Compose Destinations).
Обновление вызовов навигации: Замените вызовы `navController.navigate("route/argument")` на типобезопасные вызовы, сгенерированные Compose Destinations (например, `navigator.navigate(ProfileScreenDestination(userId = 123))`).
Удаление старого кода: После миграции можно удалить старый код, связанный с ручным определением маршрутов и обработкой аргументов.

Хотя процесс может потребовать некоторых изменений в коде, преимущества типобезопасности и сокращения шаблонного кода часто оправдывают усилия, особенно в больших проектах.