Skip to content
Dominik edited this page Mar 16, 2017 · 4 revisions

How to gather logs with adb-tools.

1. Step "prepare device"

First of all, we need to prepare the device and enable USB debugging. To do this, the developer mode must be enabled:

Go: Settings> About (suborder Device)

Search for the entry "Build".

Now click on the entry "Build" several times, until the message "You are now developer" comes. You will get now a new entry in settings.

Go: Settings> Developer options (suborder Preferences)

Search for the entry "USB debugging" and activate it.

Now we have prepared our device for adb logging.

2. Step "adb-tools"

Get the adb-tools for your platform.

Windows:

https://dl.google.com/android/repository/platform-tools-latest-windows.zip

The easiest way is to unzip the tools into the root directory, which simplifies the navigation in the console.

e.g. c:\adb\

Linux:

https://dl.google.com/android/repository/platform-tools-latest-linux.zip

However you can get the tools over the repositories, but e.g. on ubuntu they will be outdated. Package is mostly known as > adb-tools. Because this, the better way is to get the latest package from google download server. Unzip to your home directory.

e.g: /home/“user“/adb/

Open a terminal, go to the adb dir and set adb executable. Ubuntu chmod +x adb

macOS

https://dl.google.com/android/repository/platform-tools-latest-darwin.zip

Dont know about macOS - you'll find it out.

3. Step "connect & authenticate"

Connect your Android TV to your PC. Depending on the model, e.g. Nexus Player or Nvidia Shield TV you need a microUSB-USB cable.

If you connect the first time your Android TV with the PC, you will get a message to authenticate your PC to the device.

Set the option to keep and confirm authentication.

4. Step "using adb"

Open the Terminal or command prompt on Windows.

Windows users open the command prompt as an administrator. Right click and "run as admin"

Navigate to the directory where you extracted the adb-tools.

e.g.:

cd c:\adb\

cd \home\”user”\adb\

Check the connection to the Android TV by enter:

adb devices

You will get a message like: "adb-server starting up" and then a list with the available devices.

If you see devices in the list you have done everything right.

Check your log by enter:

adb logcat

you can exit logcat with ctrl+x

Save log with:

adb logcat -d > logcat.txt (you will get a new file in your directory)

or

adb logcat -d > c:\path\to\what\ever\you\want\logcat.txt

adb logcat -d > /path/to/what/ever/you/want/logcat.txt

Clear log on your device with:

adb logcat -c

5. Step "reproduce error and upload logs"

Use adb logcat -c to clear log

Reproduce error, if possible several times.

Get the log by using

adb logcat -d > logcat.txt

Add your logcat.txt to a zip archiv. Now you can upload it to git by open an issue with error description and move the zip in the text field or upload it to what ever you want, report the error to G+ and give the link to the file.