UE Plugin

Android Crash Debugging

Setup

The easiest way to create a Debugging System requires "Android Studio".

After installing, verify that the settings look like in the picture below.

(Tip: Make sure you check the same android version as your phone uses. In this example it is "Android 7.0 (Nougat)")

Add the Android "platform-tools" path to your system's environmental path

For easier debugging on your Windows system, add the path to your Android sdk platform tools to the path variable.

To check whether you performed this step correctly, open a Command Prompt end type "adb".

If you get the message "command not found", then you probably did something wrong.

If your window is flooded with text like in the image below, you are ready for the next step.

Verify that your phone is connected to your computer

In a Command window, type "adb devices".

Below is a screenshot of how the result should look like.

(Tip #1: Make sure you're using a fresh Command Prompt window after adding the android sdk path to your system's environment.)

(Tip #2: Make sure your device is using the USB mode "Share Images" )

Some helpful scripts

The file "ADB_TOOLS.RAR" (attached to this page) contains two Windows scripts (*.bat files) for an even easier workflow:

  • adb_logcat_clean.bat - purge the current log on the connected device

  • adb_logcat_dump.bat - dump the current log from the connected device to a "logcat.log" file

Step by step usage instructions

  1. Install the apk to the connected device

  2. Execute the "adb_logcat_clean.bat" file to get a minimalized dump

  3. Execute the "adb_logcat_dump.bat" file right after a crash occurs on the device

  4. Analyze the created "logcat.log" to find the issue