Kotlin 语言参考文档 中文版 Help

Gradle 与 Kotlin/JVM 入门

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

开始之前, 首先请下载病安装最新版本的 IntelliJ IDEA.

创建项目

  1. 在 IntelliJ IDEA 中, 选择 File | New | Project.

  2. 在左侧面板中, 选择 New Project.

  3. 输入新项目的名称, 如果需要的话, 修改它的位置.

  4. Language 选项中, 选择 Kotlin.

    创建一个控制台应用程序
  5. 选择 Gradle 构建系统.

  6. JDK list 选项中, 选择你的项目希望使用的 JDK.

    • 如果在你的计算机上已经安装了 JDK, 但在 IDE 中没有定义它, 请选择 Add JDK, 并指定 JDK home 目录的路径.

    • 如果在你的计算机上还没有安装需要的 JDK, 请选择 Download JDK.

  7. Gradle DSL 选项中, 选择 Kotlin.

  8. 选中 Add sample code 选项, 创建一个文件, 其中包含一个 "Hello World!" 示例程序.

  9. 点击 Create.

这样你就成功的创建了 Gradle 项目.

为你的项目指定 Gradle 版本

你可以在 Advanced Settings 中为你的项目明确指定 Gradle 版本, 可以使用 Gradle Wrapper, 也可以使用本地安装的 Gradle:

  • 使用 Gradle Wrapper:Gradle distribution 选项列表中, 选择 Wrapper. 取消 Auto-select 选择框, 并在 Gradle version 选项列表中, 选择你的 Gradle 版本.

  • 使用本地安装的 Gradle:Gradle distribution 选项列表中, 选择 Local installation. 对 Gradle location, 请指定你的本地 local Gradle 版本的路径.

    高级设置

查看构建脚本

打开 build.gradle.kts 文件. 这是 Gradle 的 Kotlin 构建脚本, 包含 Kotlin 相关的 artifact 以及应用程序需要的其他部分:

// 下文中的 `KotlinCompile` task 需要这个 import import org.jetbrains.kotlin.gradle.tasks.KotlinCompile plugins { kotlin("jvm") version "1.9.23" // 使用的 Kotlin 版本 application // Application plugin. 参见下文的 1️⃣ } group = "org.example" // 公司名, 比如, `org.jetbrains` version = "1.0-SNAPSHOT" // 构建后的 artifact 的版本 repositories { // 依赖项的下载源仓库. 参见 2️⃣ mavenCentral() // Maven Central Repository. 参见 3️⃣ } dependencies { // 你想要使用的所有库. 参见 4️⃣ // 复制你在仓库中找到的依赖项名称 testImplementation(kotlin("test")) // Kotlin test 库 } tasks.test { // 参见 5️⃣ useJUnitPlatform() // 用于测试的 JUnitPlatform. 参见 6️⃣ } kotlin { // 扩展, 用于简化设置 jvmToolchain(17) // 生成的 JVM bytecode 的目标版本. 参见 7️⃣ } application { mainClass.set("MainKt") // 应用程序的 main class }

你可以看到, Gradle 构建文件中还添加了几个 Kotlin 相关的 artifact:

  1. plugins{} 代码段中, 有 kotlin("jvm") artifact – 这个 plugin 定义项目中使用的 Kotlin 版本.

  2. dependencies 内, 有 testImplementation(kotlin("test")). 详情请参见 设置测试库的依赖项.

  3. 在依赖项之后, 有 KotlinCompile 任务的配置代码段. 在这里你可以向编译器添加额外的参数, 来开启或禁用 Kotlin 的各种功能特性.

运行应用程序

打开 src/main/kotlin 目录中的 Main.kt 文件 . src 目录包含 Kotlin 源代码文件和资源. Main.kt 文件包含示例代码, 打印输出 Hello World!.

Main.kt 中的 main fun

运行应用程序的最简单的方法是, 点击编辑器侧栏中的绿色 Run 图标, 然后选择 Run 'MainKt'.

运行一个控制台应用程序

你可以在 Run 工具窗口看到结果.

程序运行的输出结果

恭喜! 你成功的运行了你的第一个 Kotlin 应用程序.

下一步做什么?

学习:

最终更新: 2024/10/17