Оригинал: https://kotlinlang.org/docs/multiplatform-mobile-create-first-app.html

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

Здесь вы узнаете, как создать и запустить ваше первое Kotlin Multiplatform Mobile приложение.

Вы также можете посмотреть видео этого урока, созданное Екатериной Петровой.

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

Вам понадобится Mac с macOS для выполнения определенных шагов в этом руководстве, которые включают написание специфичного для iOS кода и запуск iOS-приложений.

Работать с iOS в других операционных системах, таких как Microsoft Windows, нельзя. Это связано с требованием Apple.
В Android Studio выберите File | New | New Project.
Выберите Kotlin Multiplatform App в списке шаблонов проектов и нажмите Next.
Укажите имя для вашего первого приложения и нажмите Next.
В открывшемся окне выполните следующие действия:
- Не изменяйте имена по умолчанию для приложения и общих папок;
- Установите флажок, чтобы сгенерировать образцы тестов для вашего проекта;
- Выберите Regular framework в списке вариантов распространения iOS-фреймворка.
Нажмите Finish, чтобы создать новый проект.

Если вы хотите использовать мультиплатформенный модуль Kotlin в качестве зависимости CocoaPods, выберите опцию CocoaPods dependency manager. Чтобы узнать больше о зависимостях CocoaPods, см. раздел Интеграция CocoaPods.

Теперь подождите, пока ваш проект будет настроен. Загрузка и настройка необходимых компонентов может занять некоторое время, когда вы делаете это в первый раз.

Чтобы просмотреть полную структуру вашего мобильного мультиплатформенного проекта, переключите просмотр с Android на Project. Вы можете разобраться со структурой проекта и тем, как вы можете её использовать.

Выбор вида проекта

Запуск вашего приложения

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

Запуск вашего приложения на Android

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

Запуск эмулятора другого Android-устройства

Узнайте, как настроить эмулятор Android и запустить ваше приложение на другом моделируемом устройстве.

Запуск на реальном Android-устройстве

Узнайте, как настроить и подключить аппаратное устройство и запустить на нем свое приложение.

Запуск вашего приложения на iOS

В списке конфигураций запуска выберите iosApp и нажмите Run.

Запуск эмулятора другого iPhone

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

В списке конфигураций запуска нажмите Edit Configurations.
Нажмите кнопку + над списком конфигураций и выберите iOS Application.
Укажите название вашей конфигурации.
Выберите симулируемое устройство в списке Execution target, а затем нажмите OK.
Нажмите Run, чтобы запустить ваше приложение на новом симулируемом устройстве.

Запуск на реальном iPhone

Подключите iPhone к Xcode.
Создайте конфигурацию запуска, выбрав iPhone в списке Execution target.
Нажмите Run, чтобы запустить ваше приложение на iPhone.

Если ваша сборка завершится неудачей, следуйте инструкциям, описанным в этой issue.

Запуск тестов

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

Запуск тестов на iOS

Откройте файл iosTest.kt в папке shared/src/iosTest/kotlin/com.example.kmmapplication.shared. Каталоги с именем Test содержат тесты. Этот файл содержит пример теста для iOS.
Нажмите на значок Run рядом с тестом.

Тесты выполняются на симуляторе без UI. Поздравляем! Тест пройден – смотрите результаты теста в консоли.

Результаты iOS-теста

Запуск тестов на Android

Для Android процесс запуска тестов очень похож на этот же процесс для iOS.

Откройте файл androidTest.kt в папке shared/src/androidTest/kotlin/com.example.kmmapplication.shared.
Нажмите на значок Run рядом с тестом.

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

Откройте файл Greeting.kt в папке shared/src/commonmain/kotlin/com.example.kmmapplication.shared. В этом каталоге хранится общий код для обеих платформ – Android и iOS. Если вы внесете изменения в общий код, вы увидите изменения в обоих приложениях.
Обновите общий код: используйте функцию стандартной Kotlin-библиотеки, которая работает на всех платформах и возвращает текст: reversed().
```
class Greeting {
    fun greeting(): String {
        return "Guess what it is! > ${Platform().platform.reversed()}!"
    }
}
```
Запустите обновленное приложение на Android.
Запустите обновленное приложение на iOS.
Запустите тесты на Android и iOS.

Как вы видите, тесты проваливаются. Обновите тесты для прохождения. Вы знаете, как это сделать, верно? ;)