Kotlin 与 Gradle 的安装与初步使用(1)

Kotlin 与 Gradle 的安装与初步使用(1)

前言

最近公司需要做一个小型的网页系统，我负责写后端的程序， 前端可能使用 vue 或者 react??
关于前端选型什么我还不太清楚，但是由于这是一个小型的系统，所以我个人并不是很想用 java + spring boot 来做后端
我感觉有点杀鸡用牛刀了，我个人又想尝试一下新的技术栈，得出以下结论

需求：

1. 小型的后端服务
2. 需要有一个简单的 web 界面
3. 跑在国产服务器上

我想做的事情

1. 选用一个新型的技术栈，不然的话重复的 CRUD 并没有什么意义
2. 选用一个轻型的 web 框架，需要能够连接简单的数据库与尽快的暴露 restful 接口

选型考虑

1. 轻量、快速、低占用
2. 较为平滑的学习曲线

java + maven 当然很适合传统的企业开发，但是我只是个人开发者，我希望能够更加轻量一些，
毕竟我并不需要很复杂的生态支持与稳定性，我也不需要写很复杂的业务
同时我个人也厌倦了在国产系统上做 java 开发，性能占用真的很高，我不喜欢

考虑结果

1. 选用 kotlin 作为后端语言
2. 选用 spark 作为 web 框架
3. 选用 sqlite 作为数据库
4. 选用 gradle 作为构建工具

所以本章节，我想先来谈一谈如何安装 kotlin 与 gradle，
以及如何使用 kotlin 与 gradle 来跑一个简单的 hello world 程序

具体工作

1. 安装 kotlin 与 gradle
2. 使用 kotlin 与 gradle 编写一个简单的 hello world 程序

实际内容

Kotlin 与 Gradle 安装

Kotlin 安装

首先，确保本机器已经安装了 JDK（Java Development Kit），可以通过以下命令检查：

> java -version

在本机中，我安装了 jenv 来管理我的 jdk 版本，如果有疑问的话可以翻看我之前的文章

❯ jenv versions
  system
  17
  17.0
  17.0.14
  1.8
  1.8.0.442
* 21 (set by /home/su/.jenv/version)
  21.0
  21.0.6
  temurin64-17.0.14
  temurin64-1.8.0.442
  temurin64-21.0.6
❯ jenv global 21
❯ java -version
openjdk version "21.0.6" 2025-01-21 LTS
OpenJDK Runtime Environment Temurin-21.0.6+7 (build 21.0.6+7-LTS)
OpenJDK 64-Bit Server VM Temurin-21.0.6+7 (build 21.0.6+7-LTS, mixed mode, sharing)

其次是安装 kotlin 的命令行版本

为什么是命令行版本呢？在 Get started with Kotlin 中有这么一段话

> Kotlin is included in each IntelliJ IDEA and Android Studio release. Download and install one of these IDEs to start using Kotlin.

哦，我个人又不喜欢用 IntelliJ IDEA 这样的 IDE，
所以我选择了命令行版本的 kotlin

所以我跑去了 Kotlin Releases 页面，下载了 kotlin 的命令行版本

⚠️ 注意：
Kotlin Release 页面是截止 2025-8-4 的最新版本，自行注意版本号

// 首先要下载相关的文件
❯ j down // autojump 插件，跑到本机 download 文件夹下
❯ wget https://github.com/JetBrains/kotlin/releases/download/v2.2.0/kotlin-compiler-2.2.0.zip
❯ wget https://github.com/JetBrains/kotlin/releases/download/v2.2.0/kotlin-native-prebuilt-linux-x86_64-2.2.0.tar.gz

接下来就是解压缩这两个文件，放在你喜欢的文件夹下并写环境变量了
参考我写的环境变量，这里有我的存放路径的信息

❯ tail -20f ~/.zshrc
export PATH="$PATH":"$HOME/.local/opt/depot_tools"

# CHROME
export CHROME_EXECUTABLE=/usr/bin/google-chrome-stable

# MVN
export MVN_HOME="$HOME/.local/opt/apache-maven-3.9.11"
export PATH="$PATH":"$MVN_HOME/bin"

# KOTLIN_NATIVE
export KOTLIN__NATIVE_HOME="$HOME/.local/opt/kotlin-native-prebuilt-linux-x86_64-2.2.0"
export PATH="$PATH":"$KOTLIN_NATIVE_HOME/bin"

# KOTLIN
export KOTLIN_HOME="$HOME/.local/opt/kotlinc"
export PATH="$PATH":"$KOTLIN_HOME/bin"

# GRADLE
export GRADLE_HOME="$HOME/.local/opt/gradle-9.0.0-rc-4"
export PATH="$PATH":"$GRADLE_HOME/bin"

❯ source ~/.zshrc
// 检查是否安装成功
❯ kotlinc -version
info: kotlinc-jvm 2.2.0 (JRE 21.0.6+7-LTS)
❯ kotlinc-native -version
info: kotlinc-native 2.2.0 (JRE 21.0.6+7-LTS)
Kotlin/Native: 2.2.0

🔔 提醒：
kotlin-compiler 全名为 Kotlin command-line compiler 这个编译器用于编译 JVM 应用
kotlin-native 全名为 Kotlin Native，用于编译原生应用, 也就是说这个编译出来的不依赖 JVM
ℹ️ 信息
Although the compiler output has no dependencies or virtual machine requirements,
the compiler itself requires Java 1.8 or higher runtime. It's supported by JDK 8 (JAVA SE 8) or later versions.
-- download and install the compiler

有关 kotlin-compiler 和 kotlin-native 的区别可以参考 Kotlin Native 文档

写一个简单的 hello world 程序感受一下

❯ cat test.kt
fun main() {
    println("Hello, World!")
}
❯ kotlinc test.kt -include-runtime -d hello.jar
❯ java -jar hello.jar
Hello, World!

至此，kotlin 已经安装成功并且跑了一个简单的 hello world 程序了

Gradle 安装

Gradle 是一个构建工具，简介看 getting started 吧

还是一如既往的下载解压写环境变量，这里就不再赘述了，参考上面的 ~/.zshrc 就可以了

测试一下就可以了

❯ gradle -v


------------------------------------------------------------
Gradle 9.0.0-rc-4
------------------------------------------------------------

Build time:    2025-07-28 15:10:02 UTC
Revision:      a0a6deb6f9937f9e9894a4460f4158267a13ad03

Kotlin:        2.2.0
Groovy:        4.0.27
Ant:           Apache Ant(TM) version 1.10.15 compiled on August 25 2024
Launcher JVM:  21.0.6 (Eclipse Adoptium 21.0.6+7-LTS)
Daemon JVM:    /home/su/.local/opt/jdk-21.0.6+7 (no JDK specified, using current Java home)
OS:            Linux 6.15.2-arch1-1 amd64

这里给出 release 页面
想下载 Gradle 去这里下载就可以了

Gradle 与 Kotlin 初步应用

接下来我们应该要新建一个 Gradle 项目，并使用 Kotlin 来编写代码

❯ mkdir tutorial
❯ cd tutorial
❯ gradle init --type kotlin-application --dsl kotlin 

🔔 提醒：
这里的 --type kotlin-application 表示我们要新建一个 Kotlin 应用程序项目
--dsl kotlin 表示我们要使用 Kotlin DSL 来编写 Gradle 构建脚本 \

❯ ./gradlew build

🔔 提醒：
这里的 ./gradlew 是 Gradle Wrapper 的脚本文件，
它会自动下载 Gradle 的指定版本并执行构建任务，
在执行该命令的时候，可能会报如下错误 \

1. Exception in thread "main" javax.net.ssl.SSLHandshakeException:\
2. Exception in thread "main" javax.net.ssl.SSLHandshakeException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

上述的两个问题都和网络有关，因为我同时开了 host 代理 和猫咪
我把代理关了并保持猫咪打开就可以了

我们可以看到，经过了 build 之后，Gradle 会生成一个 build 目录，
里面就是我们所需要的编译结果和依赖文件

❯ ./gradlew tasks

查看一下 gradle 的任务列表

❯ ./gradlew run
Calculating task graph as no cached configuration is available for tasks: run

> Task :app:run
Hello World!

BUILD SUCCESSFUL in 995ms
2 actionable tasks: 1 executed, 1 up-to-date
Configuration cache entry stored.

我们已经成果运行了一个简单的 Kotlin 应用程序，
接下了以这个样板工程为基础，我想谈一下 gradle 的核心概念
以及一个 gradle+kotlin 项目该如何组织，这部分工作我想放在下一章来写

总结

在本章中，我们完成了以下工作：

1. 安装了 Kotlin 和 Gradle
2. 使用 Kotlin 编写了一个简单的 hello world 程序
3. 使用 Gradle 创建了一个 Kotlin 应用程序项目，并成功运行