ملاحظات إصدار "مجموعة أدوات اختبار صور الكاميرا" في Android 17

يتضمّن إصدار Android 17 عددًا من التغييرات على مجموعة أدوات اختبار توافق الكاميرا (ITS). تلخّص هذه الصفحة التغييرات التي تم إجراؤها على Camera ITS في Android 17.

إصدارات Python والحِزم

في نظام التشغيل Android 17 والإصدارات الأحدث، ننصحك بشدة باستخدام برنامج إدارة الحِزم لتجميع الإصدارات الصحيحة من الحِزم لإنشاء بيئة افتراضية لتطوير إصدار Android. للاطّلاع على مثال لأداة إدارة الحِزم التي تتعامل مع معظم الحِزم المطلوبة، راجِع مستندات Python 3 حول venv.

لإنشاء البيئة الافتراضية باستخدام venv، اتّبِع الخطوات التالية:

  1. تثبيت الإصدار 3.12 من Python وpython3-venv

    sudo apt install python3.12
sudo apt install python3.12-venv python3.12-dev

  2. التحقّق من تثبيت Python

    python3.12 --version

  3. تعديل apt وتثبيت pip

    sudo apt-get update
sudo apt install python3-pip

  4. إنشاء بيئة افتراضية

    python3.12 -m venv its_android17_env

  5. تفعيل البيئة الافتراضية

    source its_android17_env/bin/activate

  6. إنشاء its_android17_env.txt مع قائمة الحِزم المطلوبة

    contourpy==1.3.1
cycler==0.12.1
fonttools==4.56.0
imagecodecs==2026.3.6
ImageIO==2.37.3
kiwisolver==1.4.8
lazy-loader==0.5
matplotlib==3.10.0
mobly==1.12.3
mobly-android-partner-tools==1.5.2
networkx==3.6.1
numpy==2.2.2
opencv-python==4.11.0.86
packaging==24.2
pillow==11.1.0
portpicker==1.6.0
protobuf==6.33.6
psutil==6.1.1
pyparsing==3.2.1
pyserial==3.5
python-dateutil==2.9.0.post0
pyudev==0.24.4
PyYAML==6.0.2
scikit-image==0.26.0
scipy==1.15.1
six==1.17.0
snippet-uiautomator==1.1.2
tifffile==2026.3.3

  7. تثبيت الحِزم المُدرَجة its_android17_env.txt

    pip install -r its_android17_env.txt

  8. تثبيت الإصدار 7.0.2 من FFmpeg باستخدام أداة تنزيل FFmpeg

    pip install ffmpeg-downloader
ffdl install 7.0.2

    (اختياري) إذا لم تعمل أداة تنزيل ffmpeg، نزِّل الإصدار 7.0.2 من مصدر على الإنترنت.

  9. التحقّق من تثبيت الإصدار 7.0.2 من FFmpeg

    ffmpeg -version

    إذا لم يكن إصدار FFmpeg هو 7.0.2، عليك إنشاء رابط رمزي للثنائيات (عدِّل PATH استنادًا إلى المكان الذي تحفظ فيه its_android17_env).

    ln -s ~/.local/share/ffmpeg-downloader/ffmpeg/ffmpeg ~/PATH/its_android17_env/bin/ffmpeg
ln -s ~/.local/share/ffmpeg-downloader/ffmpeg/ffprobe ~/PATH/its_android17_env/bin/ffprobe

  10. التحقّق من الحِزم المثبَّتة

    pip freeze

  11. (اختياري) أمر لإيقاف البيئة:

    deactivate

مَشاهد جديدة أو معدَّلة

يقدّم Android 17 المشاهد التالية:

منظر الوصف
gen2_chart مشهد جديد يستخدم test_chart_gen2 مخططًا ورقيًا بدلاً من مشاهد الجهاز اللوحي لتحسين اتساق الاختبار وموثوقيته . يتم استخدام test_chart_gen2 أيضًا في scene_ip.
wide_gamut مشهد جديد للأجهزة اللوحية التي تتوافق مع التدرّج اللوني الواسع
3 يستخدم علامات ArUco لرصد الرسوم البيانية من أجل تحسين السرعة والموثوقية. يستوعب هذا التغيير النطاق الأوسع لمجال الرؤية والمسافات التي يتم رصدها في اختبار الكاميرا المقرّبة. يؤدي استخدام العلامات إلى تجاوز منطق تحديد الحجم الحالي ومشاكل أداة التحسين. لمزيد من المعلومات، يُرجى الاطّلاع على scene3.
flash يمكن إجراء الاختبارات باستخدام منصة Gen2.

الفحوصات الجديدة

يقدّم Android 17 الاختبارات التالية:

منظر اسم الاختبار الوصف
gen2_chart test_tonemap_sequence تتحقّق هذه السمة من تطبيق المَعلمة android.tonemap.mode بشكلٍ صحيح على التوزيع المنتظم وغير المنتظم.
ip test_jca_jpegr_ip تتحقّق هذه الحالة من أنّ الفرق في توازن اللون الأبيض بين معاينة JPEG_R JCA والصور الملتقطة يقع ضمن الحدّ المحدّد.
wide_gamut test_display_p3 تتحقّق هذه السمة مما إذا كان ناتج JPEG بتنسيق P3 يتضمّن ملف ICC شخصي مناسبًا ويحتوي على أكثر من 1% من الألوان خارج نطاق ألوان sRGB.

الاختبارات التي تمت إعادة هيكلتها

في Android 17، تم إعادة تصميم الاختبارات التالية لزيادة تغطية الاختبارات وتجميعها بشكل أكثر منطقية:

منظر اسم الاختبار الوصف
1_2 tests_param_tonemap_mode تم إيقاف الإصدار scene1_2 من اختبار tests_param_tonemap_mode نهائيًا، ولا يتم استخدامه إلا على الأجهزة التي تعمل بالإصدار 16 من نظام التشغيل Android أو إصدار أقدم.
1_2 test_tonemap_sequence يتم استخدام إصدار scene1_2 من اختبار test_tonemap_sequence فقط على الأجهزة التي تعمل بالإصدار 16 من نظام التشغيل Android أو الإصدارات الأقدم.
2_b test_yuv_jpeg_capture_sameness يتم تقليل الحد الأدنى لفرق RMS للمساعدة في ضمان الإبلاغ عن حالات عدم تطابق الألوان المرتبطة بدرجة اللون على أنّها حالات تعذُّر كلما أدّت إلى اختلاف مرئي للمستخدم.
3 test_edge_enhancement يستخدم علامات ArUco للتحقّق من كلّ من الوجود والاتجاه. توفّر هذه الطريقة رصدًا ثابتًا للكاميرات، بدءًا من الكاميرا ذات الزاوية الواسعة جدًا (UW) وصولاً إلى تطبيقات التقريب البعيد.
3 test_flip_mirror يستخدم علامات ArUco للتحقّق من كلّ من الوجود والاتجاه. لا يتم منح الحالة PASS إلا إذا تم رصد جميع العلامات ومحاذاتها بشكل صحيح. يتعذّر الاختبار في حال إزاحة الرسوم البيانية أو تدويرها.
3 test_landscape_to_portrait تحميل الرسم البياني scene3 المعدَّل مع علامات ArUco
3 test_lens_movement_report يستخدم علامات ArUco للتحقّق من كلّ من الوجود والاتجاه. توفّر هذه الطريقة رصدًا ثابتًا للكاميرات، بدءًا من الكاميرا ذات الزاوية الواسعة جدًا (UW) وصولاً إلى تطبيقات التقريب البعيد.
4 test_multi_camera_alignment تتخطى الاختبار إذا كان الجهاز يحتوي على كاميرا واحدة فقط ذات زاوية عريضة وكاميرا واحدة فائقة التقريب.
flash test_auto_flash تعديل الاختبار للتحقّق من أنّ الفلاش يعمل بشكل سليم عند مستويات تكبير/تصغير مختلفة
ip test_default_jca_ip تفرض عمليات التحقّق الحالية: اختلاف السطوع واختلاف توازن اللون الأبيض وعدم تطابق مجال الرؤية. تضيف هذه السمة عملية التحقّق not_yet_mandated من اختلاف عرض الألوان بين تطبيق الكاميرا التلقائي وعمليات الالتقاط باستخدام JCA.

أنشطة الاختبار المنفصلة

في Android 17، لإجراء اختبارات متوازية على أجهزة منفصلة، يتم تقسيم اختبارات ITS للكاميرا إلى نشاطَين في CTS Verifier، هما Camera ITS Test وCamera ITS Sensor Fusion Rig Test. يحتوي النشاط Camera ITS Sensor Fusion Rig Test على المشهدَين feature_combination و sensor_fusion، ويمكن تشغيله بشكل منفصل في جهاز اختبار دمج البيانات الحسية. يوضّح الجدول التالي المشاهد المضمّنة في كل نشاط.

النشاط المشاهد الوصف
Camera ITS Test ‫gen2_chart، وscene0، وscene1_1، scene1_2، وscene1_3، وscene2_a، scene2_b، وscene2_c، وscene2_d، scene2_e، وscene2_f، وscene2_g، scene3، وscene4، وscene5، scene6، وscene8، وscene9، scene_flash، وscene_hdr، وscene_ip، scene_low_light، وscene_video، وwide_gamut المَشاهد التي يتم تشغيلها في جهاز اختبار ITS-in-a-box للكاميرا و جهاز اختبار Gen2
Camera ITS Sensor Fusion Rig Test feature_combination، sensor_fusion المشاهد التي يتم تشغيلها في جهاز اختبار دمج المستشعرات

الاختبارات المتوقّفة نهائيًا

في Android 17، سيتم إيقاف الاختبارات التالية نهائيًا لأنّ وظيفة الاختبار مشمولة باختبارات أخرى:

منظر اسم الاختبار الوصف
sensor_fusion test_video_stabilization تم إيقاف هذا الاختبار نهائيًا. استخدِم test_video_stabilization_jca بدلاً من ذلك.

تحديثات Gen2 rig

تم نقل الاختبارات التالية إلى منصة Gen2 في Android 17:

منظر اسم الاختبار الوصف
7 test_multi_camera_switch تم نقل الاختبار إلى إعدادات منصة الاختبار من الجيل الثاني لاستخدام مخطط الجيل الثاني في عمليات التحقّق من "التعرّض التلقائي" و"توازن اللون الأبيض التلقائي". يحلّ هذا الانتقال محلّ الاستهداف المستند إلى الأجهزة اللوحية باستخدام لوحات عرض فعلية للتخلص من تأثيرات التداخل وتقديم بيئة اختبار أكثر استقرارًا وقابلة للتكرار.
flash all tests تم نقل اختبارات scene_flash في منصة gen2. يمكن للمستخدمين إجراء هذه الاختبارات في بيئة جهاز دمج البيانات الحسية أو بيئة جهاز Gen2.
sensor_fusion all tests تم نقل اختبارات sensor_fusion إلى جهاز الاختبار من الجيل الثاني. يمكن للمستخدمين إجراء هذه الاختبارات في بيئة منصة دمج المستشعرات أو منصة Gen2.

قبل تشغيل الاختبارات التي تم نقلها، ثبِّت مخطط Gen2 rig الذي تم تقديمه في Android 17. يتيح لك الرسم البياني الجديد إجراء جميع اختبارات دمج البيانات الحسية في منصة Gen2. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد الرسم البياني للاختبار.

حالة الاختبار الجديدة: اجتياز*

يقدّم الإصدار 17 حالة الاختبار PASS* لرصد الاختبارات التي اجتازت الحد الأدنى من المتطلبات. لمزيد من المعلومات، يُرجى الاطّلاع على الاختبارات التي اجتازت الحد الأدنى من المتطلبات (حالة الاختبار PASS*).

تحسينات على تغيير حجم الرسوم البيانية

يضيف الإصدار 17 من نظام التشغيل Android المَعلمة chart_scaling في config.yml لـ TEST_BED_TABLET_SCENES من أجل معالجة مشاكل تغيير حجم الرسم البياني مع أجهزة الكاميرا المقرّبة ذات مجال الرؤية الأوسع. لمزيد من المعلومات، اطّلِع على تحسينات على تغيير حجم الرسم البياني: المَعلمة chart_scaling.

جهاز لوحي جديد متوافق مع اختبارات التدرّج اللوني الواسع

في الإصدار 17 من نظام التشغيل Android والإصدارات الأحدث، تم إدراج جهاز Samsung Galaxy Tab S10 FE (طرازَي Wi-Fi و5G) في قائمة الأجهزة اللوحية المسموح بها. تمت الموافقة على استخدام جهاز Samsung Galaxy Tab S10 FE لعرض مخططات الاختبار ذات التدرج اللوني الواسع، بالإضافة إلى جميع المشاهد الأخرى المستندة إلى الأجهزة اللوحية. للتأكّد من أنّ جهازك مدرَج في القائمة المسموح بها، استخدِم الأمر adb shell getprop ro.product.device للتأكّد من أنّ معرّف المنتج يتطابق مع القيمة المدرَجة في القائمة التالية.

    'gts10fewifi',  # Samsung Galaxy Tab S10 FE
    'gts10fe',  # Samsung Galaxy Tab S10 FE 5G

إرسال النتائج المجمّعة للموافقة على الإصدارات

يقدّم الإصدار 17 من نظام التشغيل Android عملية لإرسال نتائج اختبارات Camera ITS المجمّعة للموافقة على الإصدار باستخدام حزمة APK المعدَّلة من CTS Verifier.

يوفّر نظام التجميع الجديد التحسينات التالية:

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

لمزيد من المعلومات، راجِع مقالة إرسال نتائج الاختبارات المجمّعة.