Android и iOS по-разному рассчитывают скидку, обрабатывают ответ API или проверяют форму, хотя обслуживают один продукт. Внедрение Kotlin Multiplatform позволяет вынести подходящие правила в общий модуль. Начинаем с конкретного расхождения и проверяем, оправдан ли перенос; замена работающих интерфейсов не является обязательной частью проекта.
Находим участок, который действительно стоит объединить
Сопоставляем одинаковые действия в обоих клиентах: вход, расчёт, запрос данных, локальные изменения и обработку ошибок. Выявляем, где различие задумано продуктом, а где возникло из-за независимых реализаций. Объединять противоречащие правила до этого решения опасно: общий код только закрепит одну из ошибок.
Для пилота выбираем законченную функцию с понятными входами и результатом. Например, преобразование ответа API в состояние заказа либо расчёт доступного действия. Оцениваем зависимости от Android API, iOS SDK и существующих библиотек. Если общий участок мал, а почти вся работа приходится на платформу, можно сохранить отдельные реализации и согласовать только контракт.
Проводим границу общего и платформенного кода
| Область | Возможный общий состав | Что остаётся у клиента |
| Правила продукта | Расчёты, проверки и модели состояния | Отображение и взаимодействие с пользователем |
| Работа с данными | Преобразования, согласованная обработка ошибок | Платформенные хранилища и адаптеры по архитектуре |
| Интеграции устройства | Общие интерфейсы обращения к функции | Камера, разрешения, SDK и жизненный цикл |
| Интерфейс | Только если выбран отдельный перенос UI | Существующие SwiftUI, UIKit или Android-экраны |
Kotlin Multiplatform и Compose Multiplatform решают связанные, но разные задачи. Можно подключить общий Kotlin-модуль к нативным интерфейсам. Перенос экранов на общий UI обсуждаем отдельно: он затрагивает компоненты, навигацию, доступность и работу команды. Обещанный процент общего кода не заменяет обоснования выбранных границ.
Делаем контракт удобным для Swift и Android
Описываем типы входных данных, результат, состояния загрузки и ошибки. Договариваемся, кто запускает и отменяет операцию, что происходит при закрытии экрана и как обновляется состояние. Детали корутин и потоков не должны случайно становиться обязанностью каждого разработчика интерфейса; нужный адаптер входит в проектную границу.
На iOS подключаем общий модуль выбранным способом интеграции и проверяем его в существующем Xcode-проекте. На Android заменяем выбранный путь выполнения без дублирующего вызова старой логики. Сетевые и платформенные зависимости проверяем для обеих целей: библиотека только для JVM не становится совместимой с iOS из-за переноса её импорта в общий каталог.
Переносим по одному сценарию и сохраняем работающие версии
Перед переключением фиксируем контрольные входы и ожидаемое поведение. Сначала сравниваем результат общего модуля с прежней реализацией, затем включаем его в пользовательский путь. Для локальных данных согласуем схему перехода; для API — совместимость старых и новых клиентов. Не предполагаем, что Android, iOS и сервер будут выпущены в один момент.
В сборке фиксируем версию общего артефакта и совместимые инструменты. При раздельных репозиториях определяем, как команда получает модуль и узнаёт об изменении контракта. Возможность отключить новый путь полезна только там, где старый ещё совместим с данными и сервером; возврат после необратимого преобразования требует отдельного решения.
Что проверяем и передаём команде
- Один набор правил и контрольных данных на Android и iOS, включая неверные ответы и истёкшую сессию.
- Отмену операции, закрытие экрана, повтор запроса и восстановление состояния.
- Сборку двух клиентов с зафиксированной версией модуля и согласованным серверным контрактом.
Результат — выделенный общий модуль, подключённые клиенты, платформенные адаптеры в согласованном составе и инструкция его дальнейшего выпуска. Для оценки нужны репозитории, список расхождений, описание API, платформ и инструментов сборки. Работы по новому функционалу и полному переносу UI считаем отдельно.
Можно начать с Android-приложения, если iOS-клиент ещё только планируется?
Да, после выделения независимой логики можно подключить её к новому iOS-клиенту. При этом создание самого iOS-интерфейса, интеграции устройства и выпуск остаются отдельными работами.
Нужно объединять два репозитория в один?
Не обязательно. Способ размещения и поставки модуля выбираем по текущей разработке и сборке. Важнее определить версии, зависимости и порядок изменения публичного контракта, чем механически переместить весь код.
Выбрать первый общий модуль
Покажите два клиента или Android-проект и планы развития iOS. Найдём подходящую границу KMP и проверим её на конкретном сценарии продукта.
Обсудить внедрение KMP