Звітування про вади

Трапляються помилки. Це факт. Але їх можна виправити. І чим кращий звіт про помилку, тим легше команді розробників відтворити, дослідити та, зрештою, виправити помилку.

Усі звіти про помилки слід реєструвати в офіційній системі стеження за помилками. Запити щодо нових можливостей також відстежуються там за допомогою варіанта wishlist для пункту severity. Але перш ніж створювати звіт, зробіть наступне:

Крок 1. Оновіть програму до найсвіжішої версії

Оновіть Kdenlive до останніх версій. Ми не відповідаємо на звіти про помилки для старих версій Kdenlive (якщо вони вже не можна відтворити в останній версії).

Крок 2. Пошукайте відповідь в офіційній документації до Kdenlive

RTFM — Read The Fine Manual — це фраза, яку часто використовують для висміювання користувачів, які ставлять запитання, на які можна отримати відповідь, прочитавши документацію. У добу підручників на YouTube це може бути вже не таким важливим або актуальним, але радимо ознайомитися з офіційною документацією до Kdenlive. У ньому можна пошукати відповідь, і він містить масу корисної та цінної інформації.

Крок 3. Пошукайте відповідь на форумі

Kdenlive має велику спільноту, яка активно працює на форумах і в системах спілкування. Перевірте на офіційному форумі, чи інші користувачі стикалися з такою проблемою. Можливо, існує виправлення або обхідний шлях. Інші канали, на яких варто пошукати відповідь:

Крок 4. Пошукайте серед вже створених звітів

Пошук у системі стеження за вадами. Можливо, про проблему, з якою ви зіткнулися, уже повідомляли або над нею навіть працюють. Стан повідомлення про ваду є показником того, що зараз відбувається:

  • REPORTED — це вада, про яку було повідомлено, але досі нічого не сталося. На сторінці повідомлення може бути обговорення, тому варто перевірити, чи може це стосуватися вашої проблеми.
  • NEEDSINFO – це повідомлення про ваду, яке потребує додаткових відомостей. Це означає, що учасник команди розробників переглянув його, але йому потрібні додаткові відомості
  • CONFIRMED означає, що помилка може бути відтворена (або іншими користувачами, або командою розробників)
  • ASSIGNED означає, що над вадою працює розробник
  • RESOLVED означає, що ваду було виправлено у версії, що перебуває у розробці

Крок 5. Повідомте про ваду

Якщо програма аварійно завершила роботу під час запуску або спроби відтворити відеофайл, виконайте такі дії:

  1. Якщо ви збирали Kdenlive і/або MLT власноруч, переконайтеся, що вами виконано кроки настанов, які описано у нашій інструкції.
  2. Перевірте, чи встановлено єдину версію MLT
  3. Спробуйте відтворити ваш відеофайл за допомогою програвача FFmpeg. З термінала: ffplay ваше_відео.mpg
  4. Спробуйте відтворити ваш відеофайл за допомогою програвача MLT. З термінала: melt ваше_відео.mpg

Включіть до вашого звіту як долучення результати роботи.

Щоб створити якісний звіт щодо вади, будь ласка, включіть до нього такі дані:

  • Ваші версії Kdenlive і MLT. Ці дані можна скопіювати з вікна, відкрити яке можна за допомогою пункту меню Kdenlive > Довідка > Про програму.
  • Ваша операційна система (ОС), зокрема Windows, дистрибутив Linux або MacOS включно з версією
  • Спосіб встановлення Kdenlive, зокрема пакунок для встановлення або самодостатня версія для Windows або пакунок flatpak/snap/ppa для Linux чи appimage
  • Докладні кроки для відтворення вади. Для відтворення вади дуже корисними будуть знімки вікон та записи з екрана.
  • Усі повідомлення про помилку або файли журналу, до яких маєте доступ. Будь ласка, не копіюйте дані журналу і не вставляйте їх до звіту щодо вади, а додайте їх як долучення.
  • Якщо у результаті вади Kdenlive завершує роботу аварійно, надайте зворотне трасування.

Як отримати корисні дані щодо аварії (зворотне трасування)

Зворотне трасування містить цінну інформацію для команди розробників. Воно потребує певних налаштувань операційної системи і майстерності у командному рядку, тому доступне не для усіх.

Linux appimage

Будь ласка, встановіть такі пакунки: gdb, kdenlive-dbg, libmlt-dbg (назви пакунків у вашому дистрибутиві можуть бути дещо іншими)

Коли Kdenlive завершує роботу в аварійному режимі, якщо буде відкрито вікно обробки аварії KDE, ви зможете скопіювати надані системою дані. Якщо таке вікно не з'являється, запустіть Kdenlive з термінала ось так:

  1. Введіть gdb kdenlive
  2. Після того, як gdb прочитає діагностичні символи, введіть run

Linux Flatpak

Перш за все, переконайтеся, що встановлено діагностичні символи Flatpak, ввівши команду flatpak install org.kde.kdenlive.Debug у командному рядку.

Далі, ви можете запустити Flatpak з командного рядка ось так:

  1. Запустіть оболонку всередині пісочниці Flatpak Kdenlive: flatpak run --command=sh --devel org.kde.kdenlive
  2. Введіть gdb /app/bin/kdenlive
  3. Після того, як gdb прочитає діагностичні символи, введіть run

Докладніше про діагностику Flatpak: https://docs.flatpak.org/en/latest/debugging.html

Windows

  1. Зберіть Kdenlive за допомогою KDE Craft локально, як це описано тут.
  2. Введіть у командному рядку команду cd C:/CraftRoot/mingw64/bin
  3. Запустіть gdb за допомогою команди gdb
  4. Запустіть Kdenlive -> отримайте номер PID
  5. attach 3288 (замініть 3288 на номер PID)
  6. Зачекайте на запит (gdb)
  7. Натисніть клавішу c

Щойно буде наведені вище для відповідної платформи настанови щодо запуску Kdenlive, ви зможете виконати дії для відтворення вади, перейдіть до вікна термінала і введіть команду:

thread apply all bt full

Натискайте Enter, аж доки не побачите дані повністю. Скопіюйте журнал до файла і долучіть цей файл до звіту щодо вади.