aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorzocker-160 <36563538+zocker-160@users.noreply.github.com>2018-02-17 19:19:50 +0100
committerChristian Schneppe <kriztan@users.noreply.github.com>2018-02-17 19:19:50 +0100
commit4a965b991fe099fd1364e7e090a7c43776ed8024 (patch)
tree964f0da9fdcb7a3d32ee88939782c9d76899356b /README.md
parentfd05eceb19a143d3658fa00f3f7b74180a38129a (diff)
added instructions for Linux (#181)
and some minor enhancements
Diffstat (limited to 'README.md')
-rw-r--r--README.md81
1 files changed, 58 insertions, 23 deletions
diff --git a/README.md b/README.md
index 911e7959a..90a3bb4ac 100644
--- a/README.md
+++ b/README.md
@@ -3,6 +3,8 @@
Pix-Art Messenger ist eine Kopie der offiziellen Android-App [Conversations](https://github.com/siacs/Conversations) mit einigen Änderungen, insbesondere zur Verbesserung der Benutzerfreundlichkeit, um den Umstieg von oftmals vorinstallierten Messengern zu erleichtern.
+###### Jetzt auch im Google Play Store:
+
<a href="https://play.google.com/store/apps/details?id=de.pixart.messenger">
<img src="https://conversations.im/images/en-play-badge.png" alt="Google Play">
</a>
@@ -28,32 +30,65 @@ oder scanne den QR-Code:
Solltest du dort nicht weiter kommen kannst du hier ein Issue erstellen, in welchem du dein Problem genau beschreibst und welche Schritte erforderlich sind, um zu dem Problem zu gelangen.
#### 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. Falls noch nicht getan, lade dir die ADB Treiber für dein Betriebssystem von Google herunter, für Windows hier: https://developer.android.com/studio/run/win-usb.html
-3. Entpacke die zip (für Windows nach z.B. C:\ADB\)
+
+##### Linux:
+
+1. Installation von ADB
+ ###### Ubuntu / Linux Mint
+ ```
+ sudo apt-get update
+ sudo apt-get install android-tools-adb
+ ```
+ ###### openSUSE 42.2 und 42.3
+ ```
+ sudo zypper ref
+ sudo zypper install android-tools
+ ```
+ ###### openSUSE Tumbleweed
+ hier muss für das benötigte Packet folgende Repo eingebunden werden (z.B. bequem über Yast):
+ http://download.opensuse.org/repositories/hardware/openSUSE_Tumbleweed/
+
+ alternativ kann auch der `1 Click Installer` benutzt werden:
+ https://software.opensuse.org/package/android-tools
+
+2. Navigiere mit `cd` in das Verzeichnis deines Vertrauens und fahre mit Schritt [6] unter [Windows] fort. s.u.
+
+##### Windows:
+
+1. Lade dir die SDK-Plattform-Tools für dein Betriebssystem von Google herunter:
+
+ https://developer.android.com/studio/releases/platform-tools.html
+2. Falls noch nicht getan, lade dir die ADB Treiber für dein Betriebssystem von Google herunter, für Windows hier:
+
+ https://developer.android.com/studio/run/win-usb.html
+3. Entpacke die zip (z.B. nach C:\ADB\)
4. Öffne die Kommandozeile (CMD) mit Start > Ausführen: cmd
5. Wechsele in der Kommandozeile in das Verzeichnis C:\ADB wie folgt
-
- ```
- c:
- cd ADB
- ```
-
+ ```
+ c:
+ cd ADB
+ ```
6. 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.
7. In den `Entwickleroptionen` suchst du nach dem Eintrag `USB-Debugging` und aktivierst ihn.
8. Schließe dein Handy mit dem USB-Kabel an deinen PC an. Die erforderlichen Treiber sollten zumindest in Windows automatisch installiert werden.
9. 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
- ```
-10. Nun kannst du mit der Ausgabe der Debug-Logs beginnen. Dazu gibst du im CMD folgendes ein und die Ausgabe beginnt in die Datei `logcat.txt` im Verzeichnis `C:\ADB`:
- ```
- C:\ADB>adb -d logcat -v time | FINDSTR Pix-Art > logcat.txt
- ```
-11. Führe nun die Schritte aus, die zum Fehler führen.
-
-12. 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)
+ ```
+ > adb devices -l
+ List of devices attached
+ * daemon not running. starting it now on port 5037 *
+ * daemon started successfully *
+ 042111560169500303f4 unauthorized
+ ```
+10. Falls dein Handy als `unauthorized` markiert wird, sollte am Handy eine Meldung `USB-Debugging zulassen?` kommen, diese mit `OK` bestätigen, sodass bei `adb devices` folgendes dort stehen sollte:
+ ```
+ > adb devices
+ List of devices attached
+ 042111560169500303f4 device
+ ```
+11. Nun kannst du mit der Ausgabe der Debug-Logs beginnen. Dazu gibst du im CMD folgendes ein und die Ausgabe beginnt in die Datei `logcat.txt` im Verzeichnis `C:\ADB`:
+ ```
+ > adb -d logcat -v time | FINDSTR Pix-Art > logcat.txt
+ ```
+12. Führe nun die Schritte aus, die zum Fehler führen.
+
+13. 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)