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

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

المتطلبات

قبل تشغيل أداة CTS Verifier، تأكَّد من توفُّر الأجهزة التالية:

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

تأكد أيضًا من تجهيز الحوامل الثلاثية القوائم وحاملات الأجهزة والصور المسافات المطلوبة لاختبارات قياس المسافة (التقارب) للنطاق الفائق العرض (UWB) شبكة Wi-Fi NAN والبلوتوث 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. اختر أي وضع تنقُّل مستند إلى الأزرار، ويفضَّل استخدام وضع ثلاثة أزرار، إذا المتوفرة.

ملاحظة: تغيير وضع التنقّل داخل النظام هو أحد خيارات سير العمل على هواتف Pixel 4 أجهزة تعمل بنظام التشغيل Android 10. وقد تتغيّر على أجهزة Android أو إصدارات نظام التشغيل الأخرى.

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

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

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

     adb shell settings put global hidden_api_policy 1
     

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

   • تنزيل حِزمة APK لأداة إثبات الملكية CTS للنطاق إصدار 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 من خلال النقر على رمز CTS Verifier في DUT.

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

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

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

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

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

• بطاقة (✓). انقر إذا كانت بطاقة DUT تستوفي متطلبات الاختبار وفقًا للوحة المعلومات على التعليمات
• Info (?). انقر لعرض تعليمات الاختبار. تظهر تلقائيًا أيضًا في المرة الأولى التي يتم فيها فتح الاختبار.
• إخفاق (!). انقر إذا لم يستوفِ جدول البيانات (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. حزمة أداة التحقق:

   ./cts-usb-accessory

3. انتظِر إلى أن تظهر رسالة منبثقة على DUT، ثم انقر على OK (حسنًا).
   

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

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

<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. لحفظ نتائج الاختبار، انقر على رمز الحفظ (القرص) في أعلى القائمة. من فئات الاختبار

   ملاحظة: لا يشتمل الإصدار 7.0 من نظام التشغيل Android والإصدارات الأحدث على ميزة المعاينة.

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
     

   • على الإصدار 6.0 من نظام التشغيل Android والإصدارات الأقدم، يمكنك تنزيل جميع التقارير باستخدام الأمر التالي:

     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 am get-current-user للحصول على رقم تعريف CURRENT_USER.

     لإدراج جميع التقارير المتاحة في الجهاز المتصل:

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