Skip to main content

Integrate Firebase with App Live

Firebase is an app development, testing and distribution platform. The App Distribution feature of Firebase enables you to distribute your apps with your testers for testing.

You can integrate Firebase App Distribution with App Live to test your apps on App Live. After you integrate Firebase with App Live, you can add your Firebase projects in App Live and share them with your team members. Your team can then test your apps in the shared project on App Live.

In this page, we will see:

Supported app formats

The following app formats are supported:

  • Android: .apk
  • iOS: .ipa

Prerequisites

Before you begin, complete the following on Firebase:

  • (Recommended) Create a separate project for the apps that you want to test on App Live and add the apps.
  • Ensure that you have at least Viewer access to the project that you want to integrate.
  • Set up OAuth for your project. To do that, on Google Cloud Console, create credentials for OAuth Client ID. For Application type, select Web Application and add this authorized redirect URI: https://app-live.browserstack.com/firebase/oauth.
    For detailed steps, see Setting up OAuth 2.0. To read more about Google OAuth, see Google’s documentation.
  • Download the OAuth client config JSON file or keep the project ID, client ID, and client secret key handy.

Integrate Firebase and add a project on App Live

To integrate Firebase and add a project on App Live, follow these steps:

  1. Log in to the App Live dashboard.
  2. On the Select Source panel, click Integrate with Firebase. Interage with Firebase Alternatively, go to the Integrations page. Scroll down to the Firebase tile and click Connect.
    Integration page connect
  3. On the Integrate with Firebase prompt, you can use one of the two authentication options to add the authentication details for your project: Interage with Firebase prompt
    • Upload a config file: Use this option to configure authentication using the project config file.
      Click Upload a config file. Browse to the location where the config file is stored. Select the file and click Open.
      Upload config file
      App Live automatically reads the project ID, client ID, and secret key from the config file. Next, click Sign in with Google.
      Sign in with Google
    • Connect with credentials: Use this option to manually enter the project authentication credentials (project ID, client ID, and secret key). Next, click Sign in with Google.
      You are redirected to Google’s OAuth page.
      Interage with Firebase prompt
  4. On the Google OAuth page, select the account you want to log in with. Choose Google account
    BrowserStack requests for certain permissions.
  5. Click Allow to provide the necessary permissions.

App Live only makes read requests to Firebase to get these project details from Firebase: name of the project that you added, name of the apps within the project, and app releases.

Allow permissions

You are successfully authenticated and redirected to the App Live dashboard. A prompt opens confirming that the project is added on App Live. You can click Share Now to share your project with your team members on App Live.
share now

View projects

After you add the project, the project is listed on the Select Source panel of the App Live dashboard.

Project dashboard

App Live follows the project structure hierarchy similar to Firebase, which is project > apps > releases, as explained here:

  1. Project list: This drop-down is the project list. It includes the projects added by you and the projects shared with you by your team members.
  2. App list: This drop-down is the list of apps in the project.
  3. Releases list: This list includes the app releases.

Share projects with your team

After you add a project, a prompt is shown to share your project with your team. Click Share now to share the project with your team on App Live. After you share the project, the project starts appearing on your team member’s App Live dashboard.

You can only share a project that is added by you.

Alternatively, to share your Firebase project with your team from the project list, follow these steps on the App Live dashboard:

  1. From the Firebase project drop-down, select the project that you want to share with your team.
  2. Click the three-dot menu beside the project name and click Share. Share project
    On the confirmation message that is shown, click Share. Share project

The project is shared with your team members on App Live.

Synchronize or unsynchronize app release

Synchronizing your app releases ensure that the app releases on BrowserStack Cloud and on Firebase are in sync. You can synchronize your app release for the following purposes:

  • Uploading your app release on BrowserStack Cloud before hand.
  • Keeping the app release in BrowserStack Cloud in sync with the app release in Firebase.
  • Enabling App Configurations such as Large App Support, Video Injection, and more.

You can unsync an app release to delete it from the BrowserStack Cloud. After you unsync the app release, it will no longer be available on BrowserStack Cloud and cannot be tested on App Live. Also, you cannot apply app configurations to the app release.

To sync or unsync app release:

  1. From the project list, select your project.
  2. From the app list, select the app.
  3. Click the sync icon beside the app release. Share project
    The synchronization process starts.
    Share project
    After you synchronize the app release, the app configurations are enabled that you can apply to the release. These configurations are persisted for your subsequent sessions as well.
    Unsync app release
    The sync button changes to unsync. You can unsync the app release to delete it from the BrowserStack Cloud. Unsync app release

Launch a session with a Firebase app

To launch a session with a Firebase app, on the App Live dashboard:

  1. From the project list, select the project that includes the app you want to test.
  2. From the app list, select the app that you want to test.
  3. Select the device from the device list. Unsync app release
    After you select the device and app, the app is synchronized automatically so that it is the latest. An App Live session is started with your selected app and device.

Other actions

You can perform other actions such as adding more projects, refreshing an existing project, and deleting a project.

Add more projects

To add more projects, follow these steps on the App Live dashboard:

  1. Click the + icon beside the project list. Add project
    The Integrate with Firebase prompt opens.
    Integrate with Firebase prompt another
  2. Follow the steps in Integrate with Firebase and add a project section.

Refresh project

Use this option to refresh the project. This will fetch the latest apps and releases from Firebase.

To refresh a Firebase project:

  1. From the project list, select the project that you want to share with your team.
  2. Click the three-dot menu beside the project name and click Refresh. Refresh project

Delete project

You can delete a project that is added by you on App Live. The project is also deleted for everyone with whom the project is shared on App Live.

The project is deleted from the App Live project list. Deleting your project from App Live doesn’t have any impact on the project in Firebase.

To delete a Firebase project:

  1. From the project list, select the project that you want to delete.
  2. Click the three-dot menu beside the project name and click Delete. Delete project

    A confirmation message is shown to confirm whether you want to delete the project from App Live. Click Delete to confirm.
    Confirm deletion

To delete all projects added by you at once, follow these steps:

  1. Go to the Integrations page.
  2. Scroll down to the Firebase tile. Click Disconnect. After you click Disconnect, all the projects added by you are deleted. However, the projects that are shared with you by your team members are not deleted. Integrations page delete

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked






Thank you for your valuable feedback

Is this page helping you?

Yes
No

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked






Thank you for your valuable feedback!

Talk to an Expert
Download Copy