On this page, you can learn about the supported versions, limitations, troubleshooting resources, and support options for React Native.
Requirement
Minimum Version
React
16.8
React Native
0.60
Node.js
16.0.0
Android SDK version
21
iOS SDK
12
Gradle
7.0
Android Gradle Plugin
7.0
Java
11
Kotlin
2.0.21
Jetpack Compose
1.4 - 1.9
react-native start --reset-cache to take effect.android and ios folders in your project. Run npx expo prebuild to generate these folders before installing the plugin. The plugin configuration runs automatically only when these folders exist.The Android Agent requires Kotlin 2.0.21. Using this version may cause compatibility issues with older React Native versions due to Kotlin metadata differences:
react-native-gradle-plugin compiled with Kotlin 1.7.22, which can lead to build failures with Kotlin 2.0.21.Ensure your build fulfills the Kotlin 2.0.21 requirement while meeting your React Native version requirements.
The Android Agent supports Jetpack Compose 1.4 - 1.9. If you use an incompatible version, you may encounter build errors.
Disabling Jetpack Compose instrumentation skips the compatibility check, allowing you to build with any Compose version without triggering validation errors.
Before reporting an issue, reset the metro cache using react-native start --reset-cache. Metro caches files, and stale cache can cause unexpected behavior.
dynatrace.config.js contains valid applicationId and beaconUrl values.npx instrumentDynatrace after any configuration changes.metro.config.js.Error: Could not find com.dynatrace.tools.android:gradle-plugin:X.X.X
Solution: Add mavenCentral() to all repository blocks in your top-level build.gradle file:
buildscript {repositories {google()mavenCentral()}}allprojects {repositories {google()mavenCentral()}}
JCenter sunset on May 1st. JCenter still syncs with Maven Central, but using mavenCentral() is recommended.
Error: No configuration for the Dynatrace Android Gradle plugin found! Please copy the configuration block from the instrumentation wizard to the proper location.
Solution: Ensure you've added the Android configuration block to your dynatrace.config.js file and run npx instrumentDynatrace.
Error: DynatraceNative.PLATFORM_ANDROID is null
Solution: React Native linking didn't work correctly. Unlink and relink the native library:
react-native unlinkreact-native link
Error: Missing property DTXApplicationID
Solution: No configuration is available. Run npx instrumentDynatrace at least once to apply the configuration from dynatrace.config.js.
Error: Version '1.0.0' of artifact 'androidx.compose.material:material' is not supported.
Solution: Update to the latest Dynatrace Android Gradle plugin or disable Jetpack Compose instrumentation by adding the following to your dynatrace.config.js file:
module.exports = {android: {config: `dynatrace {configurations {defaultConfig {userActions {composeEnabled false}}}}`},// ... other configuration}
After making this change, run npx instrumentDynatrace to apply the configuration.
Before opening a support case, reset the metro cache using react-native start --reset-cache and validate if your error persists.
To report a bug or open a support case:
node_modules/@dynatrace/react-native-plugin/logs.dynatrace.config.js file.react-native --version).node --version).