Vigtigt

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.

Anmeldelsesvejledning

Denne vejledning indeholder trinvis instruktioner til at rapportere fejl og problemer, du møder i Jami.

Indstil dit miljø

• Vær klar til datatab, sikkerhedskopier din konto og forbinder din konto med så mange enheder som muligt.

• Installer den nyeste version (eller endda en beta-version) af Jami. At rapportere fejl/problemer i forhold til ældre versioner er mindre nyttigt, og der er en sandsynlighed for, at det allerede er blevet rettet i nyere versioner.

Hvordan indberette en bug

0. Oprett en konto på [Jami GitLab]https://git.jami.net/users/sign_up) hvis du ikke allerede har en.

1. Vælg det rigtige projekt til at sende dit nummer i:

   • Det er en stor del af det, der er sket.

   • Det er ikke muligt at få en ny virksomhed til at deltage i et projekt.

   • Det er en stor del af det, der er sket.

   • (afviklet af )

   • Det Jami-projekt generelt (eller hvis du ikke er sikker)

   • [Hvis du ved, hvad du laver, kan du vælge et af de andre projekter]

2. Hvis du har flere problemer, skal du indgive separate fejlrapporter.

3. Titlen er en eksplicit sammenfatning af buggen (f.eks.: overskriften er for stor på grund af ikonstørrelsen)

4. Find ud af, hvordan du reproducerer buggen:

   • Hvis du har præcise trin til at reproducere det (fantastisk!) er du på vej til at oprette en nyttig bug-rapport.

   • Hvis du kan reproducere det lejlighedsvis, men ikke efter at have fulgt bestemte trin, skal du give yderligere oplysninger om problemet for at hjælpe andre til at forstå det og forsøge at reproducere det.

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

5. Sørg for at din software er opdateret.

6. Forsøg at isolere fra miljøet og reproducere (dvs. test på flere enheder).

7. Beskriv dit miljø ved at angive følgende:

   • OS-version

   • præcise enhedsmodel (vigtigt for mobile enheder)

   • hvis du bruger en beta-version

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

Skrive et klart resumé

Hvordan ville du beskrive buggen med ca. 10 ord? Dette er den første del af din bug-rapport en udvikler vil se.

Et godt resumé bør hurtigt og ensartet identificere en fejlrapport. Det skal forklare problemet, ikke din foreslåede løsning.

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"

Skrive præcise trin til at reproducere

• Hvordan kan en udvikler reproducere buggen på sin egen enhed?

  Hvis en udvikler er i stand til at reproducere buggen, er buggen meget sandsynligt at blive rettet. Hvis trinene er uklare, kan det måske ikke engang være muligt at vide, om buggen er blevet rettet. Vi er fuldt ud klar over, at nogle bugger kan se tydeligt ud for dig, men de er sandsynligvis relateret til dit miljø. Jo mere præcis du er, jo hurtigere buggen kan fikseres.

• Hvad skal du medtage i en bug-rapport?

  Angiv, om du kan reproducere buggen efter eget ønske, lejlighedsvis eller slet ikke. Beskriv din metode til at interagere med Jami ud over formålet med hvert trin. Efter dine trin, præcis beskrive det observerede (virkelige) resultat og det forventede resultat.

Good

Jeg kan altid reproducere ved at følge disse trin:

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.

Resultatet

Indfør følgende:

• Jami daemon (jamid eller libjami eller libring) og klient debug logs.

• Kjerne-dump, hvis en blev produceret.

Forventet resultat

Det er en beskrivelse af forventet eller ønsket adfærd.

Tilvejebringelse af yderligere oplysninger

Følgende oplysninger kræves for de fleste fejlrapporter. Du kan spare tid ved at angive disse oplysninger under de forventede resultater.

Bogen

Qt-baseret 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.

På GNU/Linux

Klassiske logs (i standard logs er kun >= advarselslogs logget):

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

Full log: Da Jami-klienten (GUI) og daemon er adskilte processer, er den nemmeste måde at få log fra begge er at starte dem en ad gangen, manuelt.

1. Sørg for, at der ikke kører nogen Jami-klient eller dæmon-instanser: tjek ved at køre ps aux ̊ grep jami i en terminal.

   • Jami kan stadig køre, selvom der ikke er vinduer åbne, afhængigt af dine præferencer.

   • Hvis enten klient eller daemon kører, skal du afslutte dem ved hjælp af kill PID.

2. I en terminal starter daemon med jamid -d -c

   • Denne udførbar er normalt ikke i PATH, og i Debian/Trisquel/Ubuntu pakker, er den placeret på /usr/lib/x86_64-linux-gnu/jamid -d -c eller /usr/libexec/jamid -d -c.

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

For at få et backtrace, kan du køre programmet inde i GDB:

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

Når det styrter, kan du skrive bt (eller endnu bedre, thread anvende alle bt) og derefter trykke på Enter.

På macOS

• Navigere til /Applications/Jami.app/Contents/MacOS/.

• Det vil starte Jami og printe loggen til terminal.

• Kopier loggen fra terminal til en fil.

Alternativt kan du køre /<path til Jami>/Jami.app/Contents/MacOS/Jami -d fra terminal.

På Android

For at indsamle logger via din telefon ved hjælp af Jami selv:

• Tryk på Samtaler

• Tryk på menuen med tre prikker øverst til højre

• Tryk på Indstillinger

• Tryk på Diagnostic logs

For at indsamle logg via din computer ved hjælp af Android Debug Bridge (adb):

• Du skal have AdB installeret på din computer.

• Løsning Jami på din smartphone og derefter udføre

• Jeg er ikke sikker på, at jeg kan få en ny bog.

• Du har nu en fil indeholdende loggen af klienten

Til Windows

Åbn en terminal (cmd.exe) og start Jami.exe med følgende muligheder:

• -d til at åbne et separat vindue på konsolen for at modtage logger

• -f til at skrive logs til % lokalt data%\jami\jami.log