Настройка окружения

Перед созданием первого приложения, работающего как на iOS, так и на Android, вам необходимо настроить окружение для разработки с помощью Kotlin Multiplatform Mobile.

Установка необходимых инструментов

Мы рекомендуем устанавливать последние стабильные версии для совместимости и лучшей производительности.

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

Возможные проблемы и решения

Android Studio

Убедитесь, что Android Studio установлен. Вы можете скачать его с официального сайта.

Java и JDK

Убедитесь, что JDK установлен. Вы можете скачать его с официального сайта.
Android Studio использует встроенный JDK для выполнения задач Gradle. Для настройки JDK Gradle в Android Studio выберите Настройки/Preferences | Build, Execution, Deployment | Build Tools | Gradle.
Возможно, у вас возникнут проблемы, связанные с JAVA_HOME. Эта переменная среды определяет расположение двоичного файла Java, необходимого для Xcode и Gradle. В этом случае следуйте советам KDoctor для решения проблем.

Xcode

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

Плагины Kotlin

Плагин Kotlin Multiplatform Mobile

Убедитесь, что плагин Kotlin Mobile Multiplatform установлен и активирован. На экране приветствия Android Studio выберите Плагины | Установленные. Проверьте, что плагин включен. Если его нет в списке Установленные, найдите его в Магазине и установите плагин.
Если плагин устарел, нажмите Обновить рядом с названием плагина. Вы можете сделать то же самое в разделе Настройки/Preferences | Инструменты | Плагины.
Проверьте совместимость плагина 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. Создайте новую проблему.

Последнее изменение: 27 сентября 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-setup.html