إعداد الاختبار الآلي لبرنامج CTS

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

إعداد البيئة المادية

تتطلّب بعض اختبارات CTS استخدام أجهزة خارجية يتم إعدادها بالقرب من جهاز DUT. لإعداد البيئة المادية:

  1. (اختياري) إذا كان جهاز التحقّق من الأداء متوافقًا مع تقنية Bluetooth LE، ضَع ثلاثة علامات بث إشارة Bluetooth LE على الأقل على مسافة 5 أمتار من جهاز التحقّق من الأداء لاختبار ميزة البحث عن الأجهزة التي تتضمّن تقنية Bluetooth LE. علاوةً على ذلك:

    • ولا يلزم ضبط إشارات البث أو بث أي إشارات محدّدة.
    • يمكن أن تكون العلامات من أي نوع، بما في ذلك iBeacon أو Eddystone أو حتى الأجهزة التي تحاكي علامات BLE.

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

    • يجب أن يكون المشهد مزوّدًا بإضاءة كافية للسماح لأجهزة الاستشعار التي يتم اختبارها بالوصول إلى الحد الأقصى من عدد اللقطات المستهدَفة في الثانية (FPS) الذي تم ضبطه والبقاء عليه كما هو موضح في CONTROL_AE_TARGET_FPS_RANGE.
    • ينطبق هذا الإعداد على جميع أدوات استشعار الكاميرا التي أبلغ عنها getCameraIdList أثناء تكرار الاختبار على الأجهزة المدرَجة وقياس الأداء بشكل فردي.
    • إذا كان جهاز DUT متوافقًا مع الكاميرات الخارجية، مثل كاميرات الويب USB، عليك توصيل كاميرا خارجية عند تشغيل CTS. وفي حال عدم استيفاء هذه المتطلبات، ستتعذّر اختبارات CTS.

  3. (اختياري) إذا كان جهاز DUT متوافقًا مع نظام تحديد المواقع العالمي (GPS) أو أي نظام آخر لتحديد المواقع الجغرافية عبر الأقمار الصناعية (GNSS)، يجب توفير إشارة GNSS لجهاز DUT بمستوى إشارة مناسب لاستقبال الإشارات وحساب الموقع الجغرافي. علاوةً على ذلك:

    • يجب أن يكون نظام تحديد المواقع العالمي (GPS) متوافقًا مع معيار ICD-GPS-200C.
    • يمكن أن تكون إشارة نظام تحديد المواقع العالمي (GNSS) من أي نوع، بما في ذلك جهاز محاكاة الأقمار الصناعية أو جهاز تكرار الإشارات الخارجية.
    • يمكنك وضع جهاز DUT بالقرب من نافذة حتى يتمكّن من تلقّي إشارة GNSS مباشرةً من أحد الأقمار الصناعية.

  4. تأكَّد من أنّ شبكة Wi-Fi متوافقة مع بروتوكولَي IPv4 وIPv6، وأنّها متصلة بالإنترنت باستخدام نظام أسماء النطاقات لبروتوكولَي IPv4 وIPv6، وأنّها متوافقة مع ميزة الإرسال المتعدد عبر بروتوكول IP، وأنّها يمكنها التعامل مع جهاز DUT على أنّه عميل معزول.

    إذا لم يكن بإمكانك الوصول إلى شبكة IPv6 أصلية أو شبكة مشغّل شبكة الجوّال التي تستخدم IPv6 أو VPN لاجتياز اختبارات IPv6، استخدِم نقطة اتصال Wi-Fi ونفق IPv6.

  5. تأكَّد من ضبط علامات UP وBROADCAST وMULTICAST في واجهة Wi-Fi على جهاز التحقّق من الأداء.

  6. تأكَّد من أنّ واجهة Wi-Fi قد تم إسناد عناوين IPv4 وIPv6 إليها. للتحقّق من خصائص واجهة Wi-Fi، شغِّل adb shell ifconfig.

  7. (اختياري) إذا كان جهاز DUT يتيح التشغيل المتزامن لوحدة التحكّم في حدود الجلسة (STA) أو نقطة الوصول (AP) في شبكة Wi-Fi، عليك إعداد شبكتَي Wi-Fi على الأقل. يجب أن تعمل شبكات Wi-Fi هذه على نطاقات مختلفة باستخدام معرّفات SSID مختلفة أو على معرّف SSID نفسه باستخدام معرّفات BSSID مختلفة.

  8. (اختياري) إذا كان جهازك النموذجي يتيح قياس وقت الرحلة ذهابًا وإيابًا عبر شبكة Wi-Fi (RTT)، يمكنك إعداد جهاز يتيح قياس وقت الرحلة ذهابًا وإيابًا عبر شبكة Wi-Fi:

    1. ضَع جهاز RTT عبر Wi-Fi على مسافة 12.2 متر من جهاز DUT.
    2. شغِّل جهاز Wi-Fi RTT.

    في ما يلي جهازان مقترَحان يتيحان قياس وقت استجابة Wi-Fi: - Google Wifi - نقطة وصول fitlet2 من Compulab (تم ضبطها على عرض نطاق 40 ميغهرتز بتردد 5 غيغاهرتز).

إعداد جهاز الكمبيوتر المكتبي

قبل إجراء الاختبارات المبرمَجة لاختبار التوافق، تأكَّد من أنّ الكمبيوتر المكتبي يستوفي متطلبات المكونات المادية ونظام التشغيل وأنّه تم تثبيت البرامج المناسبة عليه، كما هو موضّح في الأقسام التالية.

متطلبات أجهزة Meet

يجب أن يستوفي جهاز الكمبيوتر المكتبي المخصّص لخدمة مراقبة الأداء المتطلبات التالية للأجهزة أو يتجاوزها:

  • نظام x86‏ 64 بت

  • ‫256 غيغابايت على الأقل من المساحة الفارغة على القرص لاستيعاب العدد المتزايد من حالات اختبار CTS وزيادة في حجز مساحة ذاكرة Java في Tradefed

  • ذاكرة وصول عشوائي (RAM) بسعة 32 غيغابايت على الأقل

استيفاء متطلبات نظام التشغيل

يجب أن يعمل جهاز التطوير بإصدار 64 بت من توزيعة Linux مع مكتبة GNU C (glibc) 2.17 أو إصدار أحدث.

تثبيت برنامج الكمبيوتر المكتبي

لتثبيت برنامج سطح المكتب المناسب لخدمة CTS:

  1. ثبِّت الإصدار 5.1.3 من حزمة FFmpeg أو إصدار أحدث.

  2. ثبِّت أحدث إصدارَين من Android Debug Bridge (adb) وAndroid Asset Packaging Tool (AAPT2) وأضِف موقع هذين الأداتَين إلى مسار النظام على جهازك:

    1. اتّبِع التعليمات الواردة في بداية مستندات مدير حزمة تطوير البرامج (SDK) لتثبيت أداة سطر الأوامر sdkmanager. يمكنك العثور على رابط تنزيل أدوات سطر الأوامر في قسم أدوات سطر الأوامر فقط في أسفل صفحة تنزيل استوديو Android.
    2. عدِّل مسار النظام لتضمين موقع الإضافة التي تم تثبيتها حديثًا sdkmanager.
    3. باستخدام sdkmanager، ثبِّت أحدث حِزم platform-tools و build-tools. تحتوي هذه الحِزم على adb وAAPT2. للحصول على معلومات حول تثبيت الحِزم، يُرجى الاطّلاع على تثبيت الحِزم.
    4. عدِّل المسار ليشمل موقع أداتَيadb وAAPT2 المثبَّتتين حديثًا.
    5. تأكَّد من أنّ adb وAAPT2 متوفّران في مسارك.

  3. ثبِّت الإصدار المناسب من حزمة تطوير Java (JDK):

    • بالنسبة إلى Android 11 أو الإصدارات الأحدث، ثبِّت JDK 11.
    • بالنسبة إلى الإصدار 10 من نظام التشغيل Android أو الإصدارات الأقدم، يُرجى الاطّلاع على إعداد CTS (AOSP 10 أو الإصدارات الأقدم).

  4. (اختياري) في نظام التشغيل Android 13 أو الإصدارات الأحدث، ثبِّت virtualenv. يجب استخدام أداة virtualenv لإجراء الاختبارات على أجهزة متعددة.

  5. للتأكّد من تثبيت Python، اكتب python3. من المفترض أن يظهر إصدار Python و تاريخه، ما يشير إلى أنّه تم تثبيت Python بشكل صحيح.

  6. نزِّل حِزم CTS وافتحها من عمليات تنزيل مجموعة أدوات اختبار التوافق التي تتطابق مع إصدار Android على أجهزتك وجميع واجهات التطبيق الثنائي (ABI) التي تتوافق مع أجهزتك.

  7. نزِّل أحدث إصدار من ملفات وسائط CTS وافتحه. تتضمّن ملفات الوسائط مقاطع فيديو من Big Buck Bunny، وهي محمية بموجب حقوق الطبع والنشر التي تملكها مؤسسة Blender بموجب ترخيص المشاع الإبداعي 3.0 مع نسب العمل إلى مؤلفه.

  8. (اختياري) عند تشغيل CTS لأول مرة، يتم تنزيل بعض ملفات CTS ذات الصلة بالإصدار الرئيسي ديناميكيًا. تضيف عملية التنزيل هذه 10 دقائق أو أكثر إلى مدة تشغيل CTS، وذلك استنادًا إلى سرعة الشبكة.

    لتجنُّب وقت التشغيل الإضافي لبرنامج CTS، يمكنك تنزيل ملفات CTS المرتبطة بـ Mainline قبل تشغيل CTS. للحصول على معلومات عن تنزيل ملفات CTS المتعلقة بالإصدار الرئيسي، يُرجى الاطّلاع على مقالة تنزيل ملفات CTS المتعلقة بالإصدار الرئيسي.

تجهيز جهاز DUT

بعد إعداد جهاز الكمبيوتر المكتبي، عليك إعداد جهاز DUT وضبط إعداداته.

إعداد جهاز DUT

لإعداد جهاز DUT:

  1. تأكَّد من أنّ جهاز DUT يعمل بإصدار نظام يستند إلى الإصدار المتوافق المعروف لمستخدمي الجهاز (Android 4.0 أو إصدار أحدث) من الأسماء الرمزية والعلامات وأرقام الإصدار ويستخدم خيار الإصدار user. لمزيد من المعلومات عن الأسعار المتغيرة للإصدار، يُرجى الاطّلاع على مقالة اختيار هدف.

  2. إذا كان جهاز DUT يعمل بنظام التشغيل Android 13 أو إصدار أحدث، تأكَّد من أنّ الإصدار يحتوي على ro.product.first_api_level تم ضبطه على مستوى واجهة برمجة التطبيقات الذي تم طرح الجهاز تجاريًا به. لضبط هذه القيمة، عليك إجراء التغيير التالي على ملف device.mk:

    PRODUCT_SHIPPING_API_LEVEL := 21

    تعتمد بعض متطلبات CTS على الإصدار الذي تم شحنه مع الجهاز في الأساس. على سبيل المثال، قد يتم استبعاد الأجهزة التي يتم شحنها في الأصل مع إصدارات سابقة من متطلبات النظام التي تنطبق على الأجهزة التي يتم شحنها مع إصدارات لاحقة. للاطّلاع على قيم صالحة لمستوى واجهة برمجة التطبيقات، اطّلِع على الأسماء الرمزية والعلامات وأرقام الإصدار. لمزيد من المعلومات عن ro.product.first_api_level، يُرجى الاطّلاع على مستوى Vendor API.

    بالنسبة إلى الإصدار 10 من نظام التشغيل Android أو الإصدارات الأقدم، يُرجى الاطّلاع على مقالة إعداد CTS (AOSP 10 أو الإصدارات الأقدم).

  3. إذا كان جهازك يتيح إدارة حِزم APEX:

    1. نزِّل حزمة APEX shim لإصدار Android وبنية الأجهزة المحدّدة. يقدّم العمودان الأيمنان في جدول حِزم الحشو روابط إلى الحزمة التي تريد تنزيلها.
    2. انسخ الحزمة التي تم تنزيلها إلى /system/apex.
    3. أعِد تسمية الملف باسم com.android.apex.cts.shim.apex.

  4. إذا كان جهازك لا يتيح إدارة حِزم APEX:

    1. نزِّل حِزم APEX shim لإصدار Android و بنية الأجهزة المحدّدة. يقدّم العمودان الأيمنان في جدول حِزم الحشو روابط إلى الحِزم التي يجب تنزيلها.
    2. نسخ CtsShim.apk إلى /system/app/
    3. إعادة تسمية CtsShim.apk إلى CtsShimPrebuilt.apk
    4. نسخ CtsShimPriv.apk إلى /system/priv-app/
    5. إعادة تسمية CtsShimPriv.apk إلى CtsShimPrivPrebuilt.apk

  5. إذا أبلغ جهازك عن أكثر من عنصر آمن واحد:

    1. نزِّل google-cardlet.cap.
    2. انسخ الملف الذي تم تنزيله إلى /data/uicc/cardlets/.

  6. إذا أبلغ جهازك عن أكثر من عنصر آمن واحد، ثبِّت التطبيق المصغّر النموذجي في العنصر الآمن المضمّن (eSE) لوحدة التحكّم في البيانات (DUT) أو في شريحة SIM التي تستخدمها وحدة التحكّم في البيانات (DUT). لمزيد من المعلومات، يُرجى الاطّلاع على اختبار CTS للعنصر الآمن.

  7. إذا لم يكن جهازك مزوّدًا بشاشة مدمجة، عليك توصيل شاشة بالجهاز.

  8. إذا كان الجهاز يحتوي على فتحة لبطاقة ذاكرة، وصِّل بطاقة SD فارغة. استخدِم بطاقة SD متوافقة مع ناقل سرعة فائقة (UHS) بسعة SDHC أو SDXC أو بطاقة من فئة السرعة 10 أو أفضل لضمان اجتياز اختبار CTS.

  9. إذا كان الجهاز يتضمّن فتحات شرائح SIM، عليك توصيل شريحة SIM مفعّلة في كل فتحة. إذا كان الجهاز متوافقًا مع الرسائل القصيرة، يجب ملء حقل رقم الهاتف الخاص بكل شريحة SIM. بالنسبة إلى الأجهزة التي تعمل بنظام التشغيل Android 12 أو إصدار أحدث، يجب أن تكون جميع شرائح SIM متوافقة مع ميزة تخزين أرقام الاتصال المختصرة (ADN). تستوفي بطاقات GSM وUSIM التي تتضمّن الملف المخصّص للاتصالات السلكية واللاسلكية (DFTelecom) هذا المتطلب.

  10. تأكَّد من أنّ جهازك يحتوي على شريحة SIM تتضمّن امتيازات مشغّل شبكة الجوّال CTS التي تستوفي المتطلبات المحدّدة في إعداد شريحة UICC.

ضبط جهاز DUT

اتّبِع الخطوات التالية لضبط جهاز DUT لاستخدامه مع CTS.

على جهاز DUT:

  1. إعادة ضبط الجهاز على الإعدادات الأصلية

  2. اضبط لغة الجهاز على الإنجليزية (الولايات المتحدة).

  3. إذا كان الجهاز يتيح تخصيص الخطوط التلقائية، تأكَّد من ضبط مجموعة الخطوط التلقائية sans-serif على Roboto.

  4. إذا كان الجهاز يتضمّن ميزة نظام تحديد المواقع العالمي (GPS) أو شبكة Wi-Fi أو شبكة الجوّال، فعِّل إعدادات الموقع الجغرافي.

  5. يجب الاتصال بشبكة Wi-Fi متوافقة مع IPv6، ويمكنها التعامل مع جهاز DUT كعميل معزول، ويجب أن تكون متصلة بالإنترنت. للحصول على شرح للعملاء المعزولين، يُرجى الاطّلاع على مقالة إعداد البيئة المادية.

  6. تأكَّد من عدم ضبط نقش قفل أو كلمة مرور.

  7. تفعيل ميزة "تصحيح أخطاء الجهاز عبر USB":

    1. انتقِل إلى الإعدادات > لمحة عن الهاتف وانقر على رقم الإصدار سبع مرات. تظهر خيارات المطوّرين ضمن فئة إعدادات النظام.

    2. انقر على تصحيح أخطاء الجهاز عبر USB.

    لتفعيل وضع تصحيح أخطاء USB على الإصدار 10 من نظام التشغيل Android أو الإصدارات الأقدم، يُرجى الاطّلاع على مقالة إعداد CTS (AOSP 10 أو الإصدارات الأقدم).

  8. اضبط الوقت على تنسيق 12 ساعة.

  9. فعِّل خيارات المطوّرين > إبقاء الشاشة مُستيقظة.

  10. لإيقاف ميزة "التحقق من التطبيقات" عبر USB، اتّبِع الخطوات التالية:

    1. انتقِل إلى خيارات المطوّرين.

    2. انقر على التحقق من التطبيقات عبر USB.

  11. في الإصدار 13 من Android أو الإصدارات الأحدث، فعِّل وضع "المودم الوهمي":

    1. انتقِل إلى خيارات المطوّرين.

    2. انقر على السماح بخدمة مودم وهمي.

    هذا الإعداد مطلوب لإجراء اختبارات هاتفية معيّنة.

على جهاز الكمبيوتر المكتبي:

  1. افتح المتصفّح وأغلق أي شاشة بدء تشغيل أو إعداد.

  2. وصِّل جهاز DUT بالكمبيوتر المكتبي باستخدام كابل USB.

  3. إذا طلب منك النظام قبول مفتاح RSA للسماح بتصحيح الأخطاء من خلال هذا الكمبيوتر، انقر على السماح بتصحيح أخطاء USB.

  4. اضبط Roboto2 كخط نصي بدون خطوط مُسنّنة باستخدام ميزة يمكن للمستخدم الوصول إليها (وليست مخفية).

  5. نسخ ملفات الوسائط الخاصة باختبار CTS إلى جهاز DUT:

    1. انتقِل (cd) إلى المسار الذي تم فيه تنزيل ملفات الوسائط و فك ضغطها.

    2. تغيير أذونات الملف:

      chmod u+x copy_media.sh

    3. نسخ الملفات:

      • لنسخ المقاطع بدرجة دقة تصل إلى 720×480، نفِّذ ما يلي:

        ./copy_media.sh 720x480

      • إذا لم تكن متأكدًا من الحد الأقصى للدقة، انسخ جميع الملفات:

        ./copy_media.sh all

      • إذا كانت هناك أجهزة DUT متعددة، أضِف خيار الرقم التسلسلي (-s) لجهاز معيّن في النهاية. على سبيل المثال، لنسخ ما يصل إلى 720×480 إلى الجهاز الذي يحمل الرقم التسلسلي 1234567، يمكنك تنفيذ ما يلي:

        ./copy_media.sh 720x480 -s 1234567

تنزيل ملفات CTS ذات الصلة بإصدار Mainline

لتنزيل ملفات CTS ذات الصلة بإصدار Mainline:

  1. يمكنك الحصول على مستوى واجهة برمجة تطبيقات Android على الجهاز من خلال تنفيذ:

    adb shell getprop ro.build.version.sdk

  2. اتّبِع التعليمات الواردة في نص download_mcts.sh لتنزيل ملفات CTS الرئيسية.

    تستغرق عملية التنزيل 10 دقائق على الأقل، وذلك استنادًا إلى سرعة الشبكة.

حِزم الحشو

يسرد الجدول التالي الحِزم المتاحة لكل إصدار جهاز وبنية:

إصدار الجهاز الحِزم (إذا كانت حِزم APEX متاحة) الحِزم (إذا لم تكن حِزم APEX متاحة)
تفعيل جهاز الإنذار x86 تفعيل جهاز الإنذار x86
Android 15 15-arm-release android15-x86-release android15-arm-CtsShim.apk

android15-arm-CtsShimPriv.apk

 android15-x86-CtsShim.apk

android15-x86-CtsShimPriv.apk
Android 14 android14-arm-release android14-x86-release android14-arm-CtsShim.apk

android14-arm-CtsShimPriv.apk

 android14-x86-CtsShim.apk

android14-x86-CtsShimPriv.apk
Android 13 android13-arm-release android13-x86-release android13-arm-CtsShim.apk

android13-arm-CtsShimPriv.apk

 android13-x86-CtsShim.apk

android13-x86-CtsShimPriv.apk
Android 12 android12-arm-release android12-x86-release android12-arm-CtsShim.apk

android12-arm-CtsShimPriv.apk

 android12-x86-CtsShim.apk

android12-x86-CtsShimPriv.apk
Android 11 android11-arm-release android11-x86-release android11-arm-CtsShim.apk

android11-arm-CtsShimPriv.apk

 android11-x86-CtsShim.apk

android11-x86-CtsShimPriv.apk
Android 10 android10-release android10-arm-CtsShim.apk

android10-arm-CtsShimPriv.apk

 android10-x86-CtsShim.apk

android10-x86-CtsShimPriv.apk
الإصدار 9 من Android والإصدار O والإصدار O-MR1 لا ينطبق لا ينطبق arm-CtsShim.apk

arm-CtsShimPriv.apk

 x86-CtsShim.apk

x86-CtsShimPriv.apk

ما هي الخطوات التالية؟

بعد قراءة هذا المستند، يمكنك المتابعة إلى تشغيل اختبارات CTS المبرمَجة.