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

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

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

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

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

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

لإنشاء أداة التحقق من الإضافات، يُرجى اتباع الخطوات التالية:

  1. نزِّل رمز المصدر لمكتبة Android Jetpack. للحصول على التفاصيل، يمكنك مراجعة الاطّلاع على الرمز في الملف التمهيدي Android Jetpack.

  2. إنشاء extensionstestapp APK. يتيح ذلك إجراء اختبارات التحقّق من الصحة اليدوية.

      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. إنشاء androidTest APK. تسمح حزمة 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 حِزم APK.

  • ملف 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

  • ملف 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

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

بعد تثبيت حِزم APK، يمكنك إجراء كل الاختبارات الآلية للتحقّق من هوية المورِّد تنفيذ المكتبة، شغِّل الأمر التالي:

adb shell am instrument -w -r androidx.camera.integration.extensions.test/androidx.test.runner.AndroidJUnitRunner

في حال اجتياز جميع الاختبارات، يتم عرض نتيجة حسنًا. خلاف ذلك، لا يحتاج تقرير الاختبار النهائي الأعطال في الوحدة الطرفية بعد اكتمال جميع الاختبارات.

auto_Verifyation_result-pass

الشكل 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 قدراتي. إذا لم تكن الكاميرا توفِّر أي وضع إضافة، فإن الوضع المناسب لها عنصر القائمة رمادي اللون.

Camera_Verifyation_النتيجة-الحرفي

الشكل 3. وضع أداة التحقّق

انقر على إحدى الكاميرات للاطّلاع على أوضاع الإضافات للاختبار. إضافة تظهر الأوضاع غير المتاحة في الكاميرا المحددة باللون الرمادي.

export_mode_trueation_result-initial

الشكل 4. أوضاع الإضافات المتاحة للكاميرا

التحقق من نتائج المعاينة

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

معاينة-bokeh_enabled

الشكل 5. معاينة الصورة مع تفعيل خلفية ضبابية

يدعم نشاط التقاط الصور الوظائف التالية:

  • تكبير/تصغير
  • النقر للتركيز
  • زر تبديل أوضاع الفلاش
  • مركبة كهربائية +/-
  • زر التبديل بين تفعيل الإضافة وإيقافها

تأكد من أن التكبير/التصغير، والنقر للتركيز، وأوضاع الفلاش، تعمل وظائف المركبة الكهربائية +/- على النحو المتوقّع في المعاينة.

التحقّق من نتائج الصور التي تم التقاطها

لالتقاط الصورة، انقر على الزرّ CAPTURE (الزر المستدير) في الصورة. لتسجيل النشاط. يؤدي ذلك إلى بدء نشاط التحقق من صحة الصور الذي يعرض الصورة التي تم التقاطها.

image_viewer-bokeh_enabled)

الشكل 6. صورة تم التقاطها مع تفعيل ميزة "ضبابية"

يتضمن نشاط التحقق من صحة الصور الدوال التالية:

  • يمكنك التصغير أو التكبير بإصبعين لتغيير حجم الصورة.
  • مرِّر لليمين أو اليسار لتبديل الصور التي تم التقاطها.
  • تلخيص
  • حفظ صورة في قائمة الطعام

التحقق مما إذا كانت الصورة التي تم التقاطها صحيحة وتتطابق مع التكبير أو التصغير "داخل/خارج"، "النقر للتركيز"، وأوضاع الفلاش، وإعدادات المركبة الكهربائية +/- التي تم ضبطها عندما التقاط الصورة.

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

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

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

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

نتيجة_التحقّق_من_الكاميرا item_mode_validation_result

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

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

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

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

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