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 bug 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 Mensagens

Dispositivo com acesso root

Em um dispositivo com acesso root, use os seguintes comandos 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 acesso 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

Reproduza o problema.

  1. Em Configurações > Sistema > Opções do desenvolvedor > Tamanhos de buffer do registrador, maximize o tamanho do buffer do registrador. Use o tamanho maior para o dispositivo (por exemplo, 16 MB em um dispositivo de última geração).
  2. Force o fechamento do app Mensagens.
  3. Se o bug estiver relacionado ao provisionamento de 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 nas Configurações.
    5. Aguarde pelo menos cinco minutos antes de iniciar o relatório de bug.

  4. Para cada novo bug, limpe as mensagens do Logcat:

    adb logcat -c

  5. Inicie a gravação de vídeo:

    • Grave apenas o bug informado.
    • Mantenha as gravações de vídeo o mais curtas possível. Por exemplo, se o bug ocorrer após uma única chamada, registre apenas essa seção da chamada.
    • Não grave etapas repetitivas.

  6. Inicie o app Mensagens e reproduza o bug.

  7. Pare 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 durante a reprodução do 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 Denunciar. Uma notificação indica quando o relatório do bug está pronto.

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

Se o bug estiver relacionado a uma ou mais mensagens (por exemplo, mensagens que não puderam ser enviadas), 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 Debug Utils é aberto ou uma mensagem pop-up aparece com a mensagem Debug menu option enabled.
  2. Toque e pressione a mensagem.
  3. Toque no menu e em Ver detalhes.