Модуляризация мобильного приложения: архитектура и реализация

Какие проблемы решает модульная архитектура?

Monolith-приложение с 50+ экранами, где всё в одном модуле — это история про то, как команда из 8 разработчиков ждёт 4 минуты полной сборки на каждое изменение, и как фича одной команды ломает тесты другой, потому что оба импортируют один и тот же singleton. Модульная архитектура решает конкретно эти проблемы. Мы помогаем командам модуляризировать приложения от 20 до 200 экранов, опираясь на Apple Human Interface Guidelines и многолетний опыт. Услуга модуляризации включает проектирование модульной схемы, реализацию core-модулей, миграцию фич и настройку сборки.

• Скорость сборки. При изменении одного файла в feature-модуле пересобирается только он. Модуляризация сокращает инкрементальную сборку в 3–5 раз — с 7–11 минут до 45–90 секунд (реальный кейс).
• Merge-конфликты. Когда несколько команд работают в одном .pbxproj или build.gradle, конфликты неизбежны. Модули изолируют код: feature-ветки редко пересекаются.
• Изоляция тестов. Тесты одного модуля не зависят от изменений в другом. Можно запускать только тесты затронутого модуля.

Как мы это делаем: стек и практики

Разделение на модули

Стандартный подход — разделение по фичам с общим слоем:

:app                    — точка входа, DI-граф, навигация
:core:network           — HTTP клиент, interceptors
:core:storage           — БД, SharedPreferences/DataStore
:core:ui                — общие компоненты, тема
:core:auth              — токены, AuthInterceptor
:feature:profile        — профиль пользователя
:feature:catalog        — каталог товаров
:feature:checkout       — оформление заказа
:feature:orders         — история заказов

Каждый :feature:* модуль зависит только от :core:* и не знает о других фичах. Навигация между фичами — через абстракцию: NavigationManager в :core, которую каждая фича использует для перехода без прямого импорта другого feature-модуля. На Android — Navigation Component с NavGraph на уровне :app, deep links регистрируются в манифестах модулей. На iOS аналогично — Coordinator pattern или Router с protocol-based навигацией.

Android. Каждый :feature:* — отдельный Gradle-модуль (:feature:catalog → catalog/build.gradle.kts). Gradle Configuration Cache + Build Cache (~/.gradle/caches) радикально сокращают время пересборки: меняем только :feature:checkout — пересобирается только он. --configuration-cache в Gradle 8 стабилен. Kapt → KSP: миграция annotation processor'ов с Kapt на KSP (Kotlin Symbol Processing) даёт +30–50% к скорости генерации кода.

iOS. Модули реализуются через Swift Package Manager (локальные) или как Framework targets в Xcode workspace. Swift Package Manager поддерживает локальные пакеты через path: в Package.swift. Workspace с несколькими проектами (Feature1.xcodeproj, Feature2.xcodeproj) — устаревший подход, новый — монорепо с локальными SPM пакетами + один основной .xcodeproj. Tuist или XcodeGen автогенерируют .xcodeproj из конфигурационных файлов, что исключает merge-конфликты в .pbxproj.

DI в модульной архитектуре

DI-граф не должен быть монолитным. На Android — Hilt с @InstallIn(SingletonComponent::class) для core-зависимостей и @InstallIn(ViewModelComponent::class) для feature-специфичных. Каждый feature-модуль объявляет свои @Module-классы, Hilt собирает граф в compile time. Это означает: если :feature:catalog не подключён в :app — его DI-модуль не компилируется и не влияет на сборку.

На iOS — ручной DI через Resolver/Swinject, или чистый factory-паттерн без DI-фреймворка. В модульном приложении DI-фреймворк на Swift менее критичен: зависимости передаются через инициализаторы, а Composition Root в :app собирает всё вместе.

Почему модульная архитектура лучше монолита?

Модульное приложение экономит до 40% бюджета на разработку в долгосрочной перспективе (по данным нашего опыта). Сравните: в монолите одна ошибка в shared-коде может парализовать всю команду на день, а в модульном приложении проблема локализована. Google I/O демонстрировал, что Play Feature Delivery позволяет сократить размер базового APK на 30–50%.

Dynamic Delivery и опциональные модули

Android позволяет доставлять feature-модули по требованию через Play Feature Delivery (бывший Dynamic Delivery). Пользователь скачивает базовое приложение, тяжёлые фичи (AR-примерка, офлайн-карты) — при первом обращении. SplitInstallManager управляет загрузкой, SplitCompatActivity — активация. На iOS аналога нет — App Clips закрывают другую нишу.

Кейс. Ритейл-приложение: 6 команд, 80+ экранов, Android + iOS. До модуляризации: полная сборка Android — 7 минут, iOS — 11 минут. После разбивки на 14 модулей с настроенным Build Cache: инкрементальная сборка при изменении одного feature-модуля — 45–90 секунд. Merge-конфликты в общем коде снизились примерно втрое. Параллельная разработка фич без блокировок между командами. Экономия времени разработки оценивается в 30–50% на длинной дистанции. Средний бюджет модуляризации для проекта такого размера — от 8000 до 20000 USD (в зависимости от сложности зависимостей).

Что входит в работу?

Как проходит модуляризация: пошагово

1. Анализ текущей архитектуры — выявление зависимостей и циклов.
2. Проектирование модульной схемы — диаграмма модулей и интерфейсов.
3. Реализация core-модулей — сетка core-слоёв (network, storage, ui).
4. Миграция фич — каждая фича выделяется в свой модуль.
5. Настройка сборки — Build Cache, Configuration Cache, CI/CD.
6. Тестирование и документирование — тесты модулей, схема навигации, README.
7. Поддержка и обучение команды — код-ревью, воркшопы по модульной разработке.

Сроки и стоимость

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

Типичные ошибки при самостоятельной модуляризации

Circular dependencies. :feature:profile импортирует :feature:orders, :feature:orders импортирует :feature:profile. Gradle не соберёт — circular dependency. Решение: вынести общие модели в :core:domain или :shared:models, обе фичи зависят только от него.

Слишком мелкие модули. :core:extensions с 5 extension-функциями — overhead без выгоды. Рациональный минимум: модуль оправдан, если его можно менять независимо и он не зависит от модулей, которые меняются чаще.

Resource ID конфликты. На Android при объединении ресурсов нескольких модулей возникают коллизии имён. Конвенция: префикс модуля для всех ресурсов (catalog_item_card_background, не просто item_card_background). R class isolation через android.nonTransitiveRClass=true в gradle.properties — обязателен для больших проектов.

Почему стоит доверить модуляризацию профессионалам?

Мы имеем более 7 лет опыта в мобильной разработке и реализовали более 30 проектов с модульной архитектурой. Гарантируем плавный переход без простоев команды. Сертификаты Apple Developer и Google Associate Android Developer подтверждают нашу квалификацию. Свяжитесь с нами для консультации — поможем вам ускорить разработку и снизить cost of change.

Архитектура мобильных приложений

Приложение собрано в одном ViewController на 2000 строк. Сетевые вызовы, бизнес-логика, обновление UI — всё в одном месте. Добавить новую фичу без регрессии сложно, написать тест невозможно. Это не «плохой код» — это отсутствие архитектуры. И это встречается чаще, чем можно ожидать, даже в production-приложениях с миллионом пользователей.

Мы проектируем архитектуру под ключ: от выбора паттерна до полной структуры проекта с тестами и документацией. За 7–10 дней получаете чистый модульный код, готовый к масштабированию.

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

MVVM: базовый паттерн

Model-View-ViewModel — стандарт для iOS (SwiftUI + Combine/async, UIKit + Combine) и Android (Jetpack ViewModel + StateFlow + Compose). ViewModel содержит состояние UI и бизнес-логику. View только отображает состояние и передаёт намерения пользователя в ViewModel. Model — данные и их источник.

Ключевое правило: ViewModel не знает об UIKit или Android View-классах. Нет импортов UIKit, нет Context-зависимостей (кроме Application context через Hilt). Это гарантирует тестируемость: ViewModel тестируется как чистый Kotlin/Swift-код без Android Instrumented Test.

MVVM закрывает 70% потребностей. Остальные 30% — где нужна строгая изоляция фич, масштабирование команды, сложный flow управления состоянием.

Clean Architecture: когда MVVM недостаточно

Добавляет слои поверх MVVM:

Domain-слой — бизнес-логика, независимая от платформы. UseCase (или Interactor) содержит одно бизнес-правило: GetUserOrdersUseCase, PlaceOrderUseCase. Зависит только от интерфейсов (protocol/interface), не от конкретных реализаций.

Data-слой — реализация репозиториев. OrderRepositoryImpl реализует OrderRepository из domain. Знает про Retrofit, Room, UserDefaults. ViewModel не знает, откуда данные — из сети или кеша.

Presentation-слой — ViewModel + View. Знает о Domain, не знает о Data.

Dependency rule: зависимости направлены только внутрь. Domain не зависит ни от чего. Data и Presentation зависят от Domain.

Presentation → Domain ← Data

Это даёт возможность подменять реализацию: тест использует in-memory репозиторий вместо сетевого, интерфейс остаётся тем же.

Практическая оговорка: Clean Architecture добавляет файлы и слои. Для небольшого приложения это overhead. Оправдан от ~15 фич и при команде 3+ разработчиков.

BLoC для Flutter: предсказуемый поток состояний

BLoC (Business Logic Component) — стандартный паттерн в Flutter-сообществе. Библиотека flutter_bloc реализует его через два типа: Bloc (Event → State) и Cubit (State без Events, только методы).

Bloc обрабатывает Event и эмитирует новый State через on<EventType> хендлеры. Состояние иммутабельно — новый объект на каждое изменение. BlocBuilder перерисовывает только ту часть дерева, где изменился state.

// Event
abstract class CartEvent {}
class AddItemToCart extends CartEvent {
  final String productId;
  AddItemToCart(this.productId);
}

// State
abstract class CartState {}
class CartLoaded extends CartState {
  final List<CartItem> items;
  CartLoaded(this.items);
}

// Bloc
class CartBloc extends Bloc<CartEvent, CartState> {
  CartBloc(this._cartRepository) : super(CartLoaded([])) {
    on<AddItemToCart>(_onAddItem);
  }

  Future<void> _onAddItem(AddItemToCart event, Emitter<CartState> emit) async {
    final current = state as CartLoaded;
    final updated = await _cartRepository.addItem(event.productId);
    emit(CartLoaded(updated));
  }
}

Преимущество BLoC — тестируемость. blocTest из bloc_test пакета позволяет проверить: при таком-то Event, с таким-то начальным State, BLoC должен эмитировать такой-то State. Без UI, без моков для Flutter-фреймворка.

VIPER: для крупных iOS-проектов

VIPER (View, Interactor, Presenter, Entity, Router) — наиболее строгое разделение обязанностей для iOS. Каждый компонент имеет протокол и конкретную реализацию.

• View — только UI, делегирует всё Presenter
• Interactor — бизнес-логика, работа с сетью и данными
• Presenter — посредник между View и Interactor, форматирует данные для View
• Entity — модели данных (чистые структуры)
• Router — навигация между модулями

Каждый модуль (экран или фича) — отдельный VIPER-модуль. Это исключает coupling между фичами и позволяет большим командам работать параллельно без конфликтов.

Цена: много файлов, много протоколов. Шаблонный код генерируется через Sourcery или кастомные Xcode-шаблоны. VIPER оправдан для приложений с 10+ разработчиками и 50+ экранами.

TCA (The Composable Architecture)

TCA от Point-Free — более современная альтернатива VIPER для iOS/macOS. Основные концепции: State (иммутабельное состояние фичи), Action (все возможные события), Reducer (State + Action → новый State + Effect), Store (хранит State, обрабатывает Actions).

Scope позволяет composable строить большие фичи из маленьких: родительский Reducer делегирует часть State дочернему. Каждая фича тестируется изолированно через TestStore с точным контролем над Effects.

TCA имеет крутую кривую обучения, но даёт предсказуемость, которую сложно получить другим способом: каждое изменение состояния — явный Action с конкретным источником.

Какой паттерн выбрать под вашу задачу?

Оценим проект за 1 день — подберём архитектуру с учётом размера команды, платформы и планов роста.

Универсального ответа нет. Архитектуру выбирают под размер команды, требования к тестируемости и горизонт поддержки приложения.

Что входит в нашу работу

• Аудит текущей архитектуры (если приложение уже существует) — выявим узкие места и регрессионные зоны.
• Проектирование модульной структуры с чёткими границами слоёв и правилами зависимостей.
• Создание каркаса проекта (Scaffold) с внедрением DI, организации папок и настройки линтеров.
• Написание юнит-тестов для слоя домена и ViewModel — минимум 80% покрытия ключевых use case.
• Подготовка документации — архитектурные диаграммы, README с правилами модификации кода, инструкция для онбординга новых разработчиков.
• Передача рабочего репозитория с CI-пайплайном (GitHub Actions / Bitrise), настроенным запуском тестов и статическим анализом.

Всё это входит в стоимость проектирования. Дополнительно — поддержка на этапе внедрения: консультации команды, code review первых pull request.

Что происходит без архитектуры

Типичный сценарий через 18 месяцев без архитектуры: 40% времени разработки уходит на дебаг регрессий. Новый разработчик разбирается в коде неделю перед тем, как сделать первый PR. Тесты не пишутся, «потому что сложно мокировать». Добавление новой фичи требует понимания половины кодовой базы.

Выбор архитектуры на старте — это инвестиция с возвратом через 3–6 месяцев. По нашим данным, правильно спроектированная архитектура с MVVM + Clean даёт в 3 раза меньше регрессий по сравнению с монолитным ViewController. А затраты на её внедрение окупаются за 2–3 спринта.

Согласно рекомендациям Apple по проектированию приложений, разделение ответственности — ключевой фактор устойчивости кода (https://developer.apple.com/library/archive/featuredarticles/ViewControllerPGforiPhoneOS/ImplementingaViewController.html).

Почему стоит доверить архитектуру профессионалам?

Неправильный выбор паттерна на старте ведёт к переписыванию половины кода через год. Мы видели десятки проектов, где попытка сэкономить на архитектуре оборачивалась многомесячным рефакторингом. У нас за плечами 10+ лет коммерческой разработки, опыт работы с приложениями от 1 до 50 разработчиков. Мы помогаем избежать типовых ошибок:

• Overengineering для простого MVP (назначаем MVVM, а не VIPER).
• Отсутствие dependency injection — подключаем Hilt/Koin/Dagger уже на старте.
• Игнорирование тестируемости — закладываем протоколы/интерфейсы с первого коммита.

Оценим ваш проект бесплатно — пришлите описание текущего приложения или идеи, и мы подберём оптимальную архитектуру за 1 день. Пишите в Telegram или на почту — в ответ вы получите архитектурную схему, план внедрения и смету.

Дополнительная таблица: сравнение затрат на внедрение

Время указано для команды из 2–3 разработчиков. С нашим шаблоном (generator) стартовый каркас готов за 1 день вне зависимости от выбранного паттерна.