Add the SDK Dependency

Goal of this step

In this step, you add the Mapp Intelligence Android SDK v5 to your project and prepare your Android app to load it successfully at runtime.

Before you begin

Make sure your project already meets the requirements described in Requirements & Compatibility.

Note: SDK v5 is configured directly in the app. Configuration via Tag Integration is no longer supported.

Always check the latest released version on GitHub Releases.

Add the dependency

Pick the build configuration that matches your project setup. The SDK is published on Maven Central.

Gradle (Groovy)

Add the dependency to your module-level build.gradle:

dependencies {
    implementation 'com.mapp.sdk:intelligence-android:5.1.13'
}

Gradle Kotlin DSL

If your project uses build.gradle.kts:

dependencies {
    implementation("com.mapp.sdk:intelligence-android:5.1.13")
}

Maven

If you maintain dependencies in a Maven pom.xml:

<dependency>
    <groupId>com.mapp.sdk</groupId>
    <artifactId>intelligence-android</artifactId>
    <version>5.1.13</version>
</dependency>

Confirm package source availability

Make sure your build environment can reach the package source you chose:

Maven Central: https://repo.maven.apache.org must be reachable. Declare mavenCentral() in your repositories block:
```
repositories {
    google()
    mavenCentral()
}
```
Google Maven: https://maven.google.com must also be reachable for AndroidX dependencies pulled in transitively.

Network access on Android

The SDK sends tracking requests over HTTPS. Your Android app must declare the INTERNET permission in AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET" />

Android's Network Security Configuration enforces HTTPS by default on API 28+; ensure your Track Domain uses https://.

Use a compatible build toolchain

The SDK targets Android 6.0 and later. Configure your Android project accordingly:

Min SDK: API 23 (Android 6.0) or higher
Compile SDK: 34 or higher (36 recommended for current releases)
JDK: 17
Android libraries: AndroidX is required

Example Gradle Kotlin DSL configuration:

android {
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_17
        targetCompatibility = JavaVersion.VERSION_17
    }
}

kotlin {
    jvmToolchain(17)
}

What this step should achieve

After this step:

the SDK dependency resolves successfully from Maven Central
your Android min SDK and JDK version match the SDK's requirements
your app declares the INTERNET permission
your Track Domain uses HTTPS

Next, continue with Initialize the SDK.