Relatar bugs

Bugs acontecem. Isso é um fato. Mas eles podem ser corrigidos. E quanto melhor for um relatório de bug, mais fácil será para a equipe de desenvolvimento replicá-lo, investigá-lo e, eventualmente, corrigi-lo.

Todos os relatórios de bugs precisam ser registrados no rastreador oficial de bugs. E as solicitações de funcionalidades também são rastreadas lá usando o item de gravidade lista de desejos. Mas antes de fazer isso, faça o seguinte:

Passo 1: atualize para a versão mais recente

Atualize para as últimas versões lançadas do Kdenlive. Não respondemos a relatórios de bugs de versões antigas do Kdenlive (a menos que ainda sejam reproduzíveis na versão mais recente).

Passo 2: Pesquise a documentação oficial do Kdenlive

RTFM - Leia o manual (o termo em inglês não é tão polido) é uma expressão frequentemente usada para zombar de usuários que fazem perguntas que poderiam ser respondidas lendo a documentação. Na era dos tutoriais do YouTube, isso pode não ser tão importante ou relevante mais, mas recomendamos que você consulte a documentação oficial do Kdenlive. Ela pode ser pesquisada e contém uma riqueza de informações úteis e valiosas.

Passo 3: Pesquise nos fóruns

O Kdenlive tem uma grande comunidade ativa em fóruns e salas de bate-papo. Verifique no fórum oficial se outros usuários encontraram o mesmo problema. Talvez exista uma correção ou solução alternativa. Outros canais para verificar são

Passo 4: Consultar problemas já em aberto

Pesquise no rastreador de bugs. Talvez o problema que você está enfrentando já tenha sido relatado ou até mesmo esteja sendo resolvido. O status do bug é um bom indicador do que está acontecendo no momento:

  • REPORTADO é um bug que foi relatado, mas nada aconteceu até agora. Pode haver uma discussão sobre isso, então vale a pena verificar se ele se aplica ao seu problema.
  • PRECISAINFO é um bug relatado que precisa de mais feedback. Isso significa que um membro da equipe de desenvolvimento o analisou, mas precisa de mais detalhes.
  • CONFIRMADO significa que o bug pode ser reproduzido (por outros usuários ou pela equipe de desenvolvimento)
  • ATRIBUÍDO significa que um desenvolvedor está lidando com o bug
  • RESOLVIDO significa que o bug foi corrigido na versão de desenvolvimento

Passo 5: relatar o bug

Caso ocorra uma falha na inicialização do Kdenlive ou ao tentar reproduzir um arquivo de vídeo, siga estes passos:

  1. Se você compilou o Kdenlive e/ou o MLT, certifique-se de ter seguido todos os passos descritos em nossas instruções.
  2. Verifique se você não tem várias versões do MLT instaladas
  3. Tente reproduzir seu arquivo de vídeo com o player do FFmpeg. Em um terminal: ffplay meuvideo.mpg
  4. Tente reproduzir seu arquivo de vídeo com o player do MLT. Em um terminal: melt meuvideo.mpg

Inclua os resultados no seu relatório de bug como anexos.

Para um bom relatório de bug, inclua as seguintes informações:

  • Sua versão do Kdenlive e do MLT. Você pode copiar essas informações do Kdenlive Menu > Ajuda > Sobre.
  • Seu sistema operacional (SO), como Windows, distribuição Linux ou MacOS, incluindo a respectiva versão
  • O método de instalação do Kdenlive, como o instalador do Windows ou autônomo, ou Linux flatpak/snap/ppa ou appimage
  • Etapas detalhadas para reproduzir o bug. Capturas de tela e gravações de tela são muito úteis para replicar o problema.
  • Quaisquer mensagens de erro ou arquivos de log que você possa fornecer. Por favor, não copie e cole o conteúdo do log no relatório de bug, mas adicione-o como anexo.
  • Se o bug travar o Kdenlive, forneça um backtrace.

Como obter informações úteis sobre falhas (backtrace)

Um backtrace contém informações valiosas para a equipe de desenvolvimento. Ele requer um pouco de configuração específica do sistema operacional e de conhecimento de linha de comando e, portanto, pode não ser tão fácil de conseguir por qualquer um.

Appimage do Linux

Instale os seguintes pacotes: gdb, kdenlive-dbg, libmlt-dbg (os nomes dos pacotes podem ser ligeiramente diferentes dependendo da sua distribuição)

Quando o Kdenlive trava, se a caixa de diálogo do gerenciador de travamentos do KDE aparecer, você poderá copiar os dados fornecidos. Caso contrário, inicie o Kdenlive em um terminal com este comando:

  1. Digite gdb kdenlive
  2. Após o gdb ler os símbolos de depuração, digite run

Flatpak do Linux

Primeiro, certifique-se de que os símbolos de depuração do Flatpak estejam instalados digitando flatpak install org.kde.kdenlive.Debug em uma linha de comando.

Agora você pode iniciar o Flatpak a partir de uma linha de comando como esta:

  1. Inicie um shell dentro do sandbox do Kdenlive Flatpak: flatpak run --command=sh --devel org.kde.kdenlive
  2. Digite gdb /app/bin/kdenlive
  3. Após o gdb ler os símbolos de depuração, digite run

Para mais detalhes sobre a depuração do Flatpak, veja aqui: https://docs.flatpak.org/en/latest/debugging.html

Windows

  1. Compile o Kdenlive com o KDE Craft localmente, conforme descrito aqui.
  2. Digite na linha de comando cd C:/CraftRoot/mingw64/bin
  3. Inicie o gdb com gdb
  4. Inicie o Kdenlive -> obtenha o número PID
  5. attach 3288 (substitua o 3288 pelo número PID)
  6. Aguarde o prompt (gdb)
  7. Digite c

Após seguir as instruções específicas da plataforma acima para iniciar o Kdenlive, você poderá acionar o bug. Quando o Kdenlive travar, acesse a janela do seu terminal e digite:

thread apply all bt full

Em seguida, pressione Enter até ver os dados completos. Copie o log para um arquivo e anexe-o ao relatório de bug.