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

وتُعد أداة التحقق من مجموعة أدوات اختبار التوافق مع 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 في عنصر الأمان مع قواعد الوصول التالية:

  • تجزئة CtsVerifier APK: 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 Verifier:

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

    • شغِّل الأمر التالي قبل تثبيت أداة CTS Verifier للسماح بالوصول إلى واجهات غير حِزم تطوير البرامج (SDK).

      adb shell settings put global hidden_api_policy 1

    • ثبِّت استوديو Android.

    • نزِّل حزمة APK الخاصة ببرنامج CTS Verifier لإصدار Android المطلوب اختباره.

  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. بالنسبة إلى Android 13 والإصدارات الأحدث، يمكنك تنفيذ الأمر التالي للسماح بوصول أداة 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 Verifier

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

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

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

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

قائمة الاختبارات في أداة CTS Verifier

الشكل 2. قائمة الاختبارات في أداة CTS Verifier

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

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

الشكل 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. اضغط على زر الرجوع وكرِّر اختبار المعايرة لجميع دقة الصور المتوافقة مع جهاز التحكّم في العينة.

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

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

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

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

سيتم تسجيل نتائج الاختبارات المطوية في التقرير نفسه مع الاختبارات غير المطوية. لتحديد كل نتيجة اختبار تأتي منها مجموعة الاختبار، تتم إضافة لاحقة إلى كل اسم اختبار ضمن الوضع المطوي.

<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

    • بالنسبة إلى نظام التشغيل 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

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