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 Nhà sản xuất thiết bị gốc (OEM) về Tiện ích máy ảnh có được triển khai đúng cách hay không. Công cụ này bao gồm quy trình xác thực tự động và thủ công kiểm thử.
Kiểm thử xác thực tự động: xác thực rằng thư viện nhà cung cấp giao diện được triển khai đúng cách. Ví dụ: nếu
CaptureProcessor
là cần thiết để chụp ảnh, các bài kiểm tra xác nhận rằngImageCaptureExtenderImpl#getCaptureStages()
trả về giá trị bắt buộc Thực thểCaptureStage
để chụp ảnh.Kiểm tra xác thực thủ công: Xác thực hiệu ứng và chất lượng hình ảnh của hình ảnh xem trước và hình ảnh đã chụp. Ví dụ: bài kiểm thử cho phép thiết bị để xác thực thủ công xem hiệu ứng làm đẹp khuôn mặt có được được áp dụng đúng cách hoặc liệu độ đậm 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 chi tiết, hãy xem Xem mã của ĐỌC Android Jetpack.
Xây dựng
extensionstestapp
APK. Điều này cho phép chạy các quy trình kiểm tra 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 sang đường dẫn sau:
path/to/checkout/out/androidx/camera/integration-tests/camera-testapp-extensions/build/outputs/apk/debug/camera-testapp-extensions-debug.apk
Xây dựng
androidTest
APK. Tệp APK này cho phép chạy các chương trình 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 sang đườ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 tra xác thực tự động
Để chạy quy trình kiểm tra xác thực tự động, hãy cài đặt extensionstestapp
và
androidTest
APK.
extensionstestapp
APKadb install -r path/to/checkout/out/androidx/camera/integration-tests/camera-testapp-extensions/build/outputs/apk/debug/camera-testapp-extensions-debug.apk
androidTest
APKadb 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, hãy chạy tất cả chương trình kiểm thử tự động để xác thực nhà cung cấp triển khai thư viện, 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 lượt kiểm thử đều đạt, thì kết quả sẽ trả về là OK. Nếu không, báo cáo kiểm thử cuối cùng hiển thị lỗi trong thiết bị đầu cuối sau khi tất cả thử nghiệm hoàn tất.
Hình 1. Kết quả kiểm thử tự động tốt
Hình 2. Kết quả kiểm thử tự động kèm theo lỗi
Chạy kiểm thử tự động cho 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
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 tra xác thực thủ công
Các thử nghiệm xác thực thủ công được tìm thấy trong ứng dụng kiểm thử tiện ích. Sau khi cài đặt và khởi chạy ứng dụng kiểm tra 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 liệt kê tất cả các máy ảnh
có chứa
REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE
chức năng. Nếu máy ảnh không hỗ trợ bất kỳ chế độ tiện ích nào, máy ảnh tương ứng
mục danh sách 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 camera để xem các chế độ thử nghiệm của tiện ích. Phần mở rộng các chế độ không được máy ảnh đã chọn hỗ trợ sẽ được hiển thị bằng màu xám.
Hình 4. Các chế độ tiện ích dành 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 tra thủ công bằng cách nhấn vào chế độ tiện ích cho máy ảnh đã chọn. Hoạt động chụp ảnh có chứa sau đó bản xem trước sẽ hiển thị.
Hình 5. Hình ảnh xem trước có hiệu ứng bokeh đang bật
Hoạt động chụp ảnh hỗ trợ các hàm sau:
- Phóng to/thu nhỏ
- Nhấn để lấy nét
- Nút chuyển đổi chế độ đèn flash
- Xe điện +/-
- Nút chuyển đổi đã bật/tắt tiện ích
Xác minh rằng chế độ phóng to/thu nhỏ, nhấn để lấy nét, chế độ đèn flash và Các hàm EV +/- hoạt động như dự kiến 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 hình tròn) trong hình ảnh hoạt động ghi lại. 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. Ảnh chụp đã 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/duỗi hai ngón tay để điều chỉnh tỷ lệ hình ảnh
- Trượt sang trái/phải để chuyển đổi các hình ảnh đã chụp
- Chụp lại
- Mục trong trình đơn Lưu hình ảnh
Xác minh xem hình ảnh đã chụp có chính xác không và khớp với mức thu phóng vào/ra, nhấn để lấy nét, chế độ đèn flash và chế độ cài đặt EV +/- được đặt khi chụp ảnh.
Nếu kết quả đã chụp là chính xác, hãy nhấn vào nút ĐẠT (dấu kiểm) trong góc dưới cùng bên phải. Nếu không, hãy nhấn vào nút FAIL (dấu chấm than) trong góc dưới cùng bên trái.
Xem kết quả kiểm thử
Sau khi chế độ tiện ích được xác minh là đạt hoặc không đạt, mục danh sách cho giá trị chế độ tiện ích hiển thị chỉ báo và màu nền khác. Trong danh sách chế độ xem của tất cả camera, các mục được 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ợ sẽ không được xác thực hoàn toàn.
- Nền xanh lục: 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ợ sẽ được xác thực khi tất cả kết quả đều đạ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ợ đã được xác thực bằng ít nhất một chế độ tiện ích kết quả không thành công.
- Nền xám: Tính năng này không dùng được.
Hình 7. Các màu thể hiện kết quả kiểm tra của máy ảnh và chế độ tiện ích
Các hàm khác của công cụ xác thực
Sau khi tất cả kiểm thử hoàn tất, hoạt động danh sách máy ảnh sẽ cung cấp các hàm sau:
- Xuất kết quả kiểm tra: Xuất kết quả kiểm tra dưới dạng tệp CSV
Thư mục
Documents/ExtensionsValidation
. - Đặt lại: Xoá tất cả kết quả kiểm tra đã lưu vào bộ nhớ đệm.
- Ứng dụng mẫu tiện ích: Chuyển sang ứng dụng mẫu tiện ích .
Sau khi kiểm thử xong, bạn có thể xuất kết quả kiểm thử. Nếu bạn thấy một và phiên bản mới của triển khai thư viện nhà cung cấp với tính năng các giải pháp cần được xác minh lại, đặt lại kết quả kiểm thử trước đó rồi chạy lại tất cả các chế độ tiện ích được hỗ trợ trên tất cả camera để xác minh rằng các vấn đề đã được khắc phục.