تكمل أداة إثبات صحة مجموعة أدوات اختبار التوافق مع 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
على جانب المحاكي، نتوقع أن يؤدي حدث المعاملة إلى دفع النشاط في المقدمة.
ضبط إعدادات الجهاز
تغيير وضع التنقل داخل النظام في الجهاز الاختباري إلى وضع ثلاثة أزرار التالي:
- افتح "الإعدادات".
- انتقل إلى النظام > الإيماءة > التنقل داخل النظام:
- اختر أي وضع تنقُّل مستند إلى الأزرار، ويفضَّل استخدام وضع ثلاثة أزرار، إذا المتوفرة.
لإعداد بيئة اختبار CTS Verifier:
على الكمبيوتر الذي يعمل بنظام التشغيل Linux:
شغِّل الأمر التالي قبل تثبيت أداة CTS Verifier للسماح الوصول إلى واجهات غير متوفرة في حزمة SDK
adb shell settings put global hidden_api_policy 1
ثبِّت استوديو Android.
تنزيل حِزمة APK لأداة إثبات الملكية CTS للنطاق إصدار Android لاختباره.
اربط DUT بالكمبيوتر الذي يعمل بنظام التشغيل Linux.
من الوحدة الطرفية على جهاز الكمبيوتر Linux، ثبِّت
CtsVerifier.apkعلى DUT.adb install -r -g CtsVerifier.apk
على نظام التشغيل Android 10 والإصدارات الأحدث، عليك تشغيل ما يلي: لمنح الإذن للتطبيق بإنشاء التقرير.
adb shell appops set com.android.cts.verifier android:read_device_identifiers allow
على نظام التشغيل Android 11 والإصدارات الأحدث، عليك تشغيل ما يلي: للسماح بحفظ التقارير في دليل محدد ذاتيًا ضمن دليل المستوى الأعلى الخارجي للجهاز.
adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
على نظام التشغيل Android 13 والإصدارات الأحدث، عليك تشغيل ما يلي: للسماح باختبار الوصول إلى واجهة برمجة التطبيقات في CTS Verifier.
adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier
على نظام التشغيل Android 14 والإصدارات الأحدث، عليك تشغيل ما يلي: لمنح الإذن للتطبيق بتشغيل الشاشة.
adb shell appops set com.android.cts.verifier TURN_SCREEN_ON 0
يُرجى التأكّد من ضبط تاريخ ووقت النظام في DUT بشكلٍ صحيح.
تشغيل أداة 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 المكتبي. (المضيف).
- اربط DUT بالكمبيوتر الذي يعمل بنظام التشغيل Linux.
على الكمبيوتر، نفِّذ برنامج
cts-usb-accessoryمن CTS. حزمة أداة التحقق:./cts-usb-accessory
انتظِر إلى أن تظهر رسالة منبثقة على DUT، ثم انقر على OK (حسنًا).
الشكل 6. اختبار ملحقات USB
انتقل إلى اختبار ملحق USB في تطبيق CTS Verifier على DUT.
على جهاز الكمبيوتر، راجِع نتائج وحدة التحكّم. مثال على الإخراج:
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
معايرة مجال رؤية الكاميرا
استخدِم إجراء معايرة مجال الرؤية لتحديد الجهاز بسرعة. مجال الرؤية بدقة متوسطة.
إعداد بيئة الاختبار:
- طباعة هدف calibration-pattern.pdf ملف على ورق بحجم 11 × 17 بوصة أو بحجم A3.
- ثبِّت النقش المطبوع على غطاء صلب.
وجِّه جهاز الكاميرا والهدف المطبوع كما هو موضّح في ما يلي. رسم تخطيطي.
الشكل 7. الهدف المطبوع على الكاميرا
ضبط العرض المستهدَف:
- قياس المسافة (بالسنتيمتر) بين الخطوط المتصلة في النمط المستهدف لمراعاة عدم الدقة في الطباعة (38 سم تقريبًا).
- ابدأ تشغيل تطبيق المعايرة.
- اضغط على زر الإعداد واختَر مسافة العلامة.
- عليك قياس المسافة وإدخالها إلى النمط المستهدَف (100 سم تقريبًا).
- اضغط على زر الرجوع للعودة إلى معاينة المعايرة.
تحقق من وضع الجهاز والهدف كما هو موضح في الشكل تم إدخال المسافات الصحيحة في مربع حوار الإعداد. المعاينة يعرض الصورة بخط عمودي متراكب عليها؛ هذا الخط يجب تتماشى مع الخط الأوسط لنمط الهدف. يمكن للشبكة الشفافة مع الخطوط الرأسية الأخرى للتأكد من أن المحور الضوئي متعامدة للهدف.
إجراء اختبار المعايرة:
- اختَر درجة دقة الصورة (باستخدام أداة الاختيار في أسفل يمين الشاشة)، ثم انقر على الشاشة لالتقاط صورة. يدخل الاختبار في وضع المعايرة لعرض الصورة مع خطين عموديين متراكبين على الصورة.
- تحديد الدقة:
- إذا تمت محاذاة الخطوط مع الخطوط الرأسية على النمط المستهدف في غضون بضعة سنتيمترات، فإن مجال الرؤية المبلغ عنه درجة الدقة المحددة.
- إذا لم تتم محاذاة الخطين، فهذا يعني أن مجال الرؤية الذي تم الإبلاغ عنه غير دقيق. لتصحيح هذا الخطأ، حرِّك شريط التمرير أسفل الشاشة إلى أن يتوافق التراكب مع النمط المستهدف قدر الإمكان. عندما تتم محاذاة التراكب وصورة النمط المستهدف، ومجال الرؤية المعروض هو تقريب كبير من يجب أن يكون مجال الرؤية الذي تم الإبلاغ عنه ضمن +/-2 درجة من قيمة المعايرة.
- اضغط على زر الرجوع وكرِّر اختبار المعايرة لجميع الصور. والدقة التي يدعمها 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 وقت النظام.
لحفظ نتائج الاختبار، انقر على رمز الحفظ (القرص) في أعلى القائمة. من فئات الاختبار
انتظر ظهور رسالة منبثقة تعرض مسار الملف إلى التقرير المحفوظ (لـ مثال،
/sdcard/verifierReports/ctsVerifierReport-date-time.zip)، ثم لتسجيل المسار.اربط DUT بالكمبيوتر الذي يعمل بنظام التشغيل Linux.
من تثبيت حزمة تطوير البرامج (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 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
لمحو نتائج النجاح/الإخفاق، حدد النتائج في تطبيق CTS Verifier حدد القائمة > محو.