باستخدام CTS التحقق

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

متطلبات

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

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

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

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

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

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

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

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

يثبت

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

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

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

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

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

      adb shell settings put global hidden_api_policy 1

    • قم بتثبيت أندرويد ستوديو .

    • قم بتنزيل 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

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

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

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

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

  8. تأكد من أن DUT قد تم ضبط تاريخ النظام ووقته بشكل صحيح.

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

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

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

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