Настройка среды
Прежде чем создать первое приложение, работающее как на iOS, так и на Android, вам необходимо настроить среду разработки Kotlin Multiplatform Mobile.
Установка необходимых инструментов
Мы рекомендуем устанавливать последние стабильные версии для совместимости и лучшей производительности.
Инструмент |
Комментарии |
|---|---|
Вы будете использовать Android Studio для создания многоплатформенных приложений и запуска их на эмулированных или аппаратных устройствах. |
|
|
В большинстве случаев Xcode будет работать в фоновом режиме. Вы будете использовать его для добавления кода Swift или Objective-C в ваше iOS-приложение. |
|
|
Для проверки, установлен ли он, выполните следующую команду в терминале Android Studio или в вашей командной строке: java -version |
|
В Android Studio выберите Настройки/Предпочтения | Плагины, найдите Marketplace для Kotlin Multiplatform Mobile, а затем установите его. |
|
|
Плагин Kotlin поставляется с каждой версией Android Studio. Однако его все равно необходимо обновить до последней версии, чтобы избежать проблем с совместимостью. Для обновления плагина на экране приветствия Android Studio выберите Плагины | Установленные. Нажмите Обновить рядом с Kotlin. Вы также можете проверить версию Kotlin в Инструменты | Kotlin | Настройка обновлений плагина Kotlin. Плагин Kotlin должен быть совместим с плагином Kotlin Multiplatform Mobile. Обратитесь к таблице совместимости. |
Проверка вашей среды
Чтобы убедиться, что все работает как ожидается, установите и запустите инструмент KDoctor:
-
В терминале Android Studio или в вашей командной строке выполните следующую команду для установки инструмента с помощью Homebrew:
brew install kdoctor
Если у вас еще нет Homebrew, установите его или ознакомьтесь с README инструмента KDoctor для других способов установки.
-
После завершения установки вызовите KDoctor в консоли:
kdoctor
-
Если KDoctor обнаружит какие-либо проблемы при проверке вашей среды, просмотрите вывод для определения проблем и возможных решений:
Исправьте любые не пройденные проверки (
[x]). Вы можете найти описания проблем и потенциальные решения после символа*.Обратите внимание на предупреждения (
[!]) и успешные сообщения ([v]). Они также могут содержать полезные замечания и советы.
Возможные проблемы и решения
- Android Studio
Убедитесь, что у вас установлена Android Studio. Вы можете получить ее с ее официального сайта.
- Java и JDK
Убедитесь, что у вас установлен JDK. Вы можете получить его с его официального сайта.
Android Studio использует интегрированный JDK для выполнения задач Gradle. Для настройки JDK Gradle в Android Studio выберите Настройки/Предпочтения | Выполнение, развертывание, сборка | Инструменты сборки | Gradle.
У вас могут возникнуть проблемы, связанные с
JAVA_HOME. Эта переменная среды указывает расположение двоичного файла Java, необходимого для Xcode и Gradle. В таком случае следуйте советам KDoctor для решения проблем.
- Xcode
Убедитесь, что у вас установлен Xcode. Вы можете получить его с его официального сайта.
Запустите Xcode в отдельном окне, чтобы принять условия лицензии и позволить ему выполнить необходимые начальные задачи.
-
Error: can't grab Xcode schemes. Если вы столкнулись с такой ошибкой, в Xcode выберите Настройки/Предпочтения | Расположения. В поле Инструменты командной строки выберите Xcode.
- Плагины Kotlin
-
Плагин Kotlin Multiplatform Mobile
Убедитесь, что плагин Kotlin Mobile Multiplatform установлен и активирован. На экране приветствия Android Studio выберите Плагины | Установленные. Убедитесь, что плагин активирован. Если его нет в списке Установленные, найдите его в Marketplace и установите плагин.
Если плагин устарел, нажмите Обновить рядом с именем плагина. Вы можете сделать то же самое в разделе Настройки/Предпочтения | Инструменты | Плагины.
Проверьте совместимость плагина Kotlin Multiplatform Mobile с вашей версией Kotlin в таблице Подробностей выпуска.
Плагин Kotlin
Убедитесь, что плагин Kotlin обновлен до последней версии. Для этого на экране приветствия Android Studio выберите Плагины | Установленные. Нажмите Обновить рядом с Kotlin.
Вы также можете проверить версию Kotlin в Инструменты | Kotlin | Настройка обновлений плагина Kotlin.
- Командная строка
-
Убедитесь, что у вас установлены все необходимые инструменты:
command not found: brew— установите Homebrew.command not found: java— установите Java.
Следующий шаг
В следующей части руководства вы создадите свое первое кроссплатформенное мобильное приложение.
Получение помощи
Kotlin Slack. Получите приглашение и присоединитесь к каналу #multiplatform.
Отслеживание проблем Kotlin. Создать новую проблему.
© 2010–2023 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/docs/multiplatform-mobile-setup.html