Capturing Oppia app Debug Log Output

To help with fixing bugs, there may be some times when having access to the full app debug log from the phone can be very useful. The steps below describe how to capture the Oppia debug log output to assist with bug fixing:

  1. Install adb on your laptop (see: https://www.howtogeek.com/125769/how-to-install-and-use-abd-the-android-debug-bridge-utility/)

  2. Enable USB debugging on your phone/device (under Settings > System > Developer Options, you may need to enable developer options first - see: https://android.tutorials.how/enable-developer-options/)

  3. Connect your phone to the laptop

  4. Open the Oppia app on your phone

  5. On the command line on your laptop run one of the following commands ( depending on which operating system your laptop has):

    • Ubuntu/Linux: adb logcat | tee ~/oppia-output.txt

    • Windows: adb logcat >> C:\oppia-output.txt

  6. Go through the steps/process to recreate the error on your phone.

  7. After you have caused the error, you can press Ctrl+C to stop the debug log capturing.

Note

If the developer options have been enabled on a users phone/device, it would be best to disable the developer options after the log output has been saved (again, see: https://android.tutorials.how/enable-developer-options/)