File size: 3,183 Bytes
f5f56a5 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 |
# **The Complete Guide to Capturing AI Edge Gallery Bug Reports for ANDROID devices**
Thank you for helping us improve the AI Edge Gallery app\! To find and fix bugs effectively, our engineers need detailed diagnostic information from your device. A **Full Bug Report** is the best way to provide this.
Please note that this guide is specifically for capturing bug reports on **Android devices**.
This guide covers the simple on-device method for all users and the more advanced `adb` method for developers.
### **Part 1: The Recommended Method (On Your Device)**
This is the fastest and easiest way to generate a complete bug report.
#### **1\. Enable Developer Options**
First, you need to enable the hidden "Developer options" menu on your phone.
* Open your phone's **Settings** app.
* Scroll down and tap **"About phone"**.
* Find the **"Build number"** and tap on it **7 times** in a row. You will see a "You are now a developer\!" message.
#### **2\. Capture the Bug Report**
It's best to capture the report **immediately after** you've experienced the bug.
* Go back to the main **Settings** page and find the new **"Developer options"** menu (it may be under "System").
* Inside Developer options, tap **"Take bug report"**.
* Select the **"Full report"** option and tap **"Report"**. This provides the most detailed information and is strongly preferred.
#### **3\. Wait and Share**
* Your phone will take a moment to collect all the data. When it's ready, a notification will appear saying **"Bug report captured"**.
* Tap this notification.
* The Android share menu will open. You can now share the `.zip` file with us. The easiest way is to **save it to your Google Drive** and share the link, or attach it directly to the GitHub issue.
### **Part 2: For Developers & Advanced Users (Using ADB)**
This section is for users comfortable with the Android Debug Bridge (`adb`) command-line tool.
#### **Capture a Bug Report Directly**
If you have a device connected to your computer with USB debugging enabled, you can use the following commands.
* **For a single connected device:**
```shell
# This saves the report to the specified path on your computer.
adb bugreport C:\Reports\MyBugReports
```
* **For multiple connected devices:**
```shell
# First, list devices to get the serial number.
adb devices
# Then, use the serial number to target the correct device.
adb -s <your_device_serial_number> bugreport
```
#### **Access Older Bug Reports from Your Device**
Android automatically saves recent bug reports on the device.
1. **List Saved Reports:**
```shell
adb shell ls /bugreports/
```
2. **Pull a Specific Report:**
```shell
adb pull /bugreports/<bug_report_filename.zip>
```
#### **Understanding the Bug Report File**
Your bug report is a `.zip` file. Inside, the most important file is **`bugreport-[...].txt`**. This text file contains the full system log (logcat), error logs (`dumpstate`), and detailed diagnostic output for all system services (`dumpsys`), giving engineers a complete picture of the device's state at the time of the bug.
|