Relatórios de erros e pedidos de funcionalidade

O NextATC escreve o diagnóstico principal em NextATC.log, na pasta do plugin, e guarda uma sessão anterior em .previous_session. Os relatórios incluem automaticamente os registos atuais e anteriores disponíveis, incluindo Traffic e AutoFly. A revisão lista os ficheiros recolhidos. Os registos anteriores ajudam após um encerramento inesperado, mas não provam uma falha. Num pedido manual no site, anexe também NextATC.log da mesma sessão afetada, se disponível.

Abra Plugins → NextATC → Bug / Feature Request. O reporter do plugin é um benefício para Patreons e verifica novamente o direito de apoio Patreon quando um relatório é enviado. Primeiro escolha se está reportando um erro ou solicitando uma funcionalidade antes de inserir os detalhes.

No plugin, um pedido de funcionalidade sem capturas de ecrã é enviado diretamente, sem criar um ZIP nem abrir a revisão do pacote. Se incluir capturas, reveja o ZIP preparado antes de enviar.

O que está incluído#

• Os relatórios de erro incluem a sua descrição, os registos de voo atuais (com credenciais removidas), identificadores de conta e caminhos pessoais removidos, e apenas as definições explicitamente permitidas. Também incluem todos os ficheiros GeoJSON de diagnóstico criados durante o voo atual; os ficheiros GeoJSON mais antigos são excluídos. Os pedidos de funcionalidade não incluem registos, definições nem diagnósticos GeoJSON.
• Ambos os tipos podem incluir até dez capturas de ecrã PNG do voo atual. As capturas são incluídas sem alterações, por isso reveja cuidadosamente as miniaturas.
• Não são intencionalmente incluídos e‑mail Patreon, token de login, palavra‑passe, chave API, endereço IP, ID de instalação ou caminho pessoal da pasta inicial.

Para adicionar uma captura, prima Capturar imagem agora. O reporter fica brevemente oculto enquanto a função nativa do X‑Plane salva o PNG e depois volta ao mesmo diálogo com a nova miniatura selecionada. Desmarque qualquer imagem que não queira enviar: a miniatura desaparece, o slot fica disponível, mas o PNG salvo pelo X‑Plane não é apagado. Todas as dez miniaturas permanecem numa única grelha; ao atingir dez, remova uma antes de capturar outra. É possível fechar o reporter a qualquer momento e voltar mais tarde sem perder o rascunho, a pré‑visualização ou a seleção de capturas.

Se User Debug estiver desativado, o primeiro ecrã do reporter mostra um aviso grande. Ative‑o nas Opções antes de reproduzir o problema ou capturar imagens para incluir os detalhes de diagnóstico mais úteis.

Antes de enviar#

Quando é necessário um pacote, NextATC cria NextATC-bug-report.zip ou NextATC-feature-request.zip na pasta bugreport do plugin. Abrir pasta local permite verificar exatamente o que será enviado; a pasta do relatório contém apenas o ZIP. Depois prima o botão de envio. Fechar a janela apenas esconde a tarefa e Cancelar a interrompe. O progresso de upload é sempre exibido no OSD sem necessidade de reabrir um reporter fechado. O ZIP local permanece disponível até que o remova.

Os envios automáticos são limitados a 100 MiB e a três relatórios num período móvel de 24 horas. Patreons mantêm acesso às conversas de relatórios existentes no website; um novo relatório automático requer um direito de apoio Patreon ativo.

Enviar um relatório a partir do Unicom#

Os apoiantes pagantes ativos do Patreon também podem enviar um relatório a partir do website, na página New report do Unicom. Inicie primeiro sessão com o Patreon. A afiliação é verificada novamente ao enviar; membros gratuitos, em avaliação ou com subscrições presenteadas não têm acesso à criação de novos relatórios.

Escolha Bug report, Feature request ou Support request, indique um assunto e descreva o que aconteceu, o que esperava e como reproduzir o problema. Um relatório de erro na web requer o arquivo legível X-Plane/Log.txt afetado; a deteção automática incompleta de versão ou detalhes do voo não impede a submissão. Um pedido de funcionalidade não necessita de log. Revise registos e capturas de ecrã para informações privadas antes de fazer upload: a sanitização automática de diagnóstico do plugin não se aplica a ficheiros que anexar manualmente.

A sua conta fornece a identidade do reporter. Após o envio, o relatório aparece em My bug reports, My feature requests ou My support requests, onde pode acompanhar a conversa. Se a conexão falhar após o envio, verifique essas secções antes de enviar outro. As conversas de relatórios existentes permanecem disponíveis mesmo que a sua subscrição paga termine.

Pedidos de suporte#

Um pedido de suporte é uma pergunta ao Antonello sobre como configurar ou usar o NextATC, para os mesmos apoiantes pagantes. Nesta versão envia-se a partir do Unicom com New support request: o reporter dentro do NextATC oferece relatórios de erro e pedidos de funcionalidade. Anexe o Log.txt e o NextATC.log da sessão quando ajudarem. Se se revelar um erro, passa a ser um relatório de erro com o mesmo número (SUP-12 passa a BUG-12).

Dicas para um relatório útil#

• Comunique um único problema por relatório.
• Indique o aeroporto de partida e de chegada, a pista, o estacionamento, a fase de voo, a última ação premida e a hora aproximada.
• Para uma aeronave sintética que não se move, acrescente o indicativo dela e o motivo stopped: mostrado na sua dica do Nav Display; veja Tráfego.
• Não apague a pasta do plugin antes de comunicar: NextATC.log, os logs da sessão anterior e settings.ini estão guardados dentro dela. O NextATC conserva apenas uma sessão anterior; envie o relatório antes de voar mais sessões.

Capturas do Nav Display#

Take Screenshot Now oculta o reporter e captura o que está visível por trás dele. Feche o reporter, abra o Nav Display na página que quer mostrar, reabra o reporter e prima o botão. O comando atribuível NextATC/bug_report_toggle abre e fecha o reporter; só funciona com um direito de apoiante Patreon ativo.

Localização dos logs#

NextATC.log e NextATC.traffic.log estão em X-Plane/Resources/plugins/NextATC/. O Log.txt do X-Plane está na pasta raiz do X-Plane.