"Wo finde ich Crash-Logs auf Streaming-Geräten und wie kann ich sie abrufen?"

Im Falle von Abstürzen auf einem Streaming-Gerät sind Geräteprotokolle bzw. Logs obligatorisch und ein wesentlicher Bestandteil deines Bug-Reports. Sie können auch nützlich sein, wenn eine App einfriert bzw. nicht mehr reagiert. Nur protokollierte Informationen können detaillierte Einblicke in die Umstände des Problems bieten.

In diesem Artikel erfährst du, wie du Log-Informationen für deine Streaming-Geräte abrufen kannst. Durch Anwendung dieser Techniken kannst du wertvolle Protokolldateien für deine Reports aufzeichnen und anhängen.

Um Crash-Logs von Android TV, Android-TV-Streaming-Geräten und FireOS zu erhalten, empfehlen wir die Verwendung der Android Debug Bridge (ADB).

Um Crash-Logs über ADB in Windows zu erhalten, musst du SDK Platform Tools herunterladen. Du kannst SDK Platform Tools hier herunterladen.

Für macOS musst du android-platform-tools mit Homebrew installieren. Installationsanweisungen findest du weiter unten in diesem Artikel.

Nach dem Herunterladen von SDK Platform Tools musst du die Dateien (den Ordner) extrahieren und dann den extrahierten Ordner öffnen. Klicke nach dem Öffnen dieses Ordners auf eine freie Stelle in der Adressleiste des Datei-Explorers, gib hier "cmd" ein und drücke ENTER auf deiner Tastatur. Dadurch wird das cmd (Command Prompt) in diesem Ordner gestartet und somit im Grunde auch ADB.

Zuerst musst du Homebrew über das Terminal installieren und anschließend android-platform-tools. Um Homebrew auf deinem macOS zu installieren, öffne bitte die Homebrew-Website und kopiere den Installationslink unter dem Abschnitt "Homebrew installieren". Füge den Link dann in das Terminal ein und drücke ENTER auf deiner Tastatur. Die Homebrew-Installation beginnt. Befolge die Installationsanweisungen bis zum Ende.

Nachdem Homebrew mit der Installation fertig ist, musst du android-platform-tools installieren. Besuche die Website "android-platform-tools Homebrew Formulae" und kopiere den Installationsbefehl. Füge diesen Befehl dann in das Terminal ein und drücke ENTER auf deiner Tastatur. Die Installation wird dann gestartet. Gib nach Abschluss der Installation "adb" ins Terminal ein und drücke ENTER. Wenn du adb-Befehle siehst, bedeutet dies, dass die Installation erfolgreich durchgeführt wurde.

Um Protokolle zu erstellen, musst du die USB/ADB-Debugging-Funktion in den Entwickleroptionen auf deinem Android TV / Android-TV-Streaming-Gerät und/oder FireOS aktivieren und Befehle im zuvor geöffneten cmd (Windows) oder Terminal (macOS) ausführen. Wenn du diese Optionen bereits aktiviert hast und die IP-Adresse deines Geräts kennst, kannst du zu Teil 2 übergehen.

1. Gib im zuvor geöffneten cmd (Windows) oder Terminal (macOS) "adb start-server" ein und drücke ENTER auf deiner Tastatur. Dadurch wird der ADB-Server gestartet.

2. Jetzt musst du deinen PC mit deinem Android TV / Android-TV-Streaming-Gerät oder deinem FireOS-Gerät verbinden. Stelle sicher, dass deine Geräte mit demselben Netzwerk verbunden sind.

3. Gib in der geöffneten Eingabeaufforderung (cmd) oder im Terminal adb connect device_ip_address (Beispiel: adb connect 192.168.100.136) ein und drücke die ENTER-Taste auf deiner Tastatur.

3a. Wenn du in der Eingabeaufforderung (cmd) oder im Terminal die Meldung "Fehler bei der Authentifizierung bei device_ip_address" siehst, liegt das wahrscheinlich daran, dass auf deinem Fernseher ein Bildschirm mit der Aufschrift "USB-Debugging zulassen?" angezeigt wird. Drücke auf diesem Bildschirm die OK-Taste. Außerdem kannst du die Option "Immer zulassen von diesem Computer" aktivieren und erneut auf OK tippen, um sicherzustellen, dass du nicht immer wieder dazu gefragt wirst, wenn du Crash-Protokolle abrufen willst.

4. Gib nun im cmd oder Terminal "adb devices" ein und drücke ENTER. Dadurch werden die mit deinem PC verbundenen Geräte aufgelistet. Vergewissere dich, dass dein Gerät in der Liste angezeigt wird.

5. Um eine Log-Datei für die reproduzierbaren Probleme zu erstellen, lösche zuerst die Log-Historie, um unnötige Inhalte zu entfernen, indem du "adb logcat -c" eingibst und mit ENTER bestätigst.

6. Jetzt ist es an der Zeit, die Logs zu erfassen.

6a. Wenn du eine Log-Datei im aktuellen Ordner erstellen möchtest (wo sich die Plattformtools unter Windows befinden), kannst du "adb logcat -v time > crashlog.txt" eingeben und ENTER auf der Tastatur drücken, wodurch der Log-Prozess gestartet wird.
​ 6b. Wenn du eine Log-Datei in einem anderen Ordner erstellen möchtest, musst du den Dateipfad dieses Ordners kopieren (unter Windows: Zum Zielordner navigieren --> Auf freien Platz in der Adressleiste des Datei-Explorers klicken --> Dateipfad kopieren; auf macOS: Ordner auswählen --> Mit der rechten Maustaste darauf klicken --> Kopieren). Nachdem du den Dateipfad kopiert hast, gib im cmd oder Terminal "adb logcat -v time > paste_file_path_here\log.txt" ein und drücke ENTER auf der Tastatur (Der Befehl unter Windows sollte so aussehen: "adb logcat -v time > D:\testIO\Logs\crashlog.txt"; auf dem Mac sollte er so aussehen: "adb logcat -v time > /Users/testIO/log/crashlog.txt"). Der Log-Prozess startet nach dem Drücken von ENTER.

7. Jetzt, da du mit dem Logging begonnen hast, reproduziere den Bug oder Absturz, für den du eine Log-Datei erstellen möchtest. Sobald du fertig bist, drücke im cmd oder Terminal CTRL+ C. Dadurch wird der Log-Prozess gestoppt und du solltest deine Log-Datei jetzt im angegebenen Ordner sehen.

Videoerklärung: 6a. - Erstellen eines Logs im aktuellen Ordner, in dem sich die Plattformtools befinden (Windows)

Videoerklärung: 6b. - Erstellen eines Logs in einem anderen Ordner (Windows)

Videoerklärung: 6b. - Erstellen eines Logs in einem anderen Ordner (Mac)

Abrufen von Crash-Logs auf Apple TV-Gerät ist ziemlich einfach und alles, was du dazu benötigst, ist ein Mac-PC oder ein iPhone / iPad, damit du die Logs über die AirDrop-Funktion übertragen kannst. Um dies zu tun, gehe folgendermaßen vor: