"Onde encontrar e como obter registros de travamento em dispositivos móveis? Qual é a maneira mais fácil?"

Em casos de travamentos em um aplicativo móvel, os registros do dispositivo são essenciais como um componente-chave do seu relatório de bug. Além disso, podem ser valiosos para congelamentos do aplicativo. Somente as informações registradas podem fornecer uma visão detalhada das circunstâncias do problema.

Neste artigo, você aprenderá como obter informações de log para dispositivos Android e iOS. Aplicar essas técnicas permitirá que você registre e anexe arquivos de log significativos aos seus relatórios.

Para dispositivos Android, existem duas abordagens principais: uma é utilizar o Android Debug Bridge (ADB), e a segunda é utilizar o recurso integrado de Relatório de Bug, dentro das Ferramentas de Desenvolvedor em seu telefone. Primeiramente, explicaremos como usar o ADB.

No Windows, para obter registros de travamento via ADB, é necessário baixar as Ferramentas da Plataforma SDK. Você pode realizar o download dessas ferramentas aqui.

No macOS, será necessário instalar o android-platform-tools usando o Homebrew. As instruções de instalação podem ser encontradas mais adiante neste artigo.

Após baixar as Ferramentas da Plataforma SDK, você precisará extrair os arquivos (pasta). Ao abrir a pasta extraída, na barra de endereços do Explorador de Arquivos, clique em um espaço em branco. Quando o caminho do arquivo for exibido, digite cmd e pressione ENTER no teclado. Isso iniciará o Prompt de Comando dentro da pasta, e assim o ADB será basicamente iniciado.

A primeira etapa é instalar o Homebrew usando o Terminal. Em seguida, instale o android-platform-tools. Para instalar o Homebrew em seu macOS, visite o site do Homebrew e copie o link de instalação na seção Instalar o Homebrew. Após copiar o link de instalação, cole-o no Terminal e pressione Enter no teclado. O Homebrew iniciará a instalação. Siga as instruções de instalação até o final.

Após a conclusão da instalação do Homebrew, será necessário instalar o android-platform-tools. Para fazer isso, visite a android-platform-tools Homebrew Formulae e copie o comando de instalação. Em seguida, cole o comando no Terminal e pressione Enter. A instalação começará imediatamente. Após a conclusão da instalação, digite adb no Terminal e pressione Enter. Se você visualizar os comandos adb, isso indica que a instalação foi bem-sucedida.

Para criar registros, é necessário ativar a Depuração USB nas opções de desenvolvedor do seu telefone e executar comandos no cmd (Windows) ou Terminal (macOS), que foram abertos anteriormente. Se você já ativou as Ferramentas de Desenvolvedor e a Depuração USB, pode pular para a Parte 2.

1. No cmd (Windows) ou no Terminal (macOS) que foi aberto anteriormente, digite adb start-server e pressione Enter no teclado. Isso iniciará o servidor adb.

2. Em seguida, conecte seu telefone ao seu PC usando um cabo USB. Se você nunca utilizou a depuração USB antes no seu telefone Android, poderá ver um aviso "Permitir depuração USB?" - toque em OK. Você também pode selecionar "Sempre permitir neste computador" e tocar em OK para garantir que você não seja questionado repetidamente ao tentar obter registros de travamento.

3. Agora, digite no cmd ou no Terminal adb devices e pressione Enter. Isso listará os dispositivos conectados ao seu PC e garantirá que seu dispositivo esteja na lista.

4. Para criar um log para os problemas reproduzíveis, comece limpando o histórico de log para remover conteúdo desnecessário digitando adb logcat -c e pressionando Enter.

5. Agora é a hora de capturar logs.

5a. Se você deseja criar um log na pasta atual (onde as ferramentas da plataforma estão no Windows), pode digitar no cmd adb logcat -v time > crashlog.txt e pressionar Enter no teclado. O processo de registro começará após pressionar Enter.

5b. Se deseja criar um log em outra pasta, precisará copiar o caminho do arquivo dessa pasta. No Windows, navegue até a pasta de destino, clique em um espaço em branco na barra de endereços no Explorador de Arquivos e copie o caminho do arquivo. No macOS, selecione a pasta desejada, clique com o botão direito e escolha Copiar. Após copiar o caminho do arquivo, no cmd ou no Terminal, digite adb logcat -v time > cole_o_caminho_do_arquivo_aqui\log.txt e pressione Enter no teclado. No Windows, o comando deve ser assim: adb logcat -v time > D:\testIO\Logs\crashlog.txt; No Mac, deve ser assim: adb logcat -v time > /Users/testIO/log/crashlog.txt. O processo de registro começará após pressionar Enter.

6. Agora que você iniciou o registro, reproduza o erro ou travamento para o qual deseja criar um registro. Quando terminar, no cmd ou no Terminal, pressione CTRL + C. Isso interromperá o processo de registro, e você deverá ver seu arquivo de log na pasta especificada.

Explicação em vídeo: 5a - Criando um log na pasta atual onde as ferramentas da plataforma estão

Explicação em vídeo: 5b - Criando um log em outra pasta (Windows)

Explicação em vídeo: 5b - Criando um log em outra pasta (Mac)

Outra maneira de obter logs do seu telefone Android é utilizando o recurso de relatório de bug do Android diretamente nas opções de desenvolvedor do seu dispositivo. Você pode criar relatórios de bug a qualquer momento, os quais incluirão toda a atividade de log dentro de um determinado período, dependendo do tamanho do buffer de log e da atividade de log em seu dispositivo. Esse período pode variar de alguns minutos a várias horas ou até dias.

Obter informações de log em dispositivos iOS não requer muito esforço. Dependendo do computador que você está usando (Windows ou Mac), mostraremos como você pode extrair rapidamente os logs e anexá-los ao seu relatório de bug no texto a seguir.

Quando ocorre um travamento em seu dispositivo iOS, na maioria dos casos, um arquivo .ips será criado automaticamente e adicionado aos Dados de Análise. Esse arquivo .ips precisará ser anexado ao seu relatório de bug quando você estiver relatando um erro em um dispositivo iOS. Você pode encontrar registros de travamento em seu dispositivo iOS seguindo as etapas a seguir:

Depois de abrir os Dados de Análise, você encontrará todos os logs criados em seu dispositivo iOS. Agora, temos uma seção sobre como extrair rapidamente esses logs. Dependendo do seu computador (Windows ou Mac), recomendamos as seguintes maneiras:

Usando o 3uTools. Com o 3uTools, você poderá encontrar e extrair rapidamente os logs para o seu PC com Windows, e tudo o que você precisa é de um cabo USB. Para fazer isso, siga as etapas a seguir:

Extrair arquivos de log em dispositivos iOS para um Mac é ainda mais fácil do que no Windows. A maneira mais rápida de extrair arquivos de log de seu dispositivo iOS para o Mac é usando o recurso AirDrop. Para fazer isso, siga as etapas a seguir:

Se você tiver problemas para extrair logs de seu dispositivo iOS em seu computador Windows ou Mac com as etapas fornecidas anteriormente, existe também uma solução alternativa simples. Tudo o que você precisa fazer é abrir o arquivo de log correspondente em Dados de Análise, tocar no botão Compartilhar, selecionar o aplicativo de e-mail e enviar o log para você mesmo. Depois disso, vá para seu e-mail no computador Windows ou Mac, faça o download do log e anexe-o ao seu relatório de bug. Claro, se você tiver seus próprios métodos de extração de logs, também pode usá-los.