Migration steps after linking from Fabric

Welcome to Firebase!

Now that you've migrated your app to Firebase, there are a couple things you'll want to learn about and set up for Firebase:

• Discover new features from Firebase Crashlytics.

• Install and initialize Google Analytics for Firebase in your app to unlock its valuable capabilities and access features that you had in Fabric, such as crash-free users.

• Configure your notification settings for both Firebase and Fabric.

• Invite your team so that they can start using Firebase and access your migrated app in the Firebase console.

• Check out some frequently asked questions.

What happened when you migrated?

For the apps that you linked, your Crashlytics data now appears in the Firebase Crashlytics dashboard (in the Firebase console). The linking process does not involve any changes to the Crashlytics SDK or your Fabric API key.

Note that in the coming months, we'll release Firebase-specific Crashlytics SDKs for iOS and for Android, as well as offer further upgrade instructions. So, for now, if you migrated an iOS and Android app:

• Do not change how you use the Crashlytics SDK because the iOS and Android SDKs haven't changed.

• Do not change or remove your Fabric API key.

Note: For migrating Unity apps to Firebase, follow the Unity migration instructions and review the Unity API changes.

Discover Firebase Crashlytics

Find all your Crashlytics data in the Firebase Crashlytics dashboard (in the Firebase console).

Important: To view crash-free users metrics, you need Google Analytics for Firebase in your app.

Firebase Crashlytics offers several new features:

• Customize your velocity alerts.

• Use Google Analytics breadcrumbs (requires Google Analytics for Firebase).

• Export your Crashlytics data to BigQuery, then analyze it using BigQuery and the Crashlytics Data Studio template.

• New integrations, including a Jira integration that enables you to link Crashlytics issues with Jira issues from the Firebase console.

Start using Google Analytics for Firebase

Google Analytics is Firebase's analytics engine and gives you access to powerful insights into your data.

Install the Google Analytics for Firebase SDK

Visit the Google Analytics for Firebase documentation to learn how to install and initialize the SDK in your iOS, Android, or Unity app.

Note: After you initialize the Google Analytics for Firebase SDK in your app, there can be a delay of a few hours before data appears in the Firebase Crashlytics dashboard.

How Google Analytics for Firebase helps Crashlytics

Google Analytics for Firebase unlocks valuable capabilities and features that you were already using in Fabric:

• Monitor your Latest Release status.

• Use Google Analytics for Firebase events like you used Fabric's Answers.

• Track your app's crash-free users metrics in the Firebase Crashlytics dashboard.

• Set custom alerts for your app's stability with velocity alerts.

Note: Firebase can only use analytics data collected by Google Analytics for Firebase. So, for your migrated apps, your historical analytics data (from Fabric Answers) cannot migrate to Firebase. This means that, unlike your crash data, your analytics data will start from a blank slate and the Firebase console will only show data collected after installing and initializing the Google Analytics for Firebase SDK.

Monitor your Latest Release

With Google Analytics for Firebase initialized in your app, you can monitor the stability and metrics of your current builds in the Latest Release page in the Firebase console.

Access the Latest Release page a couple different ways:

• In your Firebase Crashlytics dashboard, click the link in the Event trends card.

• In the Firebase console, go to the Analytics section in the left navigation pane, then click Latest Release.

Use Events rather than Answers

Google Analytics for Firebase lets you set custom and predefined events, similar to Fabric's Answers.

• To learn how to set up events using Firebase, visit the Google Analytics for Firebase documentation for your platform (iOS, Android, or Unity).

• To learn how to convert your existing Answers events to Google Analytics for Firebase events, visit the Fabric Analytics page.

Important: After you instrument Google Analytics events, we recommend removing Answers events from your app's code.

Configure your notification settings

Now that you've migrated to Firebase, you will start getting emails from both Firebase and Fabric.

You can configure your notifications settings:

• For Firebase — Configure your Firebase notifications and integrations in the Firebase console:

  • For notifications, manage your Firebase alert subscriptions for Crashlytics via Alerts > Alert Settings
    (click the bell icon in the top-right corner of the Firebase console).

  • For integrations, visit Project settings > Integrations to set up notifications for Jira, Slack, and PagerDuty.

• For Fabric — Configure your Fabric notifications in Fabric's settings page:

  • Modify the settings for your Fabric notifications so that you're not receiving duplicate emails from both Firebase and Fabric.

Invite your team members

Now that you've migrated to Firebase, invite your team so that they can start using Firebase and access your migrated app in the Firebase console.

• From the Firebase console — Visit Project settings > Users & permissions to add teammates as members of your Firebase project.

• From the Fabric site — Visit the invite page in the Fabric migration dashboard to invite your teammates to your migrated apps. With just one click, you can add all teammates associated with your app to your Firebase project.

  Note: Using the one-click invite button on Fabric's migration dashboard assigns the Editor role to all invited members.

Frequently asked questions

I linked my app. Now what should I do?

Now that you've migrated your app to Firebase, look through this page for a couple things that you'll want to learn about and set up for Firebase:

• Discover new features from Firebase Crashlytics.

• Install and initialize the Google Analytics for Firebase SDK in your app to unlock its valuable capabilities and access features that you had in Fabric, such as crash-free users.

• Configure your notification settings for both Firebase and Fabric.

• Invite your team members so that they can start using Firebase and access your migrated app in the Firebase console.

What SDK changes do I need to make in my migrated app?

For now, continue using the Crashlytics SDK and Fabric API keys in your app. In the coming months, we'll release Firebase-specific Crashlytics SDKs for iOS and for Android, as well as offer further upgrade instructions.

Note: For migrating Unity apps to Firebase, follow the Unity migration instructions and review the Unity API changes.

To access features in Firebase Crashlytics like crash-free users, the Latest Release dashboard, and event tracking, you need Google Analytics for Firebase in your app.

How can I see my app's Latest Release status?

To view the Latest Release page, you need Google Analytics for Firebase in your app.

1. Install and initialize the Google Analytics for Firebase SDK in your app.

2. Access the Latest Release page a couple different ways:

   • In your Firebase Crashlytics dashboard, click the link in the Event trends card.

   • In the Firebase console, go to the Analytics section in the left navigation pane, then click Latest Release.

Why aren't my crash-free users showing up?

To view crash-free users metrics, you need Google Analytics for Firebase in your app.

1. Install and initialize the Google Analytics for Firebase SDK in your app.

2. Check your Firebase Crashlytics dashboard for your metrics.

   Note: After you initialize the Google Analytics for Firebase SDK in your app, there can be a delay of a few hours before data appears in the Firebase Crashlytics dashboard.

Crashlytics Beta isn't in Firebase, but I linked my Fabric app. What should I do?

Firebase is working to bring Crashlytics Beta into Firebase with a new product called App Distribution. If you're interested in taking an early look and giving feedback on App Distribution, you can sign-up to request access.

In the meantime, you can use Crashlytics via the Firebase console and continue using Crashlytics Beta via the Fabric dashboard.

How should I organize my different apps in my Firebase projects?

In Firebase, ensure that all apps within a project are platform variants of the same application from an end-user perspective. It's advisable to connect the Android and iOS versions of the same app or game to the same Firebase project. All the apps in a project generally share the same Firebase resources (database, storage buckets, etc.).

• Visit Understand Firebase projects to learn more about best practices and considerations for adding apps to a Firebase project.

• Visit Fabric's Organizing Projects page (iOS or Android) to learn about transitioning your migrated apps from Fabric organizations to Firebase projects.

How do I unlink a Firebase app from a Fabric app if I made a mistake?

Note that to unlink a Firebase app, you need to be an Owner for the Firebase project.

1. Visit Project settings > Integrations.

2. On the Fabric card, click Manage.

3. Click Unlink, then confirm the unlinking.

After you unlink your Firebase app, you can always relink it via the Fabric migration dashboard.

I deleted my Firebase project with linked Fabric apps, how do I unlink those apps now?

Note that to restore a Firebase project or unlink a Firebase app, you need to be an Owner for the Firebase project.

1. Restore your Firebase project using the Google Cloud console.

   Visit Understand Firebase projects to learn more about the relationship between Firebase projects and Google Cloud projects (and the Google Cloud console).

2. Follow the unlinking steps described on this page.

Where can I learn more about Fabric's overall plans?

Stay up to date with the latest news:

• Check our public roadmap.

• Follow us on Twitter.

I can't find the answer to my question here and need more help!

We're here to help make sure your migration to Firebase goes smoothly. Reach out to [e-mail] with migration questions or feedback.

Next steps

• Monitor your team's progress for migrating from Fabric to Firebase in Fabric's migration dashboard.

• Continue to migrate your apps and invite your teammates to Firebase.

• Stay up to date with Fabric migration timelines and news:

  • Check our public roadmap.

  • Follow us on Twitter.

• Reach out to [e-mail] with any migration questions or feedback.