Выполнение фрагментов кода

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

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

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

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

Рабочие листы автоматически имеют доступ к классам и функциям из модуля, в котором они находятся.

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

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

Запуск как REPL

Чтобы оценить каждое конкретное выражение в схеме или рабочем листе, запустите его с выбранным параметром Использовать REPL. Строки кода будут выполняться последовательно, предоставляя результаты каждого вызова. Позже вы можете использовать результаты в том же файле, ссылаясь на сгенерированные автоматически res* имена (они отображаются в соответствующих строках).

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

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

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

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

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

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

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

Playground предоставляет способы настройки среды выполнения:

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

• Несколько бэкендов для выполнения кода: JVM, JS (legacy или компилятор 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.