Retrieving QuickCapture crash logs on Android

458
0
10-24-2021 07:15 PM
JohnathanHasthorpe
Esri Regular Contributor
0 0 458

When using QuickCapture and the application crashes, the generated log files (logcat) can be retrieved to perform diagnostics and troubleshooting. However, as the app does not have Developer mode enabled by default, the log files can only be retrieved using the Android SDK developer toolset.

Procedure

The following workflow can be performed for non-rooted Android devices to extract the log files. However, prior to reproducing the error to generate and extract the log file, Developer mode must be activated on the Android device. A Windows computer is required to perform the extraction.

Warning:   
This workflow involves using Android SDK tools and is not supported by Esri.
  1. On the Android device, navigate to Settings > About device, and tap the Build Number option seven times to enable developer mode.

    Note: On some Android devices, the Build Number option can be accessed via Settings > About phone > Software information.

  2. Navigate back to the Settings menu, open Developer options > enable the USB debugging option.
  3. For Android devices running on versions 5.0 or later, increase the Log buffer sizes to 4 MB per log buffer.

    Note: 4MB is sufficient for storing the logs. However, this can be increased as needed.

  4. Open QuickCapture and reproduce the error. This generates the log file.
  5. Connect the Android device to a computer with a USB cable.
  6. Download Android SDK Platform Tools, and extract the contents to the computers c:\ drive.
  7. Open the extracted c:\platform-tools folder and ensure adb.exe exists.
  8. In Windows Search, type in cmd and then select Command Prompt and Run as administrator.
    JohnathanHasthorpe_3-1635127303559.png

     

  9. In the command prompt, perform the following:
    1. Change the directory by typing CD, followed by the extraction destination directory. For example:
      CD C:\platform-tools
    2. Enter the following command:
      adb logcat -v threadtime -d > C:\platform-tools\logcat.txt
  10. The log file (logcat.txt) is now extracted to the destination folder using verbose logging.

    Note: For more information on understanding the log file, refer to Reading Bug Reports.