MoEngage Docs

Android SDK Installation

Adding Dependency

To add MoEngage's Android SDK to your application goto <project_path> ---> platforms ---> android ---> app and create a file with the name build-extras.gradle. In case you already have this file in your project you need not create another one.

Once the file is created add the MoEngage SDK dependency in this file.

// adding the repositories block is optional. You can choose not to add this block if you have already added these repositories to your project.
repositories {
  google()
  mavenCentral()
  jcenter()
}

dependencies {
  implementation "com.moengage:moe-android-sdk:9.8.04"
}

Note: You can add the firebase messaging dependency also to this file itself if your file does not already have firebase messaging added.

Initialising the SDK

Using the APP-ID obtained the MoEngage dashboard in the previous step, initialize the Cordova MoEngage SDK in the Application class's onCreate()

// this is the instance of the application class and "XXXXXXXXXXX" is the APP ID from the dashboard.
    MoEngage moEngage = new MoEngage.Builder(this,"XXXXXXXXX”)
                                .build();
    MoEngage.initialise(moEngage);
    MoECordova.registerNativeCallbacks();

In case your application does not have an Application class yet navigate to java source code inside the android platform folder and add the Application class file

Make sure your application class is defined in the AndroidManifest.xml file as well.

Make sure your app has appcompat-v7 version 26 or above.

If you are facing issues with imports please add the below imports

import com.moengage.core.Logger;
import com.moengage.core.MoEngage;
import com.moengage.cordova.MoECordova;

Exclude MoEngage Storage File from Auto-Backup

This is a mandatory integration step and is very essential to prevent your data from getting corrupted.
Android's auto back-up service periodically backs up Shared Preference file, Database files etc, more details here.
This back-up results in MoEngage SDK's identifiers to be backed up and restored after re-install.
This restoration of the identifier results in your data being corrupted and user not being reachable via push notifications.

To ensure data is not corrupted after a backup is restored, opt-out of MoEngage SDK's storage files.
Refer to Exclude MoEngage Storage File from Auto-Backup section of the documentation to learn more about which files to exclude.

Updated 3 months ago


Android SDK Installation


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.