Rapportera fel

Fel inträffar. Det är ett faktum. Men de kan åtgärdas. Och ju bättre en felrapport är, desto lättare är det för utvecklingsteamet att replikera, undersöka och slutligen åtgärda den.

Alla felrapporter måste loggas i den officiella felspåraren. Och funktionsförfrågningar spåras även där med hjälp av severity-alternativet wishlist. Men innan du gör det, gör följande:

Steg 1: Uppgradera till den senaste versionen

Uppgradera till senast utgivna versioner av Kdenlive. Vi svarar inte på felrapporter för gamla Kdenlive-versioner (såvida de inte fortfarande är reproducerbara i den senaste versionen).

Steg 2: Sök i den officiella Kdenlive-dokumentationen

På engelska är frasen Read The "Fine" Manual (RTFM) ofta använd för att håna användare som ställer frågor som skulle kunna besvaras genom att läsa dokumentationen. I YouTube-handledningarnas tid är det kanske inte lika viktigt eller relevant längre, men du uppmuntras att konsultera den officiella Kdenlive-dokumentationen. Den är sökbar och innehåller en mängd bra och värdefull information.

Steg 3: Sök i forumen

Kdenlive har en stor gemenskap som är aktiv i forum och chattrum. Kontrollera det officiella forumet om andra användare har stött på samma problem. Det kanske finns en lösning eller ett sätt att undvika problemet. Andra kanaler att kontrollera är

Steg 4: Sök efter öppna ärenden

Sök i felspåraren. Problemet du upplever kanske redan har rapporterats eller till och med åtgärdats. Felstatus är en bra indikator på vad som händer just nu:

  • REPORTED är ett fel som har rapporterats men inget har hittills hänt. Det kan finnas en diskussion om den, så det är värt att kontrollera om den kan gälla ditt problem.
  • NEEDSINFO är ett rapporterat fel som behöver mer återkoppling. Det betyder att en medlem i utvecklingsteamet tittade på den men behöver mer information.
  • CONFIRMED betyder att felet kan reproduceras (antingen av andra användare eller utvecklingsteamet)
  • ASSIGNED betyder att en utvecklare hanterar felet
  • RESOLVED betyder att felet åtgärdades i utvecklingsversionen

Steg 5: Rapportera felet

Om du får en krasch vid start av Kdenlive eller när du försöker spela upp en videofil, följ de här stegen:

  1. Om du kompilerade Kdenlive och/eller MLT själv, se till att du följde alla steg som beskrivs i våra instruktioner.
  2. Kontrollera att du inte har flera versioner av MLT installerade
  3. Försök att spela upp din videofil med spelaren i FFmpeg. Från en terminal: ffplay myvideo.mpg
  4. Försök att spela upp din videofil med MLT:s spelare. Från en terminal: melt myvideo.mpg

Inkludera resultaten i felrapporten som bilagor.

För en bra felrapport, inkludera följande information:

  • Version av Kdenlive- och MLT. Du kan kopiera informationen från Kdenlive-menyn: Hjälp > Om.
  • Operativsystemet, som Windows, Linux-distribution eller MacOS inklusive respektive version
  • Installationsmetoden för Kdenlive, såsom Windows-installationsverktyg eller fristående installationsprogram, eller Linux flatpak/snap/ppa eller appimage
  • Detaljerade steg för att reproducera felet. Skärmbilder och skärminspelningar är mycket användbara för att replikera problemet.
  • Eventuella felmeddelanden eller loggfiler som du kan tillhandahålla. Kopiera inte och klistra in logginnehållet i felrapporten utan lägg till det som en bilaga.
  • Om felet kraschar Kdenlive, tillhandahåll en bakåtspårning.

Hur man får användbar kraschinformation (bakåtspårning)

En bakåtspårning innehåller värdefull information för utvecklingsteamet. Den kräver lite operativsystemspecifik inställning och kommandoradstrolleri och kanske därför inte passar alla.

Linux appimage

Installera följande paket: gdb, kdenlive-dbg, libmlt-dbg (paketnamnen kan skilja sig något beroende på distributionen)

När Kdenlive kraschar, om KDE:s kraschhanteringsdialogruta dyker upp, kan du kopiera data som tillhandahålls. Annars startar du Kdenlive från en terminal som den här:

  1. Skriv gdb kdenlive
  2. Efter att gdb har läst felsökningssymbolerna, skriv run

Linux Flatpak

Se först till att Flatpak-felsökningssymboler är installerade genom att skriva flatpak install org.kde.kdenlive.Debug på kommandoraden.

Nu kan du starta Flatpak från en kommandorad så här:

  1. Starta en skal i Kdenlive Flatpak-miljön: flatpak run --command=sh --devel org.kde.kdenlive
  2. Skriv gdb /app/bin/kdenlive
  3. Efter att gdb har läst felsökningssymbolerna, skriv run

För mer information om Flatpak-avlusning, se här: https://docs.flatpak.org/en/latest/debugging.html

Windows

  1. Bygg Kdenlive med KDE Craft lokalt enligt beskrivningen här.
  2. Skriv cd C:/CraftRoot/mingw64/bin i kommandoraden
  3. Starta gdb med gdb
  4. Starta Kdenlive -> hämta PID-numret
  5. attach 3288 (ersätt 3288 med PID-numret)
  6. Vänta på prompten (gdb)
  7. Skriv c

När du har följt de plattformsspecifika instruktionerna ovan för att starta Kdenlive kan du framkalla felet. När Kdenlive kraschar, gå till terminalfönstret och skriv:

thread apply all bt full

Tryck sedan på returtangenten tills du ser all data. Kopiera loggen till en fil och bifoga den i felrapporten.