Разработка SDK/библиотеки для мобильной разработки

Разработка SDK/библиотеки для мобильной разработки

Разработка SDK — это не то же самое, что разработка приложения. Приложение пишешь для конечного пользователя, SDK — для разработчиков, которые будут встраивать его в собственные проекты. Ошибка в публичном API SDK стоит дорого: после релиза её нельзя исправить без breaking change, которое сломает чужой код.

Проектирование публичного API

Первый вопрос: какова минимальная поверхность API, которую нельзя убрать? Всё остальное должно быть internal/private. Принцип наименьшей экспозиции — не опционален.

Обратная совместимость — главный контракт. Семантическое версионирование: мажорная версия — только при breaking changes. Добавление новых методов в интерфейс — breaking change для имплементаторов. Поэтому вместо расширения интерфейса добавляем новый или используем default implementations (Swift protocol extensions, Kotlin interface defaults). Помечаем нестабильные API: @experimental в Kotlin, @available(*, deprecated) в Swift.

Kotlin SDK. Публичуем через Maven Central или GitHub Packages. build.gradle.kts с MavenPublication, подпись через GPG (signing plugin), javadoc.jar обязателен для Maven Central. Artifact coordinates: com.example:sdk-name:1.0.0. Если SDK кроссплатформенный — KMP с публикацией *-android, *-ios-arm64, *-ios-simulator-arm64 артефактов.

Swift/iOS SDK. Дистрибуция через Swift Package Manager (предпочтительно) или Cocoapods. SPM: Package.swift с явным указанием .supportedPlatforms, экспорт через XCFramework если есть нативный C/Objective-C код. Cocoapods: .podspec с spec.vendored_frameworks или spec.source_files. Binary framework — через binaryTarget в SPM или spec.vendored_frameworks в podspec.

Размер бинарника SDK. Критичен — никто не хочет добавить SDK и получить +5 МБ к приложению. Строгий контроль зависимостей: transitive dependencies минимизируем. Если SDK нужен сетевой слой — не тянем OkHttp или Alamofire, пишем на стандартной библиотеке (HttpURLConnection, URLSession). Исключение — если SDK для конкретной экосистемы (например, Firebase SDK — там Kotlin корутины ожидаемы).

Ключевые технические аспекты

Thread safety. SDK вызывается из чужого кода — гарантировать порядок вызовов нельзя. Всё публичное API должно быть thread-safe или явно задокументировано как «вызывать только с main thread». В Kotlin — @WorkerThread/@MainThread аннотации + Lint rules. В Swift — @MainActor для UI-компонентов SDK, actor для mutable state.

Lifecycle awareness. Android SDK, который держит контекст Activity — это memory leak. Используем WeakReference<Context> или ApplicationContext. На iOS — аналогично, слабые ссылки на delegate. Если SDK регистрирует системные observer'ы (NotificationCenter, BroadcastReceiver) — обязателен явный deinit/close() с документацией.

Конфигурация и инициализация. Builder-паттерн вместо конструктора с 10 параметрами. На Android — MySDK.Builder(context).apiKey("...").timeout(30).build(). Инициализация в Application.onCreate(), не в Activity. Если SDK требует async init — предоставляем callback и coroutine-совместимый API (suspend fun initialize()).

Обработка ошибок. Sealed-классы для результатов (Result<T, SDKError>), а не голые исключения. Документируем все возможные SDKError. На Swift — enum SDKError: Error с LocalizedError. Crashlytics и сторонние crash-репортеры в SDK подключать нельзя — это дело интегрирующего приложения.

Кейс. Платёжный SDK для партнёрских приложений: Android (aar через Maven) + iOS (xcframework через SPM). Публичный API: PaymentSDK.present(from: UIViewController, amount: Decimal, completion: @escaping (PaymentResult) -> Void) на iOS и PaymentSDK.launch(activity, amount, callback) на Android. Внутри — нативный UI (bottom sheet с полями карты), шифрование через AES-256-GCM, отправка токена на backend клиента. Размер SDK: 340 КБ (iOS xcframework) и 280 КБ (Android aar). Тестирование — unit-тесты с mock network layer, интеграционный тест-проект в том же репозитории.

Документация и developer experience

API Reference генерируем автоматически: Dokka для Kotlin, DocC для Swift. README с quickstart — обязателен. Changelog в формате Keep a Changelog. Тест-приложение в репозитории как живой пример интеграции.

Lint rules и custom annotations для Android SDK — через lint-api. Предупреждаем о неправильном использовании на этапе компиляции, а не в рантайме.

Сроки

Стоимость рассчитывается индивидуально. При разработке SDK важно заранее зафиксировать: целевые платформы и версии ОС, требования к размеру, политику версионирования и формат дистрибуции.