Um relatório de bugs contém logs de dispositivos, traços de pilha e outras informações de diagnóstico para ajudá-lo a encontrar e corrigir bugs em seu aplicativo. Você pode capturar um relatório de bugs do seu dispositivo usando ou a opção Take bug report developeroption no dispositivo, o menu Emulator do Android, ou o comando adb bugreport na sua máquina de desenvolvimento.
Figure 1. Opções do desenvolvedor
Para pegar um relatório de bug, você deve ter as opções do desenvolvedor ativadas no yourdevice para que você possa acessar a opção Take bug report.
Capturar um relatório de bug de um dispositivo
Figure 2. O relatório de bug está pronto
Para obter um relatório de bug diretamente do seu dispositivo, faça o seguinte:
- Certifique-se de ter as Opções do Desenvolvedor ativadas.
- Em Opções do Desenvolvedor, toque em Take bug report.
- Selecione o tipo de relatório de bug que você deseja e toque em Relatório.
Após um momento você receberá uma notificação de que o relatório de bug está pronto (veja figura 2).
- Para compartilhar o relatório de bug, toque na notificação.
Capturar um relatório de bug do Emulador Android
Do Emulador Android, você pode usar a função File a bugfeature nos controles estendidos:
- Click More
no painel do emulador. -
Na janela Extended controls, selecione Bug report do lado esquerdo.
Esta opção abre uma tela onde você pode ver os detalhes do relatório de bug, como a captura de tela, as informações de configuração do AVD e o log do relatório de bug. Você também pode digitar uma mensagem com os passos de reprodução para salvar com o relatório.
-
Espere que o relatório de bug termine de coletar, e então clique em Save Report.
Capture um relatório de bug usando adb
Se você tiver apenas um dispositivo conectado, você pode obter um relatório de bug usandoadb da seguinte forma:
$ adb bugreport E:\Reports\MyBugReports
Se você não especificar um caminho para o relatório de bug, ele será salvo no diretório local.
Se você tiver vários dispositivos conectados, você deve especificar o dispositivo com a opção-s. Execute os comandos a seguir adb comando alternar o número de série do dispositivo e gerar o relatório de bug.
$ adb devicesList of devices attachedemulator-5554 device8XV7N15C31003476 device$ adb -s 8XV7N15C31003476 bugreport
Inspecione o arquivo ZIP do relatório de bug
Por padrão o arquivo ZIP é chamadobugreport-BUILD_ID-DATE.zip e pode conter vários arquivos, mas o arquivo mais importante ébugreport-BUILD_ID-DATE.txt. Este é o relatório de bugs e contém a saídasdiagnóstico para serviços de sistema (dumpsys), logs de erros (dumpstate),e logs de mensagens do sistema (logcat). As mensagens do sistema incluem traços de pilha quando o dispositivo lança um erro, e mensagens escritas de todos os aplicativos com a classeLog.
O arquivo ZIP contém um arquivo version.txt metadados que contém a letra de lançamento do Android, e quando o systrace está habilitado, o arquivo ZIP também contém um arquivo systrace.txt. A ferramentaSystrace ajuda a analisar o desempenho do seu aplicativo, capturando e exibindo os tempos de execução dos processos da sua aplicação e de outros processos do sistema Android.
A ferramenta dumpstate copia arquivos do sistema de arquivos do dispositivo para o arquivo ZIP sob a pasta FS para que você possa referenciá-los. Por exemplo, um ficheiro /dirA/dirB/fileC no dispositivo geraria umaFS/dirA/dirB/fileC entrada no ficheiro ZIP.
Figure 3. Estrutura do arquivo de relatório de bugs
Para mais informações, vejaLer relatórios de bugs.
Receba relatórios de seus usuários
Capturar relatórios de bugs como descrito acima é útil já que você mesmo está usando o appyourself, mas seus usuários finais não podem facilmente compartilhar esses tipos de relatórios de bugs com você. Para obter relatórios de falhas com traços de pilha de usuários reais, você deve aproveitar as funcionalidades de relatórios de falhas do Google Play e do Firebase.
Google Play Console
Você pode obter relatórios doGoogle Play Console para visualizar dados de falhas e erros de resposta de aplicativos (ANR) de usuários que instalaram seu aplicativo no Google Play.Data está disponível para os seis meses anteriores.
Para mais informações, consulte Exibir falhas & erros de aplicativos que não respondem (ANR) na ajuda do Console Play.Data.
Relatórios de falhas do Firerebase
Relatórios de falhas do Firerebase Crashlytics cria relatórios detalhados dos erros do seu aplicativo. Os erros são agrupados em problemas baseados em ter traços de pilha similares e triados pela gravidade do impacto nos seus usuários. Além dos relatórios automáticos, você pode registrar eventos personalizados para ajudar a capturar os passos que levam a uma falha.
Você começará a receber relatórios de falha de qualquer usuário simplesmente adicionando as dependências doFirebase ao seu arquivo build.gradle. Para mais informações, vejaFirebase Crashlytics.