قبل تنفيذ اختبارات CTS المبرمَجة، عليك إعداد بيئتك المادية وإعداد محطة العمل وضبط الجهاز الذي تختبره.
إعداد البيئة المادية
تتطلّب بعض اختبارات CTS استخدام أجهزة خارجية يتم إعدادها بالقرب من الجهاز الخاضع للاختبار (DUT). لإعداد بيئتك المادية، اتّبِع الخطوات التالية:
إذا كان الجهاز قيد الاختبار يتيح استخدام Bluetooth LE، ضَع ثلاثة منارات Bluetooth LE على الأقل على بُعد 5 أمتار من الجهاز قيد الاختبار لإجراء اختبارات فحص Bluetooth LE. علاوةً على ذلك:
- ولا تحتاج إلى ضبط إعدادات الإشارات أو إصدار أي شيء محدّد.
- يمكن أن تكون إشارات البلوتوث من أي نوع، بما في ذلك iBeacon أو Eddystone أو حتى الأجهزة التي تحاكي إشارات البلوتوث المنخفض الطاقة.
ضَع الجهاز قيد الاختبار أمام مشهد، مثل جدار أو سقف، على مسافة تعادل الحد الأدنى لمسافة التركيز في الجهاز قيد الاختبار. علاوةً على ذلك:
- يجب أن يتوفّر في المشهد إضاءة كافية للسماح لأجهزة الاستشعار الخاضعة للاختبار بالوصول إلى الحد الأقصى المستهدف الذي تم ضبطه لعدد اللقطات في الثانية (FPS) والبقاء عنده، وذلك على النحو المحدّد في
CONTROL_AE_TARGET_FPS_RANGE. - ينطبق هذا الإعداد على جميع أجهزة استشعار الكاميرا التي تعرضها
getCameraIdList، وذلك أثناء تكرار الاختبار على الأجهزة المدرَجة وقياس الأداء بشكل فردي. - إذا كان الجهاز قيد الاختبار يتوافق مع الكاميرات الخارجية، مثل كاميرات الويب التي تعمل بمنفذ USB، وصِّل كاميرا خارجية عند تشغيل اختبار التوافق. وفي حال عدم توفّرها، ستتعذّر اختبارات 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 Concurrency، يجب إعداد شبكتَي Wi-Fi على الأقل. يجب أن تعمل شبكات Wi-Fi هذه على نطاقات مختلفة باستخدام معرّفات SSID مختلفة أو على معرّف SSID نفسه باستخدام معرّفات BSSID مختلفة.
إذا كان جهاز الاختبار يدعم وقت الاستجابة لطلبات Wi-Fi (RTT)، عليك إعداد جهاز متوافق مع Wi-Fi RTT باتّباع الخطوات التالية:
- ضَع جهاز 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 Asset Packaging Tool (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 دقائق أو أكثر إلى وقت تشغيل مجموعة اختبار التوافق.
لتجنُّب وقت التشغيل الإضافي هذا في CTS، يمكنك تنزيل ملفات CTS ذات الصلة بـ Mainline قبل تشغيل CTS. للحصول على معلومات حول تنزيل ملفات 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.
ضبط الجهاز الخاضع للاختبار
اتّبِع الخطوات التالية لإعداد جهازك قيد الاختبار (DUT) لاستخدامه مع مجموعة اختبار التوافق (CTS).
على الجهاز قيد الاختبار (DUT):
أعِد ضبط الجهاز على الإعدادات الأصلية.
اضبط لغة الجهاز على الإنجليزية (الولايات المتحدة).
إذا كان الجهاز يتيح تخصيص الخطوط التلقائية، تأكَّد من ضبط مجموعة خطوط sans-serif التلقائية على Roboto.
إذا كان الجهاز يتضمّن نظام تحديد المواقع العالمي (GPS) أو شبكة Wi-Fi أو شبكة جوّال، فعِّل إعدادات الموقع الجغرافي.
اتّصِل بشبكة Wi-Fi تتوافق مع IPv6 ويمكنها التعامل مع الجهاز الخاضع للاختبار كعميل معزول، وتتضمّن اتصالاً بالإنترنت. للحصول على شرح حول الأجهزة المعزولة، يُرجى الاطّلاع على إعداد البيئة المادية.
تأكَّد من عدم ضبط نقش قفل أو كلمة مرور.
فعِّل ميزة "تصحيح أخطاء الجهاز عبر USB" باتّباع الخطوات التالية:
انتقِل إلى الإعدادات > لمحة عن الهاتف وانقر على رقم الإصدار سبع مرات. يظهر خيارات المطوّرين ضمن فئة إعدادات النظام.
انقر على تصحيح أخطاء الجهاز عبر USB.
لتفعيل تصحيح أخطاء USB على الإصدار 10 من نظام التشغيل Android أو الإصدارات الأقدم، يُرجى الاطّلاع على إعداد مجموعة اختبار التوافق (الإصدار 10 من نظام التشغيل Android أو الإصدارات الأقدم).
اضبط الوقت على تنسيق 12 ساعة.
فعِّل خيارات المطوّرين > عدم إطفاء الشاشة.
إيقاف ميزة التحقّق من التطبيقات عبر USB:
انتقِل إلى خيارات المطوّرين.
انقر على التحقّق من التطبيقات عبر USB.
في الإصدار 13 من نظام التشغيل Android أو الإصدارات الأحدث، فعِّل خيار "محاكي المودم" باتّباع الخطوات التالية:
انتقِل إلى خيارات المطوّرين.
انقر على السماح بخدمة مودم وهمي.
هذا الإعداد مطلوب لإجراء اختبارات محدّدة على خدمات الاتصال الهاتفي.
على جهاز الكمبيوتر:
افتح المتصفّح وأغلِق أي شاشة بدء أو إعداد.
وصِّل الجهاز قيد الاختبار بجهاز الكمبيوتر المكتبي باستخدام كابل USB.
إذا طلب منك النظام قبول مفتاح RSA الذي يسمح بتصحيح الأخطاء من خلال هذا الكمبيوتر، انقر على السماح بتصحيح أخطاء 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 المبرمَجة.