Capturar um relatório de bug e uma gravação de vídeo para o dispositivo Android

Para ajudar a equipe de suporte a resolver problemas com o app Mensagens em dispositivos Android, gere um relatório de bug e uma gravação de vídeo.

Para gerar um relatório de bugs diretamente no seu dispositivo Android, siga estas etapas.

Ativar as opções do desenvolvedor e a depuração USB

Para informações sobre as opções do desenvolvedor usadas para configurar comportamentos do sistema que ajudam você a criar perfis e depurar o desempenho do app, consulte Configurar opções do desenvolvedor no dispositivo.

Ativar o registro detalhado para o app Mensagens

Dispositivo com acesso root

Em um dispositivo com acesso root, use os comandos a seguir para ativar o registro detalhado:

adb shell setprop log.tag.Bugle VERBOSE
adb shell setprop log.tag.BugleDataModel VERBOSE
adb shell setprop log.tag.RcsProvisioning VERBOSE
adb shell setprop log.tag.CarrierServices VERBOSE
adb shell setprop log.tag.BugleAction VERBOSE:
adb shell setprop log.tag.BugleRcsEngine VERBOSE;
adb shell setprop log.tag.BugleTransport VERBOSE;
adb shell setprop log.tag.BugleRcsProvisioning VERBOSE;
adb shell setprop log.tag.RcsClientLib VERBOSE;
adb shell setprop log.tag.BugleRcs VERBOSE;

Ative o registro detalhado apenas para os dispositivos de teste. O registro a seguir inclui informações de identificação pessoal (PII).

adb shell su root am broadcast -a com.google.gservices.intent.action.GSERVICES_OVERRIDE -e carrier_services_log_level VERBOSE
adb shell su root am broadcast -a com.google.gservices.intent.action.GSERVICES_OVERRIDE -e carrier_services_enable_debug_mode true
adb shell su root am broadcast -a com.google.gservices.intent.action.GSERVICES_OVERRIDE -e bugle_rcs_allow_overrides true
adb shell su root am broadcast -a com.google.gservices.intent.action.GSERVICES_OVERRIDE -e bugle_debugging true
adb shell su root am broadcast -a com.google.gservices.intent.action.GSERVICES_OVERRIDE -e carrier_services_enable_sensitive_logging true

Dispositivo sem root

Em um dispositivo sem acesso root, use o seguinte comando para ativar o registro detalhado:

adb shell am broadcast -a 'com.google.android.gms.phenotype.FLAG_OVERRIDE' --es package "com.google.android.apps.messaging#com.google.android.apps.messaging" --es user "\*" --esa flags "bugle_phenotype__enable_verbose_bug_reports" --esa values "true" --esa types "boolean" com.google.android.gms

Reproduzir o problema

  1. Em Configurações > Sistema > Opções do desenvolvedor > Tamanhos de buffer de logger, maximize o tamanho do buffer de logger. Use o maior tamanho para o dispositivo (por exemplo, 16 MB em um dispositivo sofisticado).
  2. Force o fechamento do app Mensagens.
  3. Se o bug estiver relacionado ao provisionamento dos Serviços de Comunicação Avançada (RCS), siga estas etapas:
    1. Ative o modo avião.
    2. Limpe o armazenamento do app Mensagens e dos Serviços da operadora em Configurações.
    3. Desative o modo avião.
    4. Ative o chat RCS em Configurações.
    5. Aguarde pelo menos cinco minutos antes de iniciar o relatório do bug.
  4. Para cada novo bug, limpe as mensagens de logcat:

    adb logcat -c
    
  5. Inicie a gravação de vídeo:

    • Registre apenas o bug informado.
    • Faça gravações de vídeo o mais curtas possível. Por exemplo, se o bug ocorrer depois de fazer uma única chamada, grave apenas essa seção da chamada.
    • Não grave etapas repetitivas.
  6. Inicie o app Mensagens e reproduza o bug.

  7. Interrompa a gravação de vídeo.

Coletar o relatório do bug

  1. No relatório, capture o seguinte:
    1. O carimbo de data/hora em que o bug ocorre.
    2. As etapas que acionam o bug.
    3. O bug em si (por exemplo, mensagem de erro).
    4. Uma gravação da tela ao reproduzir o bug.
  2. Em Opções do desenvolvedor, toque em Obter relatório de bugs.

  3. Selecione um tipo de relatório de bug e toque em Informar. Uma notificação indica quando o relatório do bug está pronto.

  4. Anexe o relatório do bug a um bug enviado.

Se o bug estiver relacionado a uma ou mais mensagens (por exemplo, não foi possível enviar mensagens), forneça os IDs das mensagens afetadas.

  1. Ative o menu de depuração do app Mensagens:
    1. Abra o app Mensagens.
    2. Toque na barra de pesquisa.
    3. Pesquisar por *xyzzy*. O menu Utilitários de depuração é aberto ou um toast aparece com a mensagem Debug menu option enabled.
  2. Toque na mensagem e a mantenha pressionada.
  3. Toque em Menu e em Ver detalhes.