Add the SDK Dependency

Prev Next

Goal of this step

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

Before you begin

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

Add the dependency

Add the SDK from Maven Central using the current released version.

Gradle (Groovy)

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

Gradle Kotlin DSL

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

Maven

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

Confirm repository availability

The SDK is distributed via Maven Central. Make sure your project resolves dependencies from mavenCentral().

Example

repositories {
    google()
    mavenCentral()
}

Add the required Android permission

The SDK sends tracking requests over the network. Your Android app therefore needs the INTERNET permission in the manifest.

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

Use a compatible Java toolchain

The SDK requires JDK 17. Configure your Android project accordingly.

Gradle Kotlin DSL example

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

  • your app has network permission

  • your build uses a supported Java version

Next, continue with Initialize the SDK.