Spec-Zone.ru › Kotlin 1.6

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

Код 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 (старая версия или компилятор IR, или Canvas), или JUnit.

Playground: environment setup

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

Playground: generated JS

Опубликовать код онлайн

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

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

Playground: share code

Командная строка: ki shell

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

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

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

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

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

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

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

Дополнительную информацию см. в репозитории ki shell на GitHub.

Установка и запуск ki shell

Для установки ki shell скачайте последнюю версию с GitHub и распакуйте её в нужную директорию.

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

brew install ki

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

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

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

ki shell показывает варианты автодополнения кода при нажатии Tab. Также, он обеспечивает синтаксическую подсветку по мере ввода. Вы можете отключить эту функцию, введя :syntax off.

ki shell highlighting and completion

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

ki shell results

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

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

ki shell type

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

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

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

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

ki shell load file

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

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

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

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

ki shell external dependency
Последнее изменение: 07 апреля 2022
Eclipse IDE 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