This documentation is for WSO2 Enterprise Mobility Manager 2.2.0. View documentation for the latest release.
Configuring WSO2 EMM with Firebase Cloud Messaging - Enterprise Mobility Manager 2.2.0 - WSO2 Documentation
Skip to end of metadata
Go to start of metadata


  •  Clone the product-emm GIT repository. This will be referred to as <EMM_SOURCE_HOME>.

    git clone
  • Download and install Android Studio. For more information, see installing Android Studio.

Follow the instructions given below to configure WSO2 EMM Firebase Cloud Messaging (FCM):

  1. Go to the Firebase API Console.
  3. Provide a preferred name for the project (example: EMM-FCM), select the country/region, and click CREATE PROJECT.

    The new project will be created in few seconds, and you will be navigated to the overview page of the project.

  4. Click Add Firebase to your Android App on the overview page of the project.

  5. Provide the package name of the EMM Android agent, that is org.wso2.emm.agent and click ADD APP.

    The generated google-service.json file will download.

  6. Click CONTINUE > FINISH to finish the process and create the application. 
    You will then be navigated to the overview of the created application.
  7. Click the menu icon of the project you created and click Manage.
  8. Go to the CLOUD MESSAGING tab and note down the Firebase Cloud messaging token. You need to provide this token as the server key when configuring the Android platform.
  9. Replace the <EMM_SOURCE_HOME>/modules/mobile-agents/android/client/client/google-service.json file with the google-service.json file that downloaded in the fifth step.

  10. Open <EMM_SOURCE_HOME> via Android Studio and build the project.

    The WSO2 Android agent can't be built via the usual Android developer SDK, as it requires access to developer restricted APIs. Therefore, you need to replace the existing android.jar file that is in the <SDK_LOCATION>/platforms/android-<COMPILE_SDK_VERSION> directory with the explicitly built android.jar file that has access to the restricted APIs. 

    For more information on how to build the project, see creating a new APK file.

  11. Rename the created .apk file to android-agent.apk.
  12. Copy the renamed file and replace it instead of the existing android-agent.apk file that is in the <EMM_HOME>/repository/deployment/server/jaggeryapps/emm-web-agent/units/asset-download-agent-android/public/asset directory.
    Now you can configure WSO2 EMM with Android and register Android devices.
  • No labels