Groovy & Gradle: JVM Automation and Build Engineering · 课时

Gradle 的 Kotlin DSL

使用 Kotlin DSL 将 `build.gradle` 脚本迁移到 `build.gradle.kts`，提升可读性和类型安全性。

Gradle 的 Kotlin DSL 是 CoddyKit 上的免费 Groovy & Gradle: JVM Automation and Build Engineering 课时。这是第 1 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Groovy & Gradle: JVM Automation and Build Engineering 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Groovy & Gradle: JVM Automation and Build Engineering 课程共包含 4 节课。

本课时的部分内容尚未翻译，以英文显示。

Welcome to Kotlin DSL

Welcome to Kotlin DSL for Gradle! This lesson explores how to switch from Groovy DSL to Kotlin DSL in your Gradle build scripts.

Kotlin DSL offers enhanced readability and type safety, making your build files more robust and easier to maintain. It's a modern approach to defining your Gradle projects.

Why Kotlin DSL?

Why make the switch to Kotlin DSL?

Type Safety: Kotlin DSL is statically typed, meaning the compiler can catch errors at build time, not runtime. This reduces surprises!
IDE Support: Get better auto-completion, refactoring, and navigation in your IDE (like IntelliJ IDEA) because it understands the types.
Readability: Kotlin's concise syntax often makes build scripts clearer, especially for complex logic.
Consistency: If your project already uses Kotlin for application code, using Kotlin DSL brings consistency to your entire codebase.

Basic Syntax: Plugins Block

Let's start with a fundamental difference: how you apply plugins. In Kotlin DSL, your build script file extension changes from .gradle to .gradle.kts.

Notice the use of id("plugin-id") and optional version "..." for applying plugins.

plugins {
    id("java")
    id("application") version "8.1.0"
}

Declaring Dependencies

Declaring dependencies is very similar to Groovy DSL, but with Kotlin's function call syntax. You use named arguments for the dependency string.

Here's how you'd add common dependencies like JUnit for testing and Apache Commons for utilities.

dependencies {
    implementation("org.slf4j:slf4j-api:2.0.7")
    testImplementation("org.junit.jupiter:junit-jupiter-api:5.10.0")
    testRuntimeOnly("org.junit.jupiter:junit-jupiter-engine:5.10.0")
}

Defining Custom Tasks

Creating custom tasks in Kotlin DSL is straightforward. You use tasks.register("taskName") { ... } to define a new task.

Inside the lambda, you can configure the task, for example, by adding a doLast action to execute some code when the task runs.

tasks.register("helloKotlin") {
    group = "Greeting"
    description = "Prints a friendly message using Kotlin DSL."
    doLast {
        println("Hello from a Kotlin DSL task!")
    }
}

Configuring Existing Tasks

You can also configure existing tasks, like the built-in jar task, using tasks.getByName("taskName") { ... }. This allows you to customize their behavior.

For example, you can set the base name of your JAR file or add a manifest entry.

tasks.getByName<Jar>("jar") {
    archiveBaseName.set("my-app-kotlin")
    manifest {
        attributes["Implementation-Title"] = project.name
        attributes["Implementation-Version"] = project.version
    }
}

Project Properties & Variables

Accessing project properties and defining variables is also type-safe. You can declare properties like group and version using property assignment.

For local variables, you use Kotlin's val or var keywords, enhancing clarity and preventing accidental reassignments.

group = "com.example"
version = "1.0.0"

val myProperty = "Some Value"

tasks.register("printProps") {
    doLast {
        println("Project Group: $group")
        println("My Property: $myProperty")
    }
}

Type-Safe Accessors

A major benefit of Kotlin DSL is type-safe accessors. For common plugins like Java, you get dedicated blocks and properties with full IDE auto-completion.

Instead of string-based property access, you use object-oriented syntax, making it harder to make typos and easier to discover options.

java {
    sourceCompatibility = JavaVersion.VERSION_11
    targetCompatibility = JavaVersion.VERSION_11
}

application {
    mainClass.set("com.example.MainApp")
}

Migrating a Simple Groovy Script

Let's look at a quick comparison to see how a small Groovy DSL snippet translates to Kotlin DSL. Notice the use of id("..."), implementation(...), and property assignment.

The structure remains similar, but the syntax becomes more explicit and type-checked.

// Groovy DSL (build.gradle)
// plugins {
//     id 'java'
// }
// dependencies {
//     implementation 'org.apache.commons:commons-lang3:3.12.0'
// }

// Kotlin DSL (build.gradle.kts)
plugins {
    java
}

dependencies {
    implementation("org.apache.commons:commons-lang3:3.12.0")
}

Quick Check on Kotlin DSL

Which of the following are key benefits of using Kotlin DSL over Groovy DSL for Gradle build scripts?

Recap: Kotlin DSL for Gradle

In this lesson, we explored the benefits and basic syntax of Kotlin DSL for Gradle.

You learned why type safety, IDE support, and readability make Kotlin DSL a powerful choice.
We covered how to apply plugins, declare dependencies, and define/configure tasks using the .gradle.kts file extension.
You also saw how to work with project properties and utilize type-safe accessors for common configurations.

Embracing Kotlin DSL can lead to more robust and maintainable Gradle builds!

常见问题解答

「Gradle 的 Kotlin DSL」课时是免费的吗？

是的 — 「Gradle 的 Kotlin DSL」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Groovy & Gradle: JVM Automation and Build Engineering 课程的其余内容，请升级到 CoddyKit PRO。 Groovy & Gradle: JVM Automation and Build Engineering 课程共包含 4 节课。

「Gradle 的 Kotlin DSL」这节课中我会学到什么？

使用 Kotlin DSL 将 `build.gradle` 脚本迁移到 `build.gradle.kts`，提升可读性和类型安全性。你通过在浏览器中直接运行的动手代码来练习 Groovy & Gradle: JVM Automation and Build Engineering，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Groovy & Gradle: JVM Automation and Build Engineering 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Groovy & Gradle: JVM Automation and Build Engineering 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 1 节课，共 4 节。

「Gradle 的 Kotlin DSL」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Groovy & Gradle: JVM Automation and Build Engineering 课中编写并运行代码吗？

能。每节 Groovy & Gradle: JVM Automation and Build Engineering 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Groovy & Gradle: JVM Automation and Build Engineering