Here are some key points for bug reporting
@tanvirr007• Report bugs properly with logs
• If you report bugs while using Magisk, LSPosed, or any third-party modules, I won't consider them valid
A Comprehensive Guide to Proper Bug Reporting in AOSP
Encountering issues while using a custom ROM or kernel is common, and developers often request logs like logcat, dmesg, or ramoops to diagnose the problem. Here's a detailed guide on how to obtain and share these logs effectively, relevant for themers, ROM developers, and kernel developers.
1. Using an App
Getting a logcat:
- Download a logcat app like Matlog from the Play Store.
- Grant root permissions if required.
- Clear the buffer and select the desired log types.
- Record the log while reproducing the issue.
- Stop recording and send the generated file to the developer/themer.
2. Getting a dmesg:
- Use a dmesg app or a terminal emulator.
- Access root privileges and save the dmesg output to a file.
- Share the generated file with the developer.
3. Getting a ramoops:
- Via system: Navigate to /sys/fs/pstore, copy the ramoops file to the sdcard, and share it with the kernel developer.
- Via recovery: Access TWRP recovery, navigate to /sys/fs/pstore, copy the ramoops file to /sdcard, and share it with the relevant party.
2. Using ADB
i. Setup ADB:
- Download and extract the latest ADB tools.
- Connect your device and ensure it's recognized.
ii. Capture Logs:
- Clear logcat buffer and capture logs using ADB commands.
- Save the logs to a file and provide them to the appropriate party.
Proper Bug Reporting Etiquette
1. Understand that developers do this as a hobby and be patient with issue resolution.
2. Clearly describe the issue with reproducible steps.
3. Detail the steps already attempted to resolve the problem.
4. Mention any scenarios or ROMs where the issue didn't occur.
5. If technically inclined, suggest possible solutions or relevant commits.
Adhering to these guidelines fosters effective communication and enhances the chances of timely issue resolution.
Base Credits: https://github.com/nathanchance/android-tools
Modified by: @tanvirr007