Nếu như các phiên bản 8.x tập trung vào việc hoàn thiện Kotlin DSL, thì dòng Gradle 9.x ra mắt chính thức vào năm 2025 đánh dấu một bước chuyển mình mạnh mẽ về Performance và Isolation

Phần 1: Chuẩn bị

Gradle 9.2.1 chạy trên JVM, và nó yêu cầu version JVM mới.

1. Kiểm tra Java:

   java -version
   

2. Yêu cầu: Output phải là Java 17 trở lên. Nếu bạn đang dùng Java 8 hoặc 11, Gradle 9 sẽ không chạy.
   • Cài đặt nhanh nếu thiếu: sudo apt install openjdk-17-jdk -y

Cách 1: Setup Manual

Đây là cách cài đặt giúp bạn kiểm soát hoàn toàn thư mục cài đặt và dễ dàng nâng cấp/quay lại phiên bản cũ.

Bước 1: Security Best Practice

Chúng ta sẽ tải bản Binary về /tmp và checksum để đảm bảo file không bị lỗi hoặc bị giả mạo.

cd /tmp
# 1. Tải file cài đặt
wget https://services.gradle.org/distributions/gradle-9.2.1-bin.zip

# 2. Tải file mã băm SHA-256
wget https://services.gradle.org/distributions/gradle-9.2.1-bin.zip.sha256

# 3. Xác thực
echo "  gradle-9.2.1-bin.zip" >> gradle-9.2.1-bin.zip.sha256
shasum -c gradle-9.2.1-bin.zip.sha256

Kết quả: gradle-9.2.1-bin.zip: OK

Bước 2: Giải nén

Tuân thủ chuẩn Filesystem Hierarchy Standard.

# Giải nén vào /opt
sudo unzip -d /opt/ gradle-9.2.1-bin.zip

# Kiểm tra
ls /opt/gradle-9.2.1

Bước 3: Tạo Symlink

Thay vì trỏ thẳng vào thư mục có số version, ta trỏ vào symlink. Sau này có Gradle 9.3, bạn chỉ cần đổi symlink này là xong.

sudo ln -s /opt/gradle-9.2.1 /opt/gradle

Bước 4: Config

Tạo file cấu hình hệ thống để mọi user đều dùng được.

1. Tạo file script:

   sudo nano /etc/profile.d/gradle.sh
   

2. Dán nội dung sau:

   export GRADLE_HOME=/opt/gradle
   export PATH=${GRADLE_HOME}/bin:${PATH}
   

3. Lưu lại (Ctrl+O, Enter, Ctrl+X) và kích hoạt:

   sudo chmod +x /etc/profile.d/gradle.sh
   source /etc/profile.d/gradle.sh
   

Bước 5: Kiểm tra cài đặt

gradle -v

Kết quả: Bạn sẽ thấy Gradle 9.2.1 và thông tin JVM (phải là 17+).

Cách 2: Cài đặt qua SDKMAN!

Nếu bạn là Dev, cách này nhanh hơn gấp 10 lần và cho phép cài song song Gradle 8.x và 9.x.

# 1. Cài Gradle 9.2.1
sdk install gradle 9.2.1

# 2. Set làm mặc định
sdk default gradle 9.2.1

Cách nâng cấp dự án cũ lên Gradle 9.2.1

Cài đặt xong gradle trên máy chỉ là bước 1. Để dự án của bạn thực sự dùng Gradle 9.2.1, bạn cần cập nhật Gradle Wrapper trong source code. Đây là bước mà nhiều người hay quên.

Vào thư mục dự án của bạn và chạy lệnh sau:

# Lệnh này sẽ dùng Gradle hệ thống để update wrapper của dự án
gradle wrapper --gradle-version 9.2.1 --distribution-type bin

Sau khi chạy xong, file gradle/wrapper/gradle-wrapper.properties trong dự án sẽ đổi thành:

distributionUrl=https\://services.gradle.org/distributions/gradle-9.2.1-bin.zip

Từ giờ, khi bạn gõ ./gradlew build, dự án sẽ tự động tải và dùng môi trường Gradle 9.2.1, không phụ thuộc vào việc máy bạn cài gì.

Compatibility Matrix

Do bạn dùng bản rất mới (9.2.1), hãy lưu ý bảng tương thích sau để tránh lỗi lạ: