Настройка среды
Перед созданием своего первого приложения, работающего как на iOS, так и на Android, вам потребуется настроить среду для разработки Kotlin Multiplatform Mobile.
Установка необходимых инструментов
Мы рекомендуем устанавливать последние стабильные версии для совместимости и лучшей производительности.
Инструмент |
Комментарии |
|---|---|
Вы будете использовать Android Studio для создания своих кроссплатформенных приложений и запуска их на симулированных или аппаратных устройствах. |
|
|
В большинстве случаев Xcode будет работать в фоновом режиме. Вы будете использовать его для добавления кода Swift или Objective-C в ваше приложение iOS. |
|
|
Чтобы проверить установку, выполните следующую команду в терминале Android Studio или вашей командной строке: java -version |
|
В Android Studio выберите Настройки/Предпочтения | Плагины, найдите Рынок для 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. Для настройки Gradle JDK в 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 выберите Плагины | Установленные. Убедитесь, что плагин включён. Если его нет в списке Установленные, найдите его на Рынке и установите плагин.
Если плагин устарел, нажмите Обновить рядом с названием плагина. Вы можете сделать то же самое в разделе Настройки/Предпочтения | Сервис | Плагины.
Проверьте совместимость плагина 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