Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Comece a usar o Monitoramento de desempenho para plataformas Apple

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de você começar

Se ainda não o fez, adicione o Firebase ao seu projeto da Apple .

Etapa 1 : adicionar o monitoramento de desempenho ao seu aplicativo

Depois de adicionar o SDK de monitoramento de desempenho, o Firebase começa automaticamente a coletar dados para a renderização da tela do seu aplicativo , dados relacionados ao ciclo de vida do seu aplicativo (como hora de início do aplicativo ) e dados para solicitações de rede HTTP/S .

Use o Swift Package Manager para instalar e gerenciar as dependências do Firebase.

  1. No Xcode, com seu projeto de aplicativo aberto, navegue até File > Add Packages .
  2. Quando solicitado, adicione o repositório do SDK das plataformas Firebase Apple:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Escolha a biblioteca de Monitoramento de Desempenho.
  5. Quando terminar, o Xcode começará automaticamente a resolver e baixar suas dependências em segundo plano.

Em seguida, configure o módulo Firebase:

  1. Importe o módulo FirebaseCore em seu UIApplicationDelegate , bem como qualquer outro módulo Firebase usado pelo delegado do aplicativo. Por exemplo, para usar o Cloud Firestore e a autenticação:

    Rápido

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objetivo-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Configure uma instância compartilhada do FirebaseApp no ​​método application(_:didFinishLaunchingWithOptions:) do representante do seu aplicativo:

    Rápido

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

    Objetivo-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  1. Recompile seu aplicativo.

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

O Firebase começa a processar os eventos quando você adiciona o SDK ao seu aplicativo. Se você ainda estiver desenvolvendo localmente, interaja com seu aplicativo para gerar eventos para coleta e processamento de dados iniciais.

  1. Continue desenvolvendo seu aplicativo usando um simulador ou dispositivo de teste.

  2. Gere eventos alternando seu aplicativo entre segundo plano e primeiro plano várias vezes, interagindo com seu aplicativo navegando pelas telas e/ou acionando solicitações de rede.

  3. Acesse o painel Desempenho do console do Firebase. Você deverá ver sua exibição de dados inicial em alguns minutos.

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

Etapa 3 : (opcional) visualizar mensagens de log para eventos de desempenho

  1. Ative o registro de depuração, da seguinte maneira:

    1. No Xcode (mínimo v13.3.1), selecione Produto > Esquema > Editar esquema .
    2. Selecione Executar no menu esquerdo e selecione a guia Argumentos .
    3. Na seção Argumentos passados ​​na inicialização , adicione -FIRDebugEnabled .
  2. Verifique suas mensagens de log para quaisquer mensagens de erro.

  3. O Monitoramento de desempenho marca suas mensagens de registro com Firebase/Performance para que você possa filtrar suas mensagens de registro.

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

    • Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL
  5. Clique no URL para visualizar seus dados no console do Firebase. Pode levar alguns instantes para que os dados sejam atualizados no painel.

Se seu aplicativo não estiver registrando eventos de desempenho, consulte as dicas de solução de problemas .

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

Para monitorar dados de desempenho associados a um código específico em seu aplicativo, você pode instrumentar rastreamentos de código personalizados .

Com um rastreamento de código personalizado, você pode medir quanto tempo seu aplicativo 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 para um rastreamento de código personalizado é sua duração, mas você também pode adicionar métricas personalizadas, como acertos de cache e avisos de memória.

Em seu código, você define o início e o fim de um rastreamento de código personalizado (e adiciona as métricas personalizadas desejadas) usando a API fornecida pelo SDK do Monitoramento de desempenho.

Visite Adicionar monitoramento para código específico para saber mais sobre esses recursos e como adicioná-los ao seu aplicativo.

Etapa 5 : implante seu aplicativo e analise os resultados

Depois de validar o Monitoramento de desempenho usando o simulador Xcode e um ou mais dispositivos de teste, você pode implantar a versão atualizada do seu aplicativo para seus 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 aplicativos que usam GTMSQLite.
  • A alternância de métodos após chamar FirebaseApp.configure() pode interferir no SDK do Monitoramento de desempenho.
  • Problemas conhecidos com o Simulador do iOS 8.0-8.2 impedem que o Monitoramento de Desempenho capture eventos de desempenho. Esses problemas foram corrigidos no iOS 8.3 Simulator e versões posteriores.
  • As conexões estabelecidas usando backgroundSessionConfiguration de NSURLSession exibirão tempos de conexão mais longos do que o esperado. Essas conexões são executadas fora do processo e os tempos refletem eventos de retorno de chamada em processo.

Próximos passos