Android SDK Installation

Adding Dependency

To add MoEngage's Android SDK to your application goto /<path-to-your-project>/android/build.gradle and add the below dependencies.

Groovy
// 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()
}

dependencies {
  implementation("androidx.core:core:1.3.1")
  implementation("androidx.appcompat:appcompat:1.2.0")
  implementation("androidx.lifecycle:lifecycle-process:2.2.0")
  implementation("com.moengage:moe-android-sdk:11.6.01")
}

Initializing the SDK

Get APP ID from the Settings Page Dashboard --> Settings --> App --> General on the MoEngage dashboard and initialize the MoEngage SDK in the Application class's onCreate().

  It is recommended that you initialize the SDK on the main thread inside onCreate() and not create a worker thread and initialize the SDK on that thread.
Java

import android.app.Application;
import com.moengage.capacitor.MoEInitializer;
import com.moengage.core.MoEngage;

public class MainApplication extends Application {

  @Override public void onCreate() {
    super.onCreate();
    MoEngage.Builder moEngage = new MoEngage.Builder(this, "YOUR_APP_ID")
    MoEInitializer.INSTANCE.initialize(this, moEngage);
  }
}

Refer to the API reference doc for a detailed list of possible configurations.


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.

Screenshot_2022-01-28_at_6.32.19_PM.png

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

Register MoEngage's Plugin

Register the plugin in your Activity class's onCreate().

Java

import com.getcapacitor.BridgeActivity;
import com.moengage.capacitor.MoECapacitorCorePlugin;

public class MainActivity extends BridgeActivity {

  @Override protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
//register the MoEngage Capacitor Plugin registerPlugin(MoECapacitorCorePlugin.class); } }

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 files, Database files etc, more details here.
This backup 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 users 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.

Was this article helpful?
0 out of 0 found this helpful