---
title: "Set Up the Android SDK"
slug: "set-up-the-android-sdk"
updated: 2026-03-10T11:19:29Z
published: 2026-03-10T11:19:29Z
canonical: "docs.mapp.com/set-up-the-android-sdk"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Set Up the Android SDK

## Overview

To send and receive push notifications in Mapp Engage via Android, start by setting up the Android SDK.

Before you begin, make sure your project meets the requirements for your SDK version. Version-specific requirements are documented in [Android SDK v7](/v1/docs/android-sdk-v7-1) and [Android SDK v6](/v1/docs/android-sdk-v6).

---

## Download

The Android SDK artifacts are available on Maven Central.

Use the artifact corresponding to the SDK version you want to integrate:

- **Android SDK v7 (recommended)**

[https://central.sonatype.com/artifact/com.mapp.sdk/engage-android](https://central.sonatype.com/artifact/com.mapp.sdk/engage-android)
- **Android SDK v6 (legacy)**

[https://central.sonatype.com/artifact/com.mapp.sdk/mapp-android](https://central.sonatype.com/artifact/com.mapp.sdk/mapp-android)

---

## Dependencies

The SDK requires Firebase Cloud Messaging (FCM).

Use a Firebase BOM version compatible with your SDK version and Firebase setup. Refer to the respective SDK documentation (v6 or v7) for specific version requirements.

---

## Gradle Setup

Add the following to your `build.gradle`:

### Android SDK v7

```groovy
implementation 'com.mapp.sdk:engage-android:7.x.x'
implementation platform('com.google.firebase:firebase-bom:<firebase-bom-version>')
implementation 'com.google.firebase:firebase-messaging'
implementation 'com.google.firebase:firebase-analytics'
```

### Android SDK v6

```groovy
implementation 'com.mapp.sdk:mapp-android:6.x.x'
implementation platform('com.google.firebase:firebase-bom:<firebase-bom-version>')
implementation 'com.google.firebase:firebase-messaging'
implementation 'com.google.firebase:firebase-analytics'
```

Use a Firebase BOM version compatible with your Firebase setup. For v7, see the SDK v7 requirements.

### Maven

```xml
<dependency>
  <groupId>com.mapp.sdk</groupId>
  <artifactId>mapp-android</artifactId>
  <version>X.X.X</version>
</dependency>
```

---

## Project Configuration

### AndroidManifest.xml Permissions

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

---

### AndroidX Support

The SDK requires AndroidX. If needed, follow the official [AndroidX migration guide](https://developer.android.com/jetpack/androidx#using_androidx).