使用 Gradle 建立 Kotlin 專案

Gradle

在不使用 IDE 的情況下,如何單獨使用 Gradle 指令來建立 Kotlin 專案。
在使用前請先確認已經安裝 OpenJDKGradleKotlin

建立 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

Groovy// 增加 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

內容如下:

Kotlinfun 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 撰寫,請勿全文複製,轉載時請註明出處及連結,謝謝 😀

我要留言

留言小提醒:
1.回覆時間通常在晚上,如果太忙可能要等幾天。
2.請先瀏覽一下其他人的留言,也許有人問過同樣的問題。
3.程式碼請先將它編碼後再貼上。(線上編碼:http://bit.ly/1DL6yog)
4.文字請加上標點符號及斷行,難以閱讀者恕難回覆。
5.感謝您的留言,您的問題也可能幫助到其他有相同問題的人。