Tuy việc phát hành môi trường thử nghiệm cố định không yêu cầu bất cứ cấu hình cụ thể nào của ấn bản, nhưng cơ chế về mặt chức năng dùng để xử lý môi trường cố định đòi hỏi phải có một cấu hình bổ sung.
Đối với cấu phần phần mềm cho trước có chỉ số phối trí groupId:artifactId:version, Gradle kỳ vọng rằng cấu phần phần mềm của môi trường thử nghiệm cố định sẽ khai báo một chức năng có chỉ số phối trí groupId:artifactId-test-fixtures:version. Hiện nay, tính năng hỗ trợ môi trường thử nghiệm cố định hay trình bổ trợ phát hành của Maven đều chưa thể tự động định cấu hình, nên bạn sẽ phải thực hiện theo cách thủ công.
Gradle sẽ tạo chức năng dựa trên tên, nhóm và phiên bản của dự án.
Cả ba đều phải được thiết lập sao cho khớp với artifactId, groupId và version như trong ấn bản.
Theo mặc định, tên dự án là phân đoạn cuối cùng của đường dẫn dự án; do đó, tên mặc định của dự án có đường dẫn :path:to:mylibrary là mylibrary. Nếu đây không phải là tên bạn muốn dùng cho artifactId, thì bạn phải thay đổi tên dự án.
Có 2 cách để đổi tên dự án:
- Đổi tên thư mục của dự án. Thao tác này sẽ đổi tên dự án hay tên đường dẫn Gradle của dự án, vậy nên mọi phần phụ thuộc trên dự án đều cần phải được cập nhật. Tuy việc giữ nguyên tên dự án và thư mục có thể khiến bạn tốn nhiều công sức tổ chức lại lúc ban đầu, nhưng điều này sẽ giúp giảm sự nhầm lẫn.
- Đổi tên dự án trong Gradle mà không cần đổi tên thư mục của dự án. Điều này giúp tránh gây tác động lên việc phân chia phiên bản nguồn, nhưng lại làm chia tách vị trí và tên dự án.
Để đổi tên dự án trong Gradle, hãy thêm đoạn mã sau vào
tệp 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"
Đoạn mã này chỉ định đường dẫn mới của dự án thành :path:to:my-library.
Theo mặc định, giá trị groupId sẽ lấy tên bản dựng (thường là tên của thư mục gốc), còn giá trị version thì không xác định. Để thay đổi giá trị của phiên bản hoặc mã nhận dạng nhóm, hãy đặt các thuộc tính của group và version trong tệp build.gradle ở cấp độ dự án (đối với Groovy) hoặc build.gradle.kts (đối với tập lệnh Kotlin) tương ứng:
Groovy
group = 'com.my-company' version = '1.0'
Kotlin
group = "com.my-company" version = "1.0"