com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'next_previous_link3' is unknown.

Configuring Android with Firebase Cloud Messaging

Prerequisites

  •  Clone the cdmf-agent-android GIT repository. This will be referred to as <ANDROID_AGENT_SOURCE_CODE>.

    git clone https://github.com/wso2/cdmf-agent-android/tree/release-2.0.0

    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.

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

  1. Go to the Firebase API Console.
  2. Click CREATE NEW PROJECT.
  3. Provide a preferred name for the project (example: WSO2-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 WSO2 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 <ANDROID_AGENT_SOURCE_CODE>/client/client/google-services.json file with the google-services.json file that downloaded in the fifth step.

  10. Open <ANDROID_AGENT_SOURCE_CODE> 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 <IoT_HOME>/core/repository/deployment/server/jaggeryapps/android-web-agent/app/pages/mdm.page.enrollments.android.download-agent/public/asset directory.
  13. Open the <IoT_HOME>/core/repository/deployment/server/devicetypes/android.xml file and copy the configuration given below to enable communication via FCM.
    <PushNotificationProvider type="FCM">
    </PushNotificationProvider>
com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'next_previous_links2' is unknown.