Hlásenie chýb

Chyby sa stávajú. To je fakt. Ale dajú sa opraviť. A čím lepšie je hlásenie chyby, tým ľahšie je pre vývojársky tím ju zopakovať, preskúmať a nakoniec opraviť.

Všetky hlásenia chýb musia byť zaznamenané v oficiálnom sledovači chýb. Požiadavky na funkcie sa tam sledujú tiež pomocou položky závažnosť wishlist. Ale predtým, než tak urobíte, vykonajte prosím nasledujúce:

Krok 1: Aktualizujte na najnovšie vydanie

Aktualizujte prosím na najnovšie vydané verzie Kdenlive. Neodpovedáme na hlásenia chýb pre staré verzie Kdenlive (pokiaľ nie sú stále reprodukovateľné v najnovšej verzii).

Krok 2: Prehľadajte oficiálnu dokumentáciu Kdenlive

RTFM – Read The Fine Manual je fráza často používaná na ironické označenie používateľov, ktorí kladú otázky zodpovedateľné prečítaním dokumentácie. V dobe YouTube tutoriálov to možno už nie je také dôležité alebo relevantné, ale odporúčame vám nahliadnuť do oficiálnej dokumentácie Kdenlive. Dá sa v nej vyhľadávať a obsahuje množstvo dobrých a hodnotných informácií.

Krok 3: Prehľadajte fóra

Kdenlive má veľkú komunitu, ktorá je aktívna na fórach a v chatových miestnostiach. Mali by ste skontrolovať niekoľko miest, či sa iní používatelia nestretli s rovnakým problémom. Možno existuje oprava alebo obchádzka:

Krok 4: Prehľadajte otvorené problémy

Prehľadajte sledovač chýb. Možno problém, ktorý zažívate, už bol nahlásený alebo sa na ňom dokonca pracuje. Stav chyby je dobrým ukazovateľom toho, čo sa práve deje:

  • REPORTED je chyba, ktorá bola nahlásená, ale zatiaľ sa nič nestalo. Môže prebiehať diskusia, takže stojí za to skontrolovať, či sa netýka vášho problému.
  • NEEDSINFO je nahlásená chyba, ktorá potrebuje viac informácií. To znamená, že člen vývojového tímu sa na ňu pozrel, ale potrebuje viac podrobností
  • CONFIRMED znamená, že chybu je možné reprodukovať (buď inými používateľmi, alebo vývojovým tímom)
  • ASSIGNED znamená, že vývojár sa chybe venuje
  • RESOLVED znamená, že chyba bola opravená vo vývojovej verzii

Krok 5: Nahláste chybu

Ak dôjde k pádu Kdenlive pri spustení alebo pri pokuse o prehratie video súboru, postupujte podľa týchto krokov:

  1. Ak ste si Kdenlive a/alebo MLT skompilovali sami, uistite sa, že ste dodržali všetky kroky opísané v našich pokynoch.
  2. Skontrolujte, že nemáte nainštalovaných niekoľko verzií MLT
  3. Skúste prehrať váš video súbor pomocou prehrávača FFmpeg. Z terminálu: ffplay myvideo.mpg
  4. Skúste prehrať váš video súbor pomocou prehrávača MLT. Z terminálu: melt myvideo.mpg

Zahrňte výsledky do hlásenia chyby ako prílohy.

Pre dobré hlásenie chyby prosím uveďte nasledujúce informácie:

  • Vašu verziu Kdenlive a MLT. Tieto informácie môžete skopírovať z ponuky Kdenlive > Pomocník > O programe.
  • Váš operačný systém (OS), napríklad Windows, distribúciu Linuxu alebo MacOS vrátane príslušnej verzie
  • Spôsob inštalácie Kdenlive, napríklad Windows inštalátor alebo samostatná verzia, alebo Linux flatpak/snap/ppa alebo appimage
  • Podrobné kroky na reprodukciu chyby. Snímky obrazovky a záznamy obrazovky sú veľmi užitočné pre zopakovanie problému.
  • Akékoľvek chybové hlásenia alebo súbory denníkov, ktoré môžete poskytnúť. Prosím, nekopírujte a nevkladajte obsah denníkov do hlásenia chyby, ale pridajte ho ako prílohu.
  • Ak chyba spôsobí pád Kdenlive, poskytnite spätné sledovanie.

Ako získať užitočné informácie o páde (spätné sledovanie)

Spätné sledovanie obsahuje cenné informácie pre vývojársky tím. Vyžaduje trochu nastavenia špecifického pre OS a prácu s príkazovým riadkom, a preto nemusí byť pre každého.

Linux appimage

Nainštalujte prosím nasledujúce balíky: gdb, kdenlive-dbg, libmlt-dbg (názvy balíkov sa môžu mierne líšiť v závislosti od vašej distribúcie)

Keď Kdenlive spadne, ak sa objaví dialóg obsluhy pádov KDE, môžete skopírovať údaje, ktoré poskytuje. V opačnom prípade spustite Kdenlive z terminálu takto:

  1. Napíšte gdb kdenlive
  2. Po načítaní ladiacich symbolov napíšte run

Linux Flatpak

Najprv sa uistite, že sú nainštalované ladiace symboly Flatpak zadaním flatpak install org.kde.kdenlive.Debug do príkazového riadku.

Teraz môžete spustiť Flatpak z príkazového riadku takto:

  1. Spustite shell vo vnútri sandboxu Kdenlive Flatpak: flatpak run --command=sh --devel org.kde.kdenlive
  2. Napíšte gdb /app/bin/kdenlive
  3. Po načítaní ladiacich symbolov napíšte run

Viac podrobností o ladení Flatpak nájdete tu: https://docs.flatpak.org/en/latest/debugging.html

Windows

  1. Zostavte Kdenlive s KDE Craft lokálne podľa popisu tu.
  2. Do príkazového riadku napíšte cd C:/CraftRoot/mingw64/bin
  3. Spustite gdb pomocou gdb
  4. Spustite Kdenlive -> získajte číslo PID
  5. attach 3288 (nahraďte 3288 číslom PID)
  6. Počkajte na výzvu (gdb)
  7. Napíšte c

Keď ste dodržali vyššie uvedené pokyny pre konkrétnu platformu na spustenie Kdenlive, môžete vyvolať chybu. Keď Kdenlive spadne, prejdite do okna terminálu a napíšte:

thread apply all bt full

Potom stláčajte enter, kým sa nezobrazia úplné údaje. Skopírujte denník do súboru a priložte ho k hláseniu chyby.