Spec-Zone.ru › Kotlin 1.9

Компилятор Kotlin для командной строки

В каждом релизе Kotlin поставляется автономная версия компилятора. Вы можете скачать последнюю версию вручную или через менеджер пакетов.

Установка компилятора командной строки не является обязательной для использования Kotlin. Общий способ написания приложений Kotlin — использование IDE, например, IntelliJ IDEA или Android Studio. Они обеспечивают полную поддержку Kotlin «из коробки» без необходимости дополнительных компонентов. Узнайте, как начать работу с Kotlin в IDE.

Установка компилятора

Установка вручную

  1. Загрузите последнюю версию (kotlin-compiler-1.9.0.zip) с GitHub Releases.

  2. Разархивируйте автономный компилятор в каталог и, при необходимости, добавьте каталог bin в системный путь. Каталог bin содержит скрипты, необходимые для компиляции и запуска Kotlin на Windows, macOS и Linux.

SDKMAN!

Более удобный способ установки Kotlin на системах на основе UNIX, таких как macOS, Linux, Cygwin, FreeBSD и Solaris, — это SDKMAN!. Он также работает в оболочках Bash и ZSH. Узнайте, как установить SDKMAN!.

Для установки компилятора Kotlin с помощью SDKMAN! выполните следующую команду в терминале:

sdk install kotlin

Homebrew

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

brew update
brew install kotlin

Пакет Snap

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

sudo snap install --classic kotlin

Создание и запуск приложения

  1. Создайте простое приложение на Kotlin, которое отображает "Hello, World!". В вашем любимом редакторе создайте новый файл с именем hello.kt со следующими строками:

    fun main() {
        println("Hello, World!")
    }
    
  2. Скомпилируйте приложение с помощью компилятора Kotlin:

    kotlinc hello.kt -include-runtime -d hello.jar
    

    Опция -d указывает путь к выходному каталогу для сгенерированных файлов класса, который может быть либо каталогом, либо файлом .jar. Опция -include-runtime делает результирующий файл .jar автономным и исполняемым, включая в него библиотеку Kotlin Runtime.

    Чтобы увидеть все доступные опции, выполните

    kotlinc -help
    
  3. Запустите приложение.

    java -jar hello.jar
    

Компиляция библиотеки

Если вы разрабатываете библиотеку, которую будут использовать другие приложения Kotlin, вы можете создать файл .jar без включения в него библиотеки Kotlin Runtime:

kotlinc hello.kt -d hello.jar

Поскольку двоичные файлы, скомпилированные таким образом, зависят от библиотеки Kotlin Runtime, вы должны убедиться, что последняя присутствует в пути к классам всякий раз, когда используется скомпилированная библиотека.

Вы также можете использовать скрипт kotlin для запуска двоичных файлов, созданных компилятором Kotlin:

kotlin -classpath hello.jar HelloKt

HelloKt — это имя главного класса, которое компилятор Kotlin генерирует для файла с именем hello.kt.

Запуск REPL

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

Shell

Запуск скриптов

Kotlin также может использоваться как скриптовый язык. Скрипт — это файл исходного кода Kotlin (.kts) с исполняемым кодом верхнего уровня.

import java.io.File

// Get the passed in path, i.e. "-d some/path" or use the current path.
val path = if (args.contains("-d")) args[1 + args.indexOf("-d")]
           else "."

val folders = File(path).listFiles { file -> file.isDirectory() }
folders?.forEach { folder -> println(folder) }

Чтобы запустить скрипт, передайте опцию -script компилятору вместе с соответствующим файлом скрипта:

kotlinc -script list_folders.kts -- -d <path_to_folder_to_inspect>

Kotlin предоставляет экспериментальную поддержку настройки скриптов, такую как добавление внешних свойств, предоставление статических или динамических зависимостей и т. д. Настройки определяются так называемыми определениями скриптов — аннотированными классами Kotlin с соответствующим поддерживающим кодом. Расширение имени файла скрипта используется для выбора соответствующего определения. Узнайте больше о настройке скриптов Kotlin.

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

kotlinc -script-templates org.example.CustomScriptDefinition -script custom.script1.kts

Дополнительные сведения см. в KEEP-75.

Последнее изменение: 21 ноября 2022 г.
Kotlin и OSGi Параметры компилятора Kotlin

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

Spec-Zone.ru

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