Spec-Zone.ru › Kotlin 1.8

Настройка среды

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

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

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

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

Инструмент

Комментарии

Android Studio

Вы будете использовать Android Studio для создания многоплатформенных приложений и запуска их на эмулированных или аппаратных устройствах.

Xcode

В большинстве случаев Xcode будет работать в фоновом режиме. Вы будете использовать его для добавления кода Swift или Objective-C в ваше iOS-приложение.

В целом мы рекомендуем использовать последние стабильные версии всех инструментов. Однако, Kotlin/Native иногда не поддерживает новейшую версию Xcode сразу. Если у вас такая ситуация, установите более раннюю версию Xcode.

JDK

Для проверки, установлен ли он, выполните следующую команду в терминале Android Studio или в вашей командной строке:

java -version

Плагин Kotlin Multiplatform Mobile

В Android Studio выберите Настройки/Предпочтения | Плагины, найдите Marketplace для Kotlin Multiplatform Mobile, а затем установите его.

Плагин Kotlin

Плагин Kotlin поставляется с каждой версией Android Studio. Однако его все равно необходимо обновить до последней версии, чтобы избежать проблем с совместимостью.

Для обновления плагина на экране приветствия Android Studio выберите Плагины | Установленные. Нажмите Обновить рядом с Kotlin. Вы также можете проверить версию Kotlin в Инструменты | Kotlin | Настройка обновлений плагина Kotlin.

Плагин Kotlin должен быть совместим с плагином Kotlin Multiplatform Mobile. Обратитесь к таблице совместимости.

Проверка вашей среды

Чтобы убедиться, что все работает как ожидается, установите и запустите инструмент KDoctor:

KDoctor работает только на macOS.

  1. В терминале Android Studio или в вашей командной строке выполните следующую команду для установки инструмента с помощью Homebrew:

    brew install kdoctor
    

    Если у вас еще нет Homebrew, установите его или ознакомьтесь с README инструмента KDoctor для других способов установки.

  2. После завершения установки вызовите KDoctor в консоли:

    kdoctor
    
  3. Если KDoctor обнаружит какие-либо проблемы при проверке вашей среды, просмотрите вывод для определения проблем и возможных решений:

    • Исправьте любые не пройденные проверки ([x]). Вы можете найти описания проблем и потенциальные решения после символа *.

    • Обратите внимание на предупреждения ([!]) и успешные сообщения ([v]). Они также могут содержать полезные замечания и советы.

    Вы можете проигнорировать предупреждения KDoctor относительно установки CocoaPods. В вашем первом проекте вы будете использовать другой вариант распространения iOS-фреймворков.

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

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.

    Xcode schemes
Плагины 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. Создать новую проблему.

Последнее изменение: 10 января 2023
Начало работы с Kotlin Multiplatform Mobile Создание первого кроссплатформенного приложения

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API