التحقق وتصحيح الأخطاء

للتحقّق من حزمة البلوتوث وتصحيح الأخطاء فيها، استخدِم الأدوات المتوفّرة في اختبارات AOSP و"مجموعة الاهتمامات الخاصة بالبلوتوث" (SIG).

الاختبار والتحقق

لاختبار حزمة البلوتوث، توفّر خدمة AOSP مزيجًا من اختبارات الوحدات واختبارات CTS والأدوات الخاصة بـ "حزمة ضبط الملف الشخصي للبلوتوث".

اختبارات الوحدات في AOSP

يتضمّن AOSP اختبارات وظيفية واختبارات وحدة لحزمة البلوتوث التلقائية. تتوفّر هذه الاختبارات في /packages/modules/Bluetooth/system/test/. لإجراء اختبارات AOSP، اتّبِع الخطوات التالية:

  1. إيقاف وقت تشغيل Android:
    adb shell stop
  2. من دليل الاختبار، شغِّل الملف القابل للتنفيذ في واجهة أوامر وضمِّن الخيارات إذا كنت تريد تشغيل اختبار أو مجموعة اختبار محدّدة:
    ./run_unit_tests.sh TEST_GROUP_NAME TEST_NAME OPTIONS
  3. عند انتهاء الاختبارات، أعِد تفعيل بيئة تشغيل Android:
    adb shell start

يمكن العثور على قائمة أسماء الاختبارات في /packages/modules/Bluetooth/system/test/README.md.

حزمة توليف الملف الشخصي

توفّر خدمة Bluetooth SIG حزمة ضبط الملف الشخصي للبلوتوث (PTS)، وهي أداة اختبار لإمكانية التشغيل التفاعلي للبروتوكول والملف الشخصي. لمزيد من المعلومات، يُرجى الانتقال إلى موقع مجموعة أدوات ضبط الملف الشخصي للبلوتوث.

اختبارات CTS

تتضمن مجموعة أدوات اختبار التوافق (CTS) اختبارات لحزمة البلوتوث. مَوْجُودْ جِهِةِ الْاتِّصَالْ دِي فِي cts/apps/CtsVerifier/src/com/android/cts/verifier/bluetooth.

خيارات تصحيح الأخطاء

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

تصحيح الأخطاء باستخدام تقارير الأخطاء

للتحقق من حالة خدمة البلوتوث باستخدام dumpsys، استخدِم الأمر التالي:

adb shell dumpsys bluetooth_manager

وتكون جميع رسائل السجل من المستوى 2 تلقائيًا. للاطّلاع على مزيد من المعلومات عن مستويات التسجيل وتغيير مستويات التسجيل للملفات الشخصية المختلفة، انتقِل إلى system/bt/conf/bt_stack.conf.

لاستخراج سجلّات التطفل من تقرير الأخطاء، استخدِم النص البرمجي btsnooz.

  1. احصل على btsnooz.py.
  2. استخراج النسخة النصية من تقرير الخطأ
  3. تشغيل btsnooz.py على الإصدار النصي من تقرير الخطأ:
    btsnooz.py BUG_REPORT.txt > BTSNOOP.log

تصحيح الأخطاء باستخدام السجلات

وفي الإصدار Android 4.4 والإصدارات الأحدث، يمكنك جمع سجلات BTSnoop يدويًا التي تشبه تنسيق التطفل في RFC 1761. تلتقط هذه السجلات حزم واجهة وحدة تحكم المضيف (HCI). بالنسبة إلى معظم أجهزة Android، يتم تخزين السجلّات في data/misc/bluetooth/logs.

لأسباب تتعلق بالخصوصية، لا تسجِّل مجموعة BTSnoop المفعَّلة دائمًا من حيث الذاكرة سوى المعلومات والأحداث غير الشخصية. لتسجيل جميع البيانات، يحتاج المستخدم إلى تفعيل التطفل عبر واجهة وحدة تحكم المضيف للبلوتوث من خلال تنفيذ ما يلي:

  1. فعِّل خيارات المطوّرين على الجهاز.
  2. في القائمة خيارات المطوّرين، فعِّل مفتاح التبديل تفعيل سجلّ التطفل على واجهة وحدة تحكم المضيف للبلوتوث.
  3. يُرجى إعادة تشغيل البلوتوث لكي يتم تفعيل التسجيل.