This documentation is for WSO2 IoT Server 3.1.0. View the documentation for the latest release.
Configuring Android with Firebase Cloud Messaging - IoT Server 3.1.0 - WSO2 Documentation
Skip to end of metadata
Go to start of metadata

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


  •  Clone the cdmf-agent-android GIT repository. This is referred to as <ANDROID_AGENT_SOURCE_CODE> throughout this document.

    git clone

    Make sure that the Android agent release version matches the IoT Server release version. Click here for more information.

  • Download and install Android Studio. For more information, see installing Android Studio.
  1. Go to the Firebase API Console.
  3. Provide a preferred name for the project (example: WSO2-FCM), select the country/region, and click CREATE PROJECT.

    The new project is created in few seconds, and you are 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 WSO2 Android agent, that is org.wso2.iot.agent and click REGISTER APP.

  6. Click Download google-service.json to download the configurations. 

  7. Replace the <ANDROID_AGENT_SOURCE_CODE>/client/client/google-services.json file with the google-services.json file you just downloaded.

  8. Click CONTINUE > FINISH to finish the process and create the application. 
    You are navigated to the overview of the created application.
  9. Scroll up the page and go to the CLOUD MESSAGING tab. Note down the Firebase Cloud messaging token. You need to provide this token as the server key when configuring the Android platform.

  10. Open <ANDROID_AGENT_SOURCE_CODE> via Android Studio, clean the project, 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 the existing android-agent.apk file that is in the <IoT_HOME>/repository/deployment/server/jaggeryapps/android-web-agent/app/pages/ directory.
  13. Open the <IoT_HOME>/repository/deployment/server/devicetypes/android.xml file and uncomment the configuration given below to enable communication via FCM.
    <PushNotificationProvider type="FCM">
  14. Restart the WSO2 IoT Server in order to apply the changes.
  • No labels