React Native integration
Get started
This guide walks you through integrating Embrace into your React Native application with a series of articles. Following them in order is recommended, although you are free to skip around.
Requirements
Our minimum requirements are set by our native side and therefore tend to be a bit higher than those set by react-native init or @react-native-community/cli init by default for a fresh React Native project, please double-check that your project is configured correctly for the SDK to run. You may find these app templates that we've setup for integration testing useful as a guide for bringing your project up to the minimum required configuration.
Before starting, make sure to verify that your project meets the following minimum requirements.
Supported versions of React Native
- RN 0.71+
We test that apps integrated with Embrace across React Native minor versions from 0.71 to 0.79 build and launch without
issue. Apps on versions of React Native older than 0.71 may work with Embrace after some modification but these are not
directly supported. The templates used to generate apps for integration testing along with the exact patch versions of
React Native we use can be found here.
Expo support
Apps using Expo are supported by Embrace's React Native SDK. If you are using Expo's prebuild system you can make use
of our Expo config plugin to manage the changes to your
project's native android/ and ios/ folders required by the SDK.
Android
- Android: Android 7.0+ (API 24)
minSdkVersion: 24+compileSdkVersion: 34+- Java 11
- Kotlin 1.8.22+ *
- Gradle 7.5.1+
- AGP (Android Gradle Build Tools Plugin) 7.4.2+
Fresh React Native projects may need gradle/build tool upgrades. See the aforementioned app templates for tested and working configurations.