---
title: "Import the Android SDK"
slug: "android-sdk-import"
updated: 2026-06-29T13:34:20Z
published: 2026-06-29T13:34:20Z
canonical: "docs.xtremepush.com/android-sdk-import"
stale: true
---

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

# Import the Android SDK

Add the Xtremepush SDK to your Android project

1. In your app's `build.gradle` file, add the Xtremepush Maven repository:

> [!TIP]
> Android Studio Bumblebee
> 
> In Android Studio Bumblebee, the build configuration files are slightly different than as described below. Specifically, the repository settings have been moved from the top-level `build.gradle` file to the `settings.gradle` file. For more information, see the release note [Repository settings](https://developer.android.com/studio/preview/features#settings-gradle) in `settings.gradle`.

**Groovy**

```groovy
repositories {
    maven {
        url 'https://maven.xtremepush.com/artifactory/libs-release-local/'
    }
}
```

**Kotlin**

```kotlin
maven {
   url = uri("https://maven.xtremepush.com/artifactory/libs-release-local/")
}
```

1. Add the XtremePush library to the dependencies section:

> [!NOTE]
> **Shared Preferences**
> 
> Starting in Version 9.6.0, encrypted shared preferences is off by default as the library it depended on is no longer supported by google and could potentially cause issues for clients.

**Groovy**

```groovy
implementation 'ie.imobile.extremepush:XtremePush_lib:9.8.2'
```

**Kotlin**

```kotlin
implementation("ie.imobile.extremepush:XtremePush_lib:9.8.2")
```

1. If you are using version 8.0 or later of the Xtremepush SDK, please include the latest version of AndroidX.

Otherwise, if you are using an older version of the SDK, add the latest version of Android Support:

**Groovy**

```groovy
implementation 'com.android.support:support-v4:28.0.0'
```

**Kotlin**

```kotlin
implementation("com.android.support:support-v4:28.0.0")
```

> [!TIP]
> Dependency versions
> 
> This example and others below show specific version numbers. You may need to update these version numbers as new updates of these dependencies are released.

1. Also add the following google dependencies if not already included:

**Groovy**

```groovy
implementation 'com.google.firebase:firebase-messaging:25.0.1'
// if using location
implementation 'com.google.android.gms:play-services-location:21.3.0'
```

**Kotlin**

```kotlin
implementation("com.google.firebase:firebase-messaging:23.1.2")
// if using location
implementation("com.google.android.gms:play-services-location:20.0.0")
```

1. Add the following dependencies:

**Groovy**

```groovy
implementation 'com.squareup.okhttp3:okhttp:5.3.2'
implementation 'com.squareup:otto:1.3.8'
implementation 'com.google.code.gson:gson:2.13.2'
implementation 'androidx.security:security-crypto:1.1.0'
implementation 'androidx.work:work-runtime:2.11.0'
// If not using beacon the dependency below can be omitted 
implementation 'org.altbeacon:android-beacon-library:2.19.2'
```

**Kotlin**

```kotlin
implementation("com.squareup.okhttp3:okhttp:4.10.0")
implementation("com.squareup:otto:1.3.8")
implementation("com.google.code.gson:gson:2.8.8")
implementation("androidx.security:security-crypto:1.0.0")
implementation("androidx.work:work-runtime:2.9.0")
// If not using beacon the dependency below can be omitted 
implementation("org.altbeacon:android-beacon-library:2.19.2")
```

1. Sync the project with the gradle file.
2. If you are using [Android location services](/documentation/docs/android-sdk-location) for Xtremepush geofencing or iBeacons, please modify the `AndroidManifest.xml` to include the following permissions :

```xml
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"  />
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
```