تسمح أداة التحقق من صحة ملحقات الكاميرا لمصنعي الأجهزة بالتحقق من تنفيذ مكتبة موردي Camera Extensions OEM بشكل صحيح. تتضمن الأداة اختبارات التحقق الآلية واليدوية.
اختبارات التحقق التلقائية: التحقق من تنفيذ واجهة مكتبة البائع بشكل صحيح. على سبيل المثال، إذا كان
CaptureProcessorمطلوبًا لالتقاط الصور، فإن الاختبارات تتحقق من أنImageCaptureExtenderImpl#getCaptureStages()تقوم بإرجاع مثيلاتCaptureStageالمطلوبة لالتقاط الصور.اختبارات التحقق اليدوية: التحقق من صحة تأثيرات الصورة وجودة المعاينة والصور الملتقطة. على سبيل المثال، تسمح الاختبارات لمصنعي الأجهزة بالتحقق يدويًا مما إذا كان تأثير تنقيح الوجه قد تم تطبيقه بشكل صحيح أو ما إذا كانت قوة البوكيه كافية.
يعد الكود المصدري لأداة التحقق جزءًا من تطبيق اختبار الامتدادات في مستودع Android Jetpack .
قم ببناء أداة التحقق من صحة ملحقات الكاميرا
لإنشاء أداة التحقق من صحة الامتدادات، اتبع الخطوات التالية:
قم بتنزيل الكود المصدري لمكتبة Android Jetpack. للحصول على التفاصيل، راجع قسم التحقق من الكود في ملف Android Jetpack README .
قم ببناء ملف APK
extensionstestapp. وهذا يسمح بإجراء اختبارات التحقق اليدوية.cd path/to/checkout/frameworks/support/./gradlew camera:integration-tests:camera-testapp-extensions:assembleDebugيتم إخراج APK إلى المسار التالي:
path/to/checkout/out/androidx/camera/integration-tests/camera-testapp-extensions/build/outputs/apk/debug/camera-testapp-extensions-debug.apkقم ببناء
androidTestAPK. يسمح ملف APK هذا بإجراء اختبارات التحقق الآلية.cd path/to/checkout/frameworks/support/./gradlew camera:integration-tests:camera-testapp-extensions:assembleAndroidTestيتم إخراج APK إلى المسار التالي:
path/to/checkout/out/androidx/camera/integration-tests/camera-testapp-extensions/build/outputs/apk/androidTest/debug/camera-testapp-extensions-debug-androidTest.apk
تشغيل اختبارات التحقق الآلي
لتشغيل اختبارات التحقق التلقائية، قم بتثبيت extensionstestapp و androidTest APKs.
extensionstestappAPKadb install -r path/to/checkout/out/androidx/camera/integration-tests/camera-testapp-extensions/build/outputs/apk/debug/camera-testapp-extensions-debug.apkandroidTestAPKadb install -r path/to/checkout/out/androidx/camera/integration-tests/camera-testapp-extensions/build/outputs/apk/androidTest/debug/camera-testapp-extensions-debug-androidTest.apk
تشغيل كافة الاختبارات الآلية
بعد تثبيت ملفات APK، لتشغيل جميع الاختبارات التلقائية للتحقق من صحة تنفيذ مكتبة المورد، قم بتشغيل الأمر التالي:
adb shell am instrument -w -r androidx.camera.integration.extensions.test/androidx.test.runner.AndroidJUnitRunner
إذا نجحت جميع الاختبارات، يتم إرجاع نتيجة جيدة . وبخلاف ذلك، يُظهر تقرير الاختبار النهائي حالات الفشل في الجهاز بعد اكتمال جميع الاختبارات.
الشكل 1. الاختبارات الآلية نتيجة موافق
الشكل 2. تؤدي الاختبارات الآلية إلى الفشل
تشغيل اختبارات آلية لفئة معينة
لتشغيل اختبارات تلقائية لفئة معينة، حدد اسم الفئة المستهدفة ومسارها. يوضح المثال التالي الأمر لتشغيل الاختبارات لفئة ImageCaptureTest :
adb shell am instrument -w -r -e class **androidx.camera.integration.extensions.ImageCaptureTest** androidx.camera.integration.extensions.test/androidx.test.runner.AndroidJUnitRunner
تشغيل اختبارات التحقق اليدوية
تم العثور على اختبارات التحقق اليدوية في تطبيق اختبار الإضافات . بعد تثبيت تطبيق اختبار الإضافات وتشغيله، قم بالتبديل إلى وضع أداة التحقق من الصحة من خلال النقر على عنصر القائمة في الجزء العلوي الأيمن.
بعد التبديل إلى وضع أداة التحقق من الصحة، تسرد الصفحة الأولى جميع الكاميرات التي تحتوي على إمكانية REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE . إذا كانت الكاميرا لا تدعم أي وضع تمديد، فسيكون عنصر القائمة المقابل له باللون الرمادي.
الشكل 3. وضع أداة التحقق من الصحة
اضغط على إحدى الكاميرات لرؤية أوضاع الامتداد للاختبار. تظهر أوضاع الامتداد غير المدعومة بالكاميرا المحددة باللون الرمادي.
الشكل 4. أوضاع التمديد المتاحة للكاميرا
التحقق من نتائج المعاينة
للتحقق من نتائج المعاينة، ابدأ اختبارًا يدويًا من خلال النقر على أحد أوضاع الامتداد للكاميرا المحددة. يتم بعد ذلك عرض نشاط التقاط الصور الذي يحتوي على المعاينة.
الشكل 5. معاينة الصورة مع تمكين البوكيه
يدعم نشاط التقاط الصور الوظائف التالية:
- التكبير / التصغير
- انقر للتركيز
- زر تبديل أوضاع الفلاش
- قيمة التعريض +/-
- تم تمكين/تعطيل زر التبديل
تأكد من أن وظائف التكبير/التصغير والضغط للتركيز وأوضاع الفلاش ووظائف EV +/- تعمل كما هو متوقع في المعاينة.
التحقق من نتائج الصورة الملتقطة
لالتقاط الصورة، اضغط على زر الالتقاط (الزر الدائري) في نشاط التقاط الصورة. يؤدي هذا إلى تشغيل نشاط التحقق من صحة الصورة الذي يعرض الصورة الملتقطة.
الشكل 6. الصورة الملتقطة مع تمكين البوكيه
يتضمن نشاط التحقق من صحة الصورة الوظائف التالية:
- اضغط للداخل/للخارج لتغيير حجم الصورة
- قم بالتمرير إلى اليسار/اليمين لتبديل الصور الملتقطة
- استعادة
- حفظ عنصر القائمة الصورة
تحقق مما إذا كانت الصورة الملتقطة صحيحة وتطابق إعدادات التكبير/التصغير والضغط للتركيز وأوضاع الفلاش وإعدادات EV +/- التي تم ضبطها عند التقاط الصورة.
إذا كانت النتائج التي تم التقاطها صحيحة، فانقر على زر PASS (علامة الاختيار) في الزاوية اليمنى السفلية. بخلاف ذلك، اضغط على زر FAIL (علامة التعجب) في الزاوية السفلية اليسرى.
عرض نتائج الاختبار
بعد التحقق من وضع الامتداد كنجاح أو فشل، يعرض عنصر القائمة الخاص بوضع الامتداد لون خلفية ومؤشرًا مختلفين. في عرض القائمة لجميع الكاميرات، يتم عرض العناصر بالألوان التالية:
- خلفية بيضاء: تدعم الكاميرا وضع تمديد واحد على الأقل ولم يتم التحقق من صحة أوضاع التمديد المدعومة بشكل كامل.
- الخلفية الخضراء: تدعم الكاميرا وضع تمديد واحد على الأقل. يتم التحقق من صحة جميع أوضاع الامتداد المدعومة مع مرور جميع النتائج.
- خلفية حمراء: تدعم الكاميرا وضع تمديد واحد على الأقل. يتم التحقق من صحة جميع أوضاع الامتداد المدعومة مع فشل نتيجة وضع امتداد واحد على الأقل.
- الخلفية الرمادية: هذه الميزة غير متوفرة.
الشكل 7. الألوان التي تشير إلى نتائج الاختبار للكاميرات وأوضاع التمديد
وظائف أداة التحقق الأخرى
بعد اكتمال جميع الاختبارات، يوفر نشاط قائمة الكاميرا الوظائف التالية:
- تصدير نتائج الاختبار: لتصدير نتائج الاختبار كملف CSV إلى مجلد
Documents/ExtensionsValidation. - إعادة التعيين: مسح جميع نتائج الاختبار المخزنة مؤقتًا.
- نموذج تطبيق الامتدادات: للتبديل إلى وضع نموذج تطبيق الامتدادات.
بعد الانتهاء من الاختبار، يمكنك تصدير نتائج الاختبار. إذا وجدت مشكلة ويلزم التحقق من إصدار جديد من تنفيذ مكتبة المورد مع الحلول مرة أخرى، فأعد تعيين نتائج الاختبار السابقة وأعد تشغيل جميع أوضاع الامتداد المدعومة على جميع الكاميرات للتحقق من إصلاح المشكلات.