از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
بررسی و رفع اشکال
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
برای تأیید و اشکال زدایی پشته بلوتوث، از ابزارهای ارائه شده در تست های AOSP و گروه علاقه ویژه بلوتوث (SIG) استفاده کنید.
تست و تایید کنید
برای آزمایش پشته بلوتوث، AOSP ترکیبی از تست‌های واحد، تست‌های CTS و ابزارهای مجموعه تنظیم پروفایل بلوتوث (PTS) را ارائه می‌کند.
تست های واحد در AOSP
AOSP شامل تست های عملکردی و واحد برای پشته بلوتوث پیش فرض است. این تست ها در /packages/modules/Bluetooth/system/test/ قرار دارند. برای اجرای تست های AOSP موارد زیر را انجام دهید:
توقف اجرای اندروید:
adb shell stop
از دایرکتوری تست، فایل اجرایی پوسته را اجرا کنید و اگر می‌خواهید یک مجموعه آزمایشی یا آزمایشی خاص را اجرا کنید، گزینه‌هایی را در آن قرار دهید:
./run_unit_tests.sh TEST_GROUP_NAME TEST_NAME OPTIONS
پس از پایان تست ها، زمان اجرا اندروید را دوباره فعال کنید:
adb shell start
لیست نام های آزمون را می توان در /packages/modules/Bluetooth/system/test/README.md پیدا کرد.
مجموعه تنظیم پروفایل
بلوتوث 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 نگاه کنید.
برای استخراج snoop log از گزارش باگ، از اسکریپت btsnooz استفاده کنید.
btsnooz.py را دریافت کنید.
نسخه متنی گزارش اشکال را استخراج کنید.
btsnooz.py را روی نسخه متنی گزارش اشکال اجرا کنید:
btsnooz.py BUG_REPORT.txt > BTSNOOP.log
اشکال زدایی با لاگ ها
در اندروید 4.4 و بالاتر، می‌توانید به صورت دستی گزارش‌های BTSnoop را که شبیه فرمت snoop در RFC 1761 هستند، جمع‌آوری کنید. این گزارش‌ها بسته‌های رابط کنترل‌کننده میزبان (HCI) را ضبط می‌کنند. برای اکثر دستگاه‌های Android، گزارش‌ها در data/misc/bluetooth/logs ذخیره می‌شوند.
به دلایل حفظ حریم خصوصی، BTSnoop همیشه روشن، "در حافظه" فقط اطلاعات و رویدادهای غیر شخصی را ثبت می کند. برای ثبت همه داده ها، کاربر باید با انجام کارهای زیر بلوتوث HCI snoop را فعال کند:
گزینه های برنامه نویس را در دستگاه فعال کنید.
در منوی Developer options ، کلید Enable Bluetooth HCI snoop log را فعال کنید.
بلوتوث را مجدداً راه اندازی کنید تا ورود به سیستم اعمال شود.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-09-05 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-09-05 بهوقت ساعت هماهنگ جهانی."],[],[],null,["To verify and debug the Bluetooth stack, use the tools provided in AOSP\nand the Bluetooth Special Interest Group's (SIG) tests.\n\nTest and verify\n\nTo test the Bluetooth stack, AOSP provides a mix of unit tests, CTS tests,\nand tools for the Bluetooth Profile Tuning Suite (PTS).\n\nUnit tests in AOSP\n\nAOSP includes functional and unit tests for the default Bluetooth stack.\nThese tests are located in [`/packages/modules/Bluetooth/system/test/`](https://cs.android.com/android/platform/superproject/+/android-latest-release:packages/modules/Bluetooth/system/test/).\nTo run the AOSP tests, do the following:\n\n1. Stop the Android runtime:\n\n adb shell stop\n\n2. From the test directory, run the shell executable file and include\n options if you want to run a specific test or test suite:\n\n ./run_unit_tests.sh \u003cvar translate=\"no\"\u003eTEST_GROUP_NAME\u003c/var\u003e \u003cvar translate=\"no\"\u003eTEST_NAME\u003c/var\u003e \u003cvar translate=\"no\"\u003eOPTIONS\u003c/var\u003e\n\n3. When the tests finish, re-enable the Android runtime:\n\n adb shell start\n\nThe list of test names can be found in\n[`/packages/modules/Bluetooth/system/test/README.md`](https://cs.android.com/android/platform/superproject/main/+/main:packages/modules/Bluetooth/system/test/README.md).\n\nProfile Tuning Suite\n\nThe Bluetooth SIG provides the Bluetooth PTS, a\ntesting tool for protocol and profile interoperability. For more\ninformation, see the [Bluetooth Profile Tuning Suite](https://www.bluetooth.com/develop-with-bluetooth/test-tools/profile-tuning-suite)\nsite.\n\nCTS tests\n\nThe [Compatibility Test Suite](/docs/compatibility/cts) (CTS) includes\ntests for the Bluetooth stack. These are located in\n[`cts/apps/CtsVerifier/src/com/android/cts/verifier/bluetooth`](https://cs.android.com/android/platform/superproject/+/android-latest-release:cts/apps/CtsVerifier/src/com/android/cts/verifier/bluetooth).\n\nDebugging options\n\nAOSP provides different methods of debugging a device's Bluetooth stack,\nincluding logs and bug reports. These methods may not work for issues that\ncannot be reproduced or for audio issues, which can be affected by multiple\nparts of the platform and device.\n\nDebugging with bug reports\n\nTo check the Bluetooth service status using `dumpsys`, use the following\ncommand: \n\n adb shell dumpsys bluetooth_manager\n\nBy default, all log messages are trace level 2. To find out more about\nthe logging levels and change the logging levels for different profiles,\nlook in [`system/bt/conf/bt_stack.conf`](https://cs.android.com/android/platform/superproject/+/android-latest-release:packages/modules/Bluetooth/system/conf/bt_stack.conf).\n\nTo extract snoop logs from the bug report, use the `btsnooz` script.\n\n1. Get [`btsnooz.py`](https://cs.android.com/android/platform/superproject/+/android-latest-release:packages/modules/Bluetooth/system/tools/scripts/btsnooz.py).\n\n2. Extract the text version of the bug report.\n\n3. Run `btsnooz.py` on the text version of the bug report:\n\n btsnooz.py BUG_REPORT.txt \u003e BTSNOOP.log\n\nDebugging with logs\n\nIn Android 4.4 and later, you can manually collect BTSnoop logs, which\nresemble the snoop format in [RFC 1761](https://www.rfc-editor.org/rfc/rfc1761). These logs capture the Host\nController Interface (HCI) packets. For most Android devices, the logs are\nstored in `data/misc/bluetooth/logs`.\n\nFor privacy reasons, always-on, \"in-memory\" BTSnoop only logs non-personal\ninformation and events. To log all data, the user needs to enable\nBluetooth HCI snoop by doing the following:\n\n1. Enable **Developer options** on the device.\n\n2. In the **Developer options** menu, activate the **Enable Bluetooth\n HCI snoop log** toggle.\n\n3. Restart Bluetooth for logging to take effect."]]
