How to create a system log (logcat)

This page is currently under construction.

Please do not translate this page.

Creating a logcat (debug log) should not be a big deal for you, but it often greatly help to debug and fix issues.

First you need ADB (Android Debug Bridge) on your PC. If it's not installed yet, you can follow this description of the K-9 Mail Team.

You will need to do the following:

Phone

• Connect your phone to your PC.
• Choose "USB Debugging" if your phone ask: "Only Charge" or "USB Debugging"
• Enable "Settings" -> "Developer Settings" -> "USB-Debugging" (your mileage may vary).
• Reproduce the steps to the issue you discovered

After having reproduced the issue, you'll have a few minutes to do the following on your computer, because logs will be rotated after some time.

PC (Linux-based only)

• Open a terminal
• Make sure that your phone is connected via USB cable and unlocked (Android might ask for verification on first connection)
• Enter adb logcat -d | grep `adb shell ps | grep org.kontalk | cut -c10-15` >kontalk-log.txt in the terminal
• Now you will find a file named kontalk-log.txt in the current directory

E-mail this file to devteam (at) kontalk.org. It's possible that this file contains sensitive data. Never post its content in public or anywhere else on the Internet.