Suporte

Como reportar erros de aplicações Android com informação útil

Um relatório reproduzível reduz o tempo necessário para perceber um erro.

Este artigo apresenta critérios e exemplos práticos para compreender o tema. As funcionalidades e os requisitos podem variar com a versão do Android, os serviços utilizados e as condições de cada fornecedor.

Reproduzir antes de comunicar

Registe o que estava a fazer imediatamente antes da falha, a sequência exata de toques ou comandos e o resultado observado. Uma descrição como «abri a categoria Madeira, escolhi uma webcam e apareceu um ecrã preto» é muito mais útil do que «não funciona». Se a falha for intermitente, indique quantas vezes aconteceu.

Identificar o ambiente

Indique o modelo do dispositivo, versão do Android, versão da aplicação, tipo de ligação à Internet e se utiliza VPN. Em Android TV, explique também se a navegação foi feita pelo comando ou por rato. Não partilhe identificadores privados, palavras-passe nem tokens.

Separar erro da aplicação e erro da fonte

Quando a aplicação apresenta conteúdos de terceiros, uma transmissão indisponível pode resultar de um servidor externo. Compare outra fonte na mesma aplicação e, se possível, o mesmo conteúdo noutro dispositivo. O resultado ajuda a localizar a origem, sem presumir que o problema é da aplicação.

Juntar provas relevantes

Uma captura do ecrã com a mensagem de erro pode ajudar; um pequeno vídeo pode demonstrar uma falha de foco na TV. Para problemas de reprodução, registe se existe som, imagem, carregamento infinito ou código de erro. Evite incluir dados pessoais nas imagens.

Modelo de comunicação

Exemplo: «Dispositivo: Android TV; ação: abrir a lista de webcams e selecionar a segunda entrada; esperado: iniciar a transmissão; observado: carregamento permanente; frequência: 3 em 3 tentativas; rede: Wi-Fi; outras webcams: funcionam». O modelo serve para qualquer aplicação.

Depois da correção

Teste o mesmo percurso e confirme se o problema desapareceu. Uma correção pode resolver um caso específico e deixar outros por testar; por isso, indique também se surgiram novos sintomas.

Leituras relacionadas

Para aprofundar, consulte outros guias práticos. os projetos publicados. as informações de contacto.