Spec-Zone.ru › Kotlin 1.9

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

Перед созданием своего первого приложения, работающего как на 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 выберите Настройки/Предпочтения | Плагины, найдите Рынок для 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. Для настройки Gradle JDK в 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 выберите Плагины | Установленные. Убедитесь, что плагин включён. Если его нет в списке Установленные, найдите его на Рынке и установите плагин.

  • Если плагин устарел, нажмите Обновить рядом с названием плагина. Вы можете сделать то же самое в разделе Настройки/Предпочтения | Сервис | Плагины.

  • Проверьте совместимость плагина 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. Отправить новую проблему.

Последнее изменение: 11 апреля 2023 г.
Начало работы с Kotlin Multiplatform для мобильных устройств Создание первого кроссплатформенного приложения

© 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