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

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

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. Запустите обновлённое приложение на Android.

   

4. Запустите обновлённое приложение на iOS.

   

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

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

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

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

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