Начало работы с Gradle и Kotlin/JVM

Создание проекта

1. В IntelliJ IDEA выберите Файл | Создать | Проект.

2. На панели слева выберите Kotlin.

3. Укажите имя нового проекта и при необходимости измените его расположение.

   

4. Выберите систему сборки Gradle.

5. В списке JDK выберите JDK, который хотите использовать в проекте.

   • Если JDK установлен на компьютере, но не определен в IDE, выберите Добавить JDK и укажите путь к домашнему каталогу JDK.

   • Если на компьютере нет нужного JDK, выберите Скачать JDK.

6. Выберите Kotlin для DSL Gradle.

7. Установите флажок Добавить пример кода, чтобы создать файл с примером приложения "Hello World!".

8. Нажмите Создать.

Вы успешно создали проект с помощью Gradle!

Изучение скрипта сборки

Откройте файл build.gradle.kts. Это скрипт сборки Gradle на Kotlin, содержащий артефакты, связанные с Kotlin, и другие компоненты, необходимые приложению:

plugins {
    kotlin("jvm") version "2.4.20" // Kotlin version to use
}

group = "org.example" // A company name, for example, `org.jetbrains.kotlin`
version = "1.0-SNAPSHOT" // Version to assign to the build artifact

repositories { // Sources of dependencies. See 1️⃣
    mavenCentral() // Maven Central Repository. See 2️⃣
}

dependencies { // All the libraries you want to use. See 3️⃣
    // Copy dependencies' names after you find them in a repository
    testImplementation(kotlin("test")) // The Kotlin test library
}

kotlin { // Generated JVM toolchain configuration. See 4️⃣
    jvmToolchain(25) // The JDK for compiling the project.
}

tasks.test { // Test task configuration. See 5️⃣ 
    useJUnitPlatform() // JUnitPlatform for tests. See 6️⃣
}

• 1️⃣ Подробнее об источниках зависимостей.

• 2️⃣ Центральный репозиторий Maven. Также это может быть репозиторий Maven от Google или частный репозиторий вашей компании.

• 3️⃣ Подробнее об объявлении зависимостей.

• 4️⃣ Подробнее о поддержке цепочек инструментов Java.

• 5️⃣ Подробнее о задачах.

• 6️⃣ JUnitPlatform для тестов.

В файле сборки Gradle есть несколько артефактов, относящихся к Kotlin:

1. В блоке plugins {} находится артефакт kotlin("jvm"). Этот плагин задает версию Kotlin, используемую в проекте.

2. В блоке dependencies {} находится testImplementation(kotlin("test")). Подробнее о настройке зависимостей для библиотек тестирования.

Запуск приложения

1. Откройте окно Gradle, выбрав Вид | Окна инструментов | Gradle:

   

2. Выполните задачу Gradle build в Tasks/build. В окне Сборка появится BUILD SUCCESSFUL. Это означает, что Gradle успешно собрал приложение.

3. В src/main/kotlin откройте файл Main.kt:

   • Каталог src содержит исходные файлы Kotlin и ресурсы.

   • Файл Main.kt содержит пример кода, который выводит Hello World!.

4. Запустите приложение, нажав зеленый значок Запустить на поле слева и выбрав Запустить 'MainKt'.

   

Результат можно увидеть в окне инструмента Запуск:

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

Что дальше?

Дополнительная информация:

• Свойства файла сборки Gradle.

• Выбор целевых платформ и настройка зависимостей библиотек.

• Параметры компилятора и способы их передачи.

• Инкрементальная компиляция, поддержка кэшей, отчеты о сборке и демон Kotlin.