Сообщения об ошибках

Ошибки случаются. Это факт. Но их возможно исправить. И чем лучше составлено сообщение об ошибке, тем проще команде разработчиков воспроизвести её, разобраться и в итоге устранить.

Все сообщения об ошибках должны попадать в официальную систему отслеживания ошибок. Там же отслеживаются и пожелания — со значением wishlist в поле severity. Но прежде чем сообщать, выполните следующее:

Шаг 1. Обновитесь до последнего выпуска

Обновитесь до последних выпущенных версий Kdenlive. Мы не отвечаем на сообщения об ошибках в старых версиях Kdenlive (если только ошибка не воспроизводится и в последней версии).

Шаг 2. Поищите в официальной документации Kdenlive

RTFM — Read The Fine Manual («прочти руководство») — фраза, которой часто подтрунивают над теми, кто задаёт вопросы, ответы на которые есть в документации. В эпоху видеоуроков на YouTube это, возможно, уже не так важно, но всё же советуем заглянуть в официальную документацию Kdenlive. По ней возможен поиск, и она содержит множество полезных сведений.

Шаг 3. Поищите на форумах

У Kdenlive большое сообщество, активное на форумах и в чатах. Стоит заглянуть в несколько мест и проверить, не сталкивались ли другие пользователи с той же трудностью. Возможно, исправление или обходной путь уже есть:

Шаг 4. Просмотрите открытые ошибки

Выполните поиск в системе отслеживания ошибок. Возможно, о вашей трудности уже сообщили или даже занимаются ею. Состояние ошибки хорошо показывает, что происходит сейчас:

  • REPORTED — об ошибке сообщили, но пока ничего не происходит. Возможно, идёт обсуждение, поэтому стоит проверить, относится ли оно к вашему случаю.
  • NEEDSINFO — об ошибке сообщили, но нужны дополнительные сведения. То есть участник команды разработчиков посмотрел её, но ему нужны подробности.
  • CONFIRMED — ошибку удалось воспроизвести (другим пользователям или команде разработчиков).
  • ASSIGNED — ошибкой занимается разработчик.
  • RESOLVED — ошибка исправлена в версии для разработчиков.

Шаг 5. Сообщите об ошибке

Если Kdenlive аварийно завершается при запуске или при попытке воспроизвести видеофайл, выполните следующие действия:

  1. Если вы собирали Kdenlive и (или) MLT самостоятельно, убедитесь, что выполнили все действия из наших указаний.
  2. Проверьте, что у вас не установлено несколько версий MLT.
  3. Попробуйте воспроизвести видеофайл проигрывателем FFmpeg. В терминале: ffplay myvideo.mpg
  4. Попробуйте воспроизвести видеофайл проигрывателем MLT. В терминале: melt myvideo.mpg

Приложите результаты к сообщению об ошибке.

Чтобы сообщение об ошибке было хорошим, укажите в нём следующее:

  • Версии Kdenlive и MLT. Эти сведения возможно скопировать из меню Kdenlive «Справка → О программе».
  • Операционную систему (Windows, дистрибутив Linux или macOS) с указанием её версии.
  • Способ установки Kdenlive: программа установки или автономная сборка для Windows, flatpak, snap, ppa или appimage для Linux.
  • Подробные действия для воспроизведения ошибки. Снимки экрана и записи экрана очень помогают повторить произошедшее.
  • Любые сообщения об ошибках или файлы журналов, которые вы можете предоставить. Не вставляйте содержимое журнала в текст сообщения — приложите его файлом.
  • Если из-за ошибки Kdenlive аварийно завершается, приложите стек вызовов.

Как получить полезные сведения об аварийном завершении (стек вызовов)

Стек вызовов содержит ценные для команды разработчиков сведения. Для его получения требуется некоторая настройка, зависящая от операционной системы, и работа в командной строке, так что подойдёт это не каждому.

AppImage для Linux

Установите следующие пакеты: gdb, kdenlive-dbg, libmlt-dbg (названия пакетов могут немного отличаться в зависимости от дистрибутива).

Если при аварийном завершении Kdenlive появляется диалог обработчика сбоев KDE, возможно скопировать предоставленные им данные. Иначе запустите Kdenlive из терминала так:

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

Flatpak для Linux

Сначала убедитесь, что установлены отладочные символы 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 на идентификатор процесса)
  6. Дождитесь приглашения (gdb)
  7. Введите c

После того как вы запустите Kdenlive по указаниям для вашей платформы, вызовите ошибку. Когда Kdenlive аварийно завершится, перейдите в окно терминала и введите:

thread apply all bt full

Затем нажимайте клавишу Enter, пока не увидите все данные. Скопируйте журнал в файл и приложите его к сообщению об ошибке.