Gradle 與 Kotlin/JVM 快速入門
本教學示範如何使用 IntelliJ IDEA 與 Gradle 建立 JVM 主控台應用程式。
若要開始使用，請先下載並安裝最新版本的 IntelliJ IDEA。
建立專案
在 IntelliJ IDEA 中，選取 File | New | Project。
在左側面板中，選取 Kotlin。
為新專案命名，並在必要時變更其位置。
選取 Create Git repository 核取方塊，將新專案納入版本控制。你稍後可以隨時執行此操作。
選取 Gradle 建構系統。
從 JDK 清單中，選取你想要在專案中使用的 JDK。
- 如果電腦上已安裝 JDK，但尚未在 IDE 中定義，請選取 Add JDK並指定 JDK 根目錄的路徑。
- 如果電腦上沒有所需的 JDK，請選取 Download JDK。
為 Gradle 選取 Kotlin DSL。
選取 Add sample code 核取方塊，以建立包含範例
"Hello World!"應用程式的檔案。你也可以啟用 Generate code with onboarding tips 選項，為範例程式碼新增一些額外的實用註解。
點擊 Create。
你已成功使用 Gradle 建立專案！
為專案指定 Gradle 版本
你可以在 Advanced Settings 區段下明確指定專案的 Gradle 版本，可以使用 Gradle Wrapper 或本機安裝的 Gradle：
Gradle Wrapper：
- 從 Gradle distribution 清單中，選取 Wrapper。
- 停用 Auto-select 核取方塊。
- 從 Gradle version 清單中，選取你的 Gradle 版本。
本機安裝：
- 從 Gradle distribution 清單中，選取 Local installation。
- 對於 Gradle location，指定本機 Gradle 版本的路徑。
探索建置指令碼
開啟 build.gradle.kts 檔案。這是 Gradle Kotlin 建置指令碼，其中包含 Kotlin 相關構件以及應用程式所需的其他部分：
plugins {
kotlin("jvm") version "2.3.0" // 要使用的 Kotlin 版本
}
group = "org.example" // 公司名稱，例如 `org.jetbrains`
version = "1.0-SNAPSHOT" // 分配給建置構件的版本
repositories { // 相依性來源。參見 1️⃣
mavenCentral() // Maven Central 儲存庫。參見 2️⃣
}
dependencies { // 所有你想要使用的程式庫。參見 3️⃣
// 在儲存庫中找到相依性名稱後進行複製
testImplementation(kotlin("test")) // Kotlin 測試程式庫
}
tasks.test { // 參見 4️⃣
useJUnitPlatform() // 用於測試的 JUnitPlatform。參見 5️⃣
}- 1️⃣ 進一步了解 相依性來源。
- 2️⃣ Maven Central 儲存庫。它也可以是 Google 的 Maven 儲存庫 或你公司的私有儲存庫。
- 3️⃣ 進一步了解 宣告相依性。
- 4️⃣ 進一步了解 任務。
- 5️⃣ 用於測試的 JUnitPlatform。
如你所見，Gradle 建置檔案中新增了幾個 Kotlin 特有的構件：
在
plugins {}區塊中，有kotlin("jvm")構件。此外掛程式定義了專案中要使用的 Kotlin 版本。在
dependencies {}區塊中，有testImplementation(kotlin("test"))。 進一步了解 設定測試程式庫的相依性。
執行應用程式
透過選取 View | Tool Windows | Gradle 開啟 Gradle 視窗：
執行
Tasks\build\中的 build Gradle 任務。在 Build 視窗中，會出現BUILD SUCCESSFUL。 這表示 Gradle 已成功建置應用程式。在
src/main/kotlin中，開啟Main.kt檔案：src目錄包含 Kotlin 原始碼檔案和資源。Main.kt檔案包含會印出Hello World!的範例程式碼。
點擊裝訂邊中的綠色 Run 圖示並選取 Run 'MainKt' 以執行應用程式。
你可以在 Run 工具視窗中查看結果：
恭喜！你剛剛執行了你的第一個 Kotlin 應用程式。
下一步
進一步了解：