使用 Gradle 建立 Kotlin 專案

Gradle

在不使用 IDE 的情況下，如何單獨使用 Gradle 指令來建立 Kotlin 專案。

在使用前請先確認已經安裝 OpenJDK、Gradle 及 Kotlin。

建立 Gradle Kotlin 專案

Gradle 從 5.0 版開始內建 Kotlin 的新專案初始化，使用流程如下 (Linux/Mac)：

# 1. 建立專案目錄
mkdir kotlin-gradle-demo
cd kotlin-gradle-demo/

# 2. 初始化專案
gradle init --type kotlin-application

# 3. 選擇使用 groovy 或 kotlin 作為 DSL
Select build script DSL:
  1: groovy
  2: kotlin
Enter selection (default: kotlin) [1..2] 

# 4. 選擇 專案名稱 及 套件名稱
Project name (default: kotlin-gradle-demo):
Source package (default: kotlin.gradle.demo): com.tonycube.demo

# 5. 執行專案
./gradlew run
# Windows 使用者請改用如下指令
gradlew.bat run
# 執行結果如下
> Task :run
Hello world.

# 其他常用任務
./gradlew clean # 清除已編譯的內容
./gradlew build # 建置專案
./gradlew test  # 執行測試
./gradlew jar   # 產生 Jar 檔, 檔案在 build/libs 目錄下

# 查詢可用的任務
gradle tasks

# 查看任務說明文件
gradle help --task 任務名稱 (例如：run)

# 6. 使用 VSCode 開啟專案 (記得安裝 Kotlin 擴充工具)
code .

內建的專案初始化類型有 (Build Init Plugin)：

指令 gradle 及 gradlew 有什麼不一樣

gradle 是 Gradle 指令本身，而 gradlew 是一個腳本程式，可以在專案根目錄之下看到，它最後還是會呼叫 gradle 指令來執行專案；差別在於，使用 gradlew 可以保持開發環境的一致性。

簡單的說，gradlew 增加了環境設定。

gradlew 腳本會綁定指定的 Gradle 版本，當你的專案分享給其他開發者時，gradlew 會確保使用指定的 Gradle 版本來執行，如果該開發者的電腦上無此版本或沒有安裝 Gradle，它會自動去下載該版本；也就是說，其他開發者在取得專案時，無須擔心執行專案時出現未安裝 Gradle 或 Gradle 版本不符合而無法正確執行的意外狀況。

詳細內容可以查看 The Gradle Wrapper 官方文件。

如何使用 Gradle 4 建立 Kotlin 專案

註：Gradle 為 4.10.2 版。

如果你還在使用 Gradle 4 ，可以先以 java-application 類型來初始化專案，然後修改加入 Kotlin 的相關設定。

1. 初始化專案

mkdir GradleDemo
cd GradleDemo
gradle init --type java-application
code .

2. 修改 `build.gradle`：

// 增加 buildscript 區塊
buildscript {
    ext.kotlin_version = '1.3.10'

    repositories {
        mavenCentral()
    }

    dependencies {
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

plugins {
    id 'java'
    id 'application'
    // 加入 Kotlin plugin
    id "org.jetbrains.kotlin.jvm" version "1.3.10"
}

// 設定 java 及 kotlin 的程式碼根目錄
sourceSets {
    main.kotlin.srcDirs += 'src/main/kotlin'
    main.java.srcDirs += 'src/main/java'
}

// Kotlin 的主程式必須加上 Kt 字尾
mainClassName = 'AppKt'

dependencies {
    // 加入 Kotlin 函式庫
    compile 'org.jetbrains.kotlin:kotlin-stdlib'
    testCompile 'junit:junit:4.12'
}

repositories {
    jcenter()
}

註：Kotlin 版本請自行調整。

3. 建立程式碼根目錄

src/main/kotlin

4. 在 kotlin 目錄中，新增主程式檔案：

App.kt

內容如下：

fun main(args: Array<String>) {
    println("Hello Kotlin")
}

5. 執行

./gradlew run

參考資料：https://kotlinlang.org/docs/reference/using-gradle.html#targeting-the-jvm

本文網址：https://blog.tonycube.com/2018/12/gradle-kotlin.html
由 Tony Blog 撰寫，請勿全文複製，轉載時請註明出處及連結，謝謝 😀