Confira tudo que foi anunciado no Firebase Summit e veja como usar o Firebase para acelerar o desenvolvimento de apps e executar os aplicativos com confiança. Saiba mais

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 Apple .

Etapa 1 : adicionar 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 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 Firebase Apple Platform SDK:
  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 quaisquer outros módulos Firebase usados ​​pelo delegado do aplicativo. Por exemplo, para usar Cloud Firestore e autenticação:

    SwiftUI

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Rápido

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objective-C

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

    SwiftUI

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

    Rápido

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

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. Se você estiver usando SwiftUI, deverá criar um delegado de aplicativo e anexá-lo à sua estrutura de App por meio de UIApplicationDelegateAdaptor ou NSApplicationDelegateAdaptor . Você também deve desativar o swizzling de delegado de aplicativo. Para obter mais informações, consulte as instruções do SwiftUI .

    SwiftUI

    @main
    struct YourApp: App {
      // register app delegate for Firebase setup
      @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
    
      var body: some Scene {
        WindowGroup {
          NavigationView {
            ContentView()
          }
        }
      }
    }
          
  4. 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 inicial de dados.

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

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

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

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

Etapa 3 : (Opcional) Exibir mensagens de log para eventos de desempenho

  1. Habilite o log de depuração, da seguinte maneira:

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

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

  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, revise 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 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 quaisquer métricas personalizadas desejadas) usando a API fornecida pelo SDK de 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 de seu aplicativo para seus usuários.

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

Problemas conhecidos

  • Monitoramento de desempenho tem problemas de compatibilidade conhecidos com GTMSQLite. Recomendamos não usar o Monitoramento de desempenho com aplicativos que usam GTMSQLite.
  • A oscilação do método após a chamada de FirebaseApp.configure() pode interferir no SDK de monitoramento de desempenho.
  • Problemas conhecidos com o Simulador iOS 8.0-8.2 impedem que o Monitoramento de Desempenho capture eventos de desempenho. Esses problemas foram corrigidos no Simulador iOS 8.3 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 no processo.

Próximos passos