Trình bổ trợ Android cho Gradle 8.1.0 (tháng 7 năm 2023)

Trình bổ trợ Android cho Gradle 8.1.0 là một bản phát hành chính bao gồm nhiều tính năng và điểm cải thiện mới.

Khả năng tương thích

Kotlin DSL là cấu hình mặc định cho bản dựng

Theo mặc định, các dự án mới hiện sử dụng Kotlin DSL (build.gradle.kts) cho cấu hình bản dựng. Điều này mang lại trải nghiệm chỉnh sửa tốt hơn so với Groovy DSL (build.gradle) nhờ tính năng làm nổi bật cú pháp, hoàn tất mã và điều hướng đến phần khai báo. Xin lưu ý rằng nếu đang sử dụng AGP 8.1 và DSL Kotlin cho cấu hình bản dựng, bạn nên sử dụng Gradle 8.1 để có trải nghiệm tốt nhất. Để tìm hiểu thêm, hãy xem hướng dẫn di chuyển DSL Kotlin.

Tự động hỗ trợ ngôn ngữ cho mỗi ứng dụng

Kể từ Android Studio Giraffe Canary 7 và AGP 8.1.0-alpha07, bạn có thể định cấu hình ứng dụng để tự động hỗ trợ các lựa chọn ưu tiên về ngôn ngữ cho mỗi ứng dụng. Dựa trên tài nguyên của dự án, trình bổ trợ Android cho Gradle sẽ tạo tệp LocaleConfig và thêm mục tham chiếu đến tệp đó trong tệp kê khai cuối cùng, do đó, bạn không còn phải tạo hoặc cập nhật tệp theo cách thủ công nữa. AGP sẽ sử dụng các tài nguyên trong thư mục res của mô-đun ứng dụng và mọi phần phụ thuộc của mô-đun thư viện để xác định ngôn ngữ cần đưa vào tệp LocaleConfig.

Xin lưu ý rằng tính năng ngôn ngữ tự động cho mỗi ứng dụng hỗ trợ các ứng dụng chạy Android 13 (API cấp 33) trở lên. Để dùng tính năng này, bạn phải đặt compileSdkVersion thành 33 trở lên. Để định cấu hình các lựa chọn ưu tiên về ngôn ngữ cho mỗi ứng dụng đối với các phiên bản Android trước, bạn vẫn cần phải sử dụng các API và bộ chọn ngôn ngữ trong ứng dụng.

Để bật tính năng tự động hỗ trợ ngôn ngữ cho mỗi ứng dụng, hãy chỉ định một ngôn ngữ mặc định:

1. Trong thư mục res của mô-đun ứng dụng, hãy tạo một tệp mới có tên resources.properties.

2. Trong tệp resources.properties, hãy đặt ngôn ngữ mặc định bằng nhãn unqualifiedResLocale. Để tạo tên ngôn ngữ, hãy kết hợp mã ngôn ngữ với tập lệnh tuỳ chọn và mã vùng, phân tách mỗi mã bằng một dấu gạch ngang:

   • Ngôn ngữ: Sử dụng mã gồm hai hoặc ba chữ cái theo tiêu chuẩn ISO 639-1.
   • Tập lệnh (không bắt buộc): Sử dụng mã theo ISO 15924.
   • Khu vực (không bắt buộc): Sử dụng mã gồm hai chữ cái theo tiêu chuẩn ISO 3166-1-alpha-2 hoặc mã gồm 3 chữ số theo tiêu chuẩn UN_M.49.

   Chẳng hạn, nếu ngôn ngữ mặc định của bạn là tiếng Anh Mỹ:

       unqualifiedResLocale=en-US
       

AGP sẽ thêm ngôn ngữ mặc định này và mọi ngôn ngữ thay thế mà bạn đã chỉ định (bằng cách dùng các đường dẫn values-* trong thư mục res) vào tệp LocaleConfig được tạo tự động.

Tính năng tự động hỗ trợ ngôn ngữ cho mỗi ứng dụng bị tắt theo mặc định. Để bật tính năng này, hãy sử dụng chế độ cài đặt generateLocaleConfig trong khối androidResources {} của tệp build.gradle.kts cấp mô-đun (tệp build.gradle nếu bạn đang sử dụng Groovy):

android {
  androidResources {
    generateLocaleConfig = true
  }
}

android {
  androidResources {
    generateLocaleConfig true
  }
}

Công cụ tìm lỗi mã nguồn Android chứa mã byte nhắm đến JVM 17

Kể từ AGP 8.1.0-alpha04, Android Lint chứa mã byte nhắm đến JVM 17. Nếu viết quy trình kiểm tra tìm lỗi mã nguồn tuỳ chỉnh, bạn cần biên dịch bằng JDK 17 trở lên và chỉ định jvmTarget = '17' trong các tuỳ chọn trình biên dịch Kotlin.

Để tìm hiểu thêm về công cụ tìm lỗi mã nguồn, hãy xem bài viết Cải thiện mã bằng các lượt kiểm tra tìm lỗi mã nguồn.

Chế độ cài đặt nén thư viện gốc đã chuyển sang DSL

Kể từ AGP 8.1.0-alpha10, bạn sẽ nhận được cảnh báo nếu không định cấu hình tính năng nén thư viện gốc bằng DSL thay vì tệp kê khai. Hướng dẫn sau đây giải thích cách cập nhật cấu hình để sử dụng DSL. Để được trợ giúp thực hiện các bản cập nhật này, hãy sử dụng Trợ lý nâng cấp AGP (Tools > AGP Upgrade Assistant) (Công cụ > Trợ lý nâng cấp AGP).

Để sử dụng thư viện gốc không nén, hãy xoá thuộc tính android::extractNativeLibs khỏi tệp kê khai và thêm mã sau vào tệp build.gradle.kts cấp mô-đun (tệp build.gradle nếu bạn đang sử dụng Groovy):

android {
  packagingOptions {
    jniLibs {
      useLegacyPackaging = false
    }
  }
}

android {
  packagingOptions {
    jniLibs {
      useLegacyPackaging false
    }
  }
}

Cờ bản dựng thử nghiệm

Đây là các cờ thử nghiệm để định cấu hình bản dựng có trong AGP 8.1.

Vấn đề đã khắc phục

Trình bổ trợ Android cho Gradle 8.1.0

Trình bổ trợ Android cho Gradle 8.1.1

Trình bổ trợ Android cho Gradle 8.1.2

Trình bổ trợ Android cho Gradle 8.1.3

Trình bổ trợ Android cho Gradle 8.1.4