Pomembno

We are currently a small number of developers active on the project. As such, we cannot answer and tag all of the opened issues immediately, but we do notice and read them. Good bug reports provide us important feedback, which we thank you for and always appreciate.

Vodnik za poročanje o hroščih

Ta vodnik vsebuje natančna navodila za poročanje o hroščih in težavah, na katere naletite v Jamiju.

Ustvarite svoje okolje

  • Pripravite se na izgubo podatkov, varnostno kopijo računa in povežite svoj račun z čim več napravami.

  • Vključite najnovejšo različico (ali celo beta različico) Jamija.

Kako prijaviti napako

  1. Ustvarite račun na [Jami GitLab]https://git.jami.net/users/sign_up) če ga še nimate.

  2. Izberite pravi projekt za objavo svojega vprašanja v:

    • {gitlab-projekt}`Qt stranka

    • {gitlab-projekt}` iOS-klient

    • (odrešen z )

    • [Če veste, kaj počnete, lahko izberete enega od drugih projektov]https://git.jami.net)

  3. Če imate več težav, lahko vnesete ločene poročila o napakih.

  4. Naslov je izrecno povzetek napake (npr. vrhova trka je prevelika zaradi velikosti ikone)

  5. Izberite korake za reprodukcijo napake:

    • Če imate natančne korake za reproduciranje (pohlep!) ste na poti do ustvarjanja koristnega poročila o napakih.

    • Če lahko občasno ponovite, vendar ne po posebnih korakih, prosim, dajte dodatne informacije o tem vprašanju, da bi drugi razumeli in poskusili ponoviti.

    • If you can not reproduce the problem, there may be little chance of it being reasonably fixable. If you do report it, please try your best to provide as much information/clues about its occurrence as possible.

  6. Preverite, ali je programska oprema posodobljena.

  7. Poskusite izolirati od okolja in se razmnoževati (tj. testiranje na več napravah).

  8. Opišite svoje okolje (s) tako, da navedete naslednje:

    • OS različica

    • natančen model naprave (pomemben za mobilne naprave)

    • če uporabljate beta različico

    • what build you are using (F-Droid, Play Store, App Store, from dl.jami.net, your own build, etc.). If you have built your own version of Jami, please specify the exact Jami Daemon version and client version (you can obtain it using jamid -v and jami -v; but note that our packages are updated quite often) and the Git commit.

    • network conditions:

      • are both devices on the same local network?

      • Different networks?

      • Is one or both behind NAT?

      • Are you using LTE?

      • Are you using WiFi?

    • other elements if needed:

      • SIP provider,

      • hardware,

      • etc.

Pisanje jasnega povzetka

Kako bi opisal napako z približno 10 besedami?

Dobro povzetek mora hitro in edinstveno opredeliti poročilo o napakih in pojasniti problem, ne pa predlagano rešitev.

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"

Napisati natančne korake za razmnoževanje

  • Kako lahko razvijalci na svojem napravi reproducirajo napako?

    Če je programist sposoben reproducirati napako, je zelo verjetno, da bo napako popravljeno. Če so koraki nejasni, morda sploh ni mogoče vedeti, ali je napako popravljeno. V celoti vemo, da vam nekateri napaki morda izgledajo očitni, vendar so verjetno povezani z vašim okoljem.

  • Kaj bi morali vključiti v poročilo o napakih?

    Navedite, ali lahko napako po želji, občasno ali sploh ne. Opišite svojo metodo interakcije z Jamijem poleg namena vsakega koraka. Po svojih korakih natančno opišite opažen (istni) rezultat in pričakovani rezultat. Jasno ločite dejstva (opservacije) od špekulacij.

Good

Vedno se lahko razmnožujem z naslednjimi koraki:

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.

Bad

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

Dosegli rezultat

Prosimo, vključite:

  • Jami demon (jamid ali libjami ali libring) in klienten log debug.

  • Če je bil izdelan, je bil to odpadek.

Pričakovani rezultat

Opis pričakovanega ali želenega vedenja.

Dodatne informacije

Za večino poročil o napakih se zahtevajo naslednje informacije.

Vlog

Klient Jami na podlagi Qt (GNU/Linux, Windows, macOS)

Go to the General settings. In the Troubleshoot section, you can click on „Open logs“, where you will be able to get statistics („Show stats“) or start recording information via „Receive logs“. Then you can just copy the result and explain your scenario.

Na GNU/Linux

Klasični dnevni dnevni dnevi (po privzetem času se evidentirajo samo dnevni dnevni dnevi >= opozorilo):

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. Preverite, da ni več nobenega klijenta ali demona v poklicu: preverite z poklicom `ps aux ‬ grep jami ‬ v terminalu.

    • Jami lahko še vedno deluje, čeprav okna niso odprta, odvisno od vaših želja.

    • Če so delujoči klienti ali demoni, jih prekini z uporabo kill PID.

  2. V enem terminalu začnite z jamid -d -c

    • Ta izvedljiv delnik običajno ni v PATH, v paketih Debian/Trisquel/Ubuntu pa se nahaja na /usr/lib/x86_64-linux-gnu/jamid -d -c ali /usr/libexec/jamid -d -c.

  3. In another terminal, start the client, using jami -d.

Če želite slediti, lahko program izkoristite v GDB:

gdb -ex run --args jami -d, or gdb -ex run --args /usr/libexec/jamid -cd, depending on the component you need to debug.

Ko se ne bo, lahko vpisate bt (ali še bolje, thread uporabite vse bt) in pritisnete Enter. Nato kopirate sled in jo vklopite v številko.

Na macOS

  • Navigajte na /Applications/Jami.app/Contents/MacOS/.

  • Dvakrat kliknite Jami in bo sprožil Jami in natisnil dnevnik na terminal.

  • Kopirajte dnevnik iz terminala v datoteko.

Alternativno lahko iz terminala izkoristite /<pot do Jami>/Jami.app/Contents/MacOS/Jami -d.

Na Androidu

Da zbiraš dnevne zapise preko telefona z uporabo Jamija:

  • Kliknite Prepravke

  • Na vrh desno pritisnite menije s tremi točkami

  • Vpiši Uprava

  • Kliknite na Diagnostic logs

Za zbiranje dnevnikov preko računalnika z uporabo mosta za odpravo odkodov Android (adb):

  • Na računalniku moraš imeti AdB.

  • Izstreli Jamija na pametnem telefonu in nato izvršite

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

  • Zdaj imate datoteko, ki vsebuje dnevnik klienta.

Za okna

Odprite terminal (cmd.exe) in zagnite Jami.exe z naslednjimi možnostmi:

  • -d odpreti ločeno okno konzole za sprejem dnevnikov

  • -f za pisanje dnevnikov v %localappdata%\jami\jami.log