Insight React Native Integration Guide

NAGRA assumes you already have some knowledge of React/React Native Application building.

Product release files

Download and unzip the Insight pack, which provides all the files to integrate into your Android, iOS or Web applications.

react-native-insight-1.2.x-examples.zip
react-native-insight-1.2.x-react-insight-0.63.4.zip
react-native-insight-1.2.x-react-insight-0.67.4.zip

The Android, JS and Apple native INSIGHT SDKs are embedded within the files delivered in this plugin.

This pattern is repeated for both 0.63.4 and 0.67.4 compatible variants.

CODE

react-native-insight-<version>-react-insight-0.63.4.zip
└──┐
   ├──RNInsight.d.ts
   ├──package.json
   ├──react-native-insight-plugin.min.js
   ├──react-native-insight-plugin.podspec
   ├──ios
   │  ├──libInsightPlugin.a
   │  ├──libInsightPluginTvOS.a
   │  └──InsightAgent.xcframework
   │     ├──Info.plist
   │     └<folders for each supported architecture>
   ├──android
   │  ├──libs
   │  │  ├──react-insight-debug.aar
   │  │  ├──react-insight-release.aar
   │  │  └──otvinsight.aar
   │  ├──src
   │  │  └──main
   │  │     ├──java
   │  │     │   └──com
   │  │     │      └──nagra
   │  │     │         └──insight
   │  │     │            └──react
   │  │     │               └──plugin
   │  │     │                  └──InsightPluginPackage.java
   │  │     └──AndroidManifest.xml
   │  └──build.gradle
   └──web
      ├──index.js
      ├──react-insight.js
      └──react-insight.js.LICENSE.txt

Development environment

NAGRA recommends using Mac for development purposes; instructions for setting up on Windows are also provided.

For Android and Apple platforms, see the React Native document Setting up the development environment and follow React Native CLI Quickstart (not Expo CLI Quickstart).
For Web/HbbTV, see the React Native for Web Installation and follow Create React App (not Expo).

The plugin has been developed using the following dependency versions. NAGRA recommends using the following versions or higher:

Node 14.17.1
Yarn 1.22.10
CocoaPods 1.10.1

The plugin is built in two variants:

With react-native-tvos@0.63.4-0, and is compatible with react-native@0.63.4.
Compatible with react-native@0.67.4 (this plugin variant has no tvOS support).

Steps common to all platforms

The package.json file for your applications needs to include a reference to the location of the contents of the zip.

Example

As a reference to a relative file path:

package.json

JS

  "dependencies": {
    "@nagra/react-native-insight": "file:../react-native-insight-plugin",
  ...