يُعدّ أداة التحقّق من مجموعة اختبار التوافق مع Android (CTS Verifier) مكمّلاً ل مجموعة اختبار التوافق (CTS). تفحص CTS واجهات برمجة التطبيقات والوظائف التي يمكن أن تكون مبرمَجة، توفّر CTS Verifier اختبارات لواجهات برمجة التطبيقات والوظائف التي لا يمكن اختبارها على جهاز ثابت بدون إدخال أو تحديد موضع يدويًا، مثل جودة الصوت وشاشة اللمس ومقياس التسارع والكاميرا.
المتطلبات
قبل تشغيل أداة CTS Verifier، تأكَّد من توفُّر المعدات التالية:
- جهاز Android تم التحقّق من توافقه مع واجهة برمجة تطبيقات Android من خلال اجتياز CTS بنجاح. هذا هو الجهاز الذي يتم اختباره (DUT).
- جهاز كمبيوتر يعمل بنظام التشغيل Linux ومزوّد بمنفذ متوافق مع USB 2.0 تتم جميع عمليات الاتصال بوحدة التحكّم في البيانات (DUT) من خلال هذا المنفذ.
- جهاز Android ثانٍ مزوّد بتقنية بلوتوث وWi-Fi Direct وWi-Fi Aware وUWB (إذا كان جهاز DUT متوافقًا مع UWB) وNFC وتنفيذ محاكاة البطاقة المُضيفة (HCE)
- جهاز توجيه Wi-Fi تم ضبطه باستخدام اسم نقطة الوصول وكلمة المرور يجب أن يكون بإمكان جهاز التوجيه إيقاف الاتصال بالإنترنت، ولكن ليس عن طريق برمجه للقيام بذلك.
احرص أيضًا على تجهيز حوامل الأجهزة وقواعد التثبيت الثلاثية الأرجل والمسافات المقاسة مسبقًا المطلوبة لاختبارات قياس المسافة (المسافة القريبة) لتقنية النطاق الفائق العرض (UWB) وشبكة Wi-Fi NAN ومؤشر مستوى طاقة الإشارة (RSSI) في البلوتوث. لمعرفة التفاصيل، يُرجى الاطّلاع على معايرة ميزة "التواجد".
متطلبات UICC لاختبارات NFC
يتضمّن أداة التحقّق من التوافق (CTS Verifier) حالات اختبار NFC التالية:
- إيقاف الحقل (يستخدم بيانات المعاملات من 0x54)
- إلغاء الاختيار (يستخدم بيانات المعاملات من 0x52)
- أمر HCI (0025000000) (يستخدِم بيانات المعاملة من 0x02)
تتطلّب اختبارات أحداث المعاملات جهازَين، يجب أن يتضمّن أحدهما ملف تعريف مستخدم كرت UICC في عنصر الأمان مع قواعد الوصول التالية:
- تجزئة حزمة APK الخاصة بتطبيق CtsVerifier: 61:ED:37:7E:85:D3:86:A8:DF:EE:6B:86:4B:D8:5B:0B:FA:A5:AF:81
- معرّف التطبيق المصرّح به (AID) للوصول إلى حدث NFC: 0xA000000476416E64726F696443545341
من جانب المحاكي، نتوقع أن يؤدي حدث المعاملة إلى دفع ال activity المرتبط إلى المقدّمة.
ضبط إعدادات الجهاز
يمكنك تغيير وضع تنقل النظام في الجهاز الاختباري إلى وضع ثلاثة أزرار على النحو التالي:
- افتح "الإعدادات".
- انتقِل إلى النظام > الإيماءات > التنقّل داخل النظام.
- اختَر أي وضع تنقّل يستند إلى الأزرار، ويُفضّل استخدام وضع "التنقّل باستخدام ثلاثة أزرار"، إذا كان متاحًا.
لإعداد بيئة اختبار أداة CTS Verifier:
على جهاز الكمبيوتر الذي يعمل بنظام التشغيل Linux:
شغِّل الأمر التالي قبل تثبيت أداة CTS Verifier للسماح بالوصول إلى الواجهات غير المستندة إلى حزمة تطوير البرامج (SDK).
adb shell settings put global hidden_api_policy 1
ثبِّت استوديو Android.
نزِّل حزمة APK الخاصة ببرنامج CTS Verifier لإصدار Android المطلوب اختباره.
وصِّل جهاز DUT بجهاز الكمبيوتر الذي يعمل بنظام التشغيل Linux.
من وحدة طرفية على جهاز الكمبيوتر الذي يعمل بنظام التشغيل Linux، ثبِّت
CtsVerifier.apk
على جهاز DUT.adb install -r -g CtsVerifier.apk
في Android 10 والإصدارات الأحدث، شغِّل العبارة التالية لمنح التطبيق الإذن بإنشاء التقرير.
adb shell appops set com.android.cts.verifier android:read_device_identifiers allow
بالنسبة إلى Android 11 والإصدارات الأحدث، يمكنك تنفيذ العبارة التالية للسماح بحفظ التقارير في دليل ذاتي التحديد ضمن الدليل الخارجي من المستوى الأعلى للجهاز.
adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
بالنسبة إلى Android 13 والإصدارات الأحدث، يمكنك تنفيذ الأمر التالي للسماح بوصول أداة CTS Verifier إلى واجهة برمجة التطبيقات الاختبارية.
adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier
بالنسبة إلى الإصدار 14 من Android والإصدارات الأحدث، يمكنك تنفيذ العبارة التالية لمنح التطبيق الإذن بتشغيل الشاشة.
adb shell appops set com.android.cts.verifier TURN_SCREEN_ON 0
تأكَّد من ضبط التاريخ والوقت في الجهاز النموذجي للاختبار بشكل صحيح.
تشغيل أداة CTS Verifier
شغِّل تطبيق CTS Verifier من خلال النقر على رمزه على جهاز DUT.
الشكل 1: رمز CTS Verifier
يعرض التطبيق عدة مجموعات اختبارات متاحة للتحقّق منها يدويًا.
الشكل 2: قائمة الاختبارات في أداة التحقّق من CTS
يحتوي كل اختبار على مجموعة من العناصر الشائعة أسفل الشاشة.
الشكل 3: شاشة اختبار مع تمييز عناصر الاختبار الشائعة
- اجتياز (✓): انقر على هذا الخيار إذا كان جهاز التحكّم في البيانات يستوفي متطلبات الاختبار وفقًا لتعليمات المعلومات.
- المعلومات (؟) انقر لعرض تعليمات الاختبار. تظهر أيضًا تلقائيًا عند فتح اختبار للمرة الأولى.
- إخفاق (!). انقر إذا لم تستوفِ DUT متطلبات الاختبار وفقًا لتعليمات المعلومات.
تتطلّب بعض الاختبارات، مثل وضع "ملحق USB" واختبار معايرة الكاميرا، إعدادات اختبار وإرشادات إضافية كما هو موضّح بالتفصيل في الأقسام التالية.
اختبار وضع ملحق USB على الإصدار 8.0 أو الإصدارات الأحدث
الشكل 4: إجراءات اختبار ملحقات USB للإصدار 8.0 والإصدارات الأحدث
الشكل 5. اختبار وضع "ملحق USB" على الإصدار 8.0 والإصدارات الأحدث
اختبار وضع "ملحق USB" لنظام التشغيل 7.x والإصدارات الأقدم
يتطلب اختبار ملحق USB جهاز كمبيوتر يعمل بنظام التشغيل Linux لتشغيل برنامج جهاز الكمبيوتر المكتبي (المضيف) USB.
- وصِّل جهاز DUT بجهاز الكمبيوتر الذي يعمل بنظام التشغيل Linux.
على جهاز الكمبيوتر، نفِّذ برنامج
cts-usb-accessory
من حزمة CTS Verifier:./cts-usb-accessory
انتظِر ظهور رسالة منبثقة على جهاز DUT، ثم انقر على حسنًا.
الشكل 6: اختبار ملحق USB
انتقِل إلى اختبار ملحق USB في تطبيق CTS Verifier على جهاز DUT.
على الكمبيوتر، راجِع الإخراج من وحدة التحكّم. مثال على الإخراج:
CTS USB Accessory Tester Found possible Android device (413c:2106) - attempting to switch to accessory mode... Failed to read protocol versionfigure3 Found Android device in accessory mode (18d1:2d01)... [RECV] Message from Android device #0 [SENT] Message from Android accessory #0 [RECV] Message from Android device #1 [SENT] Message from Android accessory #1 [RECV] Message from Android device #2 [SENT] Message from Android accessory #2 [RECV] Message from Android device #3 [SENT] Message from Android accessory #3 [RECV] Message from Android device #4 [SENT] Message from Android accessory #4 [RECV] Message from Android device #5 [SENT] Message from Android accessory #5 [RECV] Message from Android device #6 [SENT] Message from Android accessory #6 [RECV] Message from Android device #7 [SENT] Message from Android accessory #7 [RECV] Message from Android device #8 [SENT] Message from Android accessory #8 [RECV] Message from Android device #9 [SENT] Message from Android accessory #9 [RECV] Message from Android device #10 [SENT] Message from Android accessory #10
معايرة مجال رؤية الكاميرا
استخدم إجراء معايرة مجال الرؤية لتحديد مجال رؤية الجهاز بسرعة ودقة متوسطة.
إعداد بيئة الاختبار:
- اطبع ملف التوجيه calibration-pattern.pdf على ورقة مقاس 11 × 17 بوصة أو A3.
- ثبِّت النمط المطبوع على خلفية صلبة.
وجِّه جهاز الكاميرا والهدف المطبوع كما هو موضّح في المخطّط التالي.
الشكل 7: الهدف المطبوع على الكاميرا
اضبط العرض المستهدَف:
- قياس المسافة (بالسنتيمترات) بين الخطوط الثابتة على النمط المستهدَف لمراعاة عدم دقة الطباعة (حوالي 38 سم)
- ابدأ تطبيق المعايرة.
- اضغط على زر الإعداد واختَر مسافة العلامة.
- قياس المسافة إلى النمط المستهدَف وإدخالها (حوالي 100 سم)
- اضغط على زر الرجوع للعودة إلى معاينة المعايرة.
تحقق من وضع الجهاز والهدف كما هو موضح في الشكل ومن إدخال المسافات الصحيحة في مربع حوار الإعداد. تعرِض المعاينة الصورة مع خط عمودي متراكب عليها، ويجب أن يكون هذا الخط محاذيًا لخط مركز النمط المستهدَف. يمكن استخدام الشبكة الشفافة مع الخطوط الرأسية الأخرى لضمان أن المحور البصري متعامد مع الهدف.
إجراء اختبار المعايرة:
- اختَر دقة الصورة (باستخدام أداة الاختيار في أسفل يمين الشاشة)، ثم انقر على الشاشة لالتقاط صورة. يدخل الاختبار في وضع المعايرة ويُظهر الصورة مع خطَّين عموديَّين فوق الصورة.
- تحديد الدقة:
- إذا تمت محاذاة الخطوط مع الخطوط الرأسية على النمط المستهدف في غضون بضعة سنتيمترات، فسيكون مجال الرؤية الذي تم الإبلاغ عنه للدقة المحددة دقيقًا.
- إذا لم تتم محاذاة الخطوط، يعني ذلك أنّ مجال الرؤية الذي تم الإبلاغ عنه غير دقيق. لتصحيح ذلك، عدِّل شريط التمرير في أسفل الشاشة إلى أن تتم محاذاة التراكب مع النمط المستهدَف قدر الإمكان. عند محاذاة الصورة المتراكبة وصورة النمط المستهدَف، يكون عمق الحقل المعروض مماثلاً تقريبًا للقيمة الصحيحة. يجب أن يكون مجال الرؤية المسجَّل ضمن +/-2 درجة من قيمة المعايرة.
- اضغط على زر الرجوع وكرِّر اختبار المعايرة لجميع دقة الصور المتوافقة مع جهاز التحكّم في العينة.
تشغيل أداة CTS Verifier للأوضاع البديلة
بدءًا من إصداري CTS 10 R6 وCTS 11 R2، تدعم CTS Verifier الاختبارات المطلوبة للأجهزة ذات الأوضاع البديلة أو للأجهزة التي تحتوي على أكثر من وضع شاشة واحد.
في أعلى عرض القائمة الرئيسية في CTS Verifier، يظهر زر لتمكين المستخدمين من التبديل بين وضعَي العرض "غير مطوي" أو "عرض مطوي". سيعرض أداة التحقّق من CTS الاختبارات اللازمة لطريقة العرض المحدّدة. لتنفيذ انماط الاختبار البديلة في أداة CTS Verifier، يجب تبديل الزر إلى وضع الشاشة المناسب وتشغيل قائمة الاختبارات المعروضة.
سيتم تسجيل نتائج الاختبارات المجمّعة في التقرير نفسه مع الاختبارات المفتوحة. لتحديد كل نتيجة اختبار مصدر مجموعة الاختبار منها، تتم إضافة لاحقة إلى كل اسم اختبار ضمن الوضع المجمّع.
<Test result="fail" name="com.android.cts.verifier.deskclock.DeskClockTestsActivity[folded]">
<RunHistory subtest="CREATE_ALARM[folded]">
<Run start="1594176663973" end="1594176665841" isAutomated="false" />
</RunHistory>
</Test>
تصدير النتائج
بعد اكتمال جميع الاختبارات، يمكنك حفظ النتائج كتقرير وتنزيلها على جهاز كمبيوتر. يتم وضع طابع زمني تلقائيًا على أسماء التقارير استنادًا إلى وقت نظام DUT.
لحفظ نتائج الاختبار، انقر على رمز الحفظ (القرص) في أعلى قائمة فئات الاختبار.
انتظِر ظهور رسالة منبثقة تعرض مسار الملف إلى التقرير المحفوظ (مثل
/sdcard/verifierReports/ctsVerifierReport-date-time.zip
)، ثم سجِّل المسار.اربط DUT بالكمبيوتر الذي يعمل بنظام التشغيل Linux.
من تثبيت حزمة تطوير البرامج (SDK) لنظام التشغيل Android على جهاز كمبيوتر يعمل بنظام التشغيل Linux، يمكنك تنزيل التقارير من الجهاز المتصل باستخدام
adb shell content read
أوadb pull CTSVerifierReportPath
.بالنسبة إلى الإصدار 7.x من نظام التشغيل Android والإصدارات الأحدث، يمكنك تنزيل جميع التقارير باستخدام الأمر التالي:
adb pull /sdcard/verifierReports
بالنسبة إلى نظام التشغيل Android 6.0 والإصدارات الأقدم، نزِّل جميع التقارير باستخدام الأمر التالي:
adb pull /mnt/sdcard/ctsVerifierReports/
بالنسبة إلى الإصدار 10 من Android والإصدارات الأحدث، عند استخدام Automotive والأجهزة التي تعمل كأحد المستخدمين الثانويين، يمكنك تنزيل أحدث تقرير باستخدام الأمر التالي:
adb shell content read --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports/latest > report.zip
لعرض جميع التقارير المتاحة في الجهاز المتصل:
adb shell content query --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports
لتنزيل تقرير من القائمة، يمكنك تحديد رقم تعريف الصف أو اسم الملف. مثلاً:
adb shell content read --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports/0 > report.zip adb shell content read --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports/ctsVerifierReport-date-time.zip > report.zip
لمحو نتائج النجاح أو الفشل، اختَر النتائج في تطبيق CTS Verifier و اختَر القائمة > محو.