Một API cấu hình giao diện trả về màu dưới dạng chuỗi hex. Nếu đội web dùng alpha ở cuối còn Android nhận alpha ở đầu, cùng tám chữ số có thể tạo màu khác. Color.parseColor của Android nhận dạng #RRGGBB và #AARRGGBB, vì vậy hợp đồng dữ liệu cần ghi rõ thứ tự từng thành phần.
Kiểm tra bằng kênh màu
Ví dụ dùng màu đỏ đặc và đỏ có alpha 128. Hàm Color.alpha và các hàm đọc kênh giúp kiểm tra giá trị thay vì chỉ nhìn ảnh chụp màn hình. Các API trong đoạn mã có từ API level 1.
import android.graphics.Color
fun checkColors() {
val solid = Color.parseColor("#FF0000")
check(Color.alpha(solid) == 255)
check(Color.red(solid) == 255)
val translucent = Color.parseColor("#80FF0000")
check(Color.alpha(translucent) == 128)
check(Color.red(translucent) == 255)
check(Color.green(translucent) == 0)
check(Color.blue(translucent) == 0)
}
Thống nhất dữ liệu với phía cung cấp
Nếu backend dùng #RRGGBBAA, chuyển đổi theo một quy tắc được kiểm thử trước khi gọi parseColor. Đừng đổi vị trí ký tự mà không xác định đầu vào có sáu hay tám chữ số. Thêm schema hoặc validation ở ranh giới nhận cấu hình để lỗi có thông báo theo trường dữ liệu.
Chuỗi không hợp lệ có thể làm parseColor ném IllegalArgumentException. Với màu tùy chọn, quyết định fallback rõ và ghi nhận cấu hình lỗi ở mức phù hợp. Với trường bắt buộc, báo lỗi để người vận hành sửa thay vì âm thầm thay màu khiến giao diện không đúng yêu cầu.
Kiểm tra trên nền thật
Alpha 128 được pha với màu nền khi vẽ, nên ảnh nhìn thấy còn phụ thuộc background. Kiểm tra cả theme sáng và tối, rồi đối chiếu giá trị kênh với fixture. Một màu hợp lệ về cú pháp vẫn có thể thiếu tương phản cho chữ hoặc biểu tượng.
Nếu dữ liệu chỉ cho phép hex, đừng tự mở rộng hợp đồng sang mọi tên màu mà API có thể chấp nhận. Danh sách định dạng rõ giúp client khác triển khai nhất quán. Giữ ký hiệu # và trường hợp màu không có alpha trong tài liệu API.
Tạo bộ test nhỏ
Thêm đỏ đặc, đỏ nửa trong suốt, alpha bằng 0 và một chuỗi sai. Kiểm tra fallback hoặc lỗi đúng chính sách. Nếu có bước chuyển định dạng, test trực tiếp cả giá trị nguồn lẫn các kênh đầu ra.
Đoạn Kotlin đã được rà theo tài liệu Android, chưa chạy trên emulator trong lượt biên tập. Khi tích hợp, chạy fixture ở app test và chụp trên nền thật để xác nhận dữ liệu và trải nghiệm hiển thị cùng đúng.

