Управление зависимостями в IntelliJ IDEA
В этом руководстве, в продолжение темы просмотра зависимостей, мы рассмотрим управление зависимостями в IntelliJ IDEA.
Мы рассмотрим различные способы добавления зависимостей в ваш проект, а также способы добавления, обновления и удаления зависимостей с помощью Package Search.
Добавление зависимостей
Существует несколько способов добавления новых зависимостей в ваш проект.
Из файла сборки с помощью копирования/вставки
Вы наверняка копировали зависимость из репозитория Maven (или другого веб-сайта) и вставляли ее в свой файл сборки.
Например, мы можем скопировать формат Gradle для этой зависимости и вставить его в наш файл build.gradle.
Или, если мы используем Maven, мы можем скопировать формат Maven xml в наш pom.xml.
Знаете ли вы, что если вы скопируете и вставите зависимость Maven XML в файл build.gradle, IntelliJ IDEA автоматически преобразует ее в правильный формат для Gradle?
Из файла сборки с помощью автозавершения кода
Мы также можем добавить зависимости в наш файл сборки, используя автозавершение кода. Например, давайте добавим новую зависимость в наш файл pom.xml.
Мы видим, что IntelliJ IDEA автоматически дополняет xml зависимости, и мы можем искать нужную зависимость, в данном примере AssertJ.
При необходимости также будет добавлен номер версии. Поскольку это тестовая зависимость, нам нужно добавить тестовую область видимости, по-прежнему используя автозавершение кода.
Автозавершение кода работает и в Gradle, как вы можете видеть ниже.
Из файла сборки с помощью генерации кода
Мы также можем использовать генерацию кода из файла сборки для добавления зависимостей.
В файле сборки pom.xml в проекте Maven вызовите Package Search (поиск пакетов) с помощью ⌘N (в macOS) или Alt+Insert (в Windows и Linux) и в открывшемся меню выберите Add dependency.
Откроется окно инструмента Dependencies (Зависимости).
Обратите внимание: если мы используем Gradle, мы можем сделать то же самое в нашем файле build.gradle.
Из окна инструмента Dependencies
В качестве альтернативы мы можем напрямую открыть окно инструмента Dependencies.
Ярлыка для открытия окна инструмента Dependencies не существует, поэтому мы можем использовать Recent Files, ⌘E (на Mac) или Ctrl+E (в Windows/Linux) и ввести «dependencies», чтобы открыть окно инструмента Dependencies.
В качестве альтернативы мы можем открыть его, нажав Quick Launch в левом нижнем углу и выбрав Dependencies.
В окне инструмента Dependencies мы можем искать зависимость. Например, давайте поищем AssertJ.
Обратите внимание, что мы можем выбрать область видимости для этой зависимости.
Названия областей видимости зависят от инструмента сборки, с которым вы работаете.
Поскольку это тестовая зависимость, и мы используем Gradle в этом проекте, мы можем установить область видимости на testImplementation.
Мы также можем выбрать версию, которую хотим использовать.
Мы можем сделать то же самое в Maven.
Обратите внимание, что названия областей видимости для Maven отличаются от Gradle.
В Maven мы можем установить область видимости для тестовой зависимости как test.
Когда мы нажимаем Add, мы видим, что зависимость добавлена в файл сборки.
Если номер версии показан красным цветом, это означает, что IntelliJ IDEA еще не загружала эту библиотеку.
Щелкните Load Maven Changes, чтобы IntelliJ IDEA обновила свои зависимости на основе изменений в файле pom.xml или build.gradle.
Вернитесь в окно инструмента Dependencies и очистите поле поиска, нажав на x с правой стороны. Вы увидите, что зависимости проекта обновлены вашей новой зависимостью.
Далее ищем jackson-databind. Мы видим, что доступно несколько версий.
Поскольку мы выбрали Only stable, в списке отображаются только стабильные версии.
Если мы снимем флажок с этой опции, мы увидим, что в список версий также входят кандидаты на выпуск.
Для производственного кода мы, вероятно, хотим использовать стабильные версии, поэтому давайте снова установим флажок Only stable.
Если эта опция включена, IntelliJ IDEA исключит все зависимости, не имеющие стабильных версий, и скроет их в списке.
Теперь мы можем выбрать последнюю стабильную версию и добавить ее в наш проект. Давайте также снова загрузим Maven Changes.
Наконец, давайте также добавим новую зависимость для модуля Kotlin.
Давайте переключимся на модуль Kotlin и откроем pom.xml для этого модуля.
Откройте окно Dependencies Tool и найдите Ktor.
Обратите внимание, что некоторые зависимости помечены как Multiplatform (многоплатформенные).
Если мы хотим видеть только многоплатформенные зависимости Kotlin, мы можем установить флажок Kotlin multiplatform, как показано ниже.
Когда мы нажимаем Add справа от зависимости Ktor, мы видим, что Ktor добавлен в список зависимостей и в pom.xml для модуля Kotlin.
Обновление зависимостей
Нам также необходимо будет поддерживать наши зависимости в актуальном состоянии.
Чтобы показать вам, как IntelliJ IDEA может в этом помочь, мы используем в качестве примера этот крайне устаревший проект.
В pom.xml ниже мы видим, что несколько зависимостей отмечены волнистыми линиями под ними.
IntelliJ IDEA покажет предложение по обновлению, когда мы наведем указатель мыши на зависимость, и мы можем щелкнуть по предложению для обновления зависимостей.
В качестве альтернативы мы можем использовать Context Actions (контекстные действия) ⌥⏎ (в macOS) или Alt+Enter (в Windows и Linux) для обновления этих зависимостей.
Мы также можем обновить наши зависимости, используя окно Dependencies tool.
Окно Dependencies tool подскажет нам, есть ли более новая версия зависимости, как мы видим здесь.
Мы можем выбрать версию для обновления, нажав на номер версии в списке.
Обратите внимание, что нам необязательно использовать последнюю версию.
Мы также можем автоматически обновить зависимость до последней версии, нажав Upgrade для этой конкретной зависимости.
Или мы можем даже обновить все наши зависимости сразу, нажав на ссылку Upgrade all.
Удаление зависимостей
Наконец, мы можем удалить зависимости, которые нам больше не нужны. В окне Dependencies tool давайте удалим jackson-databind из модуля Java.
Выберем зависимость, которую хотим удалить (jackson-databind), и на панели сведений о зависимости справа нажимаем кнопку More (три точки) и выбираем Remove.
Мы увидим, что зависимость удалена из pom.xml и списка зависимостей. Чтобы удалить зависимость из всего проекта, выберите All Modules слева.
Резюме и ярлыки
Теперь мы знаем различные способы просмотра зависимостей нашего проекта в IntelliJ IDEA, а также различные фокусы для каждого представления.
Используемые сочетания клавиш IntelliJ IDEA
Вот горячие клавиши IntelliJ IDEA, которые мы использовали.
Горячие клавиши macOS
Горячие клавиши Windows/Linux
⌘1
Alt+1
⌘E
Control+Е
Вызвать поиск пакетов
⌘N
Alt+Insert
Alt+Ввод
Ссылки по теме
- (video) JetBrains — IntelliJ IDEA: Managing Dependencies
- (video) JetBrains — IntelliJ IDEA: Viewing Dependencies
- (blog) Viewing Dependencies in IntelliJ IDEA
- (docs) JetBrains — Package Search
- (docs) JetBrains — Package Search Build System Support Limitations
- (code) JetBrains — intellij-samples
- (code) Spring PetClinic
- (book) Getting to Know IntelliJ IDEA — Trisha Gee & Helen Scott
Настройка IntelliJ IDEA
Эта статья рассказывает о том, как настроить Ваше рабочее пространство в IntelliJ IDEA для разработки плагинов с использованием SpongeAPI и а системы сборки, таких как Maven или Gradle или Плагин разработки Minecraft.
Если вы хотите создать ваш проект полностью с нуля, пожалуйста, пропустите все до секции Gradle или Maven. Используя плагин Minecraft Dev, он установит точку старта и устранит ваши попытки понять что означают те или функции при поднятии вашего проекта «с земли».
Использование IDEA Minecraft Dev плагина для создания рабочей отправной точки
Плагин Minecraft Development для IntelliJ это отличный плагин, который делает процесс создания плагина гораздо проще, а также предоставляет некоторые аккуратные и полезные возможности для разработки. По умолчанию он создаст проект, который использует Gradle как инструмент сборки.
Установка Плагина Разработки Minecraft
Этот плагин доступен в репозитории плагинов JetBrains IntelliJ.
Благодаря нему, вы можете установить плагин через внутренний браузер IntelliJ. Перейдите в File -> Settings -> Plugins и нажмите на кнопку Browse Repositories. внизу окна. В окне поиска просто найдите Minecraft . Вы можете установить его там и перезапустить IntelliJ, чтобы активировать плагин.
Создание Вашего Проекта из Шаблона
- Откройте IntelliJ IDEA.
- Нажмите Create New Project .
- Выберите Minecraft в всплывающем меню.
- Убедитесь, что в SDK проекта установлена версия 8/1.8 Java.
- Выберите Sponge plugin для типа вашего проекта, затем нажмите Next .
- Введите Ваши Group ID, Artifact ID, и Version.
- Group ID обычно должен соответствовать названию Вашего пакета Java. Для подробностей смотрите Основной класс плагина .
- Artifact ID обычно должен соответствовать Вашему plugin ID, который задавался Вами ранее, например myplugin .
- Your Version is up to you. See Номер версии for details.
Изменение конфигурации проекта
Перейдите в Gradle или Maven секцию, в зависимости от того, что вы выбрали при создании проекта.
Создание плагина с нуля – Gradle
- Откройте IntelliJ IDEA.
- Нажмите Create New Project .
- Выберите Gradle в раскрывшемся списке.
- Если вы хотите, выберите любые дополнительные библиотеки и фреймворки, например Kotlin.
- Убедитесь, что в SDK проекта установлена версия 8/1.8 Java.
- Нажмите Next для дальнейших действий.
- Введите Ваши Group ID, Artifact ID, и Version.
- Group ID обычно должен соответствовать названию Вашего пакета Java. Для подробностей смотрите Основной класс плагина .
- Artifact ID обычно должен соответствовать Вашему plugin ID, который задавался Вами ранее, например myplugin .
- Your Version is up to you. See Номер версии for details.
- Windows: File -> Settings -> Build, Execution, Deployment -> Gradle
- Mac: Intellij IDEA -> Preferences -> Build, Execution, Deployment -> Build Tools -> Gradle
Редактирование Скрипта Сборки
- Откройте build.gradle в навигаторе и добавьте зависимости.
- Отредактируйте build-скрипт, как описано в статье Настройка Gradle .
- Откройте Gradle tab в правой части окна программы и нажмите кнопку обновления (refresh).
- Установка Gradle завершена! Теперь Вы можете приступить к написанию кода Вашего плагина.
Создание плагина с нуля – Maven
Создание Вашего Проекта
- Откройте IntelliJ IDEA.
- Нажмите Create New Project .
- Выберите Maven в раскрывающемся списке.
- Убедитесь, что в SDK проекта установлена версия 8/1.8 Java.
- Нажмите Next для дальнейших действий.
- Введите Ваши Group ID, Artifact ID, и Version.
- Group ID обычно должен соответствовать названию Вашего пакета Java. Для подробностей смотрите Основной класс плагина .
- Artifact ID обычно должен соответствовать Вашему plugin ID, который задавался Вами ранее, например myplugin .
- Your Version is up to you. See Номер версии for details.
Изменение конфигурации проекта
- Откройте pom.xml в навигаторе.
- Отредактируйте build-скрипт, как описано в статье Настройка Maven .
- Обновите Ваш проект Maven.
- Импортируйте изменения Maven, если появилась подсказка.
Тестирование Вашего Плагина
Следующие инструкции созданы для быстрого способа тестирования вашего плагина, но не являются самым эффективным способом для постоянной разработки.
Для создания .jar файла, используя Gradle:
- Перейдите в View -> Tool Windows -> Gradle
- Под Tasks -> Build , нажмите на jar
- Процесс сборки должен создать jar в build\libs
Для создания .jar файла, используя Mave:
- Перейдите в View -> «Tool Windows« -> Maven Projects
- В окне Maven Projects , укажите название вашего проекта
- В Plugins , укажите jar
- Сделайте двойной щелчок по jar:jar
- Процесс сборки должен создать jar в taget
Скопируйте ваш jar файл в директорию mods рабочего Sponge сервера, затем перезапустите сервер для проверки.
Для более эффективного процесса разработки, смотрите Отладка плагина для инструкций по запуску как на сервере Sponge, так и плагина внутри IDEA. Этот процесс позволяет вам изменять код плагина без перезапуска сервера.
Импорт Существующего Проекта (Gradle или Maven)
Если вы уже начали работу с вашим проектом и хотите снова импортировать его позже, вам необходимо его импортировать вместо повторного создания внутри вашей IDE:
- Нажмите Файл > Открыть или Импортировать Проект .
- Gradle: Переместитесь к файлу build.gradle и выберите его.
- Maven: Переместитесь к файлу pom.xml и выберите его.
- Убедитесь, что все настройки верны и нажмите Ок .
Git Интеграция
JetBrain предлагает документацию по интеграции Git:
Настройка IntelliJ IDEA
Эта статья рассказывает о том, как настроить Ваше рабочее пространство IntelliJ IDEA для разработки плагинов со SpongeAPI и :doc: создавать системы, такие как Maven или Gradle `.
Gradle
Создание проекта
- Откройте IntelliJ IDEA.
- Нажмите Create New Project .
- Выберите Gradle в появившемся окне и нажмите кнопку Next .
- Введите Ваши Group ID, Artifact ID, и Version.
- Group ID обычно должен соответствовать названию Вашего пакета Java. Для подробностей смотрите Основной класс плагина .
- Artifact ID обычно должен соответствовать Вашему plugin ID, который задавался Вами ранее, например myplugin .
- Version — версия проекта, зависит только от Вас.
Редактирование build-скрипта
- Откройте build.gradle в навигаторе и добавьте зависимости.
- Отредактируйте build-скрипт, как описано в статье Настройка Gradle .
- Откройте Gradle tab в правой части окна программы и нажмите кнопку обновления (refresh).
- Установка Gradle завершена! Теперь Вы можете приступить к написанию кода Вашего плагина.
Импорт Вашего проекта
Если вы уже начали работу с вашим проектом и хотите снова импортировать его позже, вам необходимо его импортировать вместо повторного создания внутри вашей IDE:
- Нажмите File > Open
- Перейдите к файлу проекта build.gradle
- Нажмите Ok
Maven
Создание проекта
- Откройте IntelliJ IDEA.
- Нажмите Create New Project .
- Выберите Maven в появившемся окне и нажмите Next .
- Введите Ваши Group ID, Artifact ID, и Version.
- Group ID обычно должен соответствовать названию Вашего пакета Java. Для подробностей смотрите Основной класс плагина .
- Artifact ID обычно должен соответствовать Вашему plugin ID, который задавался Вами ранее, например myplugin .
- Version — версия проекта, зависит только от Вас.
Редактирование конфигурации проекта
- Откройте pom.xml в навигаторе.
- Отредактируйте build-скрипт, как описано в статье Настройка Maven .
- Обновите Ваш проект Maven.
- Импортируйте изменения Maven, если появилась подсказка.
Импорт Вашего проекта
Если вы уже начали работу с вашим проектом и хотите снова импортировать его позже, вам необходимо его импортировать вместо повторного создания внутри вашей IDE:
- Нажмите File > Open
- Перейдите к файлу проекта pom.xml
- Нажмите Ok
Git Интеграция
JetBrains предлагает документацию по интеграции Git:
Gradle
Для сборки с помощью Gradle необходимо настроить kotlin-gradle плагин, применить его к своему проекту и добавить kotlin-stdlib зависимость. Эти действия могут быть сделаны автоматически с помощью IntelliJ IDEA во вкладке Tools | Kotlin | Configure Kotlin.
Плагин и версии
kotlin-gradle-plugin создает Kotlin ресурсы и модули.
Версия Kotlin обычно указывается в kotlin_version свойстве:
buildscript < ext.kotlin_version = '>' repositories < mavenCentral() >dependencies < classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version" >>Это не требуется когда версия Kotlin Gradle плагина 1.1.1 и выше с Gradle plugins DSL.
Поддержка JVM
Чтобы настроить JVM необходимо использовать плагин Kotlin:
apply plugin: "kotlin"Начиная с Kotlin 1.1.1 плагин может быть применен автоматически с использованием Gradle plugins DSL:
plugins < id "org.jetbrains.kotlin.jvm" version ">" >version должен быть в данном блоке(как на примере), и не может быть использован из других скриптов сборки.
Kotlin ресурсы могут сочетаться с Java ресурсами из одной папки или разных папок. По умолчанию используются разные папки:
project - src - main (root) - kotlin - javaСоответствующее свойство sourceSets должно быть обновлено, если не использовано значение по умолчанию:
sourceSets < main.kotlin.srcDirs += 'src/main/myKotlin' main.java.srcDirs += 'src/main/myJava' >Поддержка JavaScript
Для использования JavaScript должен применяться другой плагин:
apply plugin: "kotlin2js"Данный плагин работает только для Kotlin файлов, таким образом рекомендуется хранить Kotlin и Java файлы раздельно (Это в случае если данный проект содержит Java файлы). Как и с поддержкой JVM, если не используются значения по умолчанию, необходимо определить папки ресурсов в sourceSets:
sourceSets < main.kotlin.srcDirs += 'src/main/myKotlin' >В дополнение к выходному файлу JavaScript плагин по умолчанию создает дополнительный JS-файл с двоичными дескрипторами. Эти файлы требуются в случае создании библиотеки, чтобы Kotlin модули могли наследоваться от нее, и должны распространяться вместе с библиотекой.
Процесс контролируется kotlinOptions.metaInfo свойством:
compileKotlin2Js
Поддержка Android
Android’s Gradle модель отличается от обычной Gradle модели, поэтому если необходимо собрать Android проект использующий Kotlin, необходимо применить kotlin-android плагин вместо kotlin:
buildscript < ext.kotlin_version = '>' . dependencies < classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version" >> apply plugin: 'com.android.application' apply plugin: 'kotlin-android'Android Studio
При использовании Android Studio, необходимо добавить следующее под блоком android:
android < . sourceSets < main.java.srcDirs += 'src/main/kotlin' >>Это позволит Android Studio находить kotlin директорию в папке с ресурсами поэтому когда проект будет загружен в IDE, он будет правильно распознан. Другой способ — это добавить Kotlin классы в Java директорию, расположенную по пути src/main/java .
Настройка зависимостей
В дополнение к зависимостям kotlin-gradle-plugin , показанным выше, вам нужно добавить зависимость от стандартной библиотеки Kotlin:
repositories < mavenCentral() >dependencies
Для поддержки JavaScript используйте compile «org.jetbrains.kotlin:kotlin-stdlib-js» .
Если вы собираетесь включить поддержку JDK 7 или JDK 8, вы можете использовать расширенную версию Kotlin standard library, которая содержит расширенный API, добавленный в новой JDK версии. Вместо kotlin-stdlib , используйте одну из следующих зависимостей:
compile "org.jetbrains.kotlin:kotlin-stdlib-jdk7" compile "org.jetbrains.kotlin:kotlin-stdlib-jdk8"В Kotlin 1.1.x, используйте kotlin-stdlib-jre7 вместо kotlin-stdlib-jre8 .
Если проект содержит Kotlin reflection или средства тестирования, вам также необходимо добавить соответствующие зависимости:
compile "org.jetbrains.kotlin:kotlin-reflect" testCompile "org.jetbrains.kotlin:kotlin-test" testCompile "org.jetbrains.kotlin:kotlin-test-junit"Начиная с Kotlin 1.1.2 зависимости из группы org.jetbrains.kotlin по умолчанию разрешены. Вы можете указать версию вручную, используя полную зависимость, например compile «org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version» .
Аннотации
Пошаговая компиляция
Kotlin поддерживает пошаговую компиляцию в Gradle. Пошаговая компиляция отслеживает изменения исходных файлов между сборками, поэтому будут скомпилированы только файлы, затронутые этими изменениями.
Начиная с Kotlin 1.1.1 пошаговая компиляция доступна по умолчанию.
Существует несколько способов переопределить настройку по умолчанию:
- Добавить kotlin.incremental=true или kotlin.incremental=false либо в gradle.properties , либо в local.properties файл;
- Добавить -Pkotlin.incremental=true или -Pkotlin.incremental=false как параметр командной строки. Обратите внимание, что в этом случае параметр должен быть добавлен к каждой последующей сборке, а любая сборка с отключенной пошаговой компиляцией делает недействительными пошаговые кеши.
Когда пошаговая компиляция включена, в журнале сборки должно появиться следующее сообщение:
Using kotlin incremental compilationОбратите внимание, что первая сборка не будет пошаговой.
Поддержка Coroutines(сопрограммы)
Coroutines добавлены как экспериментальная функция в Kotlin 1.2, поэтому компилятор Kotlin сообщает об использовании сопрограмм в вашем проекте. Чтобы отключить предупреждение, добавьте следующий блок в свой файл build.gradle :
kotlin < experimental < coroutines 'enable' >>Названия модулей
Модули Kotlin, создаваемые сборкой, называются соответственно свойству «archivesBaseName» в проекте. Если проект имеет широкое имя, например lib или jvm , что является общим для подпроектов, выходные файлы Kotlin, относящиеся к модулю ( * .kotlin_module ), могут столкнуться с модулями из сторонних модулей с тем же именем, это вызывает проблемы, когда проект упаковывается в один архив (например, APK).
Чтобы этого избежать, рассмотрите возможность установки уникального archivesBaseName вручную:
archivesBaseName = 'myExampleProject_lib'Поддержка кеша Gradle Build Cache (начиная с версии 1.2.20)
Kotlin плагин поддерживает Gradle Build Cache (Требуется версия 4.3 и выше; кеширование отключено в более низких версиях).
Задачи обработки аннотаций Kapt не кэшируются по умолчанию, поскольку обработчики аннотаций запускают произвольный код, который необязательно преобразовывает входящие задачи в выходящие и может обращаться к файлам, не отслеживаемых Gradle, и изменять их. Чтобы включить кэширование для kapt в любом случае, добавьте следующие строки в сценарий сборки:
kapt
Чтобы отключить кеширование для всех задач Kotlin, установите для параметра системного свойства kotlin.caching.enabled значение false (запустите сборку с аргументом -Dkotlin.caching.enabled=false ).
Опции компилятора
Kotlin` pattern. The names of the tasks in Android Projects contain the [build variant](https://developer.android.com/studio/build/build-variants.html) names and follow the pattern `compile Kotlin`, for example, `compileDebugKotlin`, `compileReleaseUnitTestKotlin`. When targeting JavaScript, the tasks are called `compileKotlin2Js` and `compileTestKotlin2Js` respectively, and `compile Kotlin2Js` for custom source sets. To configure a single task, use its name. Examples: «` groovy compileKotlin < kotlinOptions.suppressWarnings = true >compileKotlin < kotlinOptions < suppressWarnings = true >> «` It is also possible to configure all Kotlin compilation tasks in the project: «` groovy tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile).all < kotlinOptions < // . >> «` A complete list of options for the Gradle tasks follows: —>
Чтобы указать дополнительные параметры компиляции, используйте свойство kotlinOptions .
При поддержке JVM опции называются compileKotlin для релизного кода и compileTestKotlin для тестового кода. Задачи для настраиваемых исходных ресурсов вызываются по шаблону compile Kotlin .
Имена задач в проектах Android содержат build variant и следуют шаблону compile Kotlin , например, compileDebugKotlin , compileReleaseUnitTestKotlin .
При поддержке JavaScript задачи называются compileKotlin2Js и compileTestKotlin2Js соответственно, и compile Kotlin2Js для настраиваемых ресурсов.
Чтобы настроить задачу, используйте ее имя. Примеры:
compileKotlin < kotlinOptions.suppressWarnings = true >compileKotlin < kotlinOptions < suppressWarnings = true >>Также возможно сконфигурировать все задачи компиляции Kotlin:
tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile).all < kotlinOptions < // . >>Ниже приведен полный список параметров для задач Gradle:
Атрибуты, общие для JVM, JS и JS DCE
Имя Описание Возможные значения Значение по умолчанию allWarningsAsErrors Сообщить об ошибке если есть какие-либо предупреждения (warnings) false suppressWarnings Не создавать предупреждения (warnings) false verbose Включить подробный вывод журнала false freeCompilerArgs Список дополнительных аргументов компилятора [] Атрибуты, общие для JVM и JS
Имя Описание Возможные значения Значение по умолчанию apiVersion Разрешить использование объявлений (declarations) только из указанных версий зависимых библиотек «1.0», «1.1», «1.2», «1.3 (EXPERIMENTAL)» languageVersion Обеспечить совместимость источника с указанной языковой версией «1.0», «1.1», «1.2», «1.3 (EXPERIMENTAL)» Атрибуты, специфичные для JVM
Имя Описание Возможные значения Значение по умолчанию javaParameters Генерировать метаданные для reflection Java 1.8 по параметрам метода false jdkHome Путь к домашнему каталогу JDK для включения в путь классов, если отличается от стандартного JAVA_HOME jvmTarget Целевая версия сгенерированного байт-кода JVM (1.6 или 1.8), по умолчанию — 1.6 «1.6», «1.8» «1.6» noJdk Не включать Java в classpath false noReflect Не включайте реализацию Kotlin reflection в classpath true noStdlib Не включать Kotlin runtime в classpath true Атрибуты, специфичные для JS
Имя Описание Возможные значения Значение по умолчанию friendModulesDisabled Отключить экспорт внутренних описаний (declaration) false main Должна ли быть вызвана основная функция «call», «noCall» «call» metaInfo Создание файлов .meta.js и .kjsm с метаданными. Использование их для создания библиотеки true moduleKind Тип модуля, сгенерированного компилятором «plain», «amd», «commonjs», «umd» «plain» noStdlib Не использовать Kotlin stdlib true outputFile Выходной путь файла sourceMap Создание источника (source map) false sourceMapEmbedSources Вставлять исходные файлы (source map) в источник «never», «always», «inlining» sourceMapPrefix Префикс для путей в источнике (source map) target Создание JS-файлов для конкретной версии ECMA «v5» «v5» typedArrays Перевести примитивные массивы на массивы в JS true Создание документации
Чтобы создать документацию для проектов Kotlin, используйте Dokka; обратитесь к Dokka README для инструкций по настройке. Dokka поддерживает проекты на смешанном языке и может генерировать выходные данные в нескольких форматов, включая стандартный JavaDoc.
OSGi
Для поддержки OSGi см. Страницу Kotlin OSGi.
Примеры
В следующих примерах показаны различные возможности настройки плагина Gradle: