اعتبارًا من عام 2026، ولضمان توافقنا مع نموذج التطوير الثابت الرئيسي وضمان استقرار المنصة في المنظومة المتكاملة، سننشر الرمز المصدري في "مشروع Android مفتوح المصدر" (AOSP) في الربع الثاني والربع الرابع. لإنشاء AOSP والمساهمة فيه، ننصحك باستخدام android-latest-release بدلاً من aosp-main. سيشير فرع البيان android-latest-release دائمًا إلى أحدث إصدار تم إرساله إلى AOSP. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android المفتوح المصدر (AOSP).

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

التحقّق من الأخطاء وتصحيحها

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

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

لاختبار حزمة بروتوكولات البلوتوث، يوفّر مشروع AOSP مجموعة من اختبارات الوحدة واختبارات مجموعة أدوات اختبار التوافق (CTS) وأدوات مجموعة أدوات ضبط ملفات البلوتوث (PTS).

اختبارات الوحدة في مشروع AOSP

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

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

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

مجموعة أدوات ضبط ملفات البلوتوث

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

اختبارات مجموعة أدوات اختبار التوافق (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.

احصل على الملف btsnooz.py.
استخرِج النسخة النصية من تقرير الخطأ.
شغِّل النص البرمجي btsnooz.py على النسخة النصية من تقرير الخطأ:
```
btsnooz.py BUG_REPORT.txt > BTSNOOP.log
```

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

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

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

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

التحقّق من الأخطاء وتصحيحها تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.