"Onde localizar os logs de travamento em dispositivos de streaming e como obter essas informações?"

Quando ocorrem travamentos em dispositivos de streaming, os logs do dispositivo desempenham um papel crucial como componente essencial do seu relatório de bugs. Esses logs também podem ser valiosos para casos de congelamento de aplicativos. Apenas as informações registradas podem proporcionar uma compreensão detalhada das circunstâncias do problema.

Neste artigo, você aprenderá como recuperar informações de log para seus dispositivos de streaming. Ao aplicar essas técnicas, você poderá gravar e anexar arquivos de log significativos aos seus relatórios.

Para obter logs de travamento do Android TV, dispositivos de streaming Android TV e FireOS, recomendamos o uso do Android Debug Bridge (ADB).

No Windows, para obter logs de travamento via ADB, será necessário baixar as Ferramentas da Plataforma SDK. Você pode fazer o download das Ferramentas da Plataforma SDK 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 vazio. Quando o caminho do arquivo for mostrado, digite cmd e pressione ENTER no teclado. Isso iniciará o cmd (Prompt de Comando) dentro da pasta, e dessa forma, o ADB será basicamente iniciado.
​

A primeira etapa é instalar o Homebrew usando o Terminal e, em seguida, instalar o android-platform-tools. Para instalar o Homebrew no seu macOS, visite osite do Homebrew e copie o link de instalação na seção Instalar o Homebrew. Depois de copiar o link, cole-o no Terminal e pressione Enter no teclado. O Homebrew começará a ser instalado. 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 realizar essa instalação, visite o site do Homebrew Formulae do android-platform-tools e copie o comando de instalação. Em seguida, cole o comando no Terminal e pressione Enter no teclado. A instalação será iniciada. Após a conclusão, digite adb no Terminal e pressione Enter. Se você visualizar os comandos adb, isso indicará que a instalação foi bem-sucedida.

Para criar logs, é necessário ativar a Depuração USB/ADB nas opções do desenvolvedor do seu Android TV ou dispositivo de streaming com Android TV e/ou FireOS. Em seguida, execute comandos no prompt de comando (Windows) ou no Terminal (macOS), que você abriu anteriormente. Se você já ativou essas opções e conhece o endereço IP do dispositivo, pode pular para a Parte 2.

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

2. Agora é necessário conectar seu PC ao seu Android TV, dispositivo de streaming Android TV ou dispositivo FireOS. Certifique-se de que ambos os dispositivos estão conectados à mesma rede.

3. No prompt de comando ou no Terminal aberto, digite adb connect endereço_ip_do_dispositivo (exemplo: adb connect 192.168.100.136) e pressione Enter no teclado.

3a. Se você visualizar a mensagem ❝falha ao autenticar-se no endereço_ip_do_dispositivo❞ no prompt de comando ou no Terminal, é provável que uma tela Permitir a depuração USB? esteja sendo exibida na sua TV. Nesta tela, pressione o botão OK. Além disso, você pode marcar a opção Sempre permitir deste computador e tocar em OK para garantir que não seja solicitado repetidamente ao tentar obter logs de travamento.

4. Agora, digite no prompt de comando ou no Terminal adb devices e pressione Enter; isso listará os dispositivos conectados ao seu PC. Certifique-se de que seu dispositivo está presente na lista.

5. Para registrar um log de problemas reproduzíveis, comece limpando o histórico de logs para remover conteúdo desnecessário. Digite adb logcat -c e pressione Enter.

6. Agora é hora de capturar logs.

6a. Se deseja criar um log na pasta atual (onde estão as ferramentas da plataforma no Windows), digite no prompt de comando adb logcat -v time > crashlog.txt e pressione Enter. O processo de registro começará imediatamente após pressionar Enter.

6b. Se você quiser 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 vazio 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'. Depois de copiar o caminho do arquivo, no prompt de comando 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 se parecer com isso: adb logcat -v time > D:\testIO\Logs\crashlog.txt; no Mac, deve se parecer com isso: adb logcat -v time > /Users/testIO/log/crashlog.txt). O processo de registro começará imediatamente após pressionar Enter.

7. Agora que você iniciou o registro, reproduza o bug ou travamento para o qual deseja criar um log. Quando terminar, no prompt de comando ou no Terminal, pressione CTRL + C; isso interromperá o processo de registro, e você poderá visualizar o arquivo de log na pasta especificada.

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

Explicação em vídeo: 6b. Criando um log em algum outro destino (Windows)

Explicação em vídeo: 6b. Criando um log em algum outro destino (MacOS)

Obter logs de travamento do seu dispositivo Apple TV é bastante simples, e tudo o que você precisa é de um PC Mac ou iPhone/iPad para transferir logs usando a funcionalidade AirDrop. Siga estes passos: