Công cụ xác thực tiện ích máy ảnh cho phép nhà sản xuất thiết bị xác minh rằng Thư viện nhà cung cấp tiện ích máy ảnh OEM được triển khai đúng cách. Công cụ này bao gồm các kiểm thử xác thực tự động và thủ công.
Kiểm thử xác thực tự động: xác thực rằng giao diện thư viện nhà cung cấp được triển khai chính xác. Ví dụ: nếu bắt buộc phải có
CaptureProcessor
để chụp ảnh, thì quy trình kiểm thử sẽ xác thực rằngImageCaptureExtenderImpl#getCaptureStages()
trả về các thực thểCaptureStage
bắt buộc để chụp ảnh.Kiểm thử xác thực thủ công: Xác thực hiệu ứng hình ảnh và chất lượng của hình ảnh xem trước và hình ảnh đã chụp. Ví dụ: các bài kiểm thử cho phép nhà sản xuất thiết bị xác thực theo cách thủ công xem hiệu ứng làm đẹp khuôn mặt có được áp dụng chính xác hay không hoặc độ mạnh của hiệu ứng bokeh có đủ hay không.
Mã nguồn của công cụ xác thực là một phần của ứng dụng kiểm thử tiện ích trong kho lưu trữ Android Jetpack.
Tạo công cụ xác thực tiện ích máy ảnh
Để tạo công cụ xác thực tiện ích, hãy làm theo các bước sau:
Tải mã nguồn thư viện Android Jetpack xuống. Để biết thông tin chi tiết, hãy xem phần Kiểm tra mã trong Tệp README của Android Jetpack.
Tạo tệp APK
extensionstestapp
. Điều này cho phép chạy các kiểm thử xác thực thủ công.cd path/to/checkout/frameworks/support/
./gradlew camera:integration-tests:camera-testapp-extensions:assembleDebug
Tệp APK được xuất ra theo đường dẫn sau:
path/to/checkout/out/androidx/camera/integration-tests/camera-testapp-extensions/build/outputs/apk/debug/camera-testapp-extensions-debug.apk
Tạo tệp APK
androidTest
. APK này cho phép chạy các bài kiểm thử xác thực tự động.cd path/to/checkout/frameworks/support/
./gradlew camera:integration-tests:camera-testapp-extensions:assembleAndroidTest
Tệp APK được xuất ra theo đường dẫn sau:
path/to/checkout/out/androidx/camera/integration-tests/camera-testapp-extensions/build/outputs/apk/androidTest/debug/camera-testapp-extensions-debug-androidTest.apk
Chạy kiểm thử xác thực tự động
Để chạy các kiểm thử xác thực tự động, hãy cài đặt tệp APK extensionstestapp
và androidTest
.
Tệp APK
extensionstestapp
adb install -r path/to/checkout/out/androidx/camera/integration-tests/camera-testapp-extensions/build/outputs/apk/debug/camera-testapp-extensions-debug.apk
Tệp APK
androidTest
adb install -r path/to/checkout/out/androidx/camera/integration-tests/camera-testapp-extensions/build/outputs/apk/androidTest/debug/camera-testapp-extensions-debug-androidTest.apk
Chạy tất cả kiểm thử tự động
Sau khi cài đặt tệp APK, để chạy tất cả kiểm thử tự động nhằm xác thực việc triển khai thư viện nhà cung cấp, hãy chạy lệnh sau:
adb shell am instrument -w -r androidx.camera.integration.extensions.test/androidx.test.runner.AndroidJUnitRunner
Nếu tất cả các bài kiểm thử đều đạt, kết quả OK sẽ được trả về. Nếu không, báo cáo kiểm thử cuối cùng sẽ cho thấy các lỗi trong dòng lệnh sau khi tất cả lượt kiểm thử hoàn tất.
Hình 1. Kết quả kiểm thử tự động OK
Hình 2. Kết quả kiểm thử tự động không đạt
Chạy kiểm thử tự động của một lớp cụ thể
Để chạy kiểm thử tự động của một lớp cụ thể, hãy chỉ định tên và đường dẫn của lớp mục tiêu. Ví dụ sau đây cho thấy lệnh chạy kiểm thử cho lớp ImageCaptureTest
:
adb shell am instrument -w -r -e class **androidx.camera.integration.extensions.ImageCaptureTest** androidx.camera.integration.extensions.test/androidx.test.runner.AndroidJUnitRunner
Chạy kiểm thử xác thực thủ công
Bạn có thể tìm thấy các hoạt động kiểm thử xác thực thủ công trong ứng dụng kiểm thử tiện ích. Sau khi cài đặt và chạy ứng dụng kiểm thử tiện ích, hãy chuyển sang chế độ công cụ xác thực bằng cách nhấn vào mục trong trình đơn ở trên cùng bên phải.
Sau khi chuyển sang chế độ công cụ xác thực, trang đầu tiên sẽ liệt kê tất cả các máy ảnh có chức năng REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE
. Nếu một máy ảnh không hỗ trợ chế độ tiện ích nào, thì mục tương ứng trong danh sách sẽ có màu xám.
Hình 3. Chế độ công cụ xác thực
Nhấn vào một trong các máy ảnh để xem các chế độ tiện ích để kiểm thử. Các chế độ tiện ích mà máy ảnh đã chọn không hỗ trợ sẽ có màu xám.
Hình 4. Các chế độ tiện ích có sẵn cho máy ảnh
Xác minh kết quả xem trước
Để xác minh kết quả xem trước, hãy bắt đầu kiểm thử thủ công bằng cách nhấn vào một chế độ tiện ích cho máy ảnh đã chọn. Sau đó, một hoạt động chụp ảnh chứa bản xem trước sẽ xuất hiện.
Hình 5. Hình ảnh xem trước khi bật hiệu ứng bokeh
Hoạt động chụp ảnh hỗ trợ các chức năng sau:
- Phóng to/thu nhỏ
- Nhấn để lấy nét
- Nút chuyển đổi chế độ đèn flash
- EV +/-
- Nút chuyển đổi đã bật/tắt tiện ích
Xác minh rằng các chức năng thu/phóng, nhấn để lấy nét, chế độ đèn flash và EV +/- hoạt động như mong đợi trong bản xem trước.
Xác minh kết quả hình ảnh đã chụp
Để chụp ảnh, hãy nhấn vào nút CAPTURE (CHỤP) (nút tròn) trong hoạt động chụp ảnh. Thao tác này sẽ khởi chạy một hoạt động xác thực hình ảnh cho thấy hình ảnh đã chụp.
Hình 6. Hình ảnh được chụp khi bật hiệu ứng bokeh
Hoạt động xác thực hình ảnh bao gồm các hàm sau:
- Chụm vào/ra để điều chỉnh tỷ lệ hình ảnh
- Trượt sang trái/phải để chuyển đổi hình ảnh đã chụp
- Quay lại
- Mục Lưu hình ảnh trong trình đơn
Xác minh xem ảnh đã chụp có chính xác hay không và khớp với chế độ phóng to/thu nhỏ, nhấn để lấy nét, chế độ đèn flash và chế độ cài đặt EV +/- đã đặt khi chụp ảnh.
Nếu kết quả thu được là chính xác, hãy nhấn vào nút ĐẠT (dấu kiểm) ở góc dưới cùng bên phải. Nếu không, hãy nhấn vào nút KHÔNG ĐẠT (dấu chấm than) ở góc dưới cùng bên trái.
Xem kết quả kiểm thử
Sau khi một chế độ tiện ích được xác minh là đạt hoặc không đạt, mục danh sách cho chế độ tiện ích sẽ hiển thị màu nền và chỉ báo khác. Trong chế độ xem danh sách của tất cả các máy ảnh, các mục sẽ hiển thị bằng các màu sau:
- Nền trắng: Máy ảnh hỗ trợ ít nhất một chế độ tiện ích và các chế độ tiện ích được hỗ trợ chưa được xác thực đầy đủ.
- Nền xanh: Máy ảnh hỗ trợ ít nhất một chế độ tiện ích. Tất cả các chế độ tiện ích được hỗ trợ đều được xác thực với tất cả kết quả đạt.
- Nền đỏ: Máy ảnh hỗ trợ ít nhất một chế độ tiện ích. Tất cả các chế độ tiện ích được hỗ trợ đều được xác thực với ít nhất một kết quả chế độ tiện ích không thành công.
- Nền xám: Tính năng này không có sẵn.
Hình 7. Màu sắc cho biết kết quả kiểm thử cho máy ảnh và chế độ tiện ích
Các hàm công cụ xác thực khác
Sau khi tất cả các bài kiểm thử hoàn tất, hoạt động danh sách máy ảnh sẽ cung cấp các chức năng sau:
- Xuất kết quả kiểm tra: Xuất kết quả kiểm tra dưới dạng tệp CSV vào
thư mục
Documents/ExtensionsValidation
. - Đặt lại: Xoá tất cả kết quả kiểm thử được lưu vào bộ nhớ đệm.
- Ứng dụng mẫu tiện ích: Chuyển sang chế độ ứng dụng mẫu tiện ích.
Sau khi hoàn tất quá trình kiểm thử, bạn có thể xuất kết quả kiểm thử. Nếu bạn phát hiện một vấn đề và cần xác minh lại phiên bản mới của việc triển khai thư viện nhà cung cấp có các giải pháp, hãy đặt lại kết quả kiểm thử trước đó và chạy lại tất cả chế độ tiện ích được hỗ trợ trên tất cả máy ảnh để xác minh rằng các vấn đề đã được khắc phục.