Viktigt

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.

Användare av en förpackning

Denna guide innehåller stegvis instruktioner för att rapportera fel och problem du möter i Jami.

Ställ in din miljö

  • Var beredd på att data går förlorade.

  • Installa den senaste versionen (eller till och med en beta-version) av Jami. Att rapportera fel/problem mot äldre versioner är mindre användbart och det finns en sannolikhet att det redan har åtgärdats i nyare versioner.

Hur man rapporterar en bugg

  1. Skapa ett konto på [Jami GitLab]https://git.jami.net/users/sign_up) om du inte redan har ett.

  2. Välj rätt projekt för att lägga ut ditt nummer i:

    • Det är en bra idé att få en bra bild av det.

    • Det är inte bara en fråga om att få en person att få en person att få en person att få en person att få en person att få en person att få en person att få en person att få en person att få en person att få en person att få en person att få en person att få en person att få en person att få en person att få en person att få en person att få en person att få en person att få en person att göra det.

    • Det är inte en bra idé att göra det.

    • (fördröjd av )

    • Det Jami-projektet i allmänhet (eller om du inte är säker)

    • [Om du vet vad du gör kan du välja ett av de andra projekten]

  3. Om du har flera problem, kan du skicka separat felrapporter. Det blir mycket lättare att hålla reda på dem på det sättet.

  4. Titeln är en explicit sammanfattning av buggen (t.ex. headerbar är för stor på grund av ikonstorlek)

  5. Ta reda på hur man kan reproducera buggen:

    • Om du har exakta steg för att reproducera det (bra!) är du på väg att skapa en användbar buggrapport.

    • Om du kan reproducera ibland, men inte efter att ha följt specifika steg, kan du ge ytterligare information om frågan för att hjälpa andra att förstå och försöka reproducera den.

    • 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. Se till att programvaran är uppdaterad.

  7. Försök att isolera från miljön och reproducera (dvs. test på flera enheter).

  8. Beskriv din miljö (s) genom att ange följande:

    • OS-version

    • Exakt modell av enheten (viktig för mobila enheter)

    • om du använder 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.

Skriva en tydlig sammanfattning

Hur skulle du beskriva buggen med ungefär 10 ord?

En bra sammanfattning bör snabbt och unikt identifiera en felrapport. Den bör förklara problemet, inte din föreslagna 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"

Skriv exakta steg för att reproducera

  • Hur kan en utvecklare reproducera buggen på sin egen enhet?

    Steg för att reproducera är den viktigaste delen av alla felrapporter. Om en utvecklare kan reproducera fel, är fel mycket sannolikt att åtgärdas. Om stegen är oklara, kan det inte ens vara möjligt att veta om fel har åtgärdats. Vi är helt medvetna om att vissa fel kan verka uppenbara för dig, men de är sannolikt relaterade till din miljö. Ju mer exakt du är, desto snabbare kan felen åtgärdas.

  • Vad bör du innehålla i en buggrapport?

    Ange om du kan reproducera buggen efter eget önskemål, ibland eller inte alls. Beskriv din metod för att interagera med Jami utöver avsikten i varje steg. Efter dina steg, beskriv exakt det observerade (faktiska) resultatet och det förväntade resultatet.

Good

Jag kan alltid reproducera genom att följa dessa steg:

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

Vänligen inkludera:

  • Jami-daemon (jamid eller libjami eller libring) och klientdebug loggar.

  • Kärnskasset om det tillverkades.

Förväntat resultat

Det är en beskrivning av förväntat eller önskat beteende.

Tillhandahållande av ytterligare information

Följande information begärs för de flesta felrapporter.

Lågar

Qt-baserad 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

Klassiska loggar (avsnittet är endast >= varning loggar):

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

Full logg: Eftersom Jami-klienten (GUI) och daemon är separata processer, är det enklaste sättet att få loggar från båda att starta dem en efter en, manuellt.

  1. Se till att ingen Jami-klient eller daemon instanser körs: kontrollera genom att köra `ps aux ̊ grep jami ̊ i en terminal.

    • Jami kan fortfarande vara på gång även om inga fönster är öppna, beroende på dina preferenser.

    • Om någon av klienterna eller demonen körs, avsluta dem med kill PID.

  2. I en terminal, starta daemon med jamid -d -c

    • Denna verkställighetsbarhet finns normalt inte i PATH, och i Debian/Trisquel/Ubuntu-paketterna finns den 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.

För att få en bakspårning kan du köra programmet inuti 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 den kraschar kan du skriva bt (eller ännu bättre, thread applicera alla bt) och trycka på Enter.

På macOS

  • Navigera till /Applications/Jami.app/Contents/MacOS/.

  • Dubbelklicka på Jami och det startar Jami och trycker loggen till terminalen.

  • Kopiera loggen från terminal till en fil.

Alternativt kan du köra /<vägen till Jami>/Jami.app/Contents/MacOS/Jami -d från terminalen.

På Android

För att samla in loggar via din telefon med Jami själv:

  • Klicka på Konversationer

  • Tryck på menyn med tre punkter längst till höger

  • Klicka på Inställningar

  • Tryck på Diagnostiklogg

För att samla in loggar via datorn med hjälp av Android Debug Bridge (adb):

  • Du måste ha AdB inställd på din dator.

  • Sätt Jami på din smartphone och sedan avrätta

  • Jag har inte hört det här. Jag har inte hört det.

  • Du har nu en fil som innehåller loggen av kunden

För Windows

Öppna en terminal (cmd.exe) och starta Jami.exe med följande alternativ:

  • -d att öppna ett separat konsolfönster för att ta emot loggar

  • -f att skriva loggar till % lokalt data%\jami\jami.log