Android agent compatibility and 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

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

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 during signing. JARs with manifests containing SHA1-Digest or SHA-256-Digest attributes will not be modified.

2.3

No longer supported in versions 6.0 and higher. 5.25 - 5.26 are not supported

3.0 - 3.3

No longer supported in versions 6.0 and higher.

3.4

5.25 and higher

4.+

5.26 and higher

7.1.0

6.2.0 and higher

8.+

7.0.0 and higher

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

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