O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Primeiros passos com o Monitoramento de desempenho para iOS

Antes de começar

Adicione o Firebase ao seu projeto do iOS, caso ainda não tenha feito.

Etapa 1: adicionar o Monitoramento de desempenho ao seu app

Depois que você adiciona o SDK do Monitoramento de desempenho, o Firebase começa a coletar dados automaticamente para a renderização de tela do seu app, incluindo os dados relacionados ao ciclo de vida do seu aplicativo (como o horário de início do app) e dados para solicitações de rede HTTP/S.

  1. Abra o podfile que você criou para o projeto (ou execute pod init para criar um). Em seguida, adicione a seguinte linha na seção de destino:

    pod 'Firebase/Performance'
  2. No diretório do seu podfile, execute o seguinte comando para instalar o SDK do Monitoramento de desempenho:

    pod install
  3. Abra o arquivo .xcworkspace usando o Xcode.

  4. Importe o módulo do Firebase no UIApplicationDelegate:

    Swift

    import Firebase

    Objective-C

    @import Firebase;
  5. Configure uma instância compartilhada do FirebaseApp, normalmente no método application:didFinishLaunchingWithOptions: do seu aplicativo:

    Swift

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  6. Recompile o app.

Etapa 2: gerar eventos de desempenho para a exibição inicial de dados

O Firebase pode detectar se você adicionou o SDK ao seu app quando ele recebe informações de eventos (como interações) do app. Se você ainda estiver desenvolvendo localmente, interaja com o app a fim de gerar eventos para a detecção do SDK, bem como coleta e processamento inicial de dados.

  1. Continue desenvolvendo o app usando um simulador ou dispositivo de teste.

  2. Gere eventos alternando o app entre o plano de fundo e o primeiro plano várias vezes, interagindo com o app ao navegar pelas telas e/ou acionando solicitações de rede.

  3. Acesse o painel Desempenho do Console do Firebase e veja se ele detectou o SDK.

    Se você não vir a mensagem "SDK detectado", veja as dicas de solução de problemas.

  4. O Monitoramento de desempenho processa dados de eventos de desempenho antes de exibi-los no painel Desempenho. Você verá seus dados iniciais em até 24 horas depois de ver a mensagem de detecção do SDK.

    Se você não vir uma exibição dos seus dados iniciais, veja as dicas de solução de problemas.

Etapa 3: (opcional) ver se há eventos de desempenho nas mensagens de registro

  1. Ative a geração de registros de depuração da seguinte maneira:

    1. No Xcode (versão mínima 11.0), selecione Product > Scheme > Edit scheme.
    2. Selecione Run no menu à esquerda e depois a guia Arguments.
    3. Na seção Arguments Passed on Launch, adicione -FIRDebugEnabled.
  2. Verifique se há mensagens de erro nas mensagens de registro.

  3. O Monitoramento de desempenho marca as mensagens de registro com Firebase/Performance para que você possa filtrá-las.

  4. Verifique os seguintes tipos de registro que indicam que o Monitoramento de desempenho está registrando eventos de desempenho:

    • Logging trace metric: TRACE_NAME
    • Logging network request trace: URL

Se o app não estiver registrando eventos de desempenho, veja as dicas de solução de problemas.

Etapa 4 (opcional): adicionar monitoramento personalizado para código específico

Para monitorar os dados de desempenho associados a um código específico no app, instrumente traces de código personalizados.

Com um trace de código personalizado, é possível avaliar quanto tempo o app leva para concluir uma tarefa específica ou um conjunto de tarefas, como carregar um conjunto de imagens ou consultar seu banco de dados. A métrica padrão de um trace de código personalizado é a duração, mas também é possível adicionar métricas personalizadas, como ocorrências em cache e avisos de memória.

No seu código, você define o início e o fim de um trace de código personalizado (e adiciona a métrica personalizada que quiser) usando a API fornecida pelo SDK do Monitoramento de desempenho.

Acesse Adicionar monitoramento para códigos específicos para saber mais sobre esses recursos e como adicioná-los ao seu app.

Etapa 5: implantar seu app e analisar os resultados

Depois de validar o Monitoramento de desempenho usando o simulador Xcode e um ou mais dispositivos de teste, você será capaz de implantar a versão atualizada do seu app para os usuários.

Você pode monitorar os dados de desempenho no painel Desempenho do Console do Firebase.

Problemas conhecidos

  • O Monitoramento de desempenho tem problemas de compatibilidade conhecidos com o GTMSQLite. Recomendamos não usar o Monitoramento de desempenho com apps que usam GTMSQLite.
  • O swizzling de métodos após chamar FirebaseApp.configure() pode interferir no SDK do Monitoramento de desempenho.
  • Problemas conhecidos no simulador de iOS 8.0 a 8.2 impedem o Monitoramento de desempenho de capturar eventos de desempenho. Esses problemas são corrigidos no simulador de iOS 8.3 e versões posteriores.
  • As conexões estabelecidas usando o backgroundSessionConfiguration da NSURLSession terão tempos de conexão mais longos do que o esperado. Essas conexões são executadas fora do processo, e o tempo reflete os eventos de retorno de chamada em processo.

Próximas etapas