設定檔案是每個 Gradle 專案的進入點。

gradle basic 3

設定檔案 的主要目的是將子專案新增至您的建置。

Gradle 支援單一和多專案建置。

  • 對於單一專案建置，設定檔案是選用的。

  • 對於多專案建置，設定檔案是強制性的，且會宣告所有子專案。

設定指令碼

設定檔案是一個指令碼。它是一個以 Groovy 編寫的 settings.gradle 檔案或一個以 Kotlin 編寫的 settings.gradle.kts 檔案。

Groovy DSL 和 Kotlin DSL 是 Gradle 指令碼唯一可接受的語言。

設定檔案通常位於專案的根目錄中。

讓我們來看一個範例並將它分解

settings.gradle.kts
rootProject.name = "root-project"   (1)

include("sub-project-a")            (2)
include("sub-project-b")
include("sub-project-c")
1 定義專案名稱。
2 新增子專案。
settings.gradle
rootProject.name = 'root-project'   (1)

include('sub-project-a')            (2)
include('sub-project-b')
include('sub-project-c')
1 定義專案名稱。
2 新增子專案。

1. 定義專案名稱

設定檔案定義您的專案名稱

rootProject.name = "root-project"

每個建置只有一個根專案。

2. 新增子專案

設定檔案透過包含子專案（如果有）來定義專案的結構

include("app")
include("business-logic")
include("data-model")

請參閱 撰寫設定檔案 頁面以瞭解更多資訊。

下一步： 了解建置指令碼 >>