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

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

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

Для выполнения определенных шагов в этом учебнике, включающих написание кода для iOS и запуск приложения iOS, вам потребуется Mac с macOS.
Эти шаги нельзя выполнить на других операционных системах, таких как Microsoft Windows. Это связано с требованиями Apple.

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

В Android Studio выберите Файл | Новый | Новый проект.
Выберите Приложение Kotlin Multiplatform в списке шаблонов проектов и нажмите Далее.
Укажите имя для вашего первого приложения и нажмите Далее.
В открывшемся окне сделайте следующее:
- Сохраните значения по умолчанию для имени приложения и общих папок.
- Отметьте флажок для генерации примеров тестов для вашего проекта.
- Выберите Обычный фреймворк в списке вариантов распространения фреймворка iOS.
Нажмите Готово, чтобы создать новый проект.

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

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

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

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

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

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

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

Запуск на другом эмулированном устройстве Android

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

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

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

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

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

Запуск на другом эмулированном устройстве iPhone

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

В списке конфигураций запуска нажмите Редактировать конфигурации.
Нажмите кнопку + над списком конфигураций и выберите Приложение iOS.
Введите имя вашей конфигурации.
Выберите эмулированное устройство в списке Цель выполнения, а затем нажмите ОК.
Нажмите Запустить, чтобы запустить приложение на новом эмулированном устройстве.

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

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

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

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

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

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

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

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

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

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

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

Откройте файл 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.
Как видите, тесты завершаются неудачно. Обновите тесты, чтобы они прошли успешно. Вы знаете, как это сделать? ;)

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

После того, как вы поигрались со своим первым кроссплатформенным мобильным приложением, вы можете:

Последнее изменение: 07 апреля 2022

© 2010–2022 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/docs/multiplatform-mobile-create-first-app.html