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

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

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

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

   

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

   

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

   

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

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

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

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

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

• 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. Откройте файл Greeting.kt в shared/src/commonMain/kotlin. Этот каталог хранит общий код для Android и iOS. Если вы внесёте изменения в общий код, они будут отражены в обоих приложениях.

   

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

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

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

   

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

   

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

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

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

Получение помощи

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

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