Tähtis

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.

Bug-aruandluse juhend

See juhend sisaldab samm-sammut juhiseid vigade ja probleemide kohta, mida sa Jami’s kohtud.

Seadista oma keskkond

  • Ole valmis andmete kaotamiseks. Varusta oma konto ja seada oma konto võimalikult paljudele seadmetele.

  • Aseta Jami uusima versiooni (või isegi beetaversiooni). Vanemate versioonide puhul on vigade/probleemide kohta teatamine vähem kasulik ja on tõenäoline, et seda on juba uusemates versioonides parandatud.

Kuidas saan teatada veast

  1. Loe konto [Jami GitLab]https://git.jami.net/users/sign_up) kui sul ei ole seda juba.

  2. Oma veast teavitamiseks vali õige projekt:

    • Androidi klient

    • Qt klient

    • {gitlab-projekt}`iOS-i klient ‘

    • (depregeeritud )

    • [Kui sa tead, mida teed, võid valida üks teistest projektidest]

  3. Kui teil on mitu probleemi, esitage eraldi vigade raportid.

  4. pealkiri on katki eksplisiit kokkuvõte (nt pealkirja pööra on liiga suur ikoni suuruse tõttu)

  5. Selgitage, kuidas segadust paljendada:

    • Kui teil on täpsed sammud seda (suurepärane!) taasesinda, siis olete teel, et luua kasulik bug-aruanne.

    • Kui saate seda teha mõnikord, kuid mitte pärast konkreetseid samme, siis andke palun täiendavat teavet selle kohta, et aidata teistel seda mõista ja proovida seda teha.

    • 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. Veenduge, et teie tarkvara on ajakohas.

  7. Püüa isoleerida keskkonda ja paljundada (st katsetamine mitmel seadmel).

  8. Kirjelda oma keskkonda, täpsustades järgmist:

    • OS versioon

    • täpsed seadme mudelid (mis on olulised mobiilseadmete jaoks)

    • kui kasutate beetaversiooni

    • 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?

      • Kas sa kasutad LTE-ühendust?

      • Kas sa kasutad WiFi-ühendust?

    • other elements if needed:

      • SIP provider,

      • hardware,

      • etc.

Kirjutada selge kokkuvõte

Kuidas kirjeldaksite viga umbes 10 sõna abil? See on esimene osa teie vigaaruandes, mida arendaja näeb.

Hea kokkuvõte peaks kiiresti ja ainulaadselt tuvastama vigadearuande.

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"

Täpseid sammude kirjutamine, mida teha.

  • Kuidas saab arendaja oma seadmes selle viga paljustada?

    Kui arendaja suudab viga uuesti teha, on väga tõenäoline, et viga saab parandada. Kui sammud on ebatäpsed, ei pruugi isegi teada, kas viga on parandatud. Me oleme täiesti teadlikud, et mõned vigad võivad teile ilmselgelt välja näha, kuid nad on tõenäoliselt seotud teie keskkonnaga. Mida täpsem olete, seda kiiremini saab viga parandada.

  • Mida peaksite sisaldama bug-aruandes?

    Märkige, kas saate viga tahtlikult, aeg-ajalt või mitte üldse paljustada. Kirjelda oma meetodit Jamiga suhtlemiseks lisaks iga sammu eesmärgile. Pärast oma sammu, kirjeldage täpselt jälgitud (tegelikku) tulemust ja oodatavat tulemust. Eristage faktid (observatsioonid) selgelt spekulatsioonidest.

Good

Ma võin alati paljundada järgides neid sammu:

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.

Saadud tulemus

Palun lisa:

  • Jami daemon (jamid või libjami või libring) ja kliendi defeg logid.

  • Põhjus on hävitatud, kui seda on toodetud.

Ootatav tulemus

See on oodatava või soovitud käitumise kirjeldus.

Lisateave esitamine

Enamiku vigade raportide puhul nõutakse järgmist teavet.

Pärisõidukid

Qt-põhine Jami klient (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.

GNU/Linuxis

Klassilised logid (põhimõtteliselt registreeritakse ainult >= hoiatuste logid):

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. Veenduge, et ei ole Jami kliendi või daemon esinemisi käivitakse: kontrollige käivitades ps aux 〇 grap jami terminaalis.

    • Jami võib ikka veel käia, isegi kui aknad on lahti, sõltuvalt teie eelistustest.

    • Kui kas kliend või daemon töötab, lõpetage nad kasutades kill PID.

  2. Ühes terminaalis alustada daemon jamid -d -c

    • See täidetav ei ole tavaliselt PATH, ja Debian/Trisquel/Ubuntu paketes asub see /usr/lib/x86_64-linux-gnu/jamid -d -c või /usr/libexec/jamid -d -c.

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

Et saada tagasisidet, saate programmi GDB sees käivitada:

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

Kui see katkeb, võite kirjutada bt (või veelgi parem, thread rakendada kõik bt) ning siis paista Enter.

MacOSis

  • Navigeerige /Applications/Jami.app/Contents/MacOS/.

  • Kaks klikka Jami, see paneb Jami tööle ja trükib terminalli log.

  • Kopeeri log terminalt failile.

Alternatiivina võite rakendada /<tee Jami>/Jami.app/Contents/MacOS/Jami -d terminaalt.

Androidis

Saate aru saada oma telefoni kaudu Jami’i abil:

  • Rõõm Sõnad

  • Pange kolm punkti menüü paremas kohal

  • Rõm Settings

  • Rõm Diagnostik logs

Arvuti kaudu andmete kogumiseks Android Debug Bridge (adb):

  • Sa pead oma arvutisse AdB seadistama.

  • Lähed Jami oma nutitelefonil ja siis täideta

  • Ma ei saa seda teha. Ma ei saa seda teha.

  • Sul on nüüd faili, mis sisaldab kliendi logit.

Akna jaoks

Avage terminal (cmd.exe) ja käivita Jami.exe järgmiste võimalustega:

  • -d avada eraldi konsooli aken logide vastuvõtmiseks

  • -f kirjutada logid %localappdata%\jami\jami.log