Параметры компилятора Kotlin

-version

Отобразить версию компилятора.

-nowarn

Запретить компилятору отображать предупреждения во время компиляции.

-Werror

Преобразовать любые предупреждения в ошибку компиляции.

-verbose

Включить подробный вывод регистрации, который включает подробности процесса компиляции.

-script

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

-help (-h)

Отобразить информацию об использовании и выйти. Отображаются только стандартные параметры. Чтобы отобразить расширенные параметры, используйте -X.

-X

Отобразить информацию о расширенных параметрах и выйти. Эти параметры в настоящее время нестабильны: их имена и поведение могут быть изменены без предварительного уведомления.

-kotlin-home path

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

-P plugin:pluginId:optionName=value

Передать параметр плагину компилятора Kotlin. Доступные плагины и их параметры перечислены в разделе Инструменты > Плагины компилятора документации.

-language-version version

Обеспечить совместимость исходного кода со указанной версией Kotlin.

-api-version version

Разрешить использование объявлений только из указанной версии связанных библиотек Kotlin.

-progressive

Включить режим поэтапного для компилятора.

В режиме поэтапного выполнения устаревания и исправления ошибок для нестабильного кода вступают в силу немедленно, вместо того, чтобы проходить цикл плавного перехода. Код, написанный в режиме поэтапного выполнения, совместим со старыми версиями; однако, код, написанный в режиме, отличном от поэтапного выполнения, может привести к ошибкам компиляции в режиме поэтапного выполнения.

@argfile

Считывать параметры компилятора из указанного файла. Такой файл может содержать параметры компилятора со значениями и путями к исходным файлам. Параметры и пути должны быть разделены пробелами. Например:

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

Для передачи значений, содержащих пробелы, заключите их в одинарные (') или двойные (") кавычки. Если значение содержит знаки кавычек, экранируйте их обратной косой чертой (\).

-include-runtime -d 'My folder'

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

$ kotlinc @compiler.options @classes

Если файлы находятся в расположениях, отличных от текущей директории, используйте относительные пути.

$ kotlinc @options/compiler.options hello.kt

-opt-in annotation

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

-classpath путь (-cp путь)

Поиск файлов классов в указанных путях. Элементы пути к классам разделяются системными разделителями путей (; в Windows, : в macOS/Linux). Путь к классам может содержать пути к файлам и каталогам, ZIP- или JAR-файлам.

-d путь

Расположение сгенерированных файлов классов в указанном месте. Место может быть каталогом, ZIP- или JAR-файлом.

-include-runtime

Включение Kotlin-runtime в результирующий JAR-файл. Делает результирующий архив исполняемым в любой Java-среде.

-jdk-home путь

Использование пользовательской домашней директории JDK в пути к классам, если она отличается от значения по умолчанию JAVA_HOME.

-Xjdk-release=версия

Указание целевой версии сгенерированного JVM-байткода. Ограничение API JDK в пути к классам указанной версией Java. Автоматически устанавливает -jvm-target version. Возможные значения: 1.8, 9, 10, ..., 18. Значение по умолчанию — 1.8.

-jvm-target версия

Указание целевой версии сгенерированного JVM-байткода. Возможные значения: 1.8, 9, 10, ..., 18. Значение по умолчанию — 1.8.

-java-parameters

Генерация метаданных для рефлексии Java 1.8 по параметрам методов.

-module-name имя (JVM)

Установка пользовательского имени для сгенерированного .kotlin_module файла.

-no-jdk

Не включать автоматически Java-runtime в путь к классам.

-no-reflect

Не включать автоматически Kotlin-рефлексию (kotlin-reflect.jar) в путь к классам.

-no-stdlib (JVM)

Не включать автоматически Kotlin/JVM-stdlib (kotlin-stdlib.jar) и Kotlin-рефлексию (kotlin-reflect.jar) в путь к классам.

-script-templates имена_классов[,]

Шаблоны определения сценариев. Используйте полные имена классов и разделяйте их запятыми (,).

-libraries path

Пути к библиотекам Kotlin с файлами .meta.js и .kjsm, разделенные системным разделителем путей.

-main {call|noCall}

Определяет, должна ли вызываться функция main при выполнении.

-meta-info

Генерирует файлы .meta.js и .kjsm с метаданными. Используйте этот параметр при создании JS-библиотеки.

-module-kind {umd|commonjs|amd|plain}

Тип генерируемого компилятором JS-модуля:

• umd — модуль Universal Module Definition

• commonjs — модуль CommonJS

• amd — модуль Asynchronous Module Definition

• plain — обычный JS-модуль

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

-no-stdlib (JS)

Не включать автоматически стандартную библиотеку Kotlin/JS в зависимости компиляции.

-output filepath

Указывает целевой файл для результата компиляции. Значение должно быть путем к файлу .js включая его имя.

-output-postfix filepath

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

-output-prefix filepath

Добавляет содержимое указанного файла в начало выходного файла.

-source-map

Генерировать карту исходного кода.

-source-map-base-dirs path

Использовать указанные пути в качестве базовых каталогов. Базовые каталоги используются для вычисления относительных путей в карте исходного кода.

-source-map-embed-sources {always|never|inlining}

Встраивать исходные файлы в карту исходного кода.

-source-map-prefix

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