اعتبارًا من عام 2026، ولضمان اتّساق نموذج التطوير الثابت الأساسي واستقرار المنصة في النظام المتكامل، سننشر رمز المصدر في مشروع Android مفتوح المصدر (AOSP) في الربعَين الثاني والرابع. لبناء مشروع Android مفتوح المصدر والمساهمة فيه، استخدِم android-latest-release. سيشير فرع بيان android-latest-release دائمًا إلى أحدث إصدار تم نشره في مشروع Android مفتوح المصدر. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android مفتوح المصدر.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

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

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

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

تثبيت Python 3.12 وpython3-venv

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

التأكّد من تثبيت Python
```
python3.12 --version
```

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

sudo apt-get update
sudo apt install python3-pip

إنشاء بيئة افتراضية
```
python3.12 -m venv its_android17_env
```
تفعيل البيئة الافتراضية
```
source its_android17_env/bin/activate
```

إنشاء 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

تثبيت الحِزم المُدرَجة في its_android17_env.txt
```
pip install -r its_android17_env.txt
```
تثبيت الإصدار 7.0.2 من FFmpeg باستخدام أداة تنزيل FFmpeg
```
pip install ffmpeg-downloader
ffdl install 7.0.2
```
(اختياري) إذا لم تنجح أداة تنزيل FFmpeg، يمكنك تنزيل الإصدار 7.0.2 من مصدر على الإنترنت.
التأكّد من تثبيت الإصدار 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
```
التأكّد من الحِزم المثبَّتة
```
pip freeze
```
(اختياري) أمر لإيقاف البيئة:
```
deactivate
```

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

يقدّم الإصدار 17 من Android المشاهد التالية:

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

اختبارات جديدة

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

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

اختبارات تم تعديلها

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

منظر	اسم الاختبار	الوصف
`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`	تم تقليل الحدّ الأقصى للفرق في الجذر التربيعي لمتوسط المربعات للمساعدة في ضمان وضع علامة على التناقضات اللونية المرتبطة بدرجة اللون كإخفاقات متى ما أدّت إلى اختلاف مرئي للمستخدم.
`3`	`test_edge_enhancement`	يستخدم علامات ArUco للتحقّق من كلّ من وجودها واتجاهها. توفر هذه الطريقة رصدًا ثابتًا للكاميرات من الكاميرا ذات الزاوية الواسعة جدًا إلى تطبيقات الكاميرا المقربة.
`3`	`test_flip_mirror`	يستخدم علامات ArUco للتحقّق من كلّ من وجودها واتجاهها. لا يتم منح الحالة `PASS` إلا إذا تم رصد جميع العلامات ومحاذاتها بشكلٍ صحيح. يفشل الاختبار في حال كانت الرسوم البيانية مُزاحة أو مُدارة.
`3`	`test_landscape_to_portrait`	يتم تحميل الرسم البياني المعدَّل scene3 باستخدام علامات ArUco.
`3`	`test_lens_movement_report`	يستخدم علامات ArUco للتحقّق من كلّ من وجودها واتجاهها. توفر هذه الطريقة رصدًا ثابتًا للكاميرات من الكاميرا ذات الزاوية الواسعة جدًا إلى تطبيقات الكاميرا المقربة.
`4`	`test_multi_camera_alignment`	يتم تخطّي الاختبار إذا كان الجهاز يتضمّن كاميرا واحدة ذات زاوية واسعة وكاميرا مقرّبة فائقة واحدة فقط.
`flash`	`test_auto_flash`	يتم تعديل الاختبار للتحقّق من أنّ الفلاش يعمل بشكلٍ سليم بمستويات تكبير مختلفة.
`ip`	`test_default_jca_ip`	يفرض عمليات التحقّق الحالية: الفرق في السطوع والفرق في توازن اللون الأبيض وعدم تطابق مجال الرؤية. يضيف عملية تحقّق `not_yet_mandated` للفرق في عرض الألوان بين تطبيق الكاميرا التلقائي وعمليات التقاط JCA.

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

في الإصدار 17 من Android، ولإجراء اختبار متوازٍ على أجهزة منفصلة، يتم فصل اختبارات Camera 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`	المشاهد التي يتم تشغيلها في منصة اختبار Camera ITS-in-a-box و منصة اختبار Gen2.
`Camera ITS Sensor Fusion Rig Test`	`feature_combination` و`sensor_fusion`	المشاهد التي يتم تشغيلها في منصة اختبار دمج المستشعرات.

اختبارات تم إيقافها نهائيًا

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

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

تعديلات منصة Gen2

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

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

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

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

يقدّم الإصدار 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 (التي تم جمعها من عمليات اختبار أو أجهزة مختلفة) في عملية إرسال موحّدة واحدة.

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