Overview
This page provides an overview of the setup and integration process for the Mapp Engage Android SDK v7.
Before integrating SDK-specific features, ensure that your Android project is properly configured. Complete the required setup steps in the Getting Started) section first.
Follow the recommended flow below to integrate and configure the SDK in your application.
Prerequisites
Ensure your development environment meets the following requirements:
Android Studio: Ensure you have the latest version installed.
JDK Version: Java 17 for version 7.x.x and later.
Gradle: 8.13 and later
Android Gradle Plugin (AGP): 8.13.2 and later
Kotlin: 2.2.21 and later
Target SDK Version: 36
Min SDK Version: 23
Configure your Android project to use the required JDK version for this SDK (for example via Gradle Java toolchain or compileOptions).
Geofencing requires additional location permissions and Google Play services dependencies. See the Geofencing section in the Android SDK v7 API Reference.
Firebase
The SDK requires Firebase Cloud Messaging (FCM).
For Android SDK v7, it is recommended to use Firebase BOM version 34.6.0 or a compatible newer version.
Gradle Compatibility
Always use compatible versions of Gradle and AGP.
Refer to the official Android documentation for supported version combinations.
Recommended Setup Flow
Complete Android setup (see Getting Started)
Notification Broadcast Receiver (optional – custom push event handling)
Deep Link Support (optional)
Use SDK APIs (see API Reference)