React Native





Unreal Engine



SDK Installation
AndroidiOSCocosCordovaFlutterIonicReact NativeUnityUnreal Engine 4XamarinSDK Release Changelogs
SDK Conceptual
SDK API reference
SDK Cookbooks
SDK Integrations
REST API (beta)

Android SDK Installation

  1. Add Smartlook in your app’s build.gradle:
implementation 'com.smartlook.recording:app:1.8.1-native'

Note that 1.8.1-native uses AndroidX if you need to fallback to support please use the following:

implementation 'com.smartlook.recording:app:1.8.1-native-support'
  1. Add Smartlook Maven repository in your projects build.gradle:
allprojects {
repositories {
maven {
url ""
  1. Setup and start Smartlook in onCreate() of your Application class:
public class MyCustomApplication extends Application {
public void onCreate() {

To setup Smartlook, the unique project API key is needed. It can be found in the mobile project settings in the Smartlook Dashboard.

  1. Smartlook now starts recording the app. The recordings will appear in the Smartlook player shortly.

SDK will upload sessions only on Wi-Fi. When uploading on mobile connections is requested, it must be enabled in the project settings in the dashboard. More details about the recording process can be found in the Conceptual documentation.

SDK update & migrations

1.8.0 migration

When updating the Smartlook SDK to 1.8.0 (or newer) from the older SDK version, some of the SDK imports may be broken. To fix this please follow the migration guide.

Supported versions

Currently the minimal supported Android version is Jelly Bean (API 18).

Further Steps

All Smartlook SDK methods are documented in the Smartlook API reference.

Some advanced use-case and troubleshooting case-studies are described in the Cookbooks section of this documentation.

Issues and bugs can be reported in the issue tracker.

Concepts underlying the Smartlook functionality are described in the Conceptual documentation: