تشغيل اختبارات CTS-V

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

المتطلبات

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

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

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

متطلبات بطاقة SIM المدمجة (UICC) لاختبارات NFC

تتضمّن أداة التحقّق في مجموعة أدوات اختبار التوافق (CTS Verifier) حالات اختبار NFC التالية:

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

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

• تجزئة حزمة APK لأداة التحقّق في مجموعة أدوات اختبار التوافق (CTS Verifier): 61:ED:37:7E:85:D3:86:A8:DF:EE:6B:86:4B:D8:5B:0B:FA:A5:AF:81
• رقم تعريف التطبيق المفوّض (AID) للوصول إلى حدث NFC: 0xA000000476416E64726F696443545341

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

الإعداد

يتطلّب Android 17 خطوة إضافية لإعداد أداة التحقّق في مجموعة أدوات اختبار التوافق (CTS-V) من أجل منح دور المتصفّح التلقائي.

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

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

لإعداد بيئة اختبار أداة التحقّق في مجموعة أدوات اختبار التوافق (CTS Verifier)، اتّبِع الخطوات التالية:

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

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

   adb shell settings put global hidden_api_policy 1
   

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

   2. نزِّل حزمة 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. بالنسبة إلى Android 14 والإصدارات الأحدث، شغِّل الأمر التالي لمنح التطبيق إذن تشغيل الشاشة:

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

8. بالنسبة إلى Android 17 والإصدارات الأحدث، شغِّل الأمر التالي لمنح دور المتصفّح التلقائي لأداة التحقّق في مجموعة أدوات اختبار التوافق (CTS Verifier):

   adb shell 'cmd role add-role-holder --user $(am get-current-user) android.app.role.BROWSER com.android.cts.verifier'
   

9. تأكَّد من ضبط تاريخ النظام ووقته بشكلٍ صحيح على الجهاز قيد الاختبار (DUT).

تشغيل أداة التحقّق في مجموعة أدوات اختبار التوافق (CTS Verifier)

شغِّل تطبيق "أداة التحقّق في مجموعة أدوات اختبار التوافق (CTS Verifier)" من خلال النقر على الرمز الخاص به على الجهاز قيد الاختبار (DUT).

الشكل 1: رمز "أداة التحقّق في مجموعة أدوات اختبار التوافق (CTS Verifier)"

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

الشكل 2: قائمة الاختبارات في "أداة التحقّق في مجموعة أدوات اختبار التوافق (CTS Verifier)"

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

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

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

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

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

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

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

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

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

1. اربط الجهاز قيد الاختبار (DUT) بالكمبيوتر الذي يعمل بنظام التشغيل Linux.

2. على الكمبيوتر، شغِّل برنامج cts-usb-accessory من حزمة "أداة التحقّق في مجموعة أدوات اختبار التوافق (CTS Verifier)":

   ./cts-usb-accessory
   

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

   

   الشكل 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. اطبع ملف PDF الخاص بنمط المعايرة على ورق مقاس 11 × 17 بوصة أو ورق بحجم A3.
   2. ثبِّت النمط المطبوع على دعامة صلبة.

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

      

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

2. ضبط عرض الهدف:

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

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

4. تشغيل اختبار المعايرة:

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

تشغيل "أداة التحقّق في مجموعة أدوات اختبار التوافق (CTS Verifier)" للأوضاع البديلة

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

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

الشكل 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. من تثبيت حزمة تطوير البرامج (SDK) لنظام Android على الكمبيوتر الذي يعمل بنظام التشغيل 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 والإصدارات الأحدث، نزِّل أحدث تقرير باستخدام الأمر التالي لتنفيذ Automotive والأجهزة التي تعمل كمستخدم ثانوي:

     adb shell content read --user <var>CURRENT_USER</var> --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
       ```
     
     To download a report from the list, you can specify the Row ID or
     filename. For example:
     
     ```shell
       adb shell content read --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports/0 > report.zip
       ```
     
     ```shell
       adb shell content read --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports ctsVerifierReport-date-time.zip > report.zip
       ```
     

5. لمحو نتائج "اجتياز" أو "عدم الاجتياز"، اختَر النتائج في تطبيق "أداة التحقّق في مجموعة أدوات اختبار التوافق (CTS Verifier)" وانقر على القائمة > محو.