Важно

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.

Упутник за извештавање о бубарима

Овај водич укључује корак по корак инструкције за пријаву грешки и питања са којима се суочавате у Џами.

Уреди своју окружење

Бидите спремни за губитак података. Задржите свој рачун и повезите свој рачун са што више уређаја.
Instalirajte najnoviju verziju (ili čak beta verziju) Jami-ja. Prijavljivanje grešaka/problema u odnosu na starije verzije je manje korisno i postoji verovatnoća da je već ispravljeno u novijim verzijama.

Како пријавити буг

Napravite nalog na Jami GitLab ako ga već nemate.
Изаберите прави пројекат за објављивање вашег издања у:
- {gitlab-пројекат}Андроидски клијент <jami-клијент-android>
- {gitlab-пројекат}Клиент КТ <jami-клиент-qt>
- {gitlab-пројекат}Иосовски клијент <jami-клијент-ios>
- MacOS клијент (опакован од Qt клијент)
- {gitlab-projekt}`Проект Џами у целини (или ако нисте сигурни)
- [Ако знате шта радите можете изабрати један од других пројеката]
Ако имате више проблема, молимо вас да подносите одвојене извештаје о грешкама.
Назва је експлицитно сузреће грешке (на пример: шефа за наслов је превише велика због величине икона)
Пронађите кораке за репродукцију грешке:
- Ако имате прецизне кораке за репродукцију (успомњујући!) на путу сте да креирате користан извештај о грешкама.
- Ако можете да се репродуктујете повремено, али не након што сте пратили одређене кораке, молимо вас да пружите додатне информације о питању како би другима помогли да то разумеју и покушају да се репродуктују.
- 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.
Proverite da li je vaš softver ažuriran. U idealnom slučaju, testirajte verziju u razvoju da vidite da li je vaša greška već ispravljena.
Покушајте да се изолирате од окружења и репродукцију (тј. тест на више уређаја).
Опишите своју окружење (s) наведајући следеће:
- Верзија оперативног система
- прецизни модел уређаја (важан за мобилне уређаје)
- ako koristite beta verziju
- 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.

Написање јасног резюмера

Како бисте описали грешку користећи око 10 речи? Ово је први део вашег извештаја о грешци који ће програмер видети.

Добро резюме треба брзо и јединствено идентификовати извештај о грешци.

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"

Написање прецизних корака за репродукцију

Kako programer može da reprodukuje grešku na svom ili njenom uređaju?

Користи за репродукцију су најважнији део било ког извештаја о грешкама. Ако програмер може да репродукција грешке, грешка је веома вероватно да ће бити исправљена. Ако кораци нису јасни, можда чак није могуће знати да ли је грешка исправљена. Ми смо потпуно свесни да неки грешке могу изгледати очигледни за вас, али они су вероватно повезани са вашим окружењем. Што сте прецизнији, брже се грешка може исправљати.
Шта треба да укључите у извештај о грешкама?

Уписајте да ли можете да репродукцију грешке по жељи, повремено, или уопште. Опишите свој метод интеракције са Џамиом поред намере сваког корака. Након ваших корака, прецизно опишете посматрани (фактички) резултат и очекивани резултат. Јасно одвојте чињенице (набљуђења) од спекулација.

Good

Увек могу да се репродукцију следећи кораци:

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.

Добијен резултат

Молимо вас да укључите:

Дајмон Џами (џамид или либами или либринг) и клијентски дебог дневници.
Једре одломке ако је било произведено.

Очекивани резултат

То је опис очекиваног или жељеног понашања.

Додавање додатних информација

Следеће информације се захтевају за већину извештаја о грешкама. Можете уштедјети време подавањем ове информације испод очекиваних резултата.

Логови

Клујент Jami на бази 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.

На ГНУ/Линуксу

Класични дневници (по уморној логи су регистровани само >= упозорење):

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.

Uverite se da nije pokrenuta instanca Jami klijenta ili demona: proverite pokretanjem ps aux | grep jami u terminalu.
- Џами може и даље да ради, чак и ако није отворено прозоре, у зависности од ваших преференција.
- Ако је клиент или демона у току, прекините га користећи kill PID.
У једном терминалу, започети демона са jamid -d -c
- Овај извршавајући се обично не налази у ПАТХ, а у дебијанским/трисквел/убанту пакетима налази се на /usr/lib/x86_64-linux-gnu/jamid -d -c или /usr/libexec/jamid -d -c.
In another terminal, start the client, using jami -d.

Да бисте добили повратну трагу, можете покренути програм у ГДБ:

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

Када се сруши, можете да напишете bt (или још боље, thread применити све bt) а затим притиснете Enter.

На макосу

Навигирајте на /Applications/Jami.app/Contents/MacOS/.
Двојно кликните на Џами и она ће лансирати Џами и штампати дневник на терминал.
Копирујте дневник из терминала у датотеку.

Алтернативно, можете покренути /<пут до Jami>/Jami.app/Contents/MacOS/Jami -d са терминала.

На Андроиду

Да бисте сакупили дневнике преко телефона користећи саму Џамију:

Dodirnite Razgovori
Натискајте мену са три тачке у горњем десном
Натискајте Сеттинг
Натицајте Дагностички регистар

Да бисте сакупили часописе преко рачунара користећи Android Debug Bridge (adb):

Треба да имате АДБ на рачунару.
Пустите Џами на свој паметни телефон и онда извршите
``` `
Сада имате датотеку која садржи дневник клијента

За Виндовсе

Отвори терминал (cmd.exe) и покрети Jami.exe са следећим опцијама:

-d да се отвори одвојено прозоре конзоле за пријем дневних књига
-f да пише дневнике на % локални подаци%\jami\jami.log