أداة التحقّق من إضافات الكاميرا

تتيح أداة التحقّق من الإضافات الخاصة بالكاميرا لصنّاع الأجهزة verifying التحقّق من تنفيذ مكتبة مورّدي الإضافات الخاصة بالكاميرا من المصنّعين الأصليين للأجهزة بشكل صحيح. تتضمن الأداة اختبارات تحقق تلقائية ويدوية.

• اختبارات التحقّق المبرمَجة: تُستخدم هذه الاختبارات للتحقّق من تنفيذ واجهة مكتبة المورّد بشكلٍ صحيح. على سبيل المثال، إذا كان CaptureProcessor مطلوبًا لالتقاط الصور، تتحقّق الاختبارات من أنّ ImageCaptureExtenderImpl#getCaptureStages() يعرض المثيلات المطلوبة CaptureStage لالتقاط الصور.

• اختبارات التحقّق يدويًا: يمكنك التحقّق من تأثيرات الصور وجودة المعاينة والصور التي تم التقاطها. على سبيل المثال، تسمح الاختبارات لصنّاع الأجهزة بالتحقق يدويًا مما إذا كان يتم تطبيق تأثير إعادة لمس الوجه بشكل صحيح أو ما إذا كانت قوة تأثير التمويه كافية.

يُعدّ الرمز المصدر لأداة التحقّق جزءًا من تطبيق اختبار الإضافات في مستودع Android Jetpack.

إنشاء أداة التحقّق من الإضافات في الكاميرا

لإنشاء أداة التحقّق من صحة الإضافات، اتّبِع الخطوات التالية:

1. نزِّل رمز المصدر لمكتبة Android Jetpack. للاطّلاع على التفاصيل، يُرجى الاطّلاع على القسم Checking the Code ضمن Android Jetpack README.

2. أنشئ حزمة 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
   

3. أنشئ حزمة APK الخاصة بتطبيقك على النحو التالي: androidTest يسمح حِزمة 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
   

إجراء اختبارات التحقّق من الصحة المبرمَجة

لتنفيذ اختبارات التحقّق المبرمَجة، ثبِّت حِزم APK الخاصة بتطبيقَي extensionstestapp و androidTest.

• extensionstestapp حزمة APK

    adb install -r path/to/checkout/out/androidx/camera/integration-tests/camera-testapp-extensions/build/outputs/apk/debug/camera-testapp-extensions-debug.apk

• androidTest حزمة APK

    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

إجراء كل الاختبارات المبرمَجة

بعد تثبيت حِزم 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 +/- التي تم ضبطها عند التقاط الصورة.

إذا كانت النتائج التي تم التقاطها صحيحة، انقر على الزر اجتياز (علامة اختيار) في أسفل يسار الشاشة. بخلاف ذلك، انقر على الزر تعذّر (علامة تعجب) في الزاوية اليسرى السفلية.

عرض نتائج الاختبار

بعد التحقُّق من وضع الإضافة كاجتياز أو تعذُّر، يعرض عنصر القائمة لوضع الإضافة لون خلفية ومؤشر مختلفين. في عرض القائمة لجميع الكاميرات، يتم عرض العناصر بالألوان التالية:

• خلفية بيضاء: تتيح الكاميرا وضع تمديد واحدًا على الأقل، ولم يتم التحقّق من أوضاع التمديد المتوافقة بالكامل.
• الخلفية الخضراء: تتيح الكاميرا وضع تمديد واحدًا على الأقل. يتم التحقّق من جميع أوضاع الإضافات المتوافقة مع اجتياز جميع النتائج.
• الخلفية الحمراء: تتوافق الكاميرا مع وضع تمديد واحد على الأقل. يتم التحقّق من صحة جميع أوضاع الإضافات المتوافقة مع تعذّر نتيجة واحدة على الأقل في أحد أوضاع الإضافات.
• الخلفية الرمادية: هذه الميزة غير متاحة.

الشكل 7: ألوان تشير إلى نتائج اختبار الكاميرات وأوضاع الإضافات

وظائف أداة التحقّق الأخرى

بعد اكتمال جميع الاختبارات، يوفّر نشاط قائمة الكاميرا الوظائف التالية:

• تصدير نتائج الاختبار: يمكنك تصدير نتائج الاختبار كملف CSV إلى مجلد Documents/ExtensionsValidation.
• إعادة الضبط: يؤدي هذا الإجراء إلى محو جميع نتائج الاختبارات المخزّنة مؤقتًا.
• تطبيق نماذج الإضافات: للتبديل إلى وضع تطبيق نماذج الإضافات

بعد اكتمال الاختبار، يمكنك تصدير نتائجه. إذا واجهت مشكلة وكنت بحاجة إلى التحقّق من إصدار جديد من مكتبة المورّد الذي يتضمّن الحلول مرة أخرى، يمكنك إعادة ضبط نتائج الاختبار السابقة وإعادة تنفيذ جميع أوضاع التوسيع المتوافقة على جميع الكاميرات للتأكّد من حلّ المشاكل.