Obtendo logs do Krita

Existem três tipos diferentes de logs que o Krita pode produzir. Dependendo do problema, você poderá ser solicitado a fornecer um log específico ou todos eles. Esta página explicará como coletar as informações necessárias para fornecer aos desenvolvedores ou usuários do Krita.

  1. Registro de uso do Krita – este registro contém suas últimas 10 sessões do Krita (uma sessão significa que você abriu o Krita). Ele mostra os horários em que você o abriu, informações básicas sobre o seu sistema e o Krita, e todos os arquivos que você criou, abriu e salvou, incluindo todos os salvamentos automáticos.

  2. Informações do sistema – este não é exatamente um log, mas um arquivo que contém informações detalhadas do sistema relacionadas ao Krita.

  3. Crash log/backtrace – este log é criado quando o Krita fecha incorretamente devido a um problema interno. Este log geralmente é necessário para corrigir o problema caso os desenvolvedores não consigam reproduzi-lo (repetir os passos para corrigir o problema).

  4. Saída do console do Krita/Saída do visualizador de logs/Saída do DebugView – este log contém qualquer informação aleatória que o Krita sentiu necessidade de relatar. Geralmente, ele contém informações adicionais úteis que podem ajudar a resolver o problema.

Acesso rápido

Registro de uso do Krita

Pela interface gráfica

A maneira mais fácil de obter o registro de uso do Krita é através da interface gráfica do usuário (GUI). Acesse Ajuda ‣ Mostrar registro do Krita para relatórios de bugs. Uma nova janela será aberta, exibindo o conteúdo do registro.

Do sistema de arquivo

Às vezes, porém, não é possível usar a interface gráfica do Krita, por exemplo, quando ele nem abre. Como os logs são arquivos de texto comuns, você mesmo pode obtê-los do seu sistema de arquivos.

O arquivo é chamado krita.log. Localização do arquivo:

Linux

$HOME/.local/share/krita.log

Windows

%LOCALAPPDATA%\krita.log

macOS

$HOME/Library/Application Support/krita.log

Android

  • Versão da Play Store: <storage>/Android/data/org.krita/files/krita.log

  • Krita Next: <storage>/Android/data/org.krita.next/files/krita.log

Nota

No Windows, você pode simplesmente colar esse caminho na caixa de pesquisa do Windows Explorer, na barra superior, e ele encontrará o arquivo para você.

Registro de crash e backtrace

A localização e a maneira de obter um backtrace são diferentes para cada sistema.

Windows

Normalmente, é suficiente compartilhar o conteúdo de Ajuda ‣ Mostrar log do Krita para relatórios de bugs, pois ele contém o backtrace.

Se você não conseguir abrir o Krita porque ele trava na inicialização, forneça o arquivo %LOCALAPPDATA%\kritacrash.log. Às vezes, informações mais detalhadas são necessárias, então você será solicitado a seguir atentamente o guia do depurador Dr. Mingw.

Linux

No Linux, há cinco maneiras de instalar o Krita.

  • Usando pacotes de distribuição

  • Compilando o Krita você mesmo a partir do código fonte

  • Usando um pacote snap

  • Usando um pacote flatpak

  • Usando o AppImage oficial

Somente pacotes de distribuição e compilados a partir do código-fonte podem produzir logs/backtraces de travamento utilizáveis. Para pacotes de distribuição, você precisará instalar os pacotes de depuração ou dbg correspondentes; o método para isso varia de distribuição para distribuição. Se você usar pacotes de distribuição e o KDE Plasma Desktop, uma janela de travamento será exibida com o backtraces na aba “Desenvolvedor”.

Caso contrário, você terá que usar gdb em uma janela de terminal.

  1. Abra o Krita no gdb:

    # se você tiver o Krita instalado de repositórios, talvez seja necessário digitar apenas 'gdb krita'
# caso contrário, digite o caminho para o arquivo executável
gdb caminho/para/krita

  2. Desabilite a paginação:

    set pagination off

  3. Execute o Krita:

    run

  4. Faça-o travar.

  5. Obtenha o backtrace curto:

    thread apply all bt

  6. Obtenha o backtrace longo:

    thread apply all bt full

  7. Backtraces curtos e longos são salvos em arquivos de texto separados.

  8. Do backtrace curto, é recomendável cortar todos os tópicos que são idênticos a outros ou que não parecem conter nenhuma informação adicional.

    Se você acha que sabe qual parte do backtrace é a mais importante (geralmente é o tópico mais longo), recorte-a e coloque este fragmento no relatório de bug em um comentário. Ambos os backtraces ainda serão necessários: anexe-os também ao relatório de bug.

    Se preferir não tomar essa decisão, basta anexar os dois arquivos com backtraces ao relatório de bug.

macOS

No macOS, é recomendado usar lldb.

  1. Abra o Terminal.app

  2. Abra o Krita no lldb:

    lldb /Applications/krita.app/Contents/MacOS/krita

  3. Execute o Krita:

    run

  4. Faça-o travar.

  5. Obtenha o backtrace:

    thread backtrace all

  6. Salve o backtrace em um arquivo de texto.

  7. Do backtrace, é recomendável cortar todos os tópicos que são idênticos a outros ou que não parecem conter nenhuma informação adicional para colocar no comentário (para que seja facilmente acessível ao desenvolvedor).

    Se você acha que sabe qual parte do backtrace é a mais importante (geralmente é o tópico mais longo), recorte-a e coloque este fragmento no relatório de bug em um comentário. O backtrace completo ainda será necessário: anexe-o também ao relatório de bug.

    Se preferir não tomar essa decisão, basta anexar o arquivo com o backtrace ao relatório de bug.

Android

Para obter os logs usando a GUI, compartilhe o conteúdo de Ajuda ‣ Mostrar log de falhas para relatórios de bugs.

Se você não conseguir abrir o Krita porque ele trava na inicialização, forneça o <storage>/Android/data/org.krita/files/kritacrashlog.txt.

Logcat (Android)

Para obter a saída do logcat para o Krita, compartilhe o conteúdo de Ajuda ‣ Mostrar log do Android para relatórios de bugs.

Saída de texto do Krita

A maior parte da saída de texto do Krita pode ser coletada usando o Visualizador de Logs. As únicas exceções são as mensagens de quando o Krita está inicializando, então ainda não há interface gráfica, ou quando ele fecha ou trava, então nenhuma interação do usuário é possível após o evento.

Pela interface gráfica

  1. Vá para Configurações ‣ Painéis ‣ Visualizador de Logs.

  2. O primeiro botão da esquerda ativa e desativa o registro, portanto, certifique-se de que ele esteja pressionado.

  3. Faça o que você quer para obter a saída.

  4. Use o terceiro botão (a dica diz: Salvar o log) para salvar o log em um arquivo.

  5. Anexe o arquivo ao relatório de bug.

Do console

Usar o console é a maneira mais confiável de obter a saída de texto do Krita. Esse método é semelhante no macOS e no Linux.

Alterado na versão 5.0: Agora isso também é possível no Windows usando o executável krita.com.

Nota

O executável krita.com inicia o Krita como um programa de linha de comando com uma janela de console. Isso não estava disponível antes da versão 5.0 do Krita. Se você tiver uma versão mais antiga ou preferir usar o programa krita.exe sem uma janela de console, consulte Guia do DebugView.

  1. No macOS, abra o Terminal.app; no Linux, abra seu aplicativo de terminal ou console favorito. No Windows, abra um Prompt de Comando digitando cmd.exe no Menu Iniciar e pressionando Enter.

  2. Digite o caminho para o executável do Krita.

    # No Linux, se instalado a partir de repositórios:
krita
# No Linux, em todos os outros casos:
#   (lembre-se de que, se quiser referenciar um arquivo do diretório
#   em que você está atualmente, você precisa digitar: './krita_nomearquivo' em vez de 'krita_nomearquivo'
#   e lembre-se de que este arquivo precisa ter direitos de execução para ser executado)
caminho/para/krita

    # No macOS:
/Applications/krita.app/Contents/MacOS/krita

    REM  No Windows:
REM  Por padrão, o cmd.exe prefere executar o arquivo .COM em vez do .EXE, então
REM  você também pode omitir a extensão de arquivo .COM.
"C:\Program Files\Krita (x64)\bin\krita.com"

  3. Faça o que você quer para obter a saída.

  4. Copie o conteúdo, salve em um arquivo e anexe ao relatório de bug.

Do DebugView

Para obter a saída de texto do Krita no Windows usando o programa gráfico, você precisa de um programa externo chamado DebugView. Comparado ao uso do console, o DebugView tem a vantagem de incluir registros de data e hora nas entradas de log.

  1. Baixe o DebugView caso ainda não o tenha feito. Clique no texto azul em negrito Baixar DebugView sublinhado. O download deverá começar imediatamente.

  2. O arquivo que você baixou é um arquivo .zip. O Windows 10 já inclui um aplicativo para abrir arquivos .zip. Basta extrair todos os arquivos em algum lugar. Você pode saber mais sobre como extrair arquivos compactados na Página do manual de extração do Windows.

  3. Há um arquivo dentro do pacote chamado DbgView.exe (que você pode ver como DbgView, dependendo das configurações do seu sistema). Clique duas vezes nele.

  4. Deixe o programa rodar e abra o Krita.

  5. Faça o que você quer para obter a saída.

  6. Mude para o DebugView e copie o conteúdo. Salve em um arquivo e anexe ao relatório de bug.