Spec-Zone.ru › Kotlin 1.7

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

Код Kotlin обычно организуется в проекты, с которыми вы работаете в IDE, текстовом редакторе или другом инструменте. Однако, если вы хотите быстро увидеть, как работает функция или найти значение выражения, нет необходимости создавать новый проект и собирать его. Ознакомьтесь с тремя удобными способами запуска кода Kotlin мгновенно в разных средах:

  • Файлы-схемы и рабочие листы в IDE.

  • Kotlin Playground в браузере.

  • ki shell в командной строке.

IDE: схемы и рабочие листы

IntelliJ IDEA и Android Studio поддерживают Kotlin файлы-схемы и рабочие листы.

  • Файлы-схемы (или просто схемы) позволяют создавать черновые наброски кода в том же окне IDE, что и ваш проект, и запускать их на лету. Схемы не привязаны к проектам; вы можете получить доступ и запустить все свои схемы из любого окна IntelliJ IDEA на вашей операционной системе.

    Чтобы создать схему Kotlin, нажмите Файл | Новый | Файл-схему и выберите тип Kotlin.

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

    Чтобы создать рабочий лист Kotlin в каталоге проекта, щелкните правой кнопкой мыши по каталогу в дереве проекта и выберите Новый | Рабочий лист Kotlin.

Подсветка синтаксиса, автозаполнение и другие функции редактирования кода IntelliJ IDEA поддерживаются в схемах и рабочих листах. Нет необходимости объявлять функцию main(), весь написанный вами код выполняется так, как будто он находится в теле main().

После завершения написания кода в схеме или рабочем листе, нажмите Запуск. Результаты выполнения будут отображены в строках напротив вашего кода.

Run scratch

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

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

Scratch interactive mode

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

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

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

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

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

Scratch select module

Запуск как REPL

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

Scratch REPL

Браузер: Kotlin Playground

Kotlin Playground — это онлайн-приложение для написания, запуска и обмена кодом Kotlin в вашем браузере.

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

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

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

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

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

Playground: code completion

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

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

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

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

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

Playground: environment setup

Для бэкендов JS вы также можете увидеть сгенерированный JS-код.

Playground: generated JS

Обмен кодом онлайн

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

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

Playground: share code

Командная строка: оболочка ki

Оболочка ki (Интерактивная оболочка Kotlin) — это утилита командной строки для выполнения кода Kotlin в терминале. Она доступна для Linux, macOS и Windows.

Оболочка ki предоставляет базовые возможности оценки кода, а также расширенные функции, такие как:

  • автодополнение кода

  • проверки типов

  • внешние зависимости

  • режим вставки для фрагментов кода

  • поддержка скриптов

Подробную информацию см. в репозитории ki shell на GitHub.

Установка и запуск оболочки 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.

ki shell highlighting and completion

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

ki shell results

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

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

ki shell type

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

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

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

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

ki shell load file

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

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

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

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

ki shell external dependency
Последнее изменение: 06 сентября 2022
Переход к стилю кода Kotlin Компилятор Kotlin для командной строки

© 2010–2022 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/docs/run-code-snippets.html

Spec-Zone.ru

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