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

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

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

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

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

  3. تجهيز جهازَين متطابقَين تحت الاختبار (DUT)، تم إعداد كل منهما باستخدام CTS-V

    • للحصول على معلومات عن إعداد جهاز DUT، يُرجى الاطّلاع على مقالة إعداد جهاز DUT.
    • للحصول على تعليمات حول إعداد CTS-V، يُرجى الاطّلاع على الإعداد.

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

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

إعداد اختبارات عادية باستخدام جهازَين

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

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

  2. لضمان بيئة نظيفة، ضَع كلا الجهازَين في علبة حماية.

  3. (اختياري) إعداد أداة فحص عبر الهواء لتصحيح أخطاء Wi-Fi

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

تستخدِم اختبارات NFC وحدة اختبار واحدة وشريحة NFC من طراز PN532.

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

  1. اشترِ شريحة NFC من طراز PN532. ننصحك باستخدام الوحدة المتكاملة PN532.

  2. على جهاز التحكّم في البيانات، انتقِل إلى تطبيق الإعدادات.

  3. فعِّل ميزة NFC.

  4. ضع شريحة NFC على النحو التالي:

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

      موضع شريحة NFC

      الشكل 1: موضع شريحة NFC

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

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

إعداد اختبارات منصّة إدارة البيانات

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

الإعفاء

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

يجب أن تجتاز الاختبارات عمليات الإنشاء القابلة لتصحيح الأخطاء بدون استثناء.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    الشكل 2: اختبارات الأجهزة المتعددة من جهة المضيف في تطبيق أداة التحقّق من مجموعة أدوات اختبار التوافق (CTS)

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

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

  4. في وحدة تحكّم cts-v-host، نفِّذ الأمر التالي: ملاحظة: إذا نقرت على وحدة من جهة المضيف في تطبيق CTS Verifier، لن تظهر لك قائمة بحالات الاختبار الفردية. بدلاً من ذلك، يتم ملء واجهة المستخدم تلقائيًا بنتائج اختبار الحالة بعد تنفيذ الوحدة على المضيف.

  5. في وحدة تحكّم xTS، نفِّذ الأمر التالي:

    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 أثناء إجراء اختبارات الأجهزة المتعددة، لن تتمكّن الاختبار من الوصول إلى لوحة NFC PN532.

لحلّ هذه المشكلة، حدِّد المسار التسلسلي الذي تستخدمه لوحة 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 في جهاز DUT اكتشاف PN532.

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

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

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

  • عليك فصل جميع الأجهزة غير DUT عن المضيف.

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

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