باستخدام CTS Verifier

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

متطلبات

قبل تشغيل CTS Verifier ، تأكد من أن لديك المعدات التالية:

  • جهاز Android الذي تحقق من توافق Android API عن طريق اجتياز CTS بنجاح. هذا هو الجهاز قيد الاختبار (DUT).
  • كمبيوتر Linux مع منفذ USB 2.0 متوافق. تمر جميع الاتصالات بـ DUT عبر هذا المنفذ.
  • جهاز Android ثاني مزود بتقنية Bluetooth متوافقة و Wi-Fi Direct وتطبيق محاكاة بطاقة مضيف NFC (HCE).
  • موجه Wi-Fi تم تكوينه باستخدام اسم نقطة الوصول وكلمة المرور. يجب أن يتمتع جهاز التوجيه بالقدرة على قطع الاتصال بالإنترنت ، ولكن لا يتم إيقاف تشغيله.

متطلبات UICC لاختبارات NFC

لدى CTS Verifier حالات اختبار NFC التالية:

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

تتطلب اختبارات حدث المعاملة جهازين ، يجب أن يحتوي أحدهما على SecureElement 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

على جانب المحاكي ، نتوقع أن يدفع حدث المعاملة النشاط المقابل إلى المقدمة.

يثبت

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

  1. أفتح الإعدادات.
  2. انتقل إلى System > Gesture > System Navigation .
  3. حدد أي وضع تنقل يعتمد على الزر ، ويفضل وضع ثلاثة أزرار ، إذا كان متاحًا.

لإعداد بيئة اختبار CTS Verifier:

  1. على كمبيوتر Linux:

    • قم بتشغيل الأمر التالي قبل تثبيت CTS Verifier للسماح بالوصول إلى واجهات غير SDK.

      adb shell settings put global hidden_api_policy 1
      
    • قم بتثبيت Android Studio .

    • قم بتنزيل CTS Verifier APK لإصدار 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
    

    لمنح الإذن الصحيح لملف شخصي تم إنشاؤه للعمل ، قم بتضمين علامة --user profileID كما يلي:

    adb shell appops set --user profileID com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
    
  6. لنظام Android 13 والإصدارات الأحدث ، قم بتشغيل الأمر التالي للسماح بوصول اختبار API لـ CTS Verifier.

    adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier
    
  7. تأكد من أن DUT لديها بيانات النظام والوقت المحدد بشكل صحيح.

قم بتشغيل CTS Verifier

قم بتشغيل تطبيق CTS Verifier بالنقر فوق أيقونة CTS Verifier على DUT.

رمز CTS Verifier في المشغل

الشكل 1. رمز CTS Verifier

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

قائمة اختبارات CTS Verifier

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

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

التحقق من جودة الفيديو

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

  • تمرير (✓). انقر فوق إذا كانت DUT تفي بمتطلبات الاختبار وفقًا لتعليمات المعلومات.
  • معلومات (؟). انقر لعرض تعليمات الاختبار. يظهر أيضًا تلقائيًا في المرة الأولى التي يتم فيها فتح الاختبار.
  • فشل (!). انقر فوق إذا كانت DUT لا تفي بمتطلبات الاختبار وفقًا لتعليمات المعلومات.

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

اختبر وضع ملحق USB للحصول على 8.0 وأعلى

اختبار ملحق USB لـ CTS Verifier

الشكل 4. اختبار ملحق USB للحصول على 8.0 وما فوق

اختبار ملحق USB لـ CTS Verifier

الشكل 5. اختبار وضع ملحق USB لـ 8.0 وما فوق

اختبر وضع ملحق USB لـ 7.x وأقل

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

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

    ./cts-usb-accessory
  3. انتظر حتى تظهر رسالة منبثقة في DUT ، ثم حدد موافق .
    اختبار ملحق USB لـ CTS Verifier

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

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

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

في الجزء العلوي من عرض القائمة الرئيسية في CTS Verifier ، يظهر زر لتمكين المستخدمين من التبديل بين وضع العرض غير المطوي والمطوي. سيُظهر CTS Verifier الاختبارات اللازمة لوضع العرض المحدد. لتنفيذ الأوضاع البديلة في 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 .

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

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

      adb pull /mnt/sdcard/ctsVerifierReports/
      
    • بالنسبة لنظام التشغيل Android 10 والإصدارات الأحدث ، عند تنفيذ السيارات والأجهزة التي تعمل كمستخدم ثانوي ، قم بتنزيل أحدث تقرير باستخدام الأمر التالي:

      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 وحدد القائمة> مسح .