Skip to content

Enabling Firebase Service (Push Notification and Analytics)

Enable Firebase Service on Android

You will need google-services.json for the Firebase Cloud Messaging (FCM) configuration on Android. Please follow the steps to set up notification on Android.

Steps

  1. Create an Android application on FCM console.

  2. Fill in the information of your Android app.

  3. Download google-services.json.

  4. Click "Next" to skip the steps for native Android app below.

    • Move google-service.json to Android app module root directory
    • Add Firebase SDK
  5. Stay at the 4th step on the FCM Setting page.

    Note

    This step is to verify whether your application registered FCM from the client app or not. You will need to build an app to verify it.

  6. Copy google-services.json file to the root folder.

  7. Open package.json file and add the following packages:

    • Under dependencies section, add "@awesome-cordova-plugins/firebase-x": "^5.44.0"
    • Under devDependencies section, add "cordova-plugin-firebasex": "14.2.1"

    • Find cordova > plugins section, add

      "cordova-plugin-firebasex": {
          "IOS_STRIP_DEBUG": "true",
          "FIREBASE_ANALYTICS_COLLECTION_ENABLED": "true",
          "FIREBASE_PERFORMANCE_COLLECTION_ENABLED": "true",
          "FIREBASE_CRASHLYTICS_COLLECTION_ENABLED": "true",
          "FIREBASE_FCM_AUTOINIT_ENABLED": "true",
          "IOS_USE_PRECOMPILED_FIRESTORE_POD": "false"
        },
      

    Note

    1. If you can't pass the installation verification, please see the readme of the plugin we use to find out for more information.
    2. After your App is built, please check for the installation verification status shown on FCM setting page.

Enable Firebase Service on iOS

You will need .p8 APNs key for the FCM authorization and GoogleService-Info.plist for the FCM configuration to set up notification on iOS.

Generate .p8 File of APNs Key

Please follow the "Create the authentication key" section of the FCM instruction to generate a .p8 key file containing your APNs Auth Key.

Set Up APNs Key on FCM Console

You need to add an Apple Push Notifications service (APNs) key in Apple Developer in advance. Go to Apple Developer → Certificates, Identifiers & Profiles → Keys, and add a key as showed below:

After you get the APNs' key ID, please also have your Apple team ID at hand and follow the steps to set up APNs key on the FCM console.

Steps

  1. Go to FCM project settings.

  2. Go to Cloud Messaging tab.

  3. Go to iOS app configuration section and click Upload under the APNs Authorization Key section.

  4. Choose the .p8 file and input APNs key ID, Apple team ID. Click Upload to complete the setting.

Set Up Notification on iOS

Follow these steps to prepare GoogleService-Info.plist for the FCM configuration on iOS.

Steps

  1. Create an iOS application on FCM console.

  2. Fill in the information of your iOS app.

  3. Download GoogleService-Info.plist.

  4. Click "Next" to skip the steps for native iOS app below.

    • Move GoogleService-Info.plist to Xcode project.
  5. Install CocoaPods and run pod setup to initialize it. You can skip the steps in the setting page.

  6. Click "Next" to skip the steps for native iOS app below.

    • Add initialization code
  7. Stay at the 5th step on the FCM Setting page.

    Note

    This step is to verify whether your application registered FCM from the client app or not. You will need to build an app to verify it.

  8. Copy GoogleService-Info.plist to the root folder.

  9. Open package.json file and add the following packages:

    • Under dependencies section, add "@awesome-cordova-plugins/firebase-x": "^5.44.0"
    • Under devDependencies section, add "cordova-plugin-firebasex": "14.2.1"

    • Find cordova > plugins section, add

      "cordova-plugin-firebasex": {
          "IOS_STRIP_DEBUG": "true",
          "FIREBASE_ANALYTICS_COLLECTION_ENABLED": "true",
          "FIREBASE_PERFORMANCE_COLLECTION_ENABLED": "true",
          "FIREBASE_CRASHLYTICS_COLLECTION_ENABLED": "true",
          "FIREBASE_FCM_AUTOINIT_ENABLED": "true",
          "IOS_USE_PRECOMPILED_FIRESTORE_POD": "false"
        },
      

    Note

    1. If you can't pass the installation verification, please see the readme of the plugin we use to find out for more information.
    2. After your App is built, please check for the installation verification status shown on FCM setting page.

Generate Firebase Server Key

You need to provide the Firebase server key to Exosite team to complete the push notification setting.

Steps

  1. Click the settings (cogwheel) icon at the top of the Firebase Console.
  2. Choose Project Settings.

  3. Click on the Cloud Messaging tab.

  4. Click Add server key button in the lower right corner.
  5. A server key will be generated immediately. Copy the token and provide it to the Exosite support team.

    Warning

    Please copy the entire token. Do not provide any screenshot in case of unexpected errors.

Have more questions? Submit a request


Last update: October 4, 2023