

Get started with Firebase Crashlytics



Before you begin

  1. If you haven't already, add Firebase to your iOS project. If you don't have an iOS app, you can download a sample app.




Step 1: Enable Crashlytics in the Firebase console

  1. Go to the Crashlytics dashboard in the Firebase console.

  2. Make sure your app is selected from the dropdown next to Crashlytics at the top of the page.

  3. Click Enable Crashlytics.

Step 2: Add the Firebase Crashlytics SDK to your app

  1. Open the podfile you created for your Firebase project and add the FirebaseCrashlytics pod.

    For an optimal experience with Crashlytics, we recommend enabling Google Analytics in your Firebase project and adding the Firebase pod for Google Analytics to your app.

    pod 'Firebase/Crashlytics'
    # Recommended: Add the Firebase pod for Google Analytics
    pod 'Firebase/Analytics'
  2. Install the pods, then re-open your .xcworkspace file to see the project in Xcode:

    pod install
    open your-project.xcworkspace
  3. Import the Firebase module in your UIApplicationDelegate:


    import Firebase


    @import Firebase;


    // Use the Firebase library to configure APIs.


    // Use the Firebase library to configure APIs.
    [FIRApp configure];

Step 3: Set up Xcode to automatically upload dSYM files





    1. Click All, then search for debug information format.



    1. Click > New Run Script Phase.


    2. Expand the new Run Script section.



    4. In the Input Files section, add the paths for the following files.

      • Add the path to your project's dSYM files

        This enables Crashlytics to process dSYMs for large apps more quickly.

      • Add the path to your project's built Info.plist file

        This enables Crashlytics to associate an app version with the dSYMs.



Step 4: Force a test crash to finish setup


And that's it! Crashlytics is now monitoring your app for crashes, and you can view and investigate crash reports and statistics in the Crashlytics dashboard.

Next steps