Migration steps after linking from Fabric

Welcome to Firebase!

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

What happened when you migrated?

For the apps that you linked, your Crashlytics data now appears in both your Fabric dashboard and the Firebase Crashlytics dashboard. The linking process does not involve any changes to the legacy Fabric SDK. After you link your app, you can choose to continue setting up Crashlytics with the Fabric SDK or to upgrade to the Firebase Crashlytics SDK in beta for iOS or Android, which requires making updates to your code.

If you want to continue using the Fabric SDK, you have no further required steps to complete. Keep in mind the following:

  • The Fabric SDK hasn't changed, so you don't need to make changes to your code.

  • Don't remove or change your Fabric API key.

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

Firebase Crashlytics offers several new features:

How Google Analytics helps Crashlytics

Google Analytics is Firebase's analytics engine that gives you access to powerful insights into your data. Google Analytics lets you set custom and predefined events, similar to Fabric's Answers. When you start using Analytics, you unlock new capabilities in addition to features you were already using in Fabric:

How do I start using Analytics?

Visit the Start using Google Analytics help page to learn how to install and initialize the SDK in your iOS or Android app. After you add Analytics to your app, visit the Google Analytics documentation to start setting up events.

If you have a Unity app, read about getting started with Analytics and logging events in Unity instead.

Keep the following in mind:

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

  • Firebase can only use analytics data collected by Google Analytics. So, for your migrated apps, your historical analytics data from Fabric Answers cannot migrate to Firebase. If you previously used Fabric Answers in your app, visit the Fabric documentation to learn how to export your Answers data for specific charts.

    • 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 SDK.

    • After you switch your Answers events to Google Analytics events, we recommend removing your Answers events from your app's code and disabling Answers reporting in your Fabric dashboard.

Monitor your Latest Release

With Google Analytics 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:

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.

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:

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

You can choose to continue using the legacy Fabric SDK or to upgrade to the Firebase Crashlytics SDK in beta, which allows you to integrate your crash data with Google Analytics. To access features in Firebase Crashlytics like crash-free users, the Latest Release dashboard, and event tracking, add Google Analytics to your app.

If you keep the Fabric SDK, you don't need to make any changes to your code.

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

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

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

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

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

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

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

  2. Check your Firebase Crashlytics dashboard for your metrics.

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

After working to bring Fabric Beta into Firebase, we now offer you a new product called Firebase App Distribution. Start using App Distribution right away by importing your testers from Fabric Beta. Or, if you haven't used Fabric Beta, learn how to start distributing builds for your specific platform.

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.

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:

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 support@fabric.io with migration questions or feedback.

Next steps