aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorChristian Schneppe <kriztan@users.noreply.github.com>2017-02-07 09:04:39 +0100
committerGitHub <noreply@github.com>2017-02-07 09:04:39 +0100
commit1e27e07d533afd1a07562bce82d7e01977700378 (patch)
tree64057f68703b84fa95e388ee092d2bc362555811 /README.md
parenta8d81dc839f6410ebafca463a785d44e1d3ea8bb (diff)
add description how to debug via adb logcat
Diffstat (limited to 'README.md')
-rw-r--r--README.md37
1 files changed, 35 insertions, 2 deletions
diff --git a/README.md b/README.md
index 69ae4d248..b4084a765 100644
--- a/README.md
+++ b/README.md
@@ -3,9 +3,42 @@
Pix-Art Messenger ist eine Kopie der offiziellen Android-App [Conversations](https://github.com/siacs/Conversations) mit einigen Änderungen.
-Welche Version soll ich herunterladen?
+####Welche Version soll ich herunterladen?
1. Du hast einen eigenen XMPP Server? Dann wähle die open-Variante
-2. Du hast keinen eigenen XMPP-Server? Dann wähle die free-Variante, mit der Du Zugriff auf meinen Server hast. So kannst Du ohne Aufwand sofort loslegen.
+2. Du hast keinen eigenen XMPP-Server? Dann wähle die free-Variante, mit der du Zugriff auf meinen Server hast. So kannst du ohne Aufwand sofort loslegen.
+
+####Wie erstelle ich Debug- bzw. ADB-Logs?
+1. Lade dir die SDK-Plattform-Tools für dein Betriebssystem von Google herunter: https://developer.android.com/studio/releases/platform-tools.html
+2. Entpacke die zip (für Windows nach z.B. C:\ADB\)
+3. Öffne die Kommandozeile (CMD) mit Start > Ausführen: cmd
+4. Wechsele in der Kommandozeile in das Verzeichnis C:\ADB wie folgt
+
+ ```
+ c:
+ cd ADB
+ ```
+
+5. Auf deinem Telefon gehst du in die Einstellungen und suchst nach dem Punkt `Entwickleroptionen`. Sollte dieser bei dir nicht vorhanden sein, musst du diese Optionen erst noch freischalten. Dazu wechselst du in den Einstellungen in den Punkt `über das Telefon` und suchst dort nach `Buildnummer` oder Ähnlichem. Diese Zeile musst Du mindestens 7 mal hintereinander antippen, es sollte dann ein Hinweis eingeblendet werden, der dir bestätigt, dass du nun Entwickler bist.
+6. In den `Entwickleroptionen` suchst du nach dem Eintrag `USB-Debugging` und aktivierst ihn.
+7. Schließe dein Handy mit dem USB-Kabel an deinen PC an. Die erforderlichen Treiber sollten zumindest in Windows automatisch installiert werden.
+8. Wenn alles ohne Fehler geklappt hat, kannst du wieder in die Kommandozeile gehen und testen, ob alles funktioniert. Gib dazu in CMD `adb devices -l` ein, es sollte in etwa sowas bei dir stehen:
+
+ ```
+ C:\ADB>adb devices -l
+ List of devices attached
+ * daemon not running. starting it now on port 5037 *
+ * daemon started successfully *
+ 8551198ade34b951 unauthorized
+ ```
+9. Nun kannst du mit der Ausgabe der Debug-Logs beginnen. Dazu gibst du im CMD folgendes ein:
+
+ ```
+ C:\ADB>adb -d logcat -v time | FINDSTR Pix-Art > logcat.txt
+ ```
+
+ und die Ausgabe beginnt in die Datei `logcat.txt`im Verzeichnis `C:\ADB`.
+10. Führe nun die Schritte aus, die zum Fehler führen.
+11. Zum Schluss schaue dir die `logcat.txt` an, lösche ggf. persönliche Angaben und sende diese Datei zur Problemlösung mit einer Beschreibung des Fehlers und was man tun muss, um diesen Fehler zu erhalten, an mich. Nutz dafür den Menüpunkt [Issues](https://github.com/kriztan/Pix-Art-Messenger/issues)
Weitere Informationen git es unter http://jabber.pix-art.de