--- title: Android agent compatibility and requirements source: https://docs.newrelic.com/docs/mobile-monitoring/new-relic-mobile-android/get-started/new-relic-android-compatibility-requirements --- The mobile monitoring capability is compliant with standard application stores, including Google Play Store, Amazon Appstore, and others. Before you [install and configure the mobile agent](https://docs.newrelic.com/docs/mobile-monitoring/new-relic-mobile-android/install-configure) with your Android applications, follow these guidelines for compatibility and other requirements. ## Foreground monitoring [#foreground] The Android agent only monitors your app while it is in the foreground. The agent does not monitor background services while the app is closed. For more information, see our [Mobile data privacy and security documentation](https://docs.newrelic.com/docs/mobile-monitoring/new-relic-mobile/get-started/security-mobile-apps). ## Android compatibility [#compatibility] Make sure your Android app meets these requirements: | Component | Application requirements | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Operating system | Android 7.0 or higher | | API/SDK | HttpURLConnection, OkHttp2 (except versions 2.0 and 2.4), OkHttp (versions 2.8, 3.5+, 4.0+), OkIO (version 1.11), AndroidHttpClient, Volley (version 1.0.0), and Apache HTTP Client networking APIs > #### ⚠️ IMPORTANT > > AndroidHttpClient was removed from the SDK in version 23, and as such only supported in Android agent version 6.5.0 and lower. **Android agent version 7.0.0 or higher** requires: - Android Studio Flamingo - Gradle 7.2 - Android Gradle plugin 7.0.0 - DexGuard 9.0 and higher **Android agent version 6.6.0 or higher** requires **Android SDK Tools version 24 or higher**. For Android SDK Tools version 24 or higher, you also need to meet the following requirements: - Android Studio - Gradle 5.1.1 - Android Gradle plugin 3.4 - Proguard 5.0 - DexGuard 8.0 through 9.x For older Android agent versions, your build's Android SDK Tools version must be compatible with your Android agent version: - **Android agent version 6.0.0 through 6.5.0** requires builds to be compiled with **Android SDK Tools version 21 or higher**. - **Android agent version 5.0.0 through 5.9.9** requires builds to be compiled with **Android SDK Tools version 14 or higher**. Note: Make sure to upgrade your SDK Tools to the most recent version before you install the Android agent. > #### ⚠️ IMPORTANT > > As of May, 2022, Android Gradle plugin version 7.2.1 release breaks the transform API when used along with ASM API, and this has impacted New Relic Android agent functionalities. This issue has been fixed in [Android Gradle plugin version 7.2.2](https://developer.android.com/studio/releases/gradle-plugin#7-2-0) | | Languages | Java 1.7 through Java 9. JDK 11 is supported in version 6.2.0 and higher. JDK 17 is supported in version 7.0.0 and higher. | | Devices | Any Android compatible device (smartphones, tablets, Android TV, Amazon Fire, etc.) | | File sizes | The agent adds less than 500KB to your release APK. | | Architectures | ARM, Intel Atom | | Signature validation | The agent cannot instrument JARs that use [signature validation](https://docs.oracle.com/javase/7/docs/technotes/guides/jar/jar.html#Signature_Validation) during signing. JARs with manifests containing `SHA1-Digest` or `SHA-256-Digest` attributes will not be modified. | ## Agent and Gradle compatibility [#agent-gradle] The following are compatible versions of the New Relic Android agent, Gradle, and the [Android Gradle plugin](https://developer.android.com/studio/releases/gradle-plugin). > #### ⚠️ IMPORTANT > > As of January 2021, our Android agent discontinued support for Android Gradle Plugin version 2. For more information, see our [Support Forum post](https://support.newrelic.com/s/hubtopic/aAX8W0000008bKn/important-upcoming-changes-to-capabilities-across-browser-php-python-mobile). | Android Gradle plugin | New Relic Android agent compatibility | | --------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [2.3](https://developer.android.com/studio/releases/gradle-plugin#2-3-0) | No longer supported in versions 6.0 and higher. [5.25](https://docs.newrelic.com/docs/release-notes/mobile-release-notes/android-release-notes/android-5252) - [5.26](https://docs.newrelic.com/docs/release-notes/mobile-release-notes/android-release-notes/android-5260-0) are not supported | | [3.0](https://developer.android.com/studio/releases/gradle-plugin#3-0-0) - [3.3](https://developer.android.com/studio/releases/gradle-plugin#3-3-0) | No longer supported in versions 6.0 and higher. | | [3.4](https://developer.android.com/studio/releases/gradle-plugin#3-4-0) | [5.25](https://docs.newrelic.com/docs/release-notes/mobile-release-notes/android-release-notes/android-5252) and higher | | [4.+](https://developer.android.com/studio/releases/gradle-plugin#4-0-0) | [5.26](https://docs.newrelic.com/docs/release-notes/mobile-release-notes/android-release-notes/android-5260-0) and higher | | [7.1.0](https://developer.android.com/studio/releases/gradle-plugin#7-1-0) | [6.2.0](https://docs.newrelic.com/docs/release-notes/mobile-release-notes/android-release-notes/android-620) and higher | | [8.+](https://developer.android.com/studio/releases/gradle-plugin#8-0-0) | [7.0.0](https://docs.newrelic.com/docs/release-notes/mobile-release-notes/android-release-notes/android-700) and higher | | [9.+](https://developer.android.com/studio/releases/gradle-plugin#9-0-0) | [7.7.0](https://docs.newrelic.com/docs/release-notes/mobile-release-notes/android-release-notes/android-770) and higher | ## Kotlin and Kotlin DSL [#kotlin] You can also use [Kotlin projects with Gradle](https://kotlinlang.org/docs/reference/using-gradle.html) and New Relic's Android agent. ### Kotlin DSL support by Android agent version [#Kotlin-DSL-support-by-Android-agent-version] With the exception of incompatibilities noted with [Android Gradle Plugin](#agent-gradle), New Relic's Android agent is compatible with versions **1.3 - 1.4** of the Kotlin Gradle Plugin. | Kotlin DSL version | New Relic Android agent compatibility | | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 1.2 | Unsupported | | 1.3 | - **5.24 and lower:** Requires Kotlin Gradle Plugin version 1.3.10 or higher - **5.25:** Requires Kotlin Gradle Plugin version 1.3.10 or higher - **5.26:** Unsupported in Android agent versions 5.26.0 through 5.28.0 | | 1.4 | - **5.24 and lower:** Requires Kotlin Gradle Plugin version 1.3.10 or higher - **5.25:** Supported - **5.26:** Unsupported in Android agent versions 5.26.0 through 5.28.0 | ### Kotlin DSL support by AGP version [#kotlin-andoid-gradle] Kotlin DSL support was officially added to Android Gradle Plugin in version 4.1, but many developers are already using it in place of Groovy. | Kotlin DSL version | Android Gradle Plugin and Android Gradle compatibility | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 1.3 | - **3.2 (AGP), 4.6 (Gradle) :** Requires Kotlin Gradle Plugin version 1.3.10 or higher - **3.3 (AGP), 5.1.1 (Gradle):** Requires Kotlin Gradle Plugin version 1.3.10 or higher - **3.4 (AGP), 5.1.1 (Gradle):** Requires Kotlin Gradle Plugin version 1.3.10 or higher - **3.5 (AGP), 5.4.1 (Gradle):** Requires Kotlin Gradle Plugin version 1.3.10 or higher - **3.6 (AGP), 5.6.4 (Gradle):** Requires Kotlin Gradle Plugin version 1.3.40 or higher - **4.0 (AGP), 6.1.1 (Gradle):** Requires Kotlin Gradle Plugin version 1.3.40 or higher - **4.1 (AGP), 6.5 (Gradle):** Requires Kotlin Gradle Plugin version 1.3.40 or higher | | 1.4 | - **3.2 (AGP), 4.6 (Gradle) :** Requires Gradle 5.3 - **3.3 (AGP), 5.1.1 (Gradle):** Requires Gradle 5.3 - **3.4 (AGP), 5.1.1 (Gradle):** Supported - **3.5 (AGP), 5.4.1 (Gradle):** Supported - **3.6 (AGP), 5.6.4 (Gradle):** Supported - **4.0 (AGP), 6.1.1 (Gradle):** Supported - **4.1 (AGP), 6.5 (Gradle):** Supported | ## Unit testing not supported [#testing] Our New Relic mobile agents are designed and tested to work in a normal app lifecycle. We do not support running any testing environment on applications with the agent. Testing can cause conflicts and unpredictable behavior.