Visualizador de Logs

O Visualizador de Logs permite revisar logs de traceback do Ren’Py gerados quando um jogo encontra um erro ou travamento.

Quando um jogo Ren’Py trava ou encontra um erro Python durante o jogo, o motor escreve um arquivo traceback.txt no diretório do jogo. Quando o jogo é encerrado, o Spark automaticamente:

1. Detecta o arquivo traceback.txt
2. Anexa informações do sistema Spark (versão do iOS, versão do Spark, versão do motor, configurações do jogo e configuração do dispositivo)
3. Renomeia o arquivo com um timestamp (por exemplo, traceback_20260311_143022.txt)
4. Move-o para uma pasta logs/ dentro do diretório do jogo

Cada travamento gera um arquivo de log separado, para que você possa revisar o histórico de erros de um jogo.

O Visualizador de Logs é acessível a partir da tela de Detalhes do Jogo. Um botão verde Logs aparece quando um jogo possui um ou mais logs de traceback disponíveis.

Se um traceback for detectado imediatamente após a saída de um jogo, o Spark irá alertá-lo de que um arquivo de log está disponível para revisão com a opção de visualizá-lo imediatamente.

Logs contêm tracebacks do Ren’Py — mensagens de erro Python e rastreamentos de pilha que descrevem o que deu errado durante a execução do jogo. Cada log também inclui informações do sistema Spark anexadas ao final:

• Versão do motor Ren’Py utilizada
• Versão do iOS e versão/número de build do Spark
• Configuração completa do aplicativo e configurações do jogo
• Configurações de tradução (se ativadas)
• Substituições de variantes do dispositivo (se definidas)

O navegador de logs exibe todos os arquivos de traceback salvos para o jogo selecionado, ordenados do mais recente ao mais antigo. Cada entrada mostra o nome do arquivo e a data de criação. Toque em um log para visualizar seu conteúdo completo.

Ao visualizar um log, você pode compartilhá-lo com a equipe de suporte:

• Botão de compartilhar — Abre a folha de compartilhamento do iOS para exportar o traceback via qualquer aplicativo (e-mail, armazenamento em nuvem, mensagens, etc.)
• Enviar por e-mail para o Suporte — Envia o log diretamente para o e-mail de suporte do Spark com o arquivo de traceback anexado

Você pode excluir todos os logs de um jogo a partir do menu do navegador de logs. Isso remove toda a pasta logs/ daquele jogo.

Ao reportar problemas à equipe de suporte:

1. Reproduza o problema iniciando o jogo
2. Após o travamento, abra o Visualizador de Logs na tela de Detalhes do Jogo
3. Compartilhe o log de traceback mais recente no Discord ou via e-mail

O traceback e as informações do sistema anexadas fornecem à equipe de suporte os detalhes necessários para diagnosticar o problema.