In order to use services from Firebase like Cloud Messaging, In-App Messaging, Analytics or Crashlytics you need to connect your Purple DS iOS app with the Firebase Console.

Please follow our step-by-step guide to get connected quickly!

Step-by-step guide

Assets (Developer Account)

In order to connect your iOS App to Firebase you need the following assets from the Apple Developer account:

01. A working P12 Distribution certificate

02. A working Mobile Provisioning profile

03. An Apple Authentication Key with Push enabled

04. A working Key-ID

05. Team -ID

Assets (App Store Connect)

From the App Store Connect you will need the following information:

01. App-Store ID

Setting up a Firebase Project

In order to quickly setup a Firebase project please follow these steps. If you already have a Firebase project you can continue to the iOS app integration chapter.

01. Set a name for your project

02. Set up Analytics (or skip if you want to add it later)

02a. Select Google Analytics account

03. That's it

Add Firebase to your iOS app

To connect your Firebase project to your iOS app the following steps need to be done:

01. Click on the gear icon and open Project settings

02. On the Your apps tab click on the iOS icon

03. Fill inn your iOS bundle ID (The Package name in Purple DS) and optional your App nickname and App store id.

04. Please ignore the following steps by clicking "Next/Skip this step" until the project is created

05. Now please click on the Cloud messaging tab

06. Please Upload your Apple Key and provide the Key ID and Team ID

07. Once you have finished adding the Key you can download the GoogleService-info.plist on the general settings page

Enabling Firebase in Purple

After you have successfully finished creating your project and all necessary assets we are now switching to the Purple DS Manager where the following steps need to be done: 

01. Got to the Push/Analytics section within the Manager

02. Activate all Firebase checkboxes and upload the GoogleService-info.plist

03. Activate Manager Push and Push registration al little further down (this is important for Cloud messaging to work)

04. As last step please save the P12 distribution certificate, it's password and the Provisioning profile in the Build settings of your app

05. Build a release App and upload it to the appstore

With the use of Testflight you can try out the results and benefits of Firebase Cloud messaging.