استخدام أداة CTS Verifier

يُعدّ أداة التحقّق من مجموعة اختبار التوافق مع Android (CTS Verifier) مكمّلاً ل مجموعة اختبار التوافق (CTS). بينما تتحقّق مجموعة اختبار التوافق (CTS) من واجهات برمجة التطبيقات والوظائف التي يمكن أتمتتها، يقدّم أداة التحقّق من التوافق (CTS Verifier) اختبارات لواجهات برمجة التطبيقات والوظائف التي لا يمكن اختبارها على جهاز ثابت بدون إدخال أو ضبط يدوي، مثل جودة الصوت وشاشة اللمس ومقياس التسارع والكاميرا.

المتطلبات

قبل تشغيل أداة CTS Verifier، تأكَّد من توفُّر المعدات التالية:

  • جهاز Android تم إثبات توافقه مع واجهة برمجة تطبيقات Android من خلال اجتياز اختبار CTS بنجاح هذا هو الجهاز الذي يتم اختباره (DUT).
  • جهاز كمبيوتر يعمل بنظام التشغيل Linux ومزوّد بمنفذ متوافق مع USB 2.0 تتم جميع عمليات الاتصال بوحدة التحكّم في البيانات من خلال هذا المنفذ.
  • جهاز Android ثانٍ مزوّد بتقنية بلوتوث وWi-Fi Direct وWi-Fi Aware وUWB (إذا كان جهاز DUT متوافقًا مع UWB) وNFC host card emulation (HCE)
  • جهاز توجيه Wi-Fi تم ضبطه باستخدام اسم نقطة الوصول وكلمة المرور يجب أن يكون بإمكان جهاز التوجيه إيقاف الاتصال بالإنترنت، ولكن ليس إطفاءه.

احرص أيضًا على تجهيز الحوامل الثلاثية للأجهزة والمسافات المقاسة مسبقًا المطلوبة لاختبارات قياس المسافة (المسافة القريبة) لتقنية النطاق الفائق العرض (UWB) وشبكة Wi-Fi NAN ومؤشر مستوى طاقة الإشارة (RSSI) في البلوتوث. لمعرفة التفاصيل، يُرجى الاطّلاع على معايرة ميزة "التواجد".

متطلبات شريحة UICC لاختبارات NFC

يتضمّن CTS Verifier حالات اختبار NFC التالية:

  • إيقاف الحقول (يستخدم بيانات المعاملات من 0x54)
  • إلغاء الاختيار (يستخدم بيانات المعاملات من 0x52)
  • الأمر HCI (0025000000) (يستخدِم بيانات المعاملات من 0x02)

تتطلّب اختبارات أحداث المعاملات جهازَين، يجب أن يتضمّن أحدهما ملف تعريف مستخدم كرت UICC في SecureElement مع قواعد الوصول التالية:

  • تجزئة حزمة 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 المرتبط إلى المقدّمة.

ضبط إعدادات الجهاز

غيِّر وضع التنقّل في النظام على الجهاز التجريبي إلى وضع "التنقّل باستخدام ثلاثة أزرار" على النحو التالي:

  1. افتح "الإعدادات".
  2. انتقِل إلى النظام > الإيماءات > التنقّل داخل النظام.
  3. اختَر أي وضع تنقّل يستند إلى الأزرار، ويُفضّل استخدام وضع "التنقّل باستخدام ثلاثة أزرار"، إذا كان متاحًا.

لإعداد بيئة اختبار أداة التحقّق من توافق الأجهزة مع معايير CTS:

  1. على جهاز الكمبيوتر الذي يعمل بنظام التشغيل Linux:

  2. وصِّل جهاز DUT بجهاز الكمبيوتر الذي يعمل بنظام التشغيل Linux.

  3. من وحدة طرفية على جهاز الكمبيوتر الذي يعمل بنظام التشغيل Linux، ثبِّت CtsVerifier.apk على جهاز DUT.

    adb install -r -g CtsVerifier.apk

  4. في Android 10 والإصدارات الأحدث، يمكنك تنفيذ العبارة التالية لمنح التطبيق الإذن بإنشاء التقرير.

    adb shell appops set com.android.cts.verifier android:read_device_identifiers allow

  5. بالنسبة إلى Android 11 والإصدارات الأحدث، يمكنك تنفيذ العبارة التالية للسماح بحفظ التقارير في دليل ذاتي التحديد ضمن الدليل الخارجي من المستوى الأعلى للجهاز.

    adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0

  6. بالنسبة إلى الإصدار 13 من نظام التشغيل Android والإصدارات الأحدث، يمكنك تنفيذ الأمر التالي للسماح بالوصول إلى واجهة برمجة التطبيقات الاختبارية من خلال أداة CTS Verifier.

    adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier

  7. بالنسبة إلى الإصدار 14 من Android والإصدارات الأحدث، يمكنك تنفيذ العبارة التالية لمنح التطبيق الإذن بتفعيل الشاشة.

    adb shell appops set com.android.cts.verifier TURN_SCREEN_ON 0

  8. تأكَّد من ضبط التاريخ والوقت في الجهاز الاختباري بشكل صحيح.

تشغيل أداة التحقّق من CTS

شغِّل تطبيق CTS Verifier من خلال النقر على رمزه على جهاز DUT.

رمز أداة التحقّق من توافق الأجهزة مع معيار CTS في مشغّل التطبيقات

الشكل 1: رمز أداة التحقّق من CTS

يعرض التطبيق عدة مجموعات اختبارات متاحة للتحقّق منها يدويًا.

قائمة الاختبارات في أداة التحقّق من CTS

الشكل 2: قائمة الاختبارات في أداة التحقّق من CTS

يحتوي كل اختبار على مجموعة من العناصر الشائعة في أسفل الشاشة.

أداة التحقّق من جودة الفيديوهات المباشرة

الشكل 3: شاشة اختبار تم فيها تمييز عناصر الاختبار الشائعة

  • اجتاز (✓): انقر على هذا الخيار إذا كان جهاز DUT يستوفي متطلبات الاختبار وفقًا لتعليمات المعلومات.
  • معلومات (?): انقر لعرض تعليمات الاختبار. تظهر أيضًا تلقائيًا عند فتح اختبار للمرة الأولى.
  • تعذّر الاختبار (!): انقر على هذا الخيار إذا لم يستوفِ جهاز DUT متطلبات الاختبار وفقًا للمعلومات والتعليمات.

تتطلّب بعض الاختبارات، مثل وضع "ملحق USB" واختبار معايرة الكاميرا، إعدادات اختبار وإرشادات إضافية كما هو موضّح بالتفصيل في الأقسام التالية.

اختبار وضع ملحق USB لنظام التشغيل 8.0 والإصدارات الأحدث

اختبار ملحق USB الخاص بأداة التحقّق من التوافق مع مجموعة أدوات اختبار التوافق (CTS)

الشكل 4: إجراءات اختبار ملحقات USB للإصدار 8.0 والإصدارات الأحدث

اختبار ملحق USB الخاص بأداة التحقّق من التوافق مع مجموعة أدوات اختبار التوافق (CTS)

الشكل 5: اختبار وضع "ملحق USB" على الإصدار 8.0 والإصدارات الأحدث

اختبار وضع "ملحق USB" لنظام التشغيل 7.x والإصدارات الأقدم

يتطلب اختبار ملحق USB جهاز كمبيوتر يعمل بنظام التشغيل Linux لتشغيل برنامج جهاز الكمبيوتر المكتبي (المضيف) USB.

  1. وصِّل جهاز DUT بجهاز الكمبيوتر الذي يعمل بنظام التشغيل Linux.

  2. على جهاز الكمبيوتر، نفِّذ برنامج cts-usb-accessory من حزمة CTS Verifier:

    ./cts-usb-accessory

  3. انتظِر ظهور رسالة منبثقة على جهاز DUT، ثم انقر على حسنًا.
    اختبار ملحق USB الخاص بأداة التحقّق من التوافق مع مجموعة أدوات اختبار التوافق (CTS)

    الشكل 6: اختبار ملحق USB

  4. انتقِل إلى اختبار ملحق USB في تطبيق CTS Verifier على جهاز DUT.

  5. على جهاز الكمبيوتر، راجِع الإخراج من وحدة التحكّم. مثال على الإخراج:

    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

معايرة مجال رؤية الكاميرا

استخدِم إجراء معايرة مجال الرؤية لتحديد مجال رؤية الجهاز بدقة معتدلة بسرعة.

  1. إعداد بيئة الاختبار:

    1. اطبع ملف التوجيه calibration-pattern.pdf على ورقة مقاس 11 × 17 بوصة أو A3.
    2. ثبِّت النمط المطبوع على خلفية صلبة.

    3. وجِّه جهاز الكاميرا والهدف المطبوع كما هو موضّح في المخطّط التالي.
      الهدف المطبوع للكاميرا

      الشكل 7: الهدف المطبوع للكاميرا

  2. اضبط العرض المستهدَف:

    1. قياس المسافة (بالسنتيمترات) بين الخطوط الثابتة على النمط المستهدَف لمراعاة عدم دقة الطباعة (حوالي 38 سم)
    2. ابدأ تطبيق المعايرة.
    3. اضغط على زر الإعداد واختَر مسافة العلامة.
    4. قياس المسافة إلى النمط المستهدَف وإدخالها (حوالي 100 سم)
    5. اضغط على زر الرجوع للعودة إلى معاينة المعايرة.

  3. تأكَّد من وضع الجهاز والهدف كما هو موضّح في الشكل ومن إدخال المسافات الصحيحة في مربّع حوار الإعداد. تعرِض المعاينة الصورة مع خط عمودي متراكب عليها، ويجب أن يتمهائل هذا الخط مع خط مركز النمط المستهدَف. يمكن استخدام الشبكة الشفافة مع الخطوط العمودية الأخرى لضمان أن يكون المحور البصري عموديًا على الهدف.

  4. يمكنك إجراء اختبار المعايرة باتّباع الخطوات التالية:

    1. اختَر درجة دقة الصورة (باستخدام أداة الاختيار في أسفل يمين الشاشة)، ثم انقر على الشاشة لالتقاط صورة. يدخل الاختبار في وضع المعايرة ويُظهر الصورة مع خطَّين عموديَّين فوق الصورة.
    2. تحديد الدقة:
      • إذا كانت الخطوط تتحاذى مع الخطوط العمودية في النمط المستهدَف في غضون بضعة سنتيمترات، يكون مجال الرؤية الذي تم الإبلاغ عنه للدقة المحدّدة دقيقًا.
      • إذا لم تتم محاذاة الخطوط، يعني ذلك أنّ مجال الرؤية الذي تم الإبلاغ عنه غير دقيق. لتصحيح ذلك، اضبط شريط التمرير في أسفل الشاشة إلى أن تتم محاذاة التراكب مع النمط المستهدَف قدر الإمكان. عند محاذاة الصورة المتراكبة وصورة النمط المستهدَف، يكون عمق الحقل المعروض مماثلاً تقريبًا للقيمة الصحيحة. يجب أن يكون مجال الرؤية المسجَّل ضمن +/-2 درجة من قيمة المعايرة.
    3. اضغط على زر الرجوع (Back) وكرِّر اختبار المعايرة لجميع دقة الصور المتوافقة مع جهاز التحكّم في العينة (DUT).

تشغيل أداة CTS Verifier للأوضاع البديلة

بدءًا من الإصدارَين CTS 10 R6 وCTS 11 R2، يتيح أداة CTS Verifier إجراء الاختبارات المطلوبة للأجهزة التي تتضمّن أوضاعًا بديلة أو للأجهزة التي تتضمّن أكثر من وضع شاشة واحد.

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

مفتاح التبديل CTS-V

الشكل 8: مفتاح تبديل أداة التحقّق من التوافق (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.

  1. لحفظ نتائج الاختبار، انقر على رمز الحفظ (القرص) في أعلى قائمة فئات الاختبار.

  2. انتظِر ظهور رسالة منبثقة تعرض مسار الملف إلى التقرير المحفوظ (مثل/sdcard/verifierReports/ctsVerifierReport-date-time.zip)، ثم سجِّل المسار.

  3. وصِّل جهاز DUT بجهاز الكمبيوتر الذي يعمل بنظام التشغيل Linux.

  4. من عملية تثبيت حزمة Android SDK على جهاز الكمبيوتر الذي يعمل بنظام التشغيل Linux، نزِّل التقارير من الجهاز المتصل باستخدام adb shell content read أو adb pull CTSVerifierReportPath.

    • بالنسبة إلى الإصدار 7.x من نظام التشغيل Android والإصدارات الأحدث، يمكنك تنزيل جميع التقارير باستخدام الأمر التالي:

      adb pull /sdcard/verifierReports

    • بالنسبة إلى الإصدار 6.0 من نظام التشغيل Android والإصدارات الأقدم، يمكنك تنزيل جميع التقارير باستخدام الأمر التالي:

      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

  5. لمحو نتائج النجاح أو الفشل، اختَر النتائج في تطبيق CTS Verifier و اختَر القائمة > محو.