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
• Prerequisites
• Integrate Firebase and add a project on App Live
• View projects
• Share projects
• Synchronize or unsynchronize projects
• Launch a session with a Firebase app
• Other actions such as adding more projects, refreshing, and deleting projects

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. Alternatively, go to the Integrations page. Scroll down to the Firebase tile and click 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:
   • 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.
     
     App Live automatically reads the project ID, client ID, and secret key from the config file. Next, click 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.
     
4. On the Google OAuth page, select the account you want to log in with.
   BrowserStack requests for certain permissions.
5. Click Allow to provide the necessary 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.

View projects

After you add the project, the project is listed on the Select Source panel of the App Live 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.

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.
   On the confirmation message that is shown, click Share.
   

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.
   The synchronization process starts.
   
   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.
   
   The sync button changes to unsync. You can unsync the app release to delete it from the BrowserStack Cloud.
   

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.
   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.
   The Integrate with Firebase prompt opens.
   
   
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.
   

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.

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.
   

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

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.