Создайте своё первое кроссплатформенное приложение

Создайте проект по шаблону

1. В Android Studio выберите Файл | Новый | Новый проект.

2. Выберите Приложение Kotlin Multiplatform в списке шаблонов проектов и нажмите Далее.

   

3. Укажите имя вашего первого приложения и нажмите Далее.

   

4. В списке распределения фреймворка iOS выберите вариант Обычный фреймворк.

   

5. Сохраните стандартные имена для приложения и общих папок. Нажмите Готово.

Проект будет настроен автоматически. Это может занять некоторое время для загрузки и настройки необходимых компонентов при первом выполнении.

Изучите структуру проекта

Чтобы просмотреть полную структуру вашего мобильного многоплатформенного проекта, переключите вид с Android на Проект.

Каждый проект Kotlin Multiplatform включает три модуля:

• shared — это модуль Kotlin, содержащий логику, общую для приложений Android и iOS — код, который вы используете на разных платформах. Он использует Gradle в качестве системы сборки, которая помогает автоматизировать процесс сборки. Модуль shared компилируется в библиотеку Android и фреймворк iOS.

• androidApp — это модуль Kotlin, который компилируется в приложение Android. Он использует Gradle в качестве системы сборки. Модуль androidApp зависит от и использует модуль shared как обычную библиотеку Android.

• iosApp — это проект Xcode, который компилируется в приложение iOS. Он зависит от и использует модуль shared как фреймворк iOS. Модуль shared может использоваться как обычный фреймворк или как зависимость CocoaPods, в зависимости от того, что вы выбрали на предыдущем шаге в распределении фреймворка iOS. В этом руководстве это обычная зависимость фреймворка.

Модуль shared состоит из трех наборов исходных кодов: androidMain, commonMain, и iosMain. Набор исходных кодов — это концепция Gradle для набора файлов, логически сгруппированных вместе, где каждая группа имеет свои зависимости. В Kotlin Multiplatform различные наборы исходных кодов в модуле shared могут быть ориентированы на разные платформы.

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

Вы можете запустить своё многоплатформенное приложение на Android или iOS.

Обновление вашего приложения

1. В shared/src/commonMain/kotlin, откройте файл Greeting.kt в папке проекта. Этот каталог хранит общий код для Android и iOS. Если вы внесёте изменения в общий код, они будут отражены в обоих приложениях.

   

2. Обновите общий код, используя reversed(), стандартную функцию Kotlin для обратного преобразования текста, которая работает на всех платформах:

   class Greeting {
       private val platform: Platform = getPlatform()
   
       fun greet(): String {
           return "Guess what it is! > ${platform.name.reversed()}!"
       }
   }
   

3. Запустите конфигурацию androidApp, чтобы увидеть обновлённое приложение в эмуляторе Android.

   

4. В Android Studio переключитесь на iosApp и запустите его, чтобы увидеть обновлённое приложение в эмуляторе iOS.

   

Следующий шаг

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

Перейти к следующей части

Получить помощь

• Kotlin Slack. Получите приглашение и присоединитесь к каналу #multiplatform.

• Система отслеживания ошибок Kotlin. Отправить новую ошибку.