获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

Eventos de depuração

O DebugView permite que você veja os dados brutos de eventos registrados pelo seu aplicativo em dispositivos de desenvolvimento quase em tempo real. Isso é muito útil para fins de validação durante a fase de instrumentação do desenvolvimento e pode ajudar você a descobrir erros e enganos na implementação do Analytics e confirmar se todos os eventos e propriedades do usuário foram registrados corretamente.

Ativar o modo de depuração

Geralmente, os eventos registrados pelo seu aplicativo são agrupados durante o período de aproximadamente uma hora e carregados juntos. Essa abordagem conserva a bateria nos dispositivos dos usuários finais e reduz o uso de dados da rede. No entanto, para validar sua implementação do Analytics (e para visualizar seu Analytics no relatório DebugView), você pode ativar o modo de depuração em seu dispositivo de desenvolvimento para carregar eventos com um atraso mínimo.

iOS+

Para habilitar o modo de depuração do Analytics em seu dispositivo de desenvolvimento, especifique o seguinte argumento de linha de comando no Xcode:

-FIRDebugEnabled

Esse comportamento persiste até que você desabilite explicitamente o modo de depuração especificando o seguinte argumento de linha de comando:

-FIRDebugDisabled

Android

Para ativar o modo de depuração do Analytics em um dispositivo Android, execute os seguintes comandos:

adb shell setprop debug.firebase.analytics.app PACKAGE_NAME

Esse comportamento persiste até que você desabilite explicitamente o modo de depuração executando o seguinte comando:

adb shell setprop debug.firebase.analytics.app .none.

Rede

Para ativar o modo de depuração do Analytics em seu navegador, instale a extensão Google Analytics Debugger Chrome.

Uma vez instalado, habilite a extensão e atualize a página. A partir desse ponto, a extensão registrará eventos em seu aplicativo no modo de depuração.

Você pode ver os eventos registrados no DebugView no console do Firebase.

Relatório sobre dados do evento

Depois de ativar o modo de depuração em seus dispositivos de desenvolvimento, navegue até DebugView selecionando a seta ao lado de StreamView na navegação superior do Google Analytics e selecionando DebugView.

Navegue até DebugView selecionando a seta ao lado de StreamView na navegação superior do Google Analytics e selecionando DebugView

Em seguida, basta começar a usar seu aplicativo para ver os eventos do seu aplicativo sendo registrados no relatório DebugView.

O relatório DebugView.

O fluxo de segundos (a coluna do meio) mostra os eventos que foram registrados nos últimos 60 segundos. O fluxo Minutos (a coluna da esquerda) mostra uma série de arquivos de eventos nos últimos 30 minutos. E a coluna da direita mostra os principais eventos registrados no período de 30 minutos, bem como as propriedades do usuário atual para o dispositivo de desenvolvimento selecionado no momento.

Fluxo de segundos

Por padrão, você verá uma lista de eventos registrados nos últimos 60 segundos. Cada evento exibe um carimbo de data/hora que corresponde à hora de seu registro no dispositivo de desenvolvimento. Você pode clicar em um evento para ver uma lista dos parâmetros que foram associados a esse evento.

Uma lista de exemplo de parâmetros de evento.

À medida que os valores das propriedades do usuário mudam durante o uso do aplicativo, você verá uma entrada para essa alteração.

Uma propriedade de usuário de exemplo.

Fluxo de minutos

Este fluxo mostra uma série de círculos, cada um correspondendo a um minuto nos últimos 30 minutos. O número no círculo indica a contagem de eventos recebidos naquele minuto. Clicar em um desses círculos preencherá o fluxo de segundos com eventos que foram registrados durante esse minuto. Isso efetivamente permite que você examine os eventos registrados nos últimos 30 minutos em detalhes refinados.

Um exemplo do fluxo de minutos.

Principais eventos e propriedades do usuário atual

A tabela Principais eventos mostra os principais eventos que foram registrados durante o período de 30 minutos. E a tabela Current User Properties mostra o estado mais recente do conjunto de User Properties para o dispositivo de desenvolvimento selecionado no momento.

Um exemplo da tabela de eventos principais.

Seletor de dispositivo

Como muitos dispositivos de desenvolvimento diferentes podem ter o modo de depuração ativado, você pode usar o seletor de dispositivos para escolher o dispositivo específico no qual o relatório DebugView se concentrará. Isso permite que vários desenvolvedores se concentrem em seus próprios esforços de instrumentação e validação sem afetar um ao outro.

Um exemplo do seletor de dispositivos.