New Relic Mobile is compliant with standard application stores, including Google Play Store, Amazon Appstore, and others. Before you install and configure New Relic Mobile functionality with your Android applications, follow these guidelines for compatibility and other requirements.
Foreground monitoring
New Relic Mobile for Android 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.
Android compatibility
Make sure your Android app meets these requirements for New Relic Mobile.
| Component | Application requirements |
|---|---|
| Operating system |
Android 2.3 or higher For Android 2.2 support, use legacy version 4.244.0. |
| 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 Build with Android SDK Tools version 21 or higher and the following as appropriate:
As of January 2021, our Android agent will discontinue support for Android Gradle Plugin version 2. For more information, see our Explorers Hub post. Upgrade to the most recent version before installing New Relic Mobile. For OkHttp 1.6 support, use legacy version 4.244.0. |
| Languages | Java 1.7 or higher |
| Devices | Any Android compatible device (smartphones, tablets, etc.) |
| File sizes | New Relic Mobile adds less than 500KB to your release APK. |
| Architectures | ARM, Intel Atom |
| Signature validation | The agent cannot instrument JARs that use signature validation during signing. JARs with manifests containing SHA1-Digest or SHA-256-Digest attributes will not be modified. |
Agent and Gradle compatibility
The following are compatible versions of the New Relic Android agent, Gradle, and the Android Gradle plugin.
As of January 2021, our Android agent will discontinue support for Android Gradle Plugin version 2. For more information, see our Explorers Hub post.
| Android Gradle plugin | New Relic Android agent compatibility |
|---|---|
| 2.3 | 5.25 - 5.26 are not supported |
| 3.0 - 3.5 | Any |
| 3.6 | 5.25 and higher |
| 4.+ | 5.26 and higher |
Kotlin and Kotlin DSL
You can also use Kotlin projects with Gradle and New Relic's Android agent.
Kotlin DSL support by Android agent version
With the exception of incompatibilities noted with Android 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 |
|
| 1.4 |
|
Kotlin DSL support by AGP version
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 |
|
| 1.4 |
|
Unit testing not supported
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.