إجراء اختبارات NFC على أجهزة متعددة (Android 15)

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

استيفاء المتطلبات الأساسية

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

1. تجهيز جهاز مزوّد بتطبيق Android 15
2. اتّبِع متطلبات CTS-V.
3. اتّبِع خطوات إعداد CTS-V.

تجهيز جهاز DUT وقارئ NFC PN532 لإجراء الاختبار

بعد الانتهاء من الخطوات السابقة، اتّبِع الخطوات التالية لإجراء الاختبار: استعد لاختبار DUT وجهاز قراءة NFC PN532 باتّباع الخطوات التالية:

1. وصِّل جهاز DUT بجهاز مضيف عبر USB.
2. امنح المضيف أذونات للوصول إلى جهاز DUT عبر ADB.

3. ثبِّت تطبيق أداة التحقّق في مجموعة أدوات اختبار التوافق (CtsVerifier.apk) على جهاز التحقّق من الأجهزة (DUT):

   extract root/out/host/linux-x86/cts-verifier/android-cts-verifier.zip
   
   cd android-cts-verifier
   
   adb install -r -g CtsVerifier.apk
   

4. ثبِّت حِزم APK المطلوبة لاختبار NFC:

   cd MultiDevice
   
   adb install -r -g NfcEmulatorTestApp.apk
   

إعداد تقنية NFC لوحدة التحكّم في البيانات

اتّبِع الخطوات التالية لتشغيل إعداد NFC لوحدة التحكّم في الجهاز:

1. على جهاز DUT، انتقِل إلى قائمة الإعدادات.
2. ابحث عن قسم الاتصال القصير المدى (NFC) أو الأجهزة المتصلة.
3. تأكَّد من أنّ مفتاح التبديل الخاص بتقنية NFC مفعّل.

4. ضَع شريحة NFC على قارئ NFC في الهاتف باتّباع الخطوات التالية:

   1. احصل على شريحة NFC من طراز PN532. ننصح باستخدام الوحدة المتكاملة PN532 التي لا تتضمّن بلوتوث منخفض الطاقة.
   2. اربط شريحة PN532 NFC بالمضيف Linux باستخدام كابل USB.
   3. ضَع شريحة NFC PN532 فوق قارئ NFC في الهاتف كما هو موضّح في الصورة التالية:

   

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

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

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

1. نفِّذ هذه الأوامر لإعداد بيئة الاختبار:

   cd MultiDevice
   
   source build/envsetup.sh
   

   يتحقّق هذا الأمر من Python ويُعدّ متغيّر PYTHONPATH البيئة. إذا لم يتم طباعة أي أخطاء في المحطة الطرفية، تكون البيئة جاهزة لتشغيل اختبارات الأجهزة المتعددة.

   إذا ظهرت لك رسالة الخطأ libtinfo.so.6: no version information available (required by /bin/sh) أثناء التشغيل، نفِّذ الأمر التالي لإعادة تسمية ملف libtinfo.so.6:

   mv $ENV_DIRECTORY/lib/libtinfo.so.6 $ENV_DIRECTORY/lib/libtinfo.so.6.bak
   

2. يمكنك إعداد منصة الاختبار من خلال ضبط أرقام التعريف التسلسلية للجهازَين، وهما جهاز الاختبار وPN532 NFC reader في MultiDevice/config.yml:

   TestBeds:
     - Name: CtsNfcHceMultiDeviceTestCases-py-ctsv
       Controllers:
         AndroidDevice:
           - serial: "<device-id>"
       TestParams:
         pn532_serial_path: "<pn532-serial-path>"
   

إجراء اختبارات NFC

لإجراء اختبارات NFC:

1. افتح تطبيق CTS-V وانقر على اختبارات NFC:

   

   الشكل 2: تطبيق CTS-V

   تظهر نافذة المعلومات التي تتضمّن قائمة بحالات الاختبار:

   

   الشكل 3: حالات اختبار تطبيق CTS-V

2. يمكنك إجراء الاختبارات على المضيف باتّباع الخطوات التالية:

   MultiDevice$ python3 tools/run_all_tests.py
   

   عند اكتمال الاختبارات، يتم تعديل نتائجها في تطبيق CTS-V. تظهر الاختبارات الناجحة باللون الأخضر:

   

   الشكل 4: نتائج اختبار CTS-V

3. إذا ظهرت لك أيّ أخطاء مميّزة باللون الأحمر، استخدِم الأمر التالي لإعادة تنفيذ الاختبارات التي تعذّر إكمالها:

   python3 tools/run_all_tests.py --test_cases "`TestCaseA`" "`TestCaseB`" --test_files "`TestFileA`"
   

   المكان:

   • TestCaseA وTestCaseB هما اسما حالات الاختبار كما تظهر في CTS-V.
   • TestFileA هو ملف الاختبار الذي يحتوي على حالات الاختبار.

   مثلاً:

   python3 tools/run_all_tests.py --test_cases "test_conflicting_non_payment" "test_conflicting_non_payment_prefix" --test_files "CtsNfcHceMultiDeviceTestCases-py-ctsv"