Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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
settings > Configurações do projeto
no console do Firebase.
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:
Adicione a flag -ObjC à seção Outras flag do vinculador das configurações de build do destino.
(Apenas macOS) Em Info.plist, adicione a chave
NSApplicationCrashOnExceptions e a defina como
YES.
Quando terminar, o Xcode vai começar a resolver e fazer o download das
dependências em segundo plano automaticamente.
Em seguida, configure o módulo do Firebase:
Importe o módulo do Firebase no struct App ou em UIApplicationDelegate:
Swift
importFirebase
Objective-C
@importFirebase;
Configure uma instância compartilhada FirebaseApp, normalmente no método application(_: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.[FIRAppconfigure];
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.
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.
[null,null,["Última atualização 2025-08-12 UTC."],[],[],null,["\u003cbr /\u003e\n\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\niOS+ Android Android (NDK) Flutter Unity \n\n\u003cbr /\u003e\n\nThis quickstart describes how to set up Firebase Crashlytics in your app\nwith the Firebase Crashlytics SDK so that you can get comprehensive crash\nreports in the Firebase console.\n\nSetting up Crashlytics requires tasks both in the Firebase console and\nyour IDE (like adding a Firebase configuration file and the Crashlytics\nSDK). To finish setup, you'll need to force a test crash to send your first\ncrash report to Firebase.\n\nBefore you begin\n\n1. If you haven't already, [add Firebase](/docs/ios/setup) to your Apple\n project. If you don't have an Apple app, you can download a\n [sample app](/docs/samples).\n\n2. **Recommended** : To automatically get\n [breadcrumb logs](/docs/crashlytics/customize-crash-reports#get-breadcrumb-logs)\n to understand user actions leading up to a crash, non-fatal, or ANR event,\n you need to enable Google Analytics in your Firebase project.\n\n - If your existing Firebase project doesn't have Google Analytics\n enabled, you can enable Google Analytics from the\n [**Integrations** tab](https://console.firebase.google.com/project/_/settings/integrations/analytics) of your\n settings \\\u003e *Project settings*\n in the Firebase console.\n\n - If you're creating a new Firebase project, enable Google Analytics\n during the project creation workflow.\n\n \u003cbr /\u003e\n\n**Step 1** : Add the Crashlytics SDK to your app\n\nUse Swift Package Manager to install and manage Firebase dependencies.\n| Visit [our installation guide](/docs/ios/installation-methods) to learn about the different ways you can add Firebase SDKs to your Apple project, including importing frameworks directly and using CocoaPods.\n\n1. In Xcode, with your app project open, navigate to **File \\\u003e Add Packages**.\n2. When prompted, add the Firebase Apple platforms SDK repository: \n\n```text\n https://github.com/firebase/firebase-ios-sdk.git\n```\n| **Note:** New projects should use the default (latest) SDK version, but you can choose an older version if needed.\n3. Choose the Crashlytics library.\n4. To take advantage of [breadcrumb logs](/docs/crashlytics/customize-crash-reports#get-breadcrumb-logs), also add the Firebase SDK for Google Analytics to your app. Make sure that [Google Analytics is enabled](https://support.google.com/firebase/answer/9289399#linkga) in your Firebase project.\n5. Add the `-ObjC` flag to the *Other Linker Flags* section of your target's build settings.\n6. *(macOS only)* In your `Info.plist`, add the key `NSApplicationCrashOnExceptions` and set it to `YES`.\n7. When finished, Xcode will automatically begin resolving and downloading your dependencies in the background.\n\nNext, configure the Firebase module:\n\n1. Import the Firebase module in your `App` struct or `UIApplicationDelegate`:\n\n Swift \n\n ```swift\n import Firebase\n ```\n\n Objective-C \n\n ```objective-c\n @import Firebase;\n ```\n2. Configure a `FirebaseApp` shared instance, typically in your app delegate's\n `application(_:didFinishLaunchingWithOptions:)` method:\n\n Swift \n\n ```swift\n // Use the Firebase library to configure APIs.\n FirebaseApp.configure()\n ```\n\n Objective-C \n\n ```objective-c\n // Use the Firebase library to configure APIs.\n [FIRApp configure];\n ```\n\n**Step 3**: Force a test crash to finish setup\n\nTo finish setting up Crashlytics and see initial data in the\nCrashlytics dashboard of the Firebase console, you need to force a test\ncrash.\n\n\u003cbr /\u003e\n\nAnd that's it! Crashlytics is now monitoring your app for crashes.\nVisit the [Crashlytics dashboard](https://console.firebase.google.com/project/_/crashlytics) to view and investigate\nall your reports and statistics.\n\nNext steps\n\n- [Customize your crash report setup](/docs/crashlytics/customize-crash-reports) by adding opt-in reporting, logs, keys, and tracking of non-fatal errors.\n\n\u003c!-- --\u003e\n\n- [Integrate with Google Play](/docs/crashlytics/integrate-with-google-play) so that you can filter your Android app's crash reports by Google Play track directly in the Crashlytics dashboard. This allows you to better focus your dashboard on specific builds."]]
