New Relic for Android compatibility and requirements

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.


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:

  • Android Studio
  • Gradle 3.3
  • Gradle plugin 2.3.0
  • Proguard 5.0
  • DexGuard 7.2.04

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.

Android Gradle Plugin (AGP)




Android Agent













Unit testing not supported

Our Mobile agents are designed and tested to work in a normal app lifecycle. New Relic does not support running any testing environment on applications with the agent. Testing can cause conflicts and unpredictable behavior.

For more help

If you need more help, check out these support and learning resources: