Android SDK Initialization

NOTE

Initialize the SDK on the main thread inside onCreate() and not create a worker thread and initialize the SDK on that thread.


import com.moengage.flutter.MoEInitializer
import com.moengage.core.MoEngage
...
// `this` is the instance of the application class and "YOUR_APP_ID" is the APP ID from the dashboard.
val moEngage: MoEngage.Builder = MoEngage.Builder(this,"YOUR_APP_ID")
MoEInitializer.initialiseDefaultInstance(context = this, builder = moengage);


import com.moengage.flutter.MoEInitializer;
import com.moengage.core.MoEngage;
...
// `this` is the instance of the application class and "YOUR_APP_ID" is the APP ID from the dashboard.
MoEngage.Builder builder = new Builder(this, "YOUR_APP_ID");
MoEInitializer.initialize(this, builder);

For more information about the detailed list of possible configurations, refer to the API reference.

NOTE

All the configurations are added to the builder before initialization. If you are calling initialize at multiple places, ensure that all the required flags and configurations are set each time you initialize to maintain consistency in behavior.

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 being 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 the Auto-Backup section of the documentation to learn more about which files to exclude.

Data Redirection

In case your app wants to redirect data to a specific zone due to any data regulation policy please configure the zone in the MoEngage initializer object. Use the setDataCenter() in the MoEngage.Builder to specify the data center.

Refer to the Data Center documentation for more information.