Fontos

Jelenleg kevés fejlesztő vesz részt a projektben. Ezért nem tudunk azonnal válaszolni és megjelölni az összes megnyitott kérdést, de észrevesszük és elolvassuk őket. A jó hibajelentések fontos visszajelzést adnak nekünk, amit köszönünk, és mindig nagyra értékelünk.

Hibabejelentési útmutató

Ez az útmutató lépésről lépésre tartalmaz utasításokat a Jami-ben tapasztalt hibák és problémák bejelentéséhez.

Környezet beállítása

  • Készüljön fel az adatvesztésre. Készítsen biztonsági másolatot fiókjáról, és kapcsolja össze fiókját a lehető legtöbb eszközzel.

  • Telepítse a Jami legújabb verzióját (vagy akár egy béta verzióját). A régebbi verziókkal kapcsolatos hibák/problémák jelentése kevésbé hasznos, és fennáll annak a valószínűsége, hogy az újabb verziókban már kijavították.

Hogyan jelentsünk hibát

  1. Hozzon létre egy fiókot a Jami GitLab oldalon, ha még nem rendelkezik fiókkal.

  2. Válassza ki a megfelelő projektet a probléma közzétételéhez:

  3. Ha több problémája van, kérjük, küldjön külön hibajelentést. Sokkal könnyebb lesz így nyomon követni őket.

  4. A cím a hiba explicit összefoglalása (pl.: a fejléc túl nagy az ikon mérete miatt)

  5. Fontolja meg a hiba megismétlésének lépéseit:

    • Ha meg kell ismételnie a pontos lépéseket (nagyszerű!), akkor már úton van egy hasznos hibajelentés elkészítése felé.

    • Ha időnként meg tudja ismételni, de bizonyos lépések végrehajtása után nem, kérjük, adjon meg további információkat a problémáról, hogy segítsen másoknak megérteni és megpróbálni megismételni.

    • Ha nem tudja megismételni a hibát, akkor kicsi az esélye annak, hogy ésszerűen javítható. Ha mégis bejelenti, kérjük, próbáljon meg minél több adatot/nyomokot közölni az előfordulásáról.

  6. Győződjön meg arról, hogy szoftvere naprakész. Ideális esetben teszteljen egy fejlesztés alatti verziót, és ellenőrizze, hogy a hibát javították-e már.

  7. Próbáljon meg elszigetelni a környezettől és az ismétléstől (vagyis tesztelje több eszközön).

  8. Jellemezze környezeteit a következők megadásával:

    • Operációs rendszer verziója

    • pontos eszközmodell (fontos mobileszközök esetén)

    • ha béta verziót használ

    • milyen buildet használsz (F-Droid, Play Store, App Store, a dl.jami.net webhelyről, saját építkezés stb.). Ha elkészítette a saját Jami verzióját, kérjük, adja meg a pontos Jami-rendszerfolyamat verziót és az Jami-ügyfél verziót (ezt a „jamid -v” és a „jami -v” használatával szerezheti be; de ​​vegye figyelembe, hogy csomagjaink gyakran frissülnek) és a Git-elkötelezett.

    • hálózati feltételek:

      • mindkét eszköz ugyanazon a helyi hálózaton van?

      • Különböző hálózatok?

      • Az egyik vagy mindkettő NAT mögött van?

      • LTE vezeték nélküli szélessávú kommunikációt használ?

      • Wi-Fi vezeték nélküli hálózatot használ?

    • egyéb elemek, ha szükséges:

      • SIP-szolgáltató,

      • hardver,

      • stb.

Egyértelmű összefoglaló írása

Hogyan jellemeznéd a hibát körülbelül 10 szóval? Ez a hibajelentés első része, amelyet a fejlesztő láthat.

Egy jó összefoglalónak gyorsan és egyértelműen azonosítania kell a hibajelentést. A problémát kell magyaráznia, nem a javasolt megoldást.

Good: "Cancelling a file transfer crashes Jami"
Bad: "Software crashes"

Good: "All calls hang up after 32 seconds"
Bad: "Not able to call my friends"

Pontos lépések megismétlése

  • Hogyan tudja egy fejlesztő megismételni a hibát a saját eszközén?

    Az ismétlődő lépések minden hibajelentés legfontosabb részét képezik. Ha egy fejlesztő képes megismételni a hibát, nagy valószínűséggel kijavítják a hibát. Ha a lépések nem egyértelműek, előfordulhat, hogy nem is lehet tudni, hogy a hibát javították-e. Tisztában vagyunk vele, hogy bizonyos hibák nyilvánvalónak tűnhetnek az Ön számára, de valószínűleg a környezetével kapcsolatosak. Minél pontosabb, annál gyorsabban javítható a hiba.

  • Mit kell szerepeltetni a hibajelentésben?

    Jelezze, hogy megismételheti-e a hibát tetszés szerint, alkalmanként vagy egyáltalán nem. Az egyes lépések szándéka mellett írja le a Jamival való interakciós módszert. Lépései után pontosan írja le a megfigyelt (tényleges) és a várt eredményt. Világosan válassza el a tényeket (megfigyeléseket) a találgatásoktól.

Jó

Mindig meg tudom ismételni az alábbi lépéseket követve:

1. Start Jami by clicking on the desktop icon
2. Start a new conversation with anyone
3. Click the file transfer icon

Expected results: A window opens and asks me to choose a file to send.
Actual results: When I click the file transfer icon, nothing happens.

Hibás

Try to transfer a file.
It doesn't work.

Megszerzett eredmény

Kérjük, a következőket tartalmazza:

  • A Jami-rendszerfolyamat (jamid vagy libjami vagy libring) és az ügyfél hibakeresési naplói.

  • A maglerakás, ha előállították.

Várható eredmény

Az elvárt vagy kívánt viselkedés leírása.

További adatok megadása

A legtöbb hibajelentéshez a következő információkra van szükség. Időt takaríthat meg, ha megadja ezeket az információkat a Várható eredmény szakasz alatt.

Naplók

Qt-alapú Jami-ügyfél (GNU/Linux, macOS, Windows)

Lépjen az Általános beállításokhoz. A Hibaelhárítás részben kattintson a „Naplók megnyitása” lehetőségre, ahol statisztikákat kaphat („Statisztikák megjelenítése”), vagy elkezdheti az információk rögzítését a „Naplók lekérése” segítségével. Másolja le az eredményt, és magyarázza el a forgatókönyvet.

GNU/Linux rendszeren

Klasszikus naplók (alapértelmezés szerint csak a naplók >= figyelmeztetések kerülnek naplózásra):

journalctl --since "24h ago" | grep jami

Full log: The Jami client (GUI) and daemon are separate processes. To obtain logs from both processes, start each process manually, one at a time.

  1. Győződjön meg arról, hogy nem fut Jami-ügyfél vagy Jami-rendszerfolyamat példány: ellenőrizze a ps aux | grep jami terminálban.

    • A beállításoktól függően előfordulhat, hogy a Jami akkor is fut, ha egyetlen ablak sem van nyitva.

    • Ha akár ügyfél, akár rendszerfolyamat fut, zárja le őket a kill PID használatával.

  2. Az egyik terminálban indítsa el a rendszerfolyamatot a jamid -d -c paranccsal

    • Ez a végrehajtható fájl általában nem található a PATH-ban, a Debian/Trisquel/Ubuntu csomagokban pedig a /usr/lib/x86_64-linux-gnu/jamid -d -c vagy a /usr/libexec/jamid -d -c helyen található.

  3. Egy másik terminálban indítsa el az ügyfelet a jami -d használatával.

A visszakövetéshez futtassa a programot a GDB (GNU Project Debugger - GNU projekt hibakereső) eszközben:

gdb -ex run --args jami -d vagy gdb -ex run --args /usr/libexec/jamid -cd, attól függően, hogy melyik összetevőt kell hibakeresni.

Amikor összeomlik, beírhatja a bt szót (vagy még jobb, a thread apply all bt-t`), majd nyomja meg az Enter-billentyűt. Ezután másolja ki a visszakövetést, és illessze be a hibaszámba.

macOS rendszeren

  • Keresse meg az /Applications/Jami.app/Contents/MacOS/ mappát.

  • Kattintson duplán a Jami alkalmazásra. Elindítja a Jami alkalmazást, és kinyomtatja a naplót a terminálra.

  • Másolja a naplót a terminálról egy fájlba.

Egy másik lehetőség a /<path to Jami>/Jami.app/Contents/MacOS/Jami -d parancs futtatása a terminálról.

Android rendszeren

A naplók gyűjtése a telefonon keresztül magának Jaminak a használatával:

  • Koppintson a Beszélgetések elemre

  • Koppintson a jobb felső sarokban található ⋮ (függőleges ellipszis) menüre

  • Koppintson a Beállítások elemre

  • Koppintson a Diagnosztikai naplók elemre

A naplók összegyűjtése a számítógépen keresztül az adb (Android Debug Bridge - Android-hibakeresőhíd) segítségével:

  • A számítógépen be kell állítania az adb-eszközt.

  • Indítsa el a Jamit az okostelefonon, majd futtassa

  • adb logcat *:D | grep `adb shell ps | egrep 'cx.ring' | cut -c10-15` > logring.txt

  • Most van egy fájl, amely az ügyfél naplóját tartalmazza

Windows rendszerhez

Nyisson meg egy terminált (cmd.exe), és indítsa el a Jami.exe alkalmazást a következő kapcsolókkal:

  • -d egy külön kezelőpult ablak megnyitásához a naplók fogadásához

  • -f naplók írásához a %localappdata%\jami\jami.log fájlba