Vložitev poročila o napaki

Napake se dogajajo. To je dejstvo. Vendar jih je možno odpraviti. Boljše kot je poročilo o napaki, lažje jo bo razvojna ekipa ponovila, raziskala in na koncu odpravila.

Vsa poročila o napakah morajo biti zabeležena v uradnem sledilniku, bug tracker. Tam se spremljajo tudi zahteve po funkcijah s seznamom želja glede na resnost.

Pojdimo po vrsti

Toda preden to storite, naredite naslednje:

Step 1: Upgrade to the latest release

Nadgradite na zadnje izdane različice Kdenlive. Ne odgovarjamo na poročila o napakah za stare različice Kdenlive (razen če so še vedno ponovljive v najnovejši različici).

Step 2: Search the official Kdenlive documentation

RTFM (angl. Read The Fine Manual) je stavek, ki se pogosto uporablja za norčevanje iz uporabnikov, ki postavljajo vprašanja, na katera je mogoče odgovoriti z branjem dokumentacije. V času vadnic na YouTube to morda ni več tako pomembno ali relevantno, vendar vas spodbujamo, da si ogledate uradno dokumentacijo Kdenlive. Po njej je možno iskati in vsebuje veliko dobrih in dragocenih informacij.

Step 3: Search the forums

Kdenlive ima veliko skupnost, ki je aktivna na forumih in klepetalnicah. Preverite official forum on Discuss, če so drugi uporabniki naleteli na isto težavo. Morda obstaja popravek ali rešitev. Drugi kanali, ki jih je treba preveriti, so

Step 4: Query open issues

Search the bug tracker. Morda je bila težava, s katero se srečujete, že prijavljena ali se na njej celo dela. Stanje hrošča je dober pokazatelj za to, kar se trenutno dogaja:

  • REPORTED (poročano) je napaka, ki je bila prijavljena, vendar se do zdaj ni nič zgodilo. Morda bo prišlo do razprave o tem, zato je vredno preveriti, ali se lahko nanaša na vašo težavo.

  • NEEDSINFO (potrebuje podatke) je prijavljena napaka, ki potrebuje več povratnih informacij. To pomeni, da si ga je član ekipe razvijalcev ogledal, vendar potrebuje več podrobnosti.

  • CONFIRMED (potrjeno) pomeni, da je hrošč mogoče reproducirati (bodisi s strani drugih uporabnikov ali ekipe razvijalcev)

  • ASSIGNED (dodeljeno) pomeni, da razvijalec obravnava napako

  • RESOLVED (razrešeno) pomeni, da je bila napaka odpravljena v razvojni različici

Step 5: Report the bug

Če se vam Kdenlive ob zagonu ali ko poskušate predvajati videodatoteko zruši, sledite tem korakom:

  • Če ste Kdenlive in/ali MLT prevedli sami, se prepričajte, da ste sledili vsem korakom, opisanim v naših navodilih.

  • Preverite, ali nimate nameščenih več različic MLT

  • Poskusite predvajati videodatoteko s predvajalnikom FFmpeg. Iz terminala: ffplay myvideo.mpg

  • Poskusite predvajati videodatoteko s predvajalnikom MLT. Iz terminala: melt myvideo.mpg

Rezultate vključite v svoje poročilo o napaki kot priloge.

Za dobro poročilo o napakah vključite naslednje informacije:

  • Vaša različica Kdenlive in MLT. Te informacije lahko kopirate iz Kdenlive prek Meni ‣ Pomoč ‣ O programu.

  • Vaš operacijski sistem (OS), kot je Windows, distribucija Linux ali macOS, vključno z ustrezno različico

  • Metoda namestitve za Kdenlive, kot je namestitveni program za Windows, samostojni progam, flatpak/snap/ppa za Linux ali appimage

  • Podrobni koraki za ponoven priklic napake. Posnetki zaslona in videoposnetki zaslona so zelo uporabni za ponovitev težave.

  • Vsa sporočila o napakah ali zapisniške datoteke, ki jih lahko posredujete. Ne kopirajte in lepite vsebine zapisnika v poročilo o napakah, ampak jo dodajte kot prilogo.

  • Če hrošč sesuje Kdenlive, zagotovite povratno sledenje.

Kako pridobiti koristne informacije o sesutju (povratno sledenje):

Povratna sled vsebuje dragocene informacije za ekipo razvijalcev. Potrebuje nekaj nastavitev, specifičnih za operacijski sistem, in čarovnika za ukazno vrstico, zato morda ni za vsakogar.

Linux appimage:

Namestite naslednje pakete: gdb, kdenlive-dbg, libmlt-dbg (imena paketov se lahko nekoliko razlikujejo glede na vašo distribucijo)

Če se Kdenlive sesuje in se odpre pogovorno okno za obravnavo sesutij KDE, lahko kopirate podatke, ki jih ponuja. V nasprotnem primeru zaženite Kdenlive iz terminala, na tak način:

Vnesite gdb kdenlive

Ko gdb prebere simbole za odpravljanje napak, vnesite run

Linux Flatpak:

Najprej se prepričajte, da so simboli za odpravljanje napak Flatpak nameščeni tako, da v ukazno vrstico vnesete flatpak install org.kde.kdenlive.Debug.

Zdaj lahko Flatpak zaženete iz ukazne vrstice, kot je ta:

  • Zaženite lupino v peskovniku Kdenlive Flatpak: flatpak run --command=sh --devel org.kde.kdenlive

  • Vnesite gdb /app/bin/kdenlive

  • Ko gdb prebere simbole za odpravljanje napak, vnesite run

Za več podrobnosti o odpravljanju napak Flatpak si oglejte tukaj: https://docs.flatpak.org/en/latest/debugging.html

Windows:

Zgradite Kdenlive s KDE Craft krajevno, kot je opisano tukaj:

  • Vnesite v ukazno vrstico: cd C:/CraftRoot/mingw64/bin

  • Zaženite gdb z gdb

  • Zaženite Kdenlive -> pridobite številko PID

  • attach 3288 (nadomesti 3288 s PID-številko)

  • Počakajte na poziv (gdb)

  • Vnesite c

Ko sledite zgornjim navodilom za specifično platformo za zagon Kdenlive, lahko sprožite napako. Ko se Kdenlive sesuje, pojdite v terminalsko okno in vnesite:

thread apply all bt full

Nato pritisnite vnašalko, dokler ne vidite vseh podatkov. Kopirajte zapisnik v datoteko in ga priložite poročilu o napaki kot prilogo.

Ustvarjanje poročila o napaki

Zdaj, ko imate vse potrebne in pomembne informacije, je čas, da prijavite napako v uradnem KDE-jevem sledilniku hroščev, Bugzilli.

Odprite brskalnik in v polje URI vnesite bugs.kde.org

kde_bugtracking_system.webp

Pozdravni zaslon KDE-jevega sistema za sledenje hroščem

Morda se boste morali najprej prijaviti ali celo ustvariti uporabniški račun. Za to sledite navodilom na zaslonu.

Kliknite na: guilabel:File a Bug (pošlji napako).

kde_bug_classification.webp

Izbiranje klasifikacij v KDE-jevem sistemu za sledenje hroščem

Kliknite Application, da pridete do seznama vseh programov, ki uporabljajo Bugzillo.

kde_bug_application.webp

Izbor programa v KDE-jevem sistemu za sledenje hroščem

Seznam je razvrščen po abecedi. Pomaknite se navzdol do mesta, kjer je Kdenlive naveden, ali uporabite krmilka+F, da odprete iskalno polje in vnesite kdenlive. To bi moralo delovati v večini brskalnikov, vendar se lahko razlikuje v vašem.

Bugzilla bo odprla podroben zaslon za poročanje o napakah, kjer lahko vnesete poročilo o napaki. Nekatera polja so obvezna (označena z rdečo *), nekatera pa bodo zapolnjena s podatki, zbranimi iz vašega sistema.

kde_bug_enter.webp

Vnašanjem podrobnosti o hrošču v KDE-jev sistem za sledenje hroščev

1:

Poročilo o napaki bo vloženo na e-poštni naslov vašega uporabniškega imena

2:

Izberite komponento, ki najbolje ustreza vrsti težave, na katero ste naleteli

3:

Izberite različico Kdenlive, ki jo uporabljate

4:

Določite resnost težave. Če želite ustvariti zahtevo za dodatno funkcijo, izberite wishlist (seznam želja).

5:

Izberite platformo, ki jo uporabljate. To pomaga pri odpravljanju težav.

6:

Izberite operacijski sistem (OS), ki ga uporabljate

7:

Vnesite kratek, vendar opisen povzetek, če je napaka ali težava, ki jo prijavljate

8:

Tukaj podrobneje opisujete težavo. Besedilo med *** je informativne namene, samo poskuša preprečiti nepotrebna poročila o napakah. Če želite nadaljevati z vlaganjem poročila o napaki, izberite to besedilo in ga izbrišite. Nato začnite vnašati opis težave.

Prosimo, bodite čim bolj podrobni in opišite, kaj ste storili, ko se je sprožila napaka ali Kdenlive ni deloval po pričakovanjih.

Nekaj razdelkov je že predpisanih, kot so Step to Reproduce (koraki za priklic napake), Observed Results (opaženi rezultati) in Expected Results (pričakovani rezultati), ki vas vodijo skozi poročilo o napaki. Pomaga le pri strukturiranju poročila za enostavno sklicevanje in replikacijo s strani ekipe razvijalcev.

V razdelku Software/OS Version lahko prilepite ustrezne podatke iz Kdenlive Meni ‣ Pomoč ‣ O programu Kdenlive ‣ Komponente ‣ Kopiraj v odložišče.

kde_bug_kdenlive_components

Kopirajte podatke iz Kdenlive

9:

Dodate lahko priloge, kot so posnetki zaslona, zaslonske slike in besedilne datoteke, z izhodnimi informacijami odpravljanja napak in terminala.

10:

Kliknite Pošlji napako, da vložite poročilo o napaki