Neste guia de início rápido, vamos mostrar como configurar o Firebase Crashlytics no seu app com o SDK do Firebase Crashlytics para receber relatórios de erros abrangentes no console do Firebase.
A configuração do Crashlytics exige tarefas no console do Firebase e no ambiente de desenvolvimento integrado, como adicionar um arquivo de configuração do Firebase e o SDK do Crashlytics. Para concluir a configuração, você terá que forçar uma falha de teste para enviar seu primeiro relatório de erros ao Firebase.
Antes de começar
Adicione o Firebase ao seu projeto da Apple caso ainda não tenha feito isso. Caso você não tenha um app da Apple, faça o download de um app de exemplo.
Recomendado: para gerar automaticamente registros de navegação estrutural e entender as ações do usuário que levam a uma falha, um evento não fatal ou um ANR, você precisa para ativar o Google Analytics no seu projeto do Firebase.
Se o Google Analytics não estiver ativado no seu projeto do Firebase, ative o Google Analytics na guia Integrações das suas
no console do > Configurações do projetoFirebase. Se você estiver criando um novo projeto do Firebase, ative o Google Analytics durante a criação.
Etapa 1: adicionar o SDK do Crashlytics ao seu app
Use o Gerenciador de pacotes do Swift para instalar e gerenciar as dependências do Firebase.
- No Xcode, com seu projeto do app aberto, navegue até File > Add Packages.
- Quando solicitado, adicione o repositório do SDK do Firebase para as plataformas Apple:
- Escolha a biblioteca do Crashlytics.
- Para aproveitar os registros de navegação estrutural, adicione também o SDK do Firebase para Google Analytics ao seu app. Verifique se o Google Analytics está ativado no seu projeto do Firebase.
- Adicione a flag
-ObjC
à seção Outras flag do vinculador das configurações de build do destino. - (Apenas macOS) Em
Info.plist
, adicione a chaveNSApplicationCrashOnExceptions
e a defina comoYES
. - Quando terminar, o Xcode vai começar a resolver e fazer o download das dependências em segundo plano automaticamente.
https://github.com/firebase/firebase-ios-sdk.git
Em seguida, configure o módulo do Firebase:
Importe o módulo do Firebase no struct
App
ou emUIApplicationDelegate
:Swift
import Firebase
Objective-C
@import Firebase;
Configure uma instância compartilhada
FirebaseApp
, normalmente no métodoapplication(_:didFinishLaunchingWithOptions:)
do delegado do seu app:Swift
// Use the Firebase library to configure APIs. FirebaseApp.configure()
Objective-C
// Use the Firebase library to configure APIs. [FIRApp configure];
Etapa 3: forçar uma falha de teste para concluir a configuração
Para concluir a configuração do Crashlytics e conferir os dados iniciais no painel do Crashlytics no console do Firebase, é necessário forçar uma falha de teste.
Pronto. O Crashlytics está monitorando seu app em busca de falhas. Acesse o painel do Crashlytics para ver e analisar todos os relatórios e estatísticas.
Próximas etapas
- Para personalizar a configuração do relatório de erros, adicione a permissão de geração de relatórios, registros, chaves e rastreamento de erros não fatais.
- Faça a integração com o Google Play para filtrar os relatórios de erros do app Android pela faixa do Google Play diretamente no painel do Crashlytics. Isso permite que você configure o painel para monitorar builds específicos.