قبل تنفيذ اختبارات CTS المبرمَجة، عليك إعداد بيئتك المادية وإعداد محطة العمل وضبط الجهاز الذي تختبره.
إعداد البيئة المادية
تتطلّب بعض اختبارات CTS استخدام أجهزة خارجية يتم إعدادها بالقرب من الجهاز الخاضع للاختبار (DUT). لإعداد بيئتك المادية، اتّبِع الخطوات التالية:
إذا كان الجهاز قيد الاختبار يتيح استخدام بلوتوث منخفض الطاقة، ضَع ثلاثة منارات بلوتوث منخفض الطاقة على الأقل على بُعد 5 أمتار من الجهاز قيد الاختبار لإجراء اختبارات فحص بلوتوث منخفض الطاقة. علاوةً على ذلك:
- ولا تحتاج إلى ضبط إعدادات الإشارات أو إصدار أي شيء محدّد.
- يمكن أن تكون إشارات البلوتوث من أي نوع، بما في ذلك iBeacon أو Eddystone أو حتى الأجهزة التي تحاكي إشارات البلوتوث المنخفض الطاقة.
ضَع الجهاز قيد الاختبار أمام مشهد، مثل جدار أو سقف، على مسافة تعادل الحد الأدنى لمسافة التركيز في الجهاز قيد الاختبار. علاوةً على ذلك:
- يجب أن يتوفّر في المشهد إضاءة كافية للسماح لأجهزة الاستشعار الخاضعة للاختبار بالوصول إلى الحد الأقصى لعدد اللقطات المستهدفة في الثانية (FPS) الذي تم ضبطه والبقاء عنده، وذلك على النحو المحدّد في
CONTROL_AE_TARGET_FPS_RANGE. - ينطبق هذا الإعداد على جميع أجهزة استشعار الكاميرا التي تعرضها
getCameraIdList، وذلك أثناء تكرار الاختبار على الأجهزة المدرَجة وقياس الأداء بشكل فردي. - إذا كان الجهاز قيد الاختبار يتوافق مع الكاميرات الخارجية، مثل كاميرات الويب التي تعمل عبر USB، وصِّل كاميرا خارجية عند تشغيل مجموعة اختبار التوافق (CTS). وفي حال عدم توفّرها، ستتعذّر اختبارات CTS.
- يجب أن يتوفّر في المشهد إضاءة كافية للسماح لأجهزة الاستشعار الخاضعة للاختبار بالوصول إلى الحد الأقصى لعدد اللقطات المستهدفة في الثانية (FPS) الذي تم ضبطه والبقاء عنده، وذلك على النحو المحدّد في
إذا كان الجهاز قيد الاختبار يتوافق مع نظام تحديد المواقع العالمي (GPS) أو أي نظام آخر من أنظمة الملاحة العالمية عبر الأقمار الصناعية (GNSS)، يجب توفير إشارة GNSS للجهاز قيد الاختبار بمستوى إشارة مناسب للاستقبال واحتساب الموقع الجغرافي. علاوةً على ذلك:
- يجب أن يتوافق نظام تحديد المواقع العالمي (GPS) مع ICD-GPS-200C.
- يمكن أن تكون إشارة نظام GNSS من أي نوع، بما في ذلك محاكي الأقمار الصناعية أو مكرّر الإشارات الخارجية.
- يمكنك وضع الجهاز قيد الاختبار بالقرب من نافذة حتى يتمكّن من تلقّي إشارة GNSS كافية مباشرةً من أحد الأقمار الصناعية.
تأكَّد من أنّ شبكة Wi-Fi تتوافق مع IPv4 وIPv6، وأنّها تتضمّن اتصالاً بالإنترنت مع نظام أسماء النطاقات (DNS) لكل من IPv4 وIPv6، وأنّها تتوافق مع البث المتعدد عبر بروتوكول الإنترنت، ويمكنها التعامل مع الجهاز الخاضع للاختبار باعتباره عميلاً معزولاً.
إذا لم يكن لديك إمكانية الوصول إلى شبكة IPv6 أصلية أو شبكة مشغّل شبكة جوّال IPv6 أو شبكة VPN لاجتياز اختبارات IPv6، استخدِم نقطة وصول Wi-Fi ونفق IPv6.
تأكَّد من ضبط العلامات
UPوBROADCASTوMULTICASTعلى واجهة Wi-Fi في الجهاز الخاضع للاختبار.تأكَّد من أنّ واجهة Wi-Fi تتضمّن عناوين IPv4 وIPv6. للاطّلاع على خصائص واجهة Wi-Fi، شغِّل الأمر
adb shell ifconfig.إذا كان جهاز الاختبار يدعم Wi-Fi STA أو STA المتزامن، يجب إعداد شبكتَي Wi-Fi على الأقل. يجب أن تعمل شبكات Wi-Fi هذه على نطاقات مختلفة باستخدام معرّفات SSID مختلفة أو على معرّف SSID نفسه باستخدام معرّفات BSSID مختلفة.
إذا كان جهازك قيد الاختبار (DUT) يتوافق مع وقت الذهاب والعودة لشبكة Wi-Fi (RTT)، عليك إعداد جهاز يتوافق مع وقت الذهاب والعودة لشبكة Wi-Fi باتّباع الخطوات التالية:
- ضَع جهاز Wi-Fi RTT على مسافة لا تزيد عن 40 قدمًا من الجهاز قيد الاختبار.
- شغِّل جهاز Wi-Fi RTT.
في ما يلي جهازان مقترَحان يتوافقان مع تقنية Wi-Fi RTT: - Google Wifi - نقطة وصول fitlet2 من Compulab (تم ضبطها على نطاق ترددي يبلغ 40 ميغاهرتز عند 5 غيغاهرتز).
إعداد جهاز الكمبيوتر المكتبي
قبل تشغيل اختبارات CTS المبرمَجة، تأكَّد من أنّ جهاز الكمبيوتر المكتبي يستوفي متطلبات الأجهزة ونظام التشغيل وأنّه تم تثبيت البرنامج المناسب عليه، كما هو موضّح في الأقسام التالية.
متطلبات أجهزة Meet
يجب أن يستوفي جهاز الكمبيوتر المكتبي المتوافق مع CTS متطلبات الأجهزة التالية أو يتجاوزها:
نظام x86 64 بت
يجب توفّر مساحة خالية في القرص لا تقل عن 256 غيغابايت لاستيعاب العدد المتزايد من حالات اختبار CTS وزيادة مساحة حجز الذاكرة المؤقتة في Java في Tradefed
ذاكرة وصول عشوائي (RAM) بسعة 32 غيغابايت على الأقل
استيفاء متطلبات نظام التشغيل
يجب أن يعمل جهاز التطوير بنظام Linux 64 بت مع الإصدار 2.17 أو إصدار أحدث من مكتبة GNU C (glibc).
يجب ضبط لغة نظام التشغيل على "الإنجليزية" للسماح لمجموعة اختبار التوافق (CTS) بتحديد المسار بشكل صحيح.
تثبيت برنامج على الكمبيوتر
لتثبيت برنامج الكمبيوتر المناسب لنظام CTS، اتّبِع الخطوات التالية:
ثبِّت أحدث إصدارات Android Debug Bridge (adb) وأداة تجميع الموارد في Android (AAPT2) وأضِف موقع هاتين الأداتين إلى مسار النظام على جهازك:
- اتّبِع التعليمات في بداية مستندات SDK Manager
لتثبيت أداة سطر الأوامر
sdkmanager. يمكنك العثور على رابط تنزيل أدوات سطر الأوامر في قسم أدوات سطر الأوامر فقط في أسفل صفحة تنزيل استوديو Android. - عدِّل مسار النظام ليشمل موقع الأداة
sdkmanagerالتي تم تثبيتها حديثًا. - باستخدام
sdkmanager، ثبِّت أحدث حِزمplatform-toolsوbuild-tools. تحتوي هذه الحِزم على adb وAAPT2. للحصول على معلومات حول تثبيت الحِزم، يُرجى الاطّلاع على تثبيت الحِزم. - عدِّل المسار ليشمل موقع أداتَي adb وAAPT2 اللتين تم تثبيتهما حديثًا.
- تأكَّد من أنّ adb وAAPT2 متوفّران في مسارك.
- اتّبِع التعليمات في بداية مستندات SDK Manager
لتثبيت أداة سطر الأوامر
ثبِّت الإصدار المناسب من حزمة تطوير Java (JDK):
- في نظام التشغيل Android 11 أو الإصدارات الأحدث، ثبِّت JDK 11.
- على نظام التشغيل Android 10 أو الإصدارات الأقدم، يُرجى الاطّلاع على إعداد مجموعة اختبار التوافق (الإصدار 10 من نظام التشغيل Android أو الإصدارات الأقدم).
في الإصدارَين 13 و14 من نظام التشغيل Android، ثبِّت virtualenv. يجب استخدام أداة virtualenv لإجراء اختبارات على أجهزة متعددة.
للتحقّق من تثبيت Python، اكتب
python3. يجب أن يظهر إصدار Python والتاريخ للإشارة إلى أنّ Python مثبّت بشكل صحيح.نزِّل حِزم CTS وافتحها من عمليات تنزيل مجموعة أدوات اختبار التوافق التي تتوافق مع إصدار Android على أجهزتك وجميع واجهات التطبيق الثنائية (ABI) التي تتوافق معها أجهزتك.
نزِّل أحدث إصدار من ملفات الوسائط في مجموعة اختبار التوافق وافتحه. تتضمّن ملفات الوسائط مقاطع فيديو من فيلم Big Buck Bunny، وهي محمية بموجب حقوق الطبع والنشر الخاصة بمؤسسة Blender Foundation بموجب رخصة المشاع الإبداعي 3.0 مع نسب العمل إلى مؤلفه.
(اختياري) عند تشغيل CTS للمرة الأولى، يتم تنزيل بعض ملفات CTS ذات الصلة بـ Mainline بشكل ديناميكي. واستنادًا إلى سرعة الشبكة، تضيف عملية التنزيل هذه 10 دقائق أو أكثر إلى وقت تشغيل مجموعة أدوات اختبار التوافق.
لتجنُّب وقت التشغيل الإضافي هذا في مجموعة أدوات اختبار التوافق، يمكنك تنزيل ملفات مجموعة أدوات اختبار التوافق ذات الصلة بمشروع Mainline قبل تشغيل مجموعة أدوات اختبار التوافق. للحصول على معلومات حول تنزيل ملفات CTS ذات الصلة بـ Mainline، يُرجى الاطّلاع على تنزيل ملفات CTS ذات الصلة بـ Mainline.
إعداد DUT
بعد إعداد جهاز الكمبيوتر المكتبي، عليك إعداد جهاز الاختبار (DUT) وضبط إعداداته.
إعداد الجهاز الخاضع للاختبار
لإعداد الجهاز قيد الاختبار (DUT)، اتّبِع الخطوات التالية:
تأكَّد من أنّ الجهاز قيد الاختبار يعمل بصورة نظام تستند إلى إصدار المستخدم المعروف بأنّه متوافق (Android 4.0 أو إصدار أحدث) من أسماء الرموز والعلامات وأرقام الإصدارات ويستخدم تنويعة التصميم
user. لمزيد من المعلومات حول صيغ الإنشاء، يُرجى الاطّلاع على اختيار هدف.إذا كان الجهاز قيد الاختبار يعمل بالإصدار 13 من نظام التشغيل Android أو إصدار أحدث، تأكَّد من أنّ الإصدار يتضمّن
ro.product.first_api_levelتم ضبطه على مستوى واجهة برمجة التطبيقات الذي تم إطلاق الجهاز به تجاريًا. لضبط هذه القيمة، عليك إجراء التغيير التالي على ملفdevice.mk:PRODUCT_SHIPPING_API_LEVEL := 21تعتمد بعض متطلبات CTS على الإصدار الذي تم شحن الجهاز به في الأصل. على سبيل المثال، قد يتم استبعاد الأجهزة التي يتم شحنها في الأصل بإصدارات أقدم من متطلبات النظام التي تنطبق على الأجهزة التي يتم شحنها بإصدارات أحدث. للاطّلاع على قيم مستوى واجهة برمجة التطبيقات الصالحة، راجِع مقالة الأسماء الرمزية والعلامات وأرقام الإصدار. لمزيد من المعلومات حول
ro.product.first_api_level، يُرجى الاطّلاع على مستوى واجهة برمجة التطبيقات الخاصة بالمورّد.بالنسبة إلى الإصدار 10 من نظام التشغيل Android أو الإصدارات الأقدم، يُرجى الاطّلاع على إعداد مجموعة اختبار التوافق (الإصدار 10 من نظام التشغيل Android أو الإصدارات الأقدم).
إذا كان جهازك يتيح إدارة حِزم APEX:
- نزِّل حزمة APEX shim لإصدار Android وبنية الأجهزة المحدّدين. يوفّر العمودان الأيمنان في جدول حِزم shim روابط لتنزيل الحزمة.
- انسخ الحزمة التي تم تنزيلها إلى
/system/apex. - أعِد تسمية الملف إلى
com.android.apex.cts.shim.apex.
إذا كان جهازك لا يتيح إدارة حِزم APEX، اتّبِع الخطوات التالية:
- نزِّل حِزم APEX shim الخاصة بإصدار Android وبنية الأجهزة المحدّدة. يوفّر العمودان الأيمنان في جدول حِزم shim روابط لتنزيل الحِزم.
- انسخ
CtsShim.apkإلى/system/app/ - أعِد تسمية
CtsShim.apkإلىCtsShimPrebuilt.apk - انسخ
CtsShimPriv.apkإلى/system/priv-app/ - أعِد تسمية
CtsShimPriv.apkإلىCtsShimPrivPrebuilt.apk
إذا كان جهازك يعرض أكثر من عنصر آمن واحد:
- نزِّل
google-cardlet.cap. - انسخ الملف الذي تم تنزيله إلى
/data/uicc/cardlets/.
- نزِّل
إذا كان جهازك يعرض أكثر من عنصر آمن واحد، ثبِّت تطبيق العيّنة المصغّر في العنصر الآمن المضمّن (eSE) في الجهاز الخاضع للاختبار أو في شريحة SIM التي يستخدمها الجهاز الخاضع للاختبار. لمزيد من المعلومات، يُرجى الاطّلاع على اختبار CTS للعنصر الآمن.
إذا لم يكن جهازك مزوّدًا بشاشة مدمجة، وصِّل شاشة بالجهاز.
إذا كان الجهاز يحتوي على فتحة لبطاقة الذاكرة، أدخِل بطاقة SD فارغة. استخدِم بطاقة SD متوافقة مع ناقل بيانات فائق السرعة (UHS) بسعة SDHC أو SDXC أو بطاقة من فئة السرعة 10 أو أعلى للتأكّد من أنّها يمكنها اجتياز اختبار التوافق مع نظام التشغيل Android (CTS).
إذا كان الجهاز مزوّدًا بفتحات لشرائح SIM، أدخِل شريحة SIM مفعَّلة في كل فتحة. إذا كان الجهاز يتيح استخدام الرسائل القصيرة، يجب ملء حقل الرقم لكل شريحة SIM. بالنسبة إلى الأجهزة التي تعمل بالإصدار 12 من نظام التشغيل Android أو الإصدارات الأحدث، يجب أن تتوافق جميع شرائح SIM مع ميزة تخزين أرقام الاتصال المختصر (ADN). تستوفي بطاقات GSM وUSIM التي تتضمّن ملف الاتصالات المخصّص (DFTelecom) هذا الشرط.
تأكَّد من أنّ جهازك يحتوي على شريحة SIM مزوّدة بامتيازات مشغّل CTS تستوفي المتطلبات المحدّدة في إعداد شريحة UICC.
إعداد الجهاز الخاضع للاختبار
اتّبِع الخطوات التالية لإعداد جهازك قيد الاختبار لاستخدامه مع مجموعة اختبارات التوافق (CTS).
على الجهاز قيد الاختبار (DUT):
أعِد ضبط الجهاز على الإعدادات الأصلية.
اضبط لغة الجهاز على الإنجليزية (الولايات المتحدة).
إذا كان الجهاز يتيح تخصيص الخطوط التلقائية، تأكَّد من ضبط مجموعة خطوط sans-serif التلقائية على Roboto.
إذا كان الجهاز يتضمّن نظام تحديد المواقع العالمي (GPS) أو شبكة Wi-Fi أو شبكة جوّال، فعِّل إعدادات الموقع الجغرافي.
اتّصِل بشبكة Wi-Fi متوافقة مع IPv6 ويمكنها التعامل مع الجهاز الخاضع للاختبار كعميل معزول، ويجب أن تتوفّر فيها إمكانية الاتصال بالإنترنت. للحصول على شرح حول الأجهزة المعزولة، يُرجى الاطّلاع على إعداد البيئة المادية.
تأكَّد من عدم ضبط نقش قفل أو كلمة مرور.
فعِّل ميزة "تصحيح أخطاء الجهاز عبر USB" باتّباع الخطوات التالية:
انتقِل إلى الإعدادات > لمحة عن الهاتف وانقر على رقم الإصدار سبع مرات. يظهر خيارات المطوّرين ضمن فئة إعدادات النظام.
انقر على تصحيح أخطاء الجهاز عبر USB.
لتفعيل تصحيح أخطاء الجهاز عبر USB على الإصدار 10 من نظام التشغيل Android أو الإصدارات الأقدم، يُرجى الاطّلاع على إعداد مجموعة أدوات اختبار التوافق (CTS) (مشروع Android المفتوح المصدر (AOSP) 10 أو الإصدارات الأقدم).
اضبط الوقت على تنسيق 12 ساعة.
فعِّل خيارات المطوّرين > البقاء في الوضع النشط.
إيقاف ميزة التحقّق من التطبيقات عبر USB:
انتقِل إلى خيارات المطوّرين.
انقر على التحقّق من التطبيقات عبر USB.
في الإصدار 13 من نظام التشغيل Android أو الإصدارات الأحدث، فعِّل خدمة المودم الوهمي باتّباع الخطوات التالية:
انتقِل إلى خيارات المطوّرين.
انقر على السماح بخدمة مودم وهمي.
هذا الإعداد مطلوب لإجراء اختبارات محددة على خدمات الاتصال الهاتفي.
على جهاز الكمبيوتر:
افتح المتصفّح وأغلِق أي شاشة بدء أو إعداد.
وصِّل الجهاز قيد الاختبار بجهاز الكمبيوتر المكتبي باستخدام كابل USB.
إذا طلب منك النظام قبول مفتاح RSA الذي يسمح بتصحيح أخطاء الجهاز عبر USB من خلال هذا الكمبيوتر، انقر على السماح بتصحيح أخطاء الجهاز عبر USB.
اضبط Roboto2 كخط sans-serif باستخدام إعداد يسهل على المستخدم الوصول إليه (غير مخفي).
انسخ ملفات وسائط CTS إلى الجهاز الخاضع للاختبار (DUT):
- انتقِل (
cd) إلى المسار الذي يتم فيه تنزيل ملفات الوسائط وفك ضغطها. غيِّر أذونات الملف باتّباع الخطوات التالية:
chmod u+x copy_media.shانسخ الملفات باتّباع الخطوات التالية:
لنسخ مقاطع تصل دقتها إلى 720x480، نفِّذ الأمر التالي:
./copy_media.sh 720x480إذا لم تكن متأكدًا من الحد الأقصى للدقة، انسخ جميع الملفات:
./copy_media.sh allإذا كانت هناك أجهزة متعدّدة قيد الاختبار، أضِف خيار الرقم التسلسلي (
-s) لجهاز معيّن في النهاية. على سبيل المثال، لنسخ ما يصل إلى 720x480 إلى الجهاز الذي يحمل الرقم التسلسلي 1234567، شغِّل ما يلي:./copy_media.sh 720x480 -s 1234567
- انتقِل (
تنزيل ملفات CTS ذات الصلة بـ Mainline
لتنزيل ملفات CTS ذات الصلة بـ Mainline، اتّبِع الخطوات التالية:
يمكنك الحصول على مستوى واجهة برمجة التطبيقات لنظام التشغيل Android على الجهاز من خلال تنفيذ ما يلي:
adb shell getprop ro.build.version.sdkاتّبِع التعليمات الواردة في نص
download_mcts.shلتنزيل ملفات CTS الرئيسية.تستغرق عملية التنزيل 10 دقائق على الأقل، ويتوقف ذلك على سرعة الشبكة.
حِزم Shim
يسرد الجدول التالي الحِزم المتاحة لكل إصدار من إصدارات الأجهزة وبنيتها:
ما هي الخطوات التالية؟
بعد قراءة هذا المستند، انتقِل إلى تشغيل اختبارات CTS المبرمَجة.