====== How to create a system bug report ======

----

Some issues may require deeper investigation by Locus Map developers. In these cases, a helpdesk representative may ask you to send a bug report from your Android device. Follow the steps in this article to unlock developer options, create a bug report, and send it to helpdesk:
===== Android OS generally =====

  - open the settings of your device and make sure you can access “Developer options”. In case you do not see this option in the settings list, please follow the instructions e.g., [[https://www.esper.io/blog/capturing-bug-reports-from-android-devices|here >>]].
  - repeat the action in Locus Map that causes the crash
  - move to the above-mentioned “Developer options” in the settings of your device
  - enable USB debugging
  - select **Take bug report** {{ :manual:faq:create_debug_log_01.jpg |}}
  - wait a few minutes for the report to be created (it may take up to a few minutes)
  - the bug report should appear in your notification bar. From there (or from "Developer options"), you may send it via email to <locus.map@asamm.com> or better, upload to a Dropbox/Google Drive/OneDrive, etc., and share it with us (reports can be bigger than 15 MB and then they are not correctly attached to email). {{ :manual:faq:create_debug_log_02.jpg |}}
==== Android 7.0+ ====
After tapping "Take bug report," you are offered two types of reports - Interactive and Full. **Select Interactive**. 
===== Xiaomi - MIUI ROMs =====

==== MIUI 8 and newer ====
  - tap *#*#284#*#* on your phone dial
  - copy the bug report from your memory directory //sdcard/miui/debug_log//

==== MIUI 7  and older ====

  - install the **CatLog** application (available on the Google Play for free)
  - go to //Security > Permissions > Root access// > Allow root access to CatLog
  - go on the same way as in the case of devices with Android OS older than 4.1

===== General solution for all Android versions=====

Instructions below are used for creating a detailed log but the procedure is more complicated.

  - Download **[[https://gofile.me/7ecf2/1o1L4ea8Y|ADB installer]]**
  - Run it
  - Press Y/Yes to install ADB and Fastboot or N/No to skip
  - Press Y/Yes to install ADB system-wide or N/No for current user only 
  - Press Y/Yes to install Drivers or N/No to skip
  - Continue Driver installation
  - launch the **command line** WIN+R > CMD > Enter
  - connect your phone to the PC via USB
  - repeat the error action
  - input **adb bugreport > c:/Users/myusername/locus_log.txt** in the command line
  - press Enter
  - wait until the bug report is done
  - **zip the bugreport** (it's huge - over 30 MBs) **and send it to <locus.map@asamm.com>**