Личное развитие · Android + iOS

Kotlin Multiplatform: сетап проекта с нуля

сен 2026 → окт 2026

Приложение на Kotlin Multiplatform: каталог городов со списком, поиском и картой. Предметная часть намеренно простая, потому что цель в другом: собрать с нуля то, на чём держится большое KMP-приложение. Логика, экраны, дизайн-система и навигация написаны один раз для Android и iOS.

Это мой личный проект: я решил сам пройти путь целиком, чтобы понимать сетап мультиплатформенного приложения изнутри.

23 модуля2 платформы

Личное развитие · Android + iOS

12:30

+−

12:30

↓

.md✓

12:30

Формат: Личный проект
Роль: Автор и единственный разработчик
Сетап: С нуля, полностью мой
Период: сен 2026 → окт 2026
Платформы: Android + iOS (общий код на KMP)

Что я делал

Сетап проекта с нуля
23 модуля и общие правила сборки
- Проект начался с пустого репозитория. Первым коммитом я заложил каркас: приложение android/app, общий модуль shared и слои внутри него. В core лежат domain, data, ui, uikit, routing и component, а каждая фича состоит из domain, data, ui и routing. Всего 23 Gradle-модуля.
- Правила сборки живут в build-conventions. shared-convention настраивает любой KMP-модуль: Android, оба iOS-таргета и KSP для DI. Рядом compose-convention и detekt-convention, так что модуль подключает ровно то, что ему нужно.
- Версии библиотек лежат в одном version catalog, репозитории объявлены один раз в settings, а модули ссылаются друг на друга типобезопасно: projects.shared.core.domain вместо строки с путём.
- Проверки качества подключены с первого дня: Spotless с ktlint форматирует код, detekt 2 с правилами для Compose ловит ошибки. Задача prePushCheck запускает оба для Android, commonMain и iosMain.
- Ключ MapKit в репозиторий не попадает: он берётся из переменной окружения или local.properties.
UrentSample
├ android/app
├ shared
├ coredomain data ui uikit routing component
├ featureapp home-tabs cities map
├ lib/annotation · resources
├ build-conventionsshared · compose · detekt
├ lib/generatorKSP
23 модуля
✓ TYPESAFE_ACCESSORS✓ FAIL_ON_PROJECT_REPOS✓ spotless + ktlint✓ detekt 2✓ prePushCheck
Выбранный стек
Что взято и как это сочетается
- Стек я собрал из Decompose, kotlin-inject с Anvil, Ktor, SQLDelight и Remo, а feature-модули разложил на domain, data, ui и routing.
- UI: Kotlin 2.4 и Compose Multiplatform 1.12 с Material 3, экраны написаны один раз для обеих платформ. Навигация: Decompose. MVI: Orbit.
- DI: kotlin-inject с Anvil, граф проверяется при компиляции и без рефлексии работает одинаково на Android и iOS.
- Сеть: Ktor 3.6 (OkHttp на Android, Darwin на iOS) и kotlinx.serialization. Данные: SQLDelight 2.4 и Paging 3. Платформенное: Yandex MapKit и WorkManager на Android.
UIKotlin 2.4Compose Multiplatform 1.12Material 3
АрхитектураDecomposeOrbitRemo
DIkotlin-injectAnvilKSP
ДанныеKtor 3.6SQLDelightPaging 3
AndroidMapKitWorkManager
Качествоdetekt 2Spotlessktlint
AndroidiOS
Один код для Android и iOS
commonMain, androidMain и iosMain
- Почти всё живёт в commonMain: бизнес-логика, экраны, навигация, дизайн-система, сеть и база. Платформенного кода немного, он лежит в androidMain и iosMain.
- Подключены оба iOS-таргета, iosArm64 и iosSimulatorArm64. Каждый KMP-модуль получает их из общей конвенции, поэтому новая фича сразу появляется и на iOS.
- Различия закрыты через expect/actual и DI: свой HTTP-клиент, корневой компонент DI, конвертер сетевых ошибок и карта у каждой платформы. Для iOS настроен фреймворк MultiPlatformLibrary с явным экспортом нужных модулей.
- Xcode-приложения-обёртки в этом репозитории пока нет, карта на iOS заглушка, а экспорт через WorkManager есть только на Android. Общий код от этого не зависит.
commonMain
бизнес-логика · экраны · навигация · UI Kit
▾▾
androidMain
iosMain
OkHttpDarwin
AndroidAppComponentIosAppComponent
ImeTargetImeTarget
MapKitзаглушка
iosArm64 · iosSimulatorArm64MultiPlatformLibrary
Дизайн-система
Токены и компоненты на Compose Multiplatform
- Токены дизайна (цвета, типографика, формы и тени) доступны через объект AppTheme. Светлая и тёмная темы это два набора цветов, а компоненты берут цвет только из AppTheme и не знают, какая тема включена.
- UI Kit лежит в :shared:core:uikit и работает на обеих платформах: кнопки, поля ввода, верхняя панель, нижняя навигация, сообщение об ошибке и shimmer-заглушки загрузки. Строки и картинки в Compose Resources.
- Отдельно занялся клавиатурой (цель для IME под Android и iOS) и отступами от выреза и системных панелей: они заданы в одном месте, чтобы экраны не считали их сами.
colorstypographyshapesshadows
▾
AppTheme
Light
Dark
ButtonTextFieldTopAppBarBottomBarShimmer
DI и свой генератор кода
kotlin-inject, Anvil и три KSP-процессора
- DI построен на kotlin-inject с Anvil: компоненты склеиваются через @MergeComponent, реализации подключаются через @ContributesBinding, а области видимости заданы явно (AppScope, ForegroundScope и отдельный scope на каждый flow).
- Чтобы не писать связку руками для каждого экрана, я сделал собственный генератор на KSP и KotlinPoet, модуль :lib:generator. В нём три процессора: для регистрации ViewModel в нужном scope, для сборки subcomponent у flow и для фабрик дочерних компонентов.
- Генератор покрыт тестами на kotlin-compile-testing. В итоге новый экран требует конструктор и две аннотации, @Inject и @ViewModel(Scope), а всё остальное подключается само.
@Inject
@ViewModel(CitiesScope::class)
class CitiesViewModel
▾ViewModelBindingProcessor▾
генерируется
@ContributesTo(CitiesScope)
@IntoSet provide(): ViewModelProvider
▾
AppScopeFlow scopeForegroundScope
@MergeComponent ✓
FlowComponentBindingProcessorChildComponentFactoryProcessor
Навигация и MVI
Flow'ы на Decompose и экраны на Orbit
- Приложение это дерево flow'ов: AppFlow, внутри него HomeTabsFlow с вкладками, а в нём CitiesFlow и MapFlow. Каждый flow построен на StackNavigation из Decompose.
- Экран ничего не знает о соседях: ViewModel отправляет событие, например CityDetailsRequested, а flow ловит его и решает, куда идти.
- На экранах MVI на Orbit: ViewState, интенты и side effects, а поверх него базовый BaseViewModel. Интент поиска сделан блокирующим, чтобы текст в поле не прыгал между нажатиями.
AppFlow
HomeTabsFlow · tabs
CitiesFlowMapFlow
CitiesScreen→CitiesViewModel
событиеCityDetailsRequested↑
переходpush(CityDetails)
stackCities›CityDetails
OrbitViewStateblockingIntentMain.immediate
Данные, поиск и пагинация
Ktor, SQLDelight и Paging 3
- Один интерфейс HttpClientProvider, а движок у каждой платформы свой. Любой неуспешный ответ превращается в типизированный ApiError с кодом и описанием, так что экран получает ошибку, а не исключение Ktor.
- Список городов лежит в SQLDelight и показывается через Paging 3: RemoteMediator подгружает страницы с сервера в базу, а экран читает уже из базы.
- Поиск идёт через debounce в 300 мс, а flatMapLatest отменяет устаревший запрос. Состояния загрузки, ошибки и контента описаны общими типами и одинаково работают на любом экране.
поискmos
debounce 300 ms
Pager→Ktor→SQLDelight
↓ PagingSource
flatMapLatestcachedInApiError
Фоновый экспорт
WorkManager, foreground и уведомления (Android)
- Из меню списка города можно выгрузить в Markdown, файл попадает в загрузки.
- Одна и та же работа на WorkManager запускается тремя способами: разово, срочно и периодически. Условия запуска (сеть, зарядка, батарея, свободное место) собраны в одном месте, а повторный тап не запускает второй экспорт.
- Воркер работает как foreground: показывает уведомление с прогрессом и кнопкой отмены. Интерфейс планировщика лежит в domain, а реализация в androidMain, поэтому общий код ничего не знает о WorkManager.
разовоKEEP
expeditedRUN_AS_NON_EXPEDITED
периодическиUPDATE
сетьзарядкабатареяпамять
↓cities.mdcancel
✓ Downloads/cities.md
Карта
Yandex MapKit, кластеры и дифф пинов
- Карта это общий composable Map с платформенной реализацией: на Android Yandex MapKit, на iOS пока заглушка.
- Состояние карты (камера, пины, выбранный город, зум) живёт в общем коде, а MapKit только его показывает, поэтому логика зума и выбора проверяется тестами в commonTest.
- Города подгружаются по видимой области, а пины обновляются разницей (PinsDiff): добавляются только новые, остальные не мигают и не теряют место в кластере. Есть шторка с городом, кнопки зума и отступы от выреза.
12
LoadedCitiesPinsDiff: добавить 3 · убрать 0MapKit clusters

Стек проекта

Язык и платформы

Kotlin 2.4
Kotlin Multiplatform
Android
iOS (iosArm64, iosSimulatorArm64)

UI

Compose Multiplatform
Material 3
Compose Resources
Дизайн-токены и UI Kit

Архитектура

MVI (Orbit)
Decompose
Remo
Feature-модули: domain · data · ui · routing
Coroutines / Flow
23 Gradle-модуля

DI

kotlin-inject
kotlin-inject-anvil
KSP
KotlinPoet
Собственный генератор биндингов

Данные и сеть

Ktor 3.6 (OkHttp и Darwin)
kotlinx.serialization
SQLDelight 2.4
Paging 3

Платформенное

Yandex MapKit
WorkManager
Foreground-уведомления

Качество и сборка

Convention-плагины
Version Catalog
Spotless + ktlint
detekt 2
prePushCheck
kotlin-compile-testing

Что я делал

Сетап проекта с нуля

Выбранный стек

Один код для Android и iOS

Дизайн-система

DI и свой генератор кода

Навигация и MVI

Данные, поиск и пагинация

Фоновый экспорт

Карта

Стек проекта

Язык и платформы

UI

Архитектура

DI

Данные и сеть

Платформенное

Качество и сборка

Что я делал

Сетап проекта с нуля

Выбранный стек

Один код для Android и iOS

Дизайн-система

DI и свой генератор кода

Навигация и MVI

Данные, поиск и пагинация

Фоновый экспорт

Карта

Стек проекта

Язык и платформы

UI

Архитектура

DI

Данные и сеть

Платформенное

Качество и сборка