您不必完成任何發布項目設定就能發布測試韌體。不過,您必須完成其他設定才能透過功能機制處理測試韌體。
假如指定成果的座標為 groupId:artifactId:version
,Gradle 預期測試韌體成果會宣告座標為 groupId:artifactId-test-fixtures:version
的功能。目前測試韌體支援功能或 Maven Publish Plugin 不會自動完成這項設定,因此您必須手動設定。
Gradle 會根據專案的名稱、群組和版本建立功能。這三個項目的設定都必須與發布項目的 artifactId
、groupId
和 version
值相符。
專案名稱預設為專案路徑的最後一個部分。因此,假如專案路徑為 :path:to:mylibrary
,專案的預設名稱就是 mylibrary
。如果您不想為 artifactId
使用這個名稱,請務必變更專案名稱。
您可以透過以下兩種做法重新命名專案:
- 重新命名專案所屬的資料夾。這會變更專案名稱或專案的 Gradle 路徑,因此您必須更新該專案的所有依附元件。雖然這種做法可能會增加您在一開始必須完成的重新編排工作,但我們還是建議讓專案名稱和資料夾名稱保持一致,因為這可以減少造成混淆的情形。
- 在 Gradle 中重新命名專案,不為專案的資料夾重新命名。這可以避免對來源版本管理造成影響,但會導致專案的位置和名稱不一致。
如要在 Gradle 中重新命名專案,請在 settings.gradle
檔案中插入下列程式碼:
Groovy
include ':path:to:mylibrary' project(':path:to:mylibrary').name = 'my-library'
Kotlin
include(":path:to:mylibrary") project(":path:to:mylibrary").name = "my-library"
這個程式碼會將專案的新路徑指派至 :path:to:my-library
。
groupId
值預設為建構名稱 (通常是根資料夾的名稱),version
值則預設為未指定。如果要變更群組 ID 或版本的值,請在專案層級 build.gradle
檔案中分別設定 group
和 version
屬性 (適用於 Groovy) 或 build.gradle.kts
(適用於 Kotlin 指令碼):
Groovy
group = 'com.my-company' version = '1.0'
Kotlin
group = "com.my-company" version = "1.0"