Một component native cần biết cấu hình hiện tại đang ở chế độ sáng hay tối để chọn màu biểu đồ. Configuration.uiMode chứa nhiều nhóm bit, gồm cả loại thiết bị và chế độ đêm. So sánh toàn bộ uiMode với một hằng night có thể cho kết quả sai khi các bit khác cũng được đặt.
Lấy đúng nhóm bit
Dùng UI_MODE_NIGHT_MASK để giữ các bit biểu diễn night mode rồi so sánh với giá trị tương ứng. Ví dụ trả null cho trường hợp chưa xác định. Những hằng này có từ API 8. Đoạn mã đọc cấu hình hiện tại, không tự theo dõi thay đổi về sau.
import android.content.res.Configuration
fun isNightMode(configuration: Configuration): Boolean? {
val night = configuration.uiMode and Configuration.UI_MODE_NIGHT_MASK
return when (night) {
Configuration.UI_MODE_NIGHT_YES -> true
Configuration.UI_MODE_NIGHT_NO -> false
else -> null
}
}
Ở Activity hoặc View, truyền resources.configuration của context phù hợp. Nếu ứng dụng có theme override riêng, kết quả của component cần nhất quán với cấu hình mà phần giao diện đó nhận. Tránh lấy một giá trị từ application context rồi lưu vĩnh viễn cho mọi màn hình.
Kiểm tra với dữ liệu tổng hợp
Tạo Configuration thử nghiệm, đặt uiMode bằng UI_MODE_NIGHT_YES kết hợp UI_MODE_TYPE_CAR, rồi kiểm tra hàm vẫn trả true. Lặp với NIGHT_NO và giá trị không xác định. Ca kết hợp thêm loại thiết bị giúp phát hiện việc so sánh nguyên uiMode thay vì lọc bit.
Sau kiểm tra hàm, mở màn hình thật, đổi chế độ trong cài đặt và trở lại ứng dụng. Xác nhận biểu đồ và các thành phần Material đổi màu nhất quán. Android có thể tái tạo Activity khi cấu hình đổi tùy cấu hình ứng dụng. Nếu đội tự xử lý thay đổi cấu hình, cập nhật màu ở callback thích hợp theo vòng đời.
Chọn nơi đặt màu
Nếu chỉ cần một màu khác giữa sáng và tối, resource values-night thường giúp cấu hình dễ theo dõi hơn nhánh if ở nhiều component. Hàm đọc bitmask phù hợp khi cần ra quyết định ở logic tích hợp hoặc thư viện native. Đừng dùng nó làm bộ nhớ theme độc lập cạnh hệ thống theme đang có.
Khi hàm trả null, chọn fallback theo yêu cầu sản phẩm và lưu rõ trong test. Chưa xác định không đồng nghĩa chắc chắn sáng. Kiểm tra thêm trường hợp người dùng đổi theme trong app, chế độ hệ thống tự chuyển theo lịch và màn hình được dựng lại.
Ví dụ đã được rà theo API Configuration. Chưa có lượt chạy Kotlin hoặc kiểm tra trên thiết bị trong quá trình viết bài, nên những ca giao diện nêu trên là checklist để tích hợp.


