Gradle 和 Kotlin/JVM 入门

本教程演示了如何使用 IntelliJ IDEA 和 Gradle 创建一个 JVM 控制台应用程序。

首先，请下载并安装最新版本的 IntelliJ IDEA。

创建项目

1. 在 IntelliJ IDEA 中，选择 文件 | 新建 | 项目。

2. 在左侧面板中，选择 Kotlin。

3. 如果需要，为新项目命名并更改其位置。

   TIP

   勾选 创建 Git 仓库 复选框，将新项目置于版本控制之下。你也可以在任何时候进行此操作。

   

4. 选择 Gradle 构建系统。

5. 从 JDK 列表中，选择你希望在项目中使用的 JDK。

   • 如果 JDK 已安装在你的计算机上，但未在 IDE 中定义，请选择 添加 JDK 并指定 JDK 主目录的路径。
   • 如果你的计算机上没有所需的 JDK，请选择 下载 JDK。

6. 选择 Gradle 的 Kotlin DSL。

7. 勾选 添加示例代码 复选框，以创建一个带有示例“Hello World!”应用程序的文件。

   TIP

   你还可以启用 生成带有新手提示的代码 选项，为你的示例代码添加一些额外的有用注释。

8. 点击 创建。

你已成功使用 Gradle 创建了一个项目！

为项目指定 Gradle 版本

你可以在 高级设置 部分明确指定项目的 Gradle 版本，可以通过使用 Gradle Wrapper 或 Gradle 的本地安装方式：

• Gradle Wrapper：

  1. 从 Gradle 分发 列表中，选择 Wrapper。
  2. 禁用 自动选择 复选框。
  3. 从 Gradle 版本 列表中，选择你的 Gradle 版本。

• 本地安装：

  1. 从 Gradle 分发 列表中，选择 本地安装。
  2. 对于 Gradle 位置，指定本地 Gradle 版本的路径。

  

探索构建脚本

打开 build.gradle.kts 文件。这是 Gradle Kotlin 构建脚本，其中包含 Kotlin 相关构件和应用程序所需的其他部分：

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

group = "org.example" // A company name, for example, `org.jetbrains`
version = "1.0-SNAPSHOT" // Version to assign to the built 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
}

tasks.test { // See 4️⃣
    useJUnitPlatform() // JUnitPlatform for tests. See 5️⃣
}

• 1️⃣ 了解更多关于依赖项来源的信息。
• 2️⃣ Maven Central Repository。它也可以是 Google 的 Maven 仓库 或你公司的私有仓库。
• 3️⃣ 了解更多关于声明依赖项的信息。
• 4️⃣ 了解更多关于任务的信息。
• 5️⃣ 用于测试的 JUnitPlatform。

如你所见，Gradle 构建文件中添加了一些 Kotlin 特定的构件：

1. 在 plugins {} 块中，有 kotlin("jvm") 构件。此插件定义了项目中使用的 Kotlin 版本。

2. 在 dependencies {} 块中，有 testImplementation(kotlin("test"))。 了解更多关于设置测试库依赖项的信息。

运行应用程序

1. 通过选择 视图 | 工具窗口 | Gradle 来打开 Gradle 窗口：

   

2. 在 Tasks\build\ 中执行 build Gradle 任务。在 Build 窗口中，将显示 BUILD SUCCESSFUL。 这意味着 Gradle 已成功构建应用程序。

3. 在 src/main/kotlin 中，打开 Main.kt 文件：

   • src 目录包含 Kotlin 源文件和资源。
   • Main.kt 文件包含将打印 Hello World! 的示例代码。

4. 点击边栏中的绿色 运行 图标，并选择 运行 'MainKt' 来运行应用程序。

   

你可以在 运行 工具窗口中看到结果：

恭喜！你刚刚运行了你的第一个 Kotlin 应用程序。

接下来做什么？

了解更多关于：

• Gradle 构建文件属性。
• 面向不同平台和设置库依赖项。
• 编译器选项及如何传递它们。
• 增量编译、缓存支持、构建报告和 Kotlin 守护进程。