Rivalry2

HTML Diff

1 added 1 removed

Original 2026-01-01

Modified 2026-03-10

1 В настоящее время мы переживаем бум появления новых технологий и подходов к написанию мобильных приложений. Одной из них является развивающийся SDK от компании JetBrains для мультиплатформенной разработки Kotlin Multiplatfrom (KMP).

2 Основная идея KMP, как и других кросс-платформенных SDK - оптимизация разработки путем написания кода один раз и последующего его использования на разных платформах.

3 Согласно концепции JetBrains, Kotlin Multiplatform не является фреймворком. Это именно SDK, который позволяет создавать модули с общим кодом, подключаемые к нативным приложениям.

4 Написанный на Kotlin модуль компилируется в JVM байткод для Android и LLVM байткод для iOS.

5 Этот модуль (Shared, Common) содержит переиспользуемую бизнес-логику. Платформенные модули iOS/Android, к которым подключен Shared/Common, либо используют написанную логику напрямую, либо имплементируют свою реализацию в зависимости от особенностей платформы.

6 Общая бизнес-логика может включать в себя:

7 <ul><li>сервисы для работы с сетью;</li>

8 <li>сервисы для работы с БД;</li>

9 <li>модели данных.</li>

10 </ul>Также в нее могут входить архитектурные компоненты приложения, напрямую не включающие UI, но с ним взаимодействующие:

11 <ul><li>ViewModel;</li>

12 <li>Presenter;</li>

13 <li>Интеракторы и т. п.</li>

14 </ul>Концепцию Kotlin Multiplatform можно сравнить с реализацией Xamarin Native. Однако, в KMP нет модулей или функционала, реализующих UI. Эта логическая нагрузка ложится на подключенные нативные проекты.

15 Рассмотрим подход на практике и попробуем написать наше первое приложение Kotlin Multiplatform.

16 Для начала нам потребуется установить и настроить инструменты:

17 <ol><li>Android Sdk</li>

18 <li>Xcode с последним iOS SDK.</li>

19 <li>Intelij IDEA CE или Android Studio. Обе IDE позволяют создавать и настраивать проекты для Kotlin Multiplatform. Но если в Intelij IDEA проект создается автоматически, то в Android Studio большую часть настроек надо сделать вручную. Если вам привычнее работать именно с Android Studio, то подробное руководство по созданию проекта можно посмотреть в документации на Kotlinlang.org</li>

20 </ol>Мы рассмотрим создание проекта с помощью Intelij IDEA.

21 Выбираем меню File → New → Create Project:

22 В появившемся окне выбираем тип проекта Kotlin → Mobile Android/iOS|Gradle

23 Далее стандартно задаем путь к JDK, имя и расположение проекта:

24 После нажатия кнопки Finish проект сгенерируется и будет почти готов к работе.

25 Рассмотрим, что у нас получилось:

26 Мультиплатформенные проекты Kotlin обычно делятся на несколько модулей:

27 <ul><li>модуль переиспользуемой бизнес-логики (Shared, commonMain и т.п);</li>

28 <li>модуль для IOS приложения (iOSMain, iOSTest);</li>

29 <li>модуль для Android приложения (androidMain, androidTest).</li>

30 </ul>В них располагается наша бизнес-логика. Сам код базового примера мы разберем немного позже.

31 Код нативного Android приложения располагается в каталоге main, как если бы мы создавали проект по шаблону обычного Android.

32 iOS приложение создается автоматически и располагается в каталоге iOSApp:

33 Перед тем, как мы проверим работоспособность базового решения, необходимо сделать ряд финальных настроек.

34 В local.properties зададим путь к SDK Android:

35 Создадим конфигурацию для работы Android-приложения:

36 Готово.

37 Теперь вызовем команду gradle wrapper для сборки нашего модуля общей логики:

38 После сборки модуль для бизнес-логики для Android приложения доступен в app/build/libs:

39 Путь к библиотеке прописывается стандартно, в блоке dependencies файла build.gradle:

40 Теперь наш проект сконфигурирован для запуска Android-приложения:

41 - Осталось сделать настройки для запуска приложения iOS.

41 + Осталось сделать настройки для запу��ка приложения iOS.

42 В файле build.gradle(:app) необходимо изменить настройку архитектура проекта, чтобы наше приложение поддерживало как реальные устройства, так и эмуляторы.

43 Меняем:

44 На:

45 После выполнения сборки создастся фреймворк в app/build/bin/ios:

46 Intelij IDEA автоматически создает в gradle-файле код для генерации, подключения и встраивания фреймворка в iOS-проект:

47 При ручной настройке проекта (например, через Android Studio) этот код потребуется указать самостоятельно.

48 После синхронизации gradle iOS-проект готов к запуску и проверке с помощью XCode.

49 Проверяем, что у нас получилось. Открываем проект iOS через iosApp.xcodeproj:

50 Проект имеет стандартную структуру, за исключением раздела app, где мы получаем доступ к коду наших модулей на Kotlin.

51 Фреймворк действительно подключен автоматически во всех соответствующих разделах проекта:

52 Запускаем проект на эмуляторе:

53 Теперь разберем код самого приложения на базовом примере.

54 Используемую в проекте бизнес-логику можно разделить на:

55 <ul><li>переиспользуемую (общую);</li>

56 <li>платформенную реализацию.</li>

57 </ul>Переиспользуемая логика располагается в проекте commonMain в каталоге kotlin и разделяется на package. Декларации функций, классов и объектов, обязательных к переопределению, помечаются модификатором expect:

58 Реализация expect-функционала задается в платформенных модулях и помечается модификатором actual:

59 Вызов логики производится в нативном проекте:

60 Все очень просто.

61 Теперь попробуем по тем же принципам сделать что-то посложнее и поинтереснее. Например, небольшое приложение для получения и отображение списка новостей для iOS и Android.

62 Приложение будет иметь следующую структуру:

63 В общей части (Common) расположим бизнес-логику:

64 сетевой сервис; сервис для запросов новостей.

65 В модулях iOS/Android-приложений оставим только UI-компоненты для отображения списка и адаптеры. iOS-часть будет написана на Swift, Android - на Kotlin. Здесь в плане работы не будет ничего нового.

66 Организуем архитектуру приложений по простому паттерну MVP. Презентер, обращающийся к бизнес-логике, также вынесем в Common часть. Также поступим и с протоколом для связи между презентером и экранами UI:

67 interface INewsListView :IView { fun setupNews(list: List) }Начнем с бизнес-логики. Т. к. весь функционал будет в модуле common, то мы будем использовать в качестве библиотек решения для Kotlin Multiplatform:

68 1.Ktor - библиотека для работы с сетью и сериализации.

69 В build.gradle (:app) пропишем следующие зависимости:

70 commonMain { dependencies { … implementation("io.ktor:ktor-client-core:1.3.2") implementation("io.ktor:ktor-client-json:1.3.2") implementation("io.ktor:ktor-client-serialization:1.3.2") } } androidMain { dependencies { ….. implementation("io.ktor:ktor-client-android:1.3.2") implementation("io.ktor:ktor-client-json-jvm:1.3.2") implementation("io.ktor:ktor-client-serialization-jvm:1.3.2") } } iosMain { dependencies { //…. implementation("io.ktor:ktor-client-ios:1.3.2") implementation("io.ktor:ktor-client-json-native:1.3.2") implementation("io.ktor:ktor-client-serialization-native:1.3.2") } }Также добавим поддержку плагина сериализации:

71 plugins { …. id 'org.jetbrains.kotlin.plugin.serialization' version '1.3.72' } apply plugin: 'kotlinx-serialization'2.Kotlin Coroutines - для организации многопоточной работы.

72 commonMain { dependencies { … implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core-common:1.3.7") implementation("org.jetbrains.kotlinx:kotlinx-serialization-runtime-common:0.14.0") …. } } androidMain { dependencies { … implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.3.7") implementation("org.jetbrains.kotlinx:kotlinx-serialization-runtime:0.14.0") …. } } iosMain { dependencies { implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core-common:1.3.5-native-mt") implementation("org.jetbrains.kotlinx:kotlinx-serialization-runtime-native:0.14.0") …. } }При добавлении зависимости в iOS-проект обратите внимание, что версия библиотеки должна быть обязательно native-mt и совместима с версией плагина Kotlin multiplatform.

73 При организации многопоточности с помощью Coroutines необходимо передавать контекст потока (CoroutineContext), в котором логика будет исполняться. Это платформозависимая логика, поэтому используем кастомизацию с помощью expect/actual.

74 В commonMain создадим Dispatchers.kt, где объявим переменные:

75 expect val defaultDispatcher: CoroutineContext expect val uiDispatcher: CoroutineContextРеализация в androidMain создается легко. Для доступа к соответствующим потокам используем CoroutineDispatchers Main (UI поток) и Default (стандартный для Coroutine):

76 actual val uiDispatcher: CoroutineContext get() = Dispatchers.Main actual val defaultDispatcher: CoroutineContext get() = Dispatchers.DefaultС iOS труднее. Та версия Kotlin Native LLVM компилятора, которая используется в Kotlin Multiplatform,не поддерживает background очереди. Это давно известная проблема, которая к сожалению, еще не исправлена

77 Поэтому попробуем обходной маневр как временное решение проблемы.

78 actual val uiDispatcher: CoroutineContext get() = MainDispatcher actual val defaultDispatcher: CoroutineContext get() = MainDispatcher private object MainDispatcher: CoroutineDispatcher() { override fun dispatch(context: CoroutineContext, block: Runnable) { dispatch_async(dispatch_get_main_queue()) { try { block.run().freeze() } catch (err: Throwable) { throw err } } } }Мы создаем свой CoroutineDispatcher, где прописываем выполнение логики в асинхронной очереди dispatch_async.

79 Также нам понадобится свой scope для работы сетевого клиента:

80 <h4>iOS</h4>

81 actual fun ktorScope(block: suspend () -> Unit) { GlobalScope.launch(MainDispatcher) { block() } }<h4>Android</h4>

82 actual fun ktorScope(block: suspend () -> Unit) { GlobalScope.launch(Dispatchers.Main) { block() } }Применим это при реализации сетевого клиента на Ktor:

83 interface INetworkService { suspend fun getData(path: String, serializer: KSerializer,completed: (ContentResponse)->Unit) } class NetworkService : INetworkService{ private val httpClient = HttpClient() override suspend fun getData(path: String, serializer: KSerializer,completed: (ContentResponse)->Unit){ //Для ktor используем свой скоуп ktorScope { var contentResponse = ContentResponse() try { val json = httpClient.get { url { protocol = URLProtocol.HTTPS host = NetworkConfig.shared.apiUrl encodedPath = path header("X-Api-Key", NetworkConfig.shared.apiKey) } } print(json) val response = kotlinx.serialization.json.Json.nonstrict.parse(serializer, json) contentResponse.content = response } catch (ex: Exception) { val error = ErrorResponse() error.message = ex.message.toString() contentResponse.errorResponse = error print(ex.message.toString()) } //Ответ отдаем в UI-поток withContext(uiDispatcher) { completed(contentResponse) } } } }Парсинг реализуем с помощью сериализатора типа KSerializer<T>. В нашем случае это NewsList.serializer(). Пропишем реализацию в сервисе новостей:

84 @TheadLocal class NewsService{ companion object { val shared = NewsApi() } val networkService = NetworkService() suspend fun getNewsList(completed: (ContentResponse)->Unit){ val path = "v2/top-headlines?language=en" networkService.getData(path, NewsList.serializer(),completed) } }Вызывать бизнес-логику будем в презентере. Для полноценной работы с coroutines нам надо будет создать scope:

85 class PresenterCoroutineScope( context: CoroutineContext ) : CoroutineScope { private var onViewDetachJob = Job() override val coroutineContext: CoroutineContext = context + onViewDetachJob fun viewDetached() { onViewDetachJob.cancel() } }и добавить его в презентер. Вынесем в базовый класс:

86 abstract class BasePresenter(private val coroutineContext: CoroutineContext) { protected var view: T? = null protected lateinit var scope: PresenterCoroutineScope fun attachView(view: T) { scope = PresenterCoroutineScope(coroutineContext) this.view = view onViewAttached(view) } … }Теперь создадим презентер NewsListPresenter для нашего модуля. В инициализатор передадим defaultDispatcher:

87 class NewsPresenter:BasePresenter(defaultDispatcher){ var service: NewsApi = NewsApi.shared var data: ArrayList = arrayListOf() fun loadData() { //запускаем в скоупе scope.launch { service.getNewsList { val result = it if (result.errorResponse == null) { data = arrayListOf() data.addAll(result.content?.articles ?: arrayListOf()) view?.setupNews(data) } } } } }Обратите внимание! Из-за особенностей<a>текущей работы Kotlin Native с многопоточностью</a>в iOS работа с синглтонами может привести к крашу. Поэтому для корректной работы надо добавить аннотацию @ThreadLocal для используемого объекта:

88 class NewsService{ @ThreadLocal companion object { val shared = NewsService() } … }Осталось подключить логику к нативным IOS и Android модулям и обработать ответ от Presenter:

89 class NewsListVC: UIViewController { private lazy var presenter: NewsPresenter? = { let _presenter = NewsPresenter() _presenter.attachView(view: self) return _presenter }() override func viewDidLoad() { super.viewDidLoad() self.presenter?.loadData() } extension NewsListVC : INewsListView { func setupNews(list: [NewsItem]) { … }<h4>Android:</h4>

90 class NewsActivity : AppCompatActivity(), INewsListView { …. private var _presenter: NewsPresenter? = null override fun onCreate(savedInstanceState: Bundle?) { _presenter = NewsPresenter() _presenter?.attachView(this) … } override fun setupNews(list: List) { …. }Запускаем сборку common модуля gradle wrapper, чтобы сборки обновились. Проверяем работу приложений:

91 <h4>Android</h4>

92 <h4>iOS</h4>

93 Готово. Вы великолепны.

94 Оба наши приложения работают и работают одинаково.

95 <a>Ссылка</a>на ресурсы.

96 Информационные материалы, которые использовались:

97 <ul><li><a>туториал от JetBrains</a>;</li>

98 <li><a>https://github.com/JetBrains/kotlin-native</a>.</li>

99 </ul>