Создайте приложение Kotlin Multiplatform

Напишите общие объявления

Общий набор исходного кода содержит код, который можно использовать на нескольких целевых платформах. Он предназначен для платформонезависимого кода. Если попытаться использовать в общем наборе исходного кода API, специфичные для платформы, IDE покажет предупреждение:

1. Откройте файл sharedLogic/src/commonMain/.../Greeting.kt, в котором находится сгенерированный класс Greeting с функцией greet().

2. Добавим немного разнообразия в приветствие. Перейдите к определению функции sayHello() в файле GreetingUtil.kt.

3. Измените общий код, добавив рандомизацию и вызов reversed() из стандартной библиотеки Kotlin, чтобы перевернуть полученную строку:

   fun sayHello(to: String): String {
       val firstWord = if (Random.nextBoolean()) "Hi!" else "Hello!"
   
       return "$firstWord Guess what this is! > ${to.reversed()}!"
   }
   

4. Импортируйте класс kotlin.random.Random, следуя предложению IDE.

У написания кода только на общем Kotlin есть очевидные ограничения: он не может использовать функциональность, специфичную для платформы. Эту проблему решает использование общих интерфейсов с платформенными реализациями через механизм expect/actual.

Изучите платформенные реализации

В общем наборе исходного кода можно объявить ожидаемые объявления — интерфейсы, классы и так далее. В каждом наборе исходного кода для конкретной платформы, в данном случае androidMain и iosMain, необходимо предоставить фактические платформенные реализации ожидаемых объявлений.

При генерации кода для конкретной платформы компилятор Kotlin объединяет ожидаемые и фактические объявления и создает одно объявление с фактическими реализациями.

1. При создании проекта Kotlin Multiplatform в IntelliJ IDEA в модуле sharedLogic/src/commonMain появляется файл Platform.kt:

   interface Platform {
       val name: String
   }
   

   Это общий интерфейс Platform, предназначенный для включения информации о платформе.

2. Классы для конкретных платформ, реализующие этот интерфейс, находятся в наборах исходного кода androidMain и iosMain:

   // Platform.android.kt in the androidMain source set
   import android.os.Build
   
   class AndroidPlatform : Platform {
       override val name: String = "Android ${Build.VERSION.SDK_INT}"
   }
   

   // Platform.ios.kt in the iosMain source set
   import platform.UIKit.UIDevice
   
   class IOSPlatform: Platform {
       override val name: String =
           UIDevice.currentDevice.systemName() + " " + UIDevice.currentDevice.systemVersion
   }
   

   • Свойство name класса AndroidPlatform использует код для Android, а именно класс android.os.Build. Этот код интерпретируется как Kotlin/JVM. Если здесь обратиться к классу, специфичному для JVM, например java.util.Random, код скомпилируется.

   • Свойство name класса IOSPlatform использует код для iOS, а именно класс platform.UIKit.UIDevice. Этот код интерпретируется как Kotlin/Native, поэтому из Kotlin можно обращаться к объявлениям iOS. Код становится частью фреймворка iOS, который импортируется в коде Swift модуля iosApp.

3. Каждый набор исходного кода включает функцию getPlatform(). Ее объявление expect не содержит тела, а реализации actual предоставлены в платформенном коде:

   // Platform.kt in the commonMain source set
   expect fun getPlatform(): Platform
   

   // Platform.android.kt in the androidMain source set
   actual fun getPlatform(): Platform = AndroidPlatform()
   

   // Platform.ios.kt in the iosMain source set
   actual fun getPlatform(): Platform = IOSPlatform()
   

Здесь в общем наборе исходного кода объявлена ожидаемая функция getPlatform(), для которой в наборах исходного кода платформ определены фактические реализации: AndroidPlatform() для приложения Android и IOSPlatform() для приложения iOS.

При генерации кода для конкретной платформы компилятор Kotlin объединяет объявления expect и actual в одну функцию getPlatform() с нужной реализацией.

Поэтому объявления expect и actual должны находиться в одном пакете — в результирующем коде платформы они объединяются в одно объявление. Любой вызов ожидаемой функции getPlatform() в сгенерированном платформенном коде будет обращаться к соответствующей фактической реализации.

Теперь можно запустить приложения и увидеть всё это в действии.

Запустите приложение на Android

1. В списке конфигураций запуска выберите androidApp.

2. Выберите виртуальное устройство Android рядом со списком конфигураций и нажмите Запустить.

   Если в списке нет устройства, создайте новое виртуальное устройство Android.

   

   

Запустите приложение на iOS

Если вы не запускали Xcode во время первоначальной настройки, запустите его перед запуском приложения для iOS.

В IntelliJ IDEA выберите iosApp в списке конфигураций запуска, выберите симулируемое устройство рядом с конфигурацией запуска и нажмите Запустить.

Если в списке нет доступной конфигурации iOS, запустите Xcode, чтобы заполнить список доступных симуляторов, а затем перезапустите IntelliJ IDEA.

См. также

• Узнайте, как создавать и запускать мультиплатформенные тесты, чтобы проверить правильность работы кода.

• Подробнее о структуре проекта.

• Если вы хотите преобразовать существующий проект Android в кроссплатформенное приложение, выполните это руководство, чтобы сделать приложение Android кроссплатформенным.