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

تحتوي هذه الصفحة على تعليمات حول استخدام اختبارات CTS Verifier (CTS-V) على أجهزة متعددة لإصدار Android 16 والإصدارات الأحدث.

إعداد اختبارات ميزة "استخدام الأجهزة المتعددة" من جانب المضيف

يوضّح هذا القسم كيفية إعداد اختبارات على أجهزة متعددة.

  1. تأكَّد من أنّ جهاز الكمبيوتر المكتبي يستوفي متطلبات نظام التشغيل الخاصة بـ CTS.
  2. اتّبِع الخطوتَين 2 و5 من تثبيت برامج سطح المكتب للتأكّد من تثبيت adb وAAPT2 وPython بشكل صحيح على جهاز الكمبيوتر.

  3. جهِّز جهازَين متطابقَين قيد الاختبار، مع إعداد CTS-V على كل منهما.

  4. إذا كنت تختبر وحدة غير وحدة NFC، اتّبِع الخطوات الواردة في إعداد اختبارات عادية على جهازَين.

  5. إذا كنت تختبر وحدة CDM، اتّبِع الخطوات الواردة في إعداد اختبارات CDM بالإضافة إلى عملية الإعداد العادية على جهازَين.

إعداد اختبارات عادية على جهازَين

بالنسبة إلى عملية الإعداد التلقائية على جهازَين:

  1. ضَع جهازَي Android متطابقَين على بُعد 20 سم تقريبًا.

  2. لضمان توفير بيئة نظيفة، ضَع كلا الجهازَين في صندوق محمي.

  3. (اختياري) إعداد أداة تتبُّع OTA لتصحيح أخطاء Wi-Fi

إعداد اختبارات NFC

تستخدم اختبارات NFC جهازًا واحدًا قيد الاختبار وشريحة NFC PN532.

لإعداد اختبارات NFC، اتّبِع الخطوات التالية:

  1. اشترِ شريحة PN532 NFC. ننصح باستخدام All-In-One PN532.

  2. على الجهاز قيد الاختبار، انتقِل إلى تطبيق الإعدادات.

  3. فعِّل ميزة الاتصال القصير المدى (NFC).

  4. ضَع شريحة NFC في الموضع التالي:

    • بالنسبة إلى الهواتف، ضَع قارئ NFC الخاص بالجهاز قيد الاختبار على النحو الموضّح في الشكل 1:

      تحديد موضع شريحة NFC

      الشكل 1. تحديد موضع شريحة NFC

    • بالنسبة إلى أنواع الأجهزة الأخرى، ضَع الشريحة بجانب هوائي الاتصال بالحقل القريب (NFC) في الجهاز.

  5. وصِّل شريحة PN532 NFC بمحطة عمل الاختبار باستخدام كابل USB.

إعداد اختبارات إدارة المحتوى الرقمي (CDM)

تتضمّن حالة الاختبار test_permissions_sync() سلوكًا مختلفًا حسب نوع الإصدار للأجهزة التي يتم تنفيذ الاختبار عليها. من الضروري أن يختبر المصنّعون الأصليون للأجهزة كلاً من الإصدارات التي يمكن تصحيح أخطائها (userdebug أو eng) والإصدارات التي لا يمكن تصحيح أخطائها (user)، وأن تجتاز الاختبارات كلا النوعين.

الإعفاء

لا يشترط بند "اتفاقية المطوّرين" الخاص بتنفيذ واجهة برمجة التطبيقات لمزامنة الأذونات سوى أن تكون قادرة على نقل البيانات بنجاح بين الأجهزة عبر قناة آمنة. بما أنّ تنفيذ القناة الآمنة ليس من متطلبات الامتثال لمتطلبات التحقّق من هوية العميل، يمكن تخطّي هذا الاختبار في الإصدارات غير القابلة لتصحيح الأخطاء (المخصّصة للمستخدمين)، ولكن فقط إذا أردت إيقاف ميزة مزامنة أذونات CDM.

يجب أن تجتاز الاختبارات الإصدارات التي يمكن تصحيح أخطائها بدون استثناء.

المتطلبات الأساسية للاختبار على الإصدارات غير القابلة لتصحيح الأخطاء

إذا لم تكن معفيًا بموجب بنود الإعفاء السابقة، تأكَّد من استيفاء المتطلبات الأساسية التالية.

تستخدم القناة الآمنة إطار عمل AVF (AttestationVerificationFramework) للتحقّق من موثوقية الأجهزة. تحتوي الشهادات التي يصدرها كلا الطرفين على عدة معلومات عن أنفسهم لضمان عدم حدوث أي تغيير غير مصرّح به في نظامهم. تتحقّق ميزة "التحقّق من صحة الجهاز" من الحالات التالية أثناء عملية التحقّق:

  • الجهاز متصل بالإنترنت
  • يستخدم الجهاز ميزة "التحقّق من صحة التمهيد"، ويجب توقيع الإصدار باستخدام مفتاح إصدار، وليس مفتاح تطوير.
  • برنامج إقلاع الجهاز مقفل. للحصول على تعليمات مفصّلة، يُرجى الاطّلاع على مقالة قفل برنامج التشغيل.
  • أن تكون مستويات تصحيح نظام التشغيل وتشغيل المفتاح ومورّد المفتاح في غضون 12 شهرًا لا تستخدِم إصدارًا أقدم من عام

  • تستند عملية إثبات صحة الجهاز إلى إحدى شهادات الجذر التي وافق عليها المورّد. حدِّد شهادات الجذر الموثوق بها في تراكب المورد vendor_required_attestation_certificates.xml.

إجراء اختبارات على أجهزة متعددة من جهة المضيف (الإصدار 16 من AOSP أو إصدار أحدث)

يتيح الإصدار 16 من CTS Verifier إجراء اختبارات على أجهزة متعددة من جهة المضيف. يمكن تنفيذ هذه الاختبارات باستخدام نصوص برمجية مبرمَجة على المضيف، بدلاً من عملية الاختبار اليدوي على الجهاز. بعد اكتمال كل اختبار، يتم تلقائيًا تحميل النتائج إلى الجهاز قيد الاختبار وعرضها في تطبيق CTS Verifier.

يوضّح هذا القسم كيفية إجراء اختبارات الأجهزة المتعدّدة من جهة المضيف.

إجراء اختبارات على أجهزة متعددة

لإجراء اختبار على أجهزة متعددة، اتّبِع الخطوات التالية:

  1. على محطة العمل الاختبارية، شغِّل وحدة تحكّم cts-v-host من الدليل الذي تم فيه فك حزمة zip الخاصة بـ CTS-V:

    ./android-cts-verifier/android-cts-v-host/tools/cts-v-host-tradefed

  2. من داخل تطبيق CTS Verifier على الجهاز قيد الاختبار، انقر على الاختبارات من جهة المضيف. يوضّح الشكل 2 الاختبارات التي يتم إجراؤها على الجهاز المضيف في تطبيق CTS Verifier:

    اختبارات الأجهزة المتعدّدة من جهة المضيف في تطبيق CTS Verifier

    الشكل 2. إجراء اختبارات على أجهزة متعدّدة من جهة المضيف في تطبيق CTS Verifier

    يتم عرض قائمة بوحدات اختبار متعددة الأجهزة على جانب المضيف.

  3. حدِّد اسم وحدة الاختبار التي تريد تنفيذها. على سبيل المثال، يتم إدراج وحدة CompanionDeviceManager على النحو التالي: CtsCompanionDeviceManagerMultiDeviceTestCases.

  4. في وحدة تحكّم cts-v-host، نفِّذ الأمر التالي:

    run cts-v-host -m test_module_name

    مثلاً:

    run cts-v-host -m CtsCompanionDeviceManagerMultiDeviceTestCases

    بعد أن تنتهي وحدة تحكّم xTS من تنفيذ الاختبارات، تظهر النتائج في تطبيق CTS Verifier. تشير الاختبارات التي تم وضع علامة خضراء بجانبها إلى أنّها اجتازت الاختبار. تعذّر اجتياز الاختبارات المميّزة باللون الأحمر. تعرض الصورة 3 نتائج نموذجية لاختبارات CtsCompanionDeviceManager:

    نتائج اختبار الأجهزة المتعدّدة من جانب المضيف في تطبيق CTS Verifier

    الشكل 3. نتائج اختبار الأجهزة المتعدّدة من جانب المضيف في تطبيق CTS Verifier

تحديد المشاكل في الاختبارات على أجهزة متعدّدة وحلّها

يقدّم هذا القسم مساعدة في تحديد المشاكل المحتملة وحلّها.

حلّ مشكلة "لم يتم تلقّي أي ردّ على GetFirmwareVersion" أثناء اختبارات NFC

إذا تلقّيت الرسالة verify_firmware_version RuntimeError: No response for GetFirmwareVersion أثناء إجراء اختبارات الأجهزة المتعددة، يعني ذلك أنّه لا يمكن للاختبارات الوصول إلى لوحة PN532 NFC.

لحلّ هذه المشكلة، حدِّد مسار الرقم التسلسلي الذي تستخدمه لوحة PN532 NFC على المضيف، مثل dev/ttyUSB1، ثم حدِّده يدويًا باستخدام الوسيطة --module-arg في وحدة التحكّم:

run cts-v-host -m CtsNfcHceMultiDeviceTestCases --module-arg CtsNfcHceMultiDeviceTestCases:pn532_serial_path:/dev/ttyUSB1

حلّ رسالة الخطأ "تعذّر إجراء المعاملة" أثناء اختبارات الاتصال القصير المدى (NFC)

إذا تلقّيت الرسالة Transaction failed, check device logs for more information. لجميع حالات اختبار الاتصال القصير المدى (NFC)، من المحتمل أن يكون ذلك بسبب عدم قدرة شريحة الاتصال القصير المدى (NFC) في الجهاز الخاضع للاختبار على رصد PN532.

إذا كانت لديك أجهزة متعددة متصلة بالجهاز المضيف، ولم يكن بعضها مزوّدًا بشريحة PN532 في الأعلى، قد يكون تم اختيار الجهاز الخاطئ. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد اختبارات NFC.

لحلّ هذه المشكلة، اتّبِع أحد الإجراءَين التاليَين:

  • اضبط الرقم التسلسلي الصحيح للجهاز الخاضع للاختبار في أمر الاختبار على الجهاز المضيف باستخدام العلامة -s.

  • افصِل جميع الأجهزة غير جهاز الاختبار عن الجهاز المضيف.

تم تجاهل حالة اختبار CDM test_permissions_sync

إذا كان الاختبار يتم إجراؤه على أجهزة لا يمكن تصحيح أخطائها، اطّلِع على ما إذا كنت معفيًا. وإلا، تأكَّد من استيفاء كلا الجهازين المتطلبات الأساسية.