Bugs rapporteren

Bugs gebeuren. Dat is een feit. Maar ze kunnen gerepareerd worden. En hoe beter een bugrapport is hoe gemakkelijker het is voor het ontwikkelteam om het na te bootsen, te onderzoeken en eventueel te repareren.

Alle bugrapporten moeten gelogd worden in de officiële bugvolger. En functieverzoeken worden daar gevolgd evenals het gebruik van het item ernst en wensenlijst. Maar voordat u dat doet, doe het volgende:

Stap 1: werk bij tot de laatste uitgave

Waardeer op naar de laatste uitgegeven versies van Kdenlive. We beantwoorden geen bugrapporten voor oude versies van Kdenlive (tenzij ze nog steeds te reproduceren zijn in de laatste versie).

Stap 2: zoek naar de officiële Kdenlive documentatie

RTFM - Lees de fijne handleiding is een zin die vaak gebruikt wordt om gebruikers te bespotten die vragen stellen die beantwoord kunnen worden door de documentatie te lezen. In de tijd van YouTube-tutorial is dit misschien niet langer meer zo belangrijk of relevant, maar u wordt aangemoedigd om de officiële Kdenlive documentatie te raadplegen. Het kan doorzocht worden en bevat een schat aan goede en waardevolle informatie.

Step 3: zoek naar de forums

Kdenlive heeft een grote gemeenschap die actief is in forums en chatrooms. Bekijk het officiële forum of andere gebruikers hetzelfde probleem zijn tegengekomen. Misschien bestaat er een reparatie of is er omheen te werken. Andere kanalen om te bekijken zijn

Stap 4: vraag open issues af

Doorzoek de bugsvolger. Misschien is het probleem dat u ervaart al gerapporteerd of wordt er aan aan gewerkt. De status van de bug is een goede indicator voor wat er nu gebeurt:

  • REPORTED is een bug die gerapporteerd is maar tot nu toe is er niets mee gedaan. Er kan een discussie over zijn, dus is het waard om te controleren of het van toepassing is op uw probleem.
  • NEEDSINFO is een gerapporteerde bug, die meer terugkoppeling nodig heeft. Dit betekent dat een teamlid van ontwikkeling er naar gekeken heeft maar dat er meer details nodig zijn
  • CONFIRMED betekent dat de bug gereproduceerd kan worden (ofwel door andere gebruikers of het ontwikkelteam)
  • ASSIGNED betekent dat een ontwikkelaar de bug in behandeling heeft
  • RESOLVED betekent dat de bug is gerepareerd in de ontwikkelversie

Stap 5: Rapporteer de bug

Als u een crash bij het opstarten van Kdenlive hebt of wanneer u probeert een videobestand af te spelen, volg dan deze steppen:

  1. Als u Kdenlive en/of MLT zelf hebt gecompileerd, ga na dat u alle stappen hebt gevolgd beschreven in onze instructies.
  2. Controleer dat u niet een aantal versies van MLT hebt geïnstalleerd
  3. Probeer uw videobestand af te spelen met de speler van FFmpeg. Vanuit een terminal: ffplay myvideo.mpg
  4. Probeer uw videobestand af te spelen met de MLT-speler. Vanuit een terminal: melt myvideo.mpg

Voeg de resultaten in i uw bugrapport als bijlagen.

Voor een goed bugrapport voeg de volgende informatie in:

  • Uw versie van Kdenlive en MLT. U kunt die informatie kopiëren uit Kdenlive Menu > Help > Info over.
  • Uw besturingssysteem (OS), zoals Windows, Linux distributie of MacOS inclusief de respectievelijke versie
  • De installatiemethode voor Kdenlive, zoals Windows installer of alleenstaand of Linux flatpak/snap/ppa of appimage
  • Gedetailleerde stappen om de bug te reproduceren. Schermafdrukken en schermopnamen zijn erg nuttig om het probleem te reproduceren.
  • Elke foutmelding of logbestanden die u kunt leveren. Kopieer/plak geen loginhoud in het bugrapport maar voeg het toe als een bijlage.
  • Als de Kdenlive laat crashen, lever een backtrace.

Hoe nuttige crashinformatie te krijgen (backtrace)

Een backtrace bevat waardevolle informatie voor de ontwikkelteam. Het heeft een beetje specifieke opzet van het OS nodig en trucjes op de opdrachtregel en kan daarom niet van iedereen worden gevraagd.

Linux toepassingsafbeelding

Installeer de volgende pakketten: gdb, kdenlive-dbg, libmlt-dbg (pakketnamen kunnen licht verschillend zijn afhankelijk van uw distributie)

Wanneer Kdenlive crasht, als de KDE crashhandlerdialoog verschijnt, dan kunt u de gegevens die het levert kopiëren. Anders, start Kdenlive vanuit een terminal zoals deze:

  1. Typ gdb kdenlive
  2. Nadat gdb debugsymbolen heeft gelezen, typ run

Linux Flatpak

Ga als eerste na dat Flatpak de debugsymbolen heeft geïnstalleerd door te typen flatpak install org.kde.kdenlive.Debug in een opdrachtregel.

U kunt nu het Flatpak starten vanuit een opdrachtregel zoals deze:

  1. Start een shell binnen de Kdenlive Flatpak sandbox: flatpak run --command=sh --devel org.kde.kdenlive
  2. Typ gdb /app/bin/kdenlive
  3. Nadat gdb debugsymbolen heeft gelezen, typ run

Voor meer details over Flatpak debugging zie hier: https://docs.flatpak.org/en/latest/debugging.html

Windows

  1. Kdenlive lokaal bouwen met KDE Craft zoals hier beschreven.
  2. Typ op de opdrachtregel cd C:/CraftRoot/mingw64/bin
  3. Start gdb met gdb
  4. Start Kdenlive -> verkrijg het PID nummer
  5. attach 3288 (vervang 3288 door het PID nummer)
  6. Wacht op de (gdb) prompt
  7. Typ c

Nadat u de bovenstaande platform specifieke instructies hebt gevolgd om Kdenlive te starten, kunt u de bug triggeren. Wanneer Kdenlive crasht, ga naar uw terminalvenster en typ:

thread apply all bt full

Druk daarna op Enter totdat u de volledige gegevens ziet. Kopieer de log naar een bestand en voeg het toe aan het bugrapport.