إعداد CTS

لتشغيل CTS، عليك أولاً تحضير البيئة المادية وجهاز الكمبيوتر المكتبي وجهاز Android الذي تستخدمه للاختبار.

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

إشارات البلوتوث المنخفض الطاقة

إذا كان الجهاز قيد الاختبار (DUT) متوافقًا مع تقنية Bluetooth LE، ضَع ثلاثة إشارات Bluetooth LE على الأقل على بُعد 5 أمتار من واجهة DUT لاختبار البحث عن بلوتوث LE Bluetooth. لا يلزم تهيئة أجهزة المرشد هذه أو إصدار أي شيء محدد، ويمكن أن تكون من أي نوع، بما في ذلك iBeacon أو Eddystone أو حتى الأجهزة التي تحاكي إشارات BLE.

النطاق الفائق العرض

إذا كان تقنية النطاق الفائق العرض (DUT) متوافقة مع النطاق الفائق العرض (UWB)، يجب أن يكون الجهاز الآخر الذي يتوافق مع النطاق الفائق العرض (UWB) في مكان قريب وموجّه بشكل كافٍ حتى لا يكون هناك هوائي ومنطقة فارغة في الراديو. بالنسبة إلى اختبارات دقة المسافة، هناك احتياجات محددة لتحديد الموقع والاتجاهات. لمعرفة تفاصيل الإعداد، يمكنك الاطّلاع على متطلبات النطاق الفائق العرض (UWB). يجب إجراء اختبار النطاق الفائق العرض (UWB) يدويًا، مع تحديد الجهازين اللذين يفصل بينهما متر واحد في سطر الأوامر. لمعرفة التفاصيل عن التقسيم المطلوب لهذا الاختبار، يُرجى مراجعة التقسيم المحلي.

الكاميرات

عند تشغيل CTS للكاميرا، استخدِم ظروف الإضاءة العادية مع رسم بياني لأنماط الاختبار (مثل نمط رقعة الشطرنج). ضع مخطط نمط الاختبار وفقًا للحد الأدنى للمسافة البؤرية في أداة DUT للتأكّد من أنها ليست قريبة جدًا من العدسة.

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

إذا كان DUT يتوافق مع كاميرات خارجية، مثل كاميرات الويب USB، يمكنك توصيل كاميرا خارجية عند تشغيل CTS. وبخلاف ذلك، تخفق اختبارات CTS.

نظام تحديد المواقع العالمي (GPS)/ GNSS

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

تنبيه: بالنسبة إلى اختبار نظام تحديد المواقع العالمي (GPS)، يجب ألا يحظر إعداد اتصال الإنترنت الاتصالات بالمنفذ supl.google.com 7276. يؤدي هذا المنفذ إلى تنزيل بيانات مساعدة نظام تحديد المواقع العالمي (GPS) لاختبار حساب موضع الجهاز على الجهاز المحلي.

Wi-Fi وIPv6

تتطلب اختبارات CTS شبكة Wi-Fi متوافقة مع IPv4 وIPv6، وبها اتصال بالإنترنت مع نظام أسماء نطاقات صالح لكل من IPv4 وIPv6، ودعم البث المتعدد لعناوين IP، ويمكنها التعامل مع DUT كبرنامج منعزل. البرنامج المعزول هو إعداد لا يظهر فيه لمجموعة البث (DUT) رسائل البث/الشبكات المتعددة على تلك الشبكة الفرعية. ويحدث هذا عند ضبط نقطة وصول Wi-Fi أو عن طريق تشغيل DUT على شبكة فرعية معزولة بدون توصيل أجهزة أخرى.

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

لاجتياز اختبار CTS، يجب ضبط العلامات UP وBROADCAST وMULTICAST على واجهة Wi-Fi. تحتاج واجهة Wi-Fi إلى تعيين عناوين IPv4 وIPv6. يمكنك التحقّق من خصائص واجهة Wi-Fi باستخدام "adb shell ifconfig".

بالنسبة إلى الأجهزة التي تتوافق مع Wi-Fi STA/STA Concurrency، يجب توفُّر عدة شبكات Wi-Fi (على الأقل شبكتان). لاجتياز اختبار CTS، يجب تشغيل شبكات Wi-Fi على نطاقات مختلفة بمعرِّفات SSID مختلفة أو على نفس معرِّف SSID باستخدام معرِّفات مجموعة الخدمات الأساسية (BSSID) مختلفة.

ميزة "المراسلة النصية في الوقت الفعلي" لشبكة Wi-Fi

يشمل نظام Android واجهة برمجة التطبيقات Wi-Fi RTT API التي تتيح ميزة المراسلة ذهابًا وإيابًا عبر شبكة Wi-Fi. ويتيح ذلك للأجهزة قياس المسافة للوصول إلى نقاط الوصول بدقة تتراوح من 1 إلى 2 متر، ما يزيد بشكل كبير من دقة تحديد الموقع الجغرافي داخل المنزل. يُنصح باستخدام جهازَين متوافقَين مع ميزة "مراسلة نصية في الوقت الفعلي" لشبكة Wi-Fi هما Google Wifi ونقطة وصول fitlet2 في Compulab (الضبط على معدل نقل بيانات بتردد 40 ميغاهرتز وبتردد 5 غيغاهرتز).

ينبغي تشغيل نقاط الوصول، ولكنها لا تتطلب اتصالاً بالشبكة. لا يلزم أن تكون نقاط الوصول بجانب جهاز الاختبار ولكن يوصى بأن تكون في نطاق 12.7 متر من جهاز الاختبار. وعادةً ما تكون نقطة وصول واحدة كافية.

إعداد جهاز سطح المكتب

تنبيه: تتوافق أداة CTS مع أجهزة Linux التي تعمل بالإصدار 64 بت. لا تتوافق CTS مع نظام التشغيل Windows أو MacOS.

خادم FFMPEG

ثبِّت حزمة الإصدار 5.1.3 (أو أحدث) من ffmpeg على الجهاز المضيف.

ترقية جهاز المضيف

يوصى بشدة بترقية ذاكرة الوصول العشوائي للجهاز المضيف CTS إلى 128 غيغابايت وترقية القرص إلى 256 غيغابايت. وهي مطلوبة لاستيعاب العدد المتزايد من حالات اختبار CTS وزيادة حجز مساحة كومة الذاكرة المؤقتة في Java في الحالات المقايضة.

ADB وAAPT2

ملاحظة: بالنسبة إلى CTS 8.0، استخدِم الإصدار 1.0.39 من adb.

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

لتثبيت ADB وAAPT2، نزِّل أحدث أدوات نظام Android SDK الأساسي وأدوات إنشاء حزمة تطوير البرامج (SDK) لنظام التشغيل Android من SDK Manager في Android Studio أو من أداة سطر الأوامر sdkmanager.

تأكَّد من أنّ adb وaapt2 في مسار النظام. يفترض الأمر التالي أنك نزّلت أرشيفات الحزمة إلى دليل فرعي يُسمى android-sdk في الدليل الرئيسي:

export PATH=$PATH:$HOME/android-sdk/platform-tools:$HOME/android-sdk/build-tools/<tools version number>

ملاحظة: تأكَّد من صحة مسار البدء واسم الدليل.

مجموعة أدوات تطوير Java لنظام التشغيل Ubuntu

ثبِّت الإصدار المناسب من مجموعة أدوات تطوير Java (JDK).

• على نظام Android 11، ثبِّت OpenJDK11.
• على Android 9 وAndroid 10، ثبِّت OpenJDK9.
• بالنسبة إلى الإصدارات 7.0 و7.1 و8.0 و8.1 من نظام Android، عليك تثبيت OpenJDK8.

لمعرفة التفاصيل، يُرجى الاطّلاع على متطلبات JDK.

الإعداد لدعم Python

ثبِّت virtualenv للنظام الأساسي باتّباع تعليمات التثبيت.

يمكنك التحقّق من نجاح التثبيت من خلال استدعاء virtualenv -h.

ملفات CTS

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

نزِّل أحدث إصدار من ملفات وسائط CTS وافتحها.

تنزيل ملفات CTS المتعلقة بـ Mainline (اختياري)

عند تشغيل إصدار CTS للمرة الأولى، تنزِّل CTS بعض ملفات CTS المتعلقة بخدمة Mainline بشكلٍ ديناميكي، والتي تضيف 10 دقائق على الأقل إلى وقت التشغيل حسب سرعة الشبكة.

لتجنب وقت تشغيل CTS الإضافي هذا، يمكنك تنزيل ملفات CTS المتعلقة بخدمة Mainline قبل تشغيل إصدار CTS، من خلال اتّباع التعليمات التالية:

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

   adb shell getprop ro.build.version.sdk
   

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

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

رصد الجهاز

اتّبِع الخطوة لإعداد النظام لاكتشاف جهازك.

الحد الأقصى للذاكرة

قد تحتاج إلى زيادة الحد الأقصى للذاكرة المتاحة أثناء تشغيل الاختبار في النص البرمجي cts-tradefed. راجِع مثال CL لمزيد من المعلومات.

إعداد جهاز Android

بُنى المستخدم

الجهاز المتوافق هو جهاز يتضمّن إصدارًا موقَّعًا من قِبل المستخدم أو مفتاح الإصدار. يجب أن يعمل جهازك بصورة نظام تستند إلى إصدار المستخدم المعروف والمتوافق (Android 4.0 أو الإصدارات الأحدث) من الأسماء البرمجية والعلامات وأرقام الإصدار.

تنبيه: عند استخدام هذه الأداة للتأكّد من توافق Android مع صورة النظام النهائية، يجب تنفيذ CTS على الأجهزة المزوّدة بإصدار مستخدم.

موقع إنشاء مستوى واجهة برمجة التطبيقات الأول

تعتمد بعض متطلبات CTS على الإصدار الذي تم شحن الجهاز من خلاله في الأصل. على سبيل المثال، قد يتم استبعاد الأجهزة التي يتم شحنها في الأصل مع إصدارات سابقة من متطلبات النظام التي تنطبق على الأجهزة التي يتم شحنها مع إصدارات لاحقة.

لإتاحة هذه المعلومات لفريق CTS، كان بإمكان الشركات المصنِّعة للأجهزة تحديد خاصية وقت الإصدار ro.product.first_api_level. قيمة هذا الموقع هي المستوى الأول لواجهة برمجة التطبيقات الذي تم من خلاله إطلاق الجهاز تجاريًا.

يمكن للشركات المصنّعة للأجهزة إعادة استخدام عملية التنفيذ الأساسية المشتركة لإطلاق منتج جديد كترقية لمنتج حالي في مجموعة الأجهزة نفسها. يمكن للشركات المصنّعة للأجهزة اختياريًا ضبط مستوى واجهة برمجة التطبيقات للمنتج الحالي على ro.product.first_api_level، ليتم تطبيق متطلبات الترقية على CTS وTreble/VTS.

يمكن للشركات المصنّعة للأجهزة تحديد قيمة PRODUCT_SHIPPING_API_LEVEL في ملف device.mk لضبط هذه السمة، كما هو موضّح في المثال التالي:

# PRODUCT_SHIPPING_API_LEVEL sets ro.product.first_api_level to indicate
# the first api level that the device has been commercially launched on.
PRODUCT_SHIPPING_API_LEVEL := 21

المستوى الأول لواجهة برمجة التطبيقات لنظام التشغيل Android 9 أو الإصدارات الأحدث

بالنسبة إلى الأجهزة التي تعمل بالإصدار 9 من نظام التشغيل Android أو الإصدارات الأحدث، عليك ضبط السمة ro.product.first_api_level على قيمة صالحة من الرموز البرمجية والعلامات وأرقام الإصدار.

المستوى الأول لواجهة برمجة التطبيقات لنظام التشغيل Android 8.x أو الإصدارات الأقدم

بالنسبة إلى الأجهزة التي تعمل بالإصدار 8.x من نظام التشغيل Android أو الإصدارات الأقدم، يجب إلغاء ضبط (إزالة) السمة ro.product.first_api_level في الإصدار الأول من المنتج. بالنسبة إلى جميع الإصدارات اللاحقة، يمكنك ضبط ro.product.first_api_level على القيمة الصحيحة لمستوى واجهة برمجة التطبيقات. يسمح ذلك للموقع بتعريف منتج جديد بشكل صحيح ويحتفظ بمعلومات حول المستوى الأول لواجهة برمجة التطبيقات للمنتج. في حال عدم ضبط العلامة، يعيّن Android Build.VERSION.SDK_INT إلى ro.product.first_api_level.

حزم شيم من CTS

يتضمّن Android 10 أو الإصدارات الأحدث تنسيق حزمة يُسمى APEX. لإجراء اختبارات CTS الخاصة بواجهات برمجة التطبيقات لإدارة APEX (مثل التحديث إلى إصدار جديد أو الإبلاغ عن حِزم APK نشطة)، عليك تثبيت حزمة CtsShimApex مسبقًا على قسم /system.

يتحقّق اختبار التحقّق من صحة أجسام APEX من تنفيذ CtsShimApex.

متطلبات ro.apex.updatable

• في حال ضبط السمة ro.apex.updatable على true، تكون السمة CtsShimApex مطلوبة لجميع الأجهزة التي تتيح إدارة حزم APEX.

• إذا لم يتم ضبط السمة ro.apex.updatable أو لم يتم ضبطها، ليس من الضروري تثبيت CtsShimApex مسبقًا على الجهاز.

يتحقّق اختبار التحقّق من صحة أجسام APEX من تنفيذ CtsShimApex.

تثبيت CtsShim وتحميله مسبقًا

بدءًا من الإصدار 11 من نظام Android، يتضمّن CtsShimApex تطبيقَين مصمَّمَين من مصدر الإصدار، ولا يتضمّنان أي رمز باستثناء البيان. تستخدم CTS هذه التطبيقات لاختبار الامتيازات والأذونات.

إذا كان الجهاز لا يتوافق مع إدارة حزم APEX (أي أنّ السمة ro.apex.updatable غير متوفّرة أو لم يتم ضبطها)، أو إذا كان الجهاز يعمل بالإصدار 10 أو الإصدارات الأقدم، يجب تثبيت التطبيقَين المصمَّمَين مسبقًا في النظام بشكل منفصل.

في حال توافق واجهة برمجة التطبيقات APEX، يجب وضع عمليات التثبيت المسبقة للإصدار المناسب على أنّها /system/apex/com.android.apex.cts.shim.apex.

في حال استخدام التطبيقات العادية المصممة مسبقًا، يجب وضع CtsShim وCtsShimPriv للإصدار المناسب على /system/app/CtsShimPrebuilt.apk و/system/priv-app/CtsShimPrivPrebuilt.apk على التوالي.

يسرد الجدول التالي عمليات التثبيت المسبقة وعمليات التحميل المُسبقة المتاحة لكل إصدار جهاز وبنية.

إصدار الجهاز	التثبيت المُسبق لـ " " (في حال توفُّر APEX)		التحميل المسبق
	تفعيل جهاز الإنذار	×86	تفعيل جهاز الإنذار	×86
Android 14	إصدار android14-arm	إصدار android14-x86	android14-arm-CtsShim.apk android14-arm-CtsShimPriv.apk	android14-x86-CtsShim.apk android14-x86-CtsShimPriv.apk
Android 13	إصدار android13-arm	إصدار android13-x86	android13-arm-CtsShim.apk android13-arm-CtsShimPriv.apk	android13-x86-CtsShim.apk android13-x86-CtsShimPriv.apk
Android 12	إصدار android12-arm	إصدار android12-x86	android12-arm-CtsShim.apk android12-arm-CtsShimPriv.apk	android12-x86-CtsShim.apk android12-x86-CtsShimPriv.apk
Android 11	إصدار android11-arm	إصدار android11-x86	android11-arm-CtsShim.apk android11-arm-CtsShimPriv.apk	android11-x86-CtsShim.apk android11-x86-CtsShimPriv.apk
Android 10	إصدار android10		android10-arm-CtsShim.apk android10-arm-CtsShimPriv.apk	android10-x86-CtsShim.apk android10-x86-CtsShimPriv.apk
Android 9 وO وO-MR1	ما مِن مدة	ما مِن مدة	arm-CtsShim.apk arm-CtsShimPriv.apk	x86-CtsShim.apk x86-CtsShimPriv.apk

لاجتياز الاختبارات، عليك تحميل التطبيقات مسبقًا في الأدلة المناسبة على صورة النظام بدون إعادة توقيع التطبيقات.

نموذج تطبيق صغير

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

يُرجى الاطّلاع على اختبار CTS للعنصر الآمن للحصول على معلومات أكثر تفصيلاً حول حالات اختبار Open Mobile API وحالات اختبار التحكّم في الوصول.

متطلبات مساحة التخزين

تتطلّب اختبارات الإجهاد للوسائط من CTS وضع مقاطع الفيديو على وحدة تخزين خارجية (/sdcard). معظم المقاطع مصدرها Big Buck Bunny، والمحمية بموجب حقوق الطبع والنشر من Blender Foundation بموجب ترخيص Creative Commons Attribution 3.0.

تعتمد المساحة المطلوبة على الحد الأقصى لدرجة دقة تشغيل الفيديو التي يدعمها الجهاز. راجِع القسم 5 في مستند تعريف التوافق مع Android للاطّلاع على إصدار النظام الأساسي لدرجات الدقة المطلوبة.

ملاحظة: يتم التحقّق من إمكانات تشغيل الفيديو في منع فقدان البيانات (DUT) من خلال واجهات برمجة تطبيقات android.media.CamcorderProfile للإصدارات السابقة من Android وواجهات برمجة تطبيقات android.media.MediaCodecInfo.CodecCapabilities من Android 5.0.

في ما يلي متطلبات التخزين لدرجة الدقة القصوى لتشغيل الفيديو:

• 480 x 360: 98 ميغابايت
• 720 × 480: 193 ميغابايت
• 1280 x 720: 606 ميغابايت
• 1920×1080: 1863 ميغابايت

الشاشة والتخزين

• يجب توصيل أي جهاز لا يحتوي على شاشة مضمنة بشاشة.

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

  تحذير: قد تعدّل أداة CTS البيانات على بطاقة SD المتصلة بالجهاز أو تمحوها.

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

  تحذير: قد تعدّل CTS البيانات وتمحوها من شرائح SIM المتصلة بالجهاز.

واجهة UICC للمطوّرين

لإجراء اختبارات واجهة برمجة التطبيقات لمشغّل شبكة الجوّال في CTS، يحتاج الجهاز إلى استخدام شريحة SIM مع امتيازات مشغِّل شبكة الجوّال في CTS تستوفي المتطلبات المحدّدة في إعداد واجهة المستخدم (UICC).

إعداد جهاز Android

1. إعادة ضبط الجهاز على الإعدادات الأصلية: الإعدادات > الاحتفاظ بنسخة احتياطية وإعادة الضبط > إعادة الضبط على الإعدادات الأصلية

   تحذير: تؤدي عملية إعادة الضبط هذه إلى محو جميع بيانات المستخدمين من الجهاز.

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

3. إذا كان الجهاز يتيح تخصيص الخطوط التلقائية، اضبط مجموعة خطوط sans-serif التلقائية على Roboto (مجموعة خطوط sans-serif التلقائية المستخدمة في إصدارات AOSP).

4. تشغيل إعداد الموقع إذا كانت هناك ميزة لنظام تحديد المواقع العالمي (GPS) أو شبكة Wi-Fi/شبكة جوّال على الجهاز: الإعدادات > الموقع > تشغيل.

5. الاتصال بشبكة Wi-Fi تتوافق مع IPv6، ويمكنها التعامل مع DUT كبرنامج معزول (راجِع البيئة المادية أعلاه)، و توفر اتصال بالإنترنت: الإعدادات > Wi-Fi.

6. تأكّد من عدم ضبط نقش قفل أو كلمة مرور على الجهاز: الإعدادات > الأمان > قفل الشاشة > بدون ضبط.

7. فعِّل تصحيح أخطاء USB على جهازك: الإعدادات > خيارات المطوِّرين > تصحيح أخطاء USB.

   ملاحظة: في الإصدار 4.2 من نظام التشغيل Android أو الإصدارات الأحدث، يتم إخفاء خيارات المطوّرين تلقائيًا. لإتاحة الإصدار، انتقِل إلى الإعدادات > لمحة عن الهاتف وانقر على رقم الإصدار سبع مرات. ارجع إلى الشاشة السابقة للاطّلاع على خيارات المطوّرين. للحصول على تفاصيل إضافية، راجِع إعداد جهاز للتطوير.

8. اضبط الوقت على تنسيق 12 ساعة: الإعدادات > التاريخ والوقت > استخدام تنسيق 24 ساعة > إيقاف.

9. عليك ضبط الجهاز ليبقى في الوضع النشط: الإعدادات > خيارات المطوّرين > البقاء في الوضع النشط > تفعيل.

10. في Android 5.x و4.4.x فقط، اضبط الجهاز على السماح بالمواقع الوهمية: الإعدادات > خيارات المطوّرين > السماح بالمواقع الوهمية > تفعيل.

11. في Android 4.2 أو الإصدارات الأحدث، أوقف التحقق من التطبيقات عبر USB من خلال الانتقال إلى الإعدادات > خيارات المطوّرين > التحقق من التطبيقات عبر USB > إيقاف.

12. في Android 13 أو الإصدارات الأحدث، اضبط الجهاز على السماح بالمودم الوهمي: الإعدادات > خيارات المطوّرين > السماح بخدمة المودم الوهمي > تفعيل.

    ملاحظة: في نظام التشغيل Android 13 أو الإصدارات الأحدث، أضافت خدمة الاتصال الهاتفي بعض اختبارات CTS التي تستخدم مودمًا وهميًا بدلاً من مودم حقيقي. يجب تفعيل هذا الإعداد في إصدارات المستخدم لاجتياز اختبارات CTS التي تحتاج إلى مودم وهمي.

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

14. قم بتوصيل جهاز سطح المكتب الذي سيتم استخدامه لاختبار الجهاز باستخدام كابل USB.

    ملاحظة: عند توصيل جهاز يعمل بالإصدار 4.2.2 من نظام التشغيل Android أو إصدار أحدث بجهاز الكمبيوتر، يعرض النظام مربع حوار يسألك عما إذا كنت تريد قبول مفتاح RSA الذي يتيح تصحيح الأخطاء من خلال هذا الكمبيوتر. اختَر السماح بتصحيح أخطاء الجهاز عبر USB.

15. قبل تشغيل CTS، قم بتعيين Roboto2 كخط sans-serif باستخدام إعداد خاصية وظيفية يمكن للمستخدم الوصول إليها (غير مخفي).

تثبيت ملف

ثبِّت تطبيقات المساعد على الجهاز واضبطها.

1. اضبط إعدادات جهازك وفقًا لإصدار CTS:

   • إصدارات CTS من 2.1 إلى 4.2 R4: عليك إعداد جهازك (أو المحاكي) لإجراء اختبارات تسهيل الاستخدام باستخدام: adb install -r android-cts/repository/testcases/CtsDelegatingAccessibilityService.apk

     على الجهاز، فعِّل التفويض: إعدادات > إمكانية الوصول > إمكانية الوصول > تفويض خدمة تسهيل الاستخدام.

   • الإصدار 6.x من CTS أو الإصدارات الأقدم: على الأجهزة التي تتضمّن التصنيف android.software.device_admin، عليك إعداد جهازك لإجراء اختبار إدارة الأجهزة باستخدام: adb install -r android-cts/repository/testcases/CtsDeviceAdmin.apk`

     في الإعدادات > الأمان > اختيار مشرفي الجهاز، فعِّل مشرفي الجهاز android.deviceadmin.cts.CtsDeviceAdminReceiver*. تأكَّد من بقاء android.deviceadmin.cts.CtsDeviceAdminDeactivatedReceiver وأي مشرفين آخرين للأجهزة محمّلة مسبقًا متوقفين.

2. انسخ ملفات وسائط CTS إلى الجهاز على النحو التالي:

   ملاحظة: بالنسبة إلى الإصدار CTS 2.3 R12 أو الإصدارات الأحدث، يجب نسخ ملفات وسائط CTS إلى الجهاز إذا كان الجهاز متوافقًا مع برامج ترميز الفيديو.
   1. الانتقال (cd) إلى المسار الذي يتم من خلاله تنزيل ملفات الوسائط وفك ضغطها

   2. غيِّر أذونات الملف: chmod u+x copy_media.sh

   3. انسخ الملفات الضرورية:

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

        ./copy_media.sh 720x480
        

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

        ./copy_media.sh all
        

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

        ./copy_media.sh 720x480 -s 1234567