| # **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. | |