Getting Started

This page lists the versions and tools required to build a React Native app that integrates the Inkrypt Video Player SDK. Make sure your environment matches these requirements before installing the package. Mismatches here cause most integration issues.


Minimum Requirements

RequirementValueNotes
React Native<= 0.74.5New Architecture is not supported
Node.js>= 18Required by React Native 0.74
Android minSdkVersion>= 24 (Android 7.0)Set in android/build.gradle
Android newArchEnabledfalseSet in android/gradle.properties
iOS deployment target>= 16.1Set in ios/Podfile and Xcode target
Xcode>= 15.3Required by the iOS native SDK
Swift>= 5.9

Why these constraints? The underlying native SDKs use modern AVFoundation (iOS) and Media3/ExoPlayer (Android) APIs that require these versions. See the native iOS requirements and native Android requirements for background.


Tools You Will Need

1. Node.js

React Native 0.74 requires Node.js 18 or newer. Install from nodejs.org.

Verify:

node -v npm -v

2. A Package Manager

Either npm (bundled with Node) or yarn will work. The SDK's example app uses yarn 3.

3. Android Studio

Required for Android development and to generate signed builds. Download from developer.android.com/studio.

During first-run setup, install:

  • Android SDK Platform 34 (target)
  • Android SDK Build-Tools
  • Android Emulator + a system image of API 24+

4. Xcode and Command Line Tools

Required for iOS development. Install Xcode 15.3+ from the Mac App Store, then open it once to let it finish installing components.

Install the command line tools:

xcode-select --install

Verify:

xcode-select -p # Expected: /Applications/Xcode.app/Contents/Developer

5. CocoaPods

CocoaPods manages the iOS native dependencies for React Native. Install it with:

sudo gem install cocoapods

Or via Homebrew:

brew install cocoapods

6. A Physical iOS Device

The iOS native SDK uses FairPlay DRM, which is not supported in the iOS Simulator. You must test video playback on a real iPhone or iPad running iOS 16.1 or later.

On android, note that Developer Mode and USB Debugging will block playback unless you set tolerateDeveloperMode: true on params during development.


Project Constraints

When bootstrapping or using an existing React Native project with this SDK:

  • Legacy Architecture only. In android/gradle.properties, ensure:
    newArchEnabled=false
    
  • Pin React Native to 0.74.5 or lower. Newer versions have not been validated against this wrapper.
  • Bump minSdkVersion to at least 24. The native Android SDK will not compile against lower API levels.
  • Set the iOS deployment target to 16.1 or higher in both Xcode and your Podfile.