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

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

المتطلبات

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

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

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

متطلبات شريحة SIM المدمَجة لاختبارات NFC

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

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

تتطلّب اختبارات أحداث المعاملات جهازَين، يجب أن يتضمّن أحدهما شريحة SIM المدمَجة 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

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

الإعداد

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

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

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

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

   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. تأكَّد من ضبط تاريخ النظام والوقت بشكلٍ صحيح على الجهاز قيد الاختبار (DUT).

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

شغِّل تطبيق أداة التحقّق في مجموعة أدوات اختبار التوافق (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.

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

     adb pull /sdcard/verifierReports
     

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

     adb pull /mnt/sdcard/ctsVerifierReports/
     

   • بالنسبة إلى الإصدار 10 من Android والإصدارات الأحدث، نزِّل أحدث تقرير باستخدام الأمر التالي عند تنفيذ 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) وانقر على القائمة > محو.