Gradle Kotlin DSL
了解 build.gradle.kts 基础
Gradle Kotlin DSL 是 CoddyKit 上的免费 Kotlin Academy 课时。 这是第 1 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Kotlin Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Kotlin Academy 课程共包含 4 节课。
什么是 Gradle Kotlin DSL？
Gradle 构建脚本可以使用 Groovy（build.gradle）或 Kotlin（build.gradle.kts）编写。Kotlin DSL 提供类型安全和 IDE 自动补全。
为什么是 .kts？
Kotlin DSL 的优点：
- 在编译时检查构建脚本
- 在 IDE 中提供自动补全和导航
- 与应用代码使用相同的语言
代价是首次编译脚本的速度会稍慢一些。
plugins 代码块
plugins { } 代码块用于应用 Gradle 插件。您可以在这里启用 Kotlin、应用打包等功能。
plugins {
kotlin("jvm") version "2.0.0"
application
}组与版本
在顶层定义项目坐标。这些信息会成为已发布构件标识的一部分。
group = "com.example"
version = "1.0.0"repositories 代码块
声明 Gradle 从哪里下载依赖项。mavenCentral() 是最常用的仓库。
repositories {
mavenCentral()
google()
}dependencies 代码块
按照配置列出依赖项。Kotlin DSL 使用带字符串坐标的函数调用。
dependencies {
implementation("com.google.guava:guava:33.2.1-jre")
testImplementation(kotlin("test"))
}配置扩展
插件会添加类型化扩展。使用 application 插件时，可以通过 application { } 代码块设置主类。
application {
mainClass.set("com.example.MainKt")
}设置属性
许多 DSL 值都是 Property 对象，可以使用 .set(...) 设置。较新版本的 Gradle 也支持使用 = 赋值。
tasks.jar {
archiveBaseName.set("my-app")
}settings.gradle.kts
settings.gradle.kts 文件用于命名项目，并在多模块构建中包含子模块。
rootProject.name = "my-app"
include(":core", ":app")运行任务
使用 Gradle 包装器从命令行调用任务。
// ./gradlew build
// ./gradlew run
// ./gradlew test
// ./gradlew tasks (list available tasks)Groovy 与 Kotlin DSL 对比
主要语法差异：
- Kotlin 中的字符串使用双引号（Groovy 中使用单引号）
- 方法调用使用圆括号
- 属性使用
.set()或=，而不是使用空格赋值
快速检查
哪个文件使用 Gradle Kotlin DSL？
回顾
您已经学习了 Kotlin DSL 的基础知识：
plugins、repositories、dependencies代码块- 类型安全的扩展和
.set()属性 - 使用
settings.gradle.kts管理项目结构 - 使用
./gradlew运行任务
下一节：深入了解依赖项和插件。
常见问题解答
「Gradle Kotlin DSL」课时是免费的吗？
是的 — 「Gradle Kotlin DSL」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Kotlin Academy 课程的其余内容，请升级到 CoddyKit PRO。 Kotlin Academy 课程共包含 4 节课。
「Gradle Kotlin DSL」这节课中我会学到什么？
了解 build.gradle.kts 基础 你通过在浏览器中直接运行的动手代码来练习 Kotlin Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Kotlin Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Kotlin Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 1 节课，共 4 节。
「Gradle Kotlin DSL」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Kotlin Academy 课中编写并运行代码吗？
能。每节 Kotlin Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。