Запуск фрагментов кода

Интерактивный режим

IDE может запускать код из черновиков автоматически. Чтобы получать результаты выполнения сразу после того, как вы перестанете печатать, включите Интерактивный режим.

Использование модулей

В черновиках можно использовать классы и функции из проекта Kotlin.

Чтобы использовать классы или функции из проекта в черновике, импортируйте их в файл-черновик с помощью инструкции import, как обычно. Затем напишите код и запустите его, выбрав соответствующий модуль в списке Использовать путь к классам модуля.

Черновики используют скомпилированные версии подключенных модулей. Поэтому, если вы измените исходные файлы модуля, изменения появятся в черновиках после повторной сборки модуля. Чтобы автоматически собирать модуль перед каждым запуском черновика, выберите Собирать модуль перед запуском.

Написание и редактирование кода

В области редактора Playground можно писать код так же, как в исходном файле:

• Добавляйте собственные классы, функции и объявления верхнего уровня в произвольном порядке.

• Пишите исполняемую часть в теле функции main().

Как и в обычных проектах Kotlin, функция main() в Playground может иметь параметр args или не иметь параметров вовсе. Чтобы передать аргументы программы при запуске, укажите их в поле Аргументы программы.

Playground подсвечивает код и показывает варианты автодополнения во время ввода. Он автоматически импортирует объявления из стандартной библиотеки и kotlinx.coroutines.

Выбор среды выполнения

Playground позволяет настраивать среду выполнения:

• Несколько версий Kotlin, включая доступные предварительные версии будущих выпусков.

• Несколько платформ для выполнения кода: JVM, JS (устаревшая версия или IR-компилятор, либо Canvas) или JUnit.

Для платформ JS можно также посмотреть сгенерированный код JS.

Обмен кодом в интернете

Используйте Playground, чтобы поделиться кодом с другими: нажмите Копировать ссылку и отправьте её тем, кому хотите показать код.

Вы также можете встраивать фрагменты кода из Playground на другие сайты и даже делать их запускаемыми. Нажмите Поделиться кодом, чтобы встроить пример на любую веб-страницу или в статью на Medium.

Установка и запуск оболочки ki

Чтобы установить оболочку ki, скачайте её последнюю версию с GitHub и распакуйте в нужную папку.

В macOS также можно установить оболочку ki с помощью Homebrew, выполнив следующую команду:

brew install ki

Чтобы запустить оболочку ki, выполните bin/ki.sh в Linux и macOS (или просто ki, если оболочка ki установлена с помощью Homebrew) либо bin\ki.bat в Windows.

После запуска оболочки можно сразу начать писать код Kotlin в терминале. Введите :help (или :h), чтобы посмотреть доступные команды оболочки ki.

Автодополнение и подсветка кода

Оболочка ki показывает варианты автодополнения кода при нажатии Tab. Она также подсвечивает синтаксис во время ввода. Эту возможность можно отключить, введя :syntax off.

При нажатии Enter оболочка ki вычисляет введённую строку и выводит результат. Значения выражений выводятся как переменные с автоматически созданными именами, например res*. Позже такие переменные можно использовать в запускаемом коде. Если введённая конструкция не завершена (например, if с условием, но без тела), оболочка выводит три точки и ожидает продолжения.

Проверка типа выражения

Для сложных выражений или незнакомых API оболочка ki предоставляет команду :type (или :t), которая показывает тип выражения:

Загрузка кода

Если нужный код хранится в другом месте, есть два способа загрузить его и использовать в оболочке ki:

• Загрузите исходный файл с помощью команды :load (или :l).

• Скопируйте и вставьте фрагмент кода в режиме вставки с помощью команды :paste (или :p).

Команда ls показывает доступные символы (переменные и функции).

Добавление внешних зависимостей

Помимо стандартной библиотеки, оболочка ki поддерживает внешние зависимости. Это позволяет пробовать сторонние библиотеки без создания целого проекта.

Чтобы добавить стороннюю библиотеку в оболочку ki, используйте команду :dependsOn. По умолчанию оболочка ki работает с Maven Central, но можно использовать и другие репозитории, подключив их с помощью команды :repository: