Installation

Install with your package manager (works with bare React Native and Expo). Your choice is remembered across the whole site:

npm install @rovenue/react-native-sdk

Peer dependencies: React Native ≥ 0.76, React ≥ 18.3, Expo ≥ 52 — in an Expo app, the React Native version your Expo SDK pins (npx expo install --check). The Nitro module bundles the prebuilt librovenue dylib — no separate native install is needed.

In Xcode: File → Add Package Dependencies and enter:

https://github.com/broverse/rovenue-ios

Or add to your Package.swift:

dependencies: [
  .package(
    url: "https://github.com/broverse/rovenue-ios",
    from: "0.16.0"
  )
],
targets: [
  .target(
    name: "YourTarget",
    dependencies: ["Rovenue"]
  )
]

Supported platforms: iOS 16.0+ (device and simulator) and macOS 12.0+.

Add to your Podfile:

pod 'Rovenue'

Then run:

pod install

In build.gradle.kts (module level):

dependencies {
  implementation("io.rovenue:sdk:0.16.0")
}

Make sure mavenCentral() is in your settings.gradle.kts repository list.

Expo (recommended): Add the config plugin so expo prebuild auto-wires the native layer:

{
  "expo": {
    "plugins": ["@rovenue/react-native-sdk/app.plugin"]
  }
}

Then run prebuild:

npx expo prebuild

Bare React Native: Link native modules (React Native ≥ 0.76 auto-links via the Nitro module spec — no manual react-native link needed). For Android, ensure minSdkVersion is 24 or higher in android/build.gradle; on iOS the deployment target must be 16.0 or higher.

No additional wiring is needed beyond adding the package. The SDK hooks into StoreKit 2 automatically at runtime.

If you are using UIKit (non-SwiftUI), ensure your AppDelegate does not override application(_:open:options:) in a way that swallows deep links — the SDK uses SKPaymentQueue for fallback receipt handling on older OS versions.

The SDK requires the BILLING permission. Confirm your AndroidManifest.xml includes it (the AAR ships with a merged manifest, so it is usually added automatically):

<uses-permission android:name="com.android.vending.BILLING" />

Ensure your app targets minSdk 24 or higher. Initialize the SDK from your Application subclass, not from an Activity, to avoid lifecycle issues (see Step 3).

Call it at the top of your app entry file, before the component tree renders:

import { Rovenue } from '@rovenue/react-native-sdk';

Rovenue.configure({
  apiKey: 'rov_pub_your_key_here',
});

With Expo Router, put this in app/_layout.tsx before the <Stack /> render, or in a dedicated app/init.ts that is imported first.

Call from application(_:didFinishLaunchingWithOptions:) (UIKit) or the @main struct init() (SwiftUI):

import Rovenue

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
  func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
  ) -> Bool {
    Rovenue.configure(
      apiKey: "rov_pub_your_key_here"
    )
    return true
  }
}

SwiftUI @main:

import SwiftUI
import Rovenue

@main
struct YourApp: App {
  init() {
    Rovenue.configure(
      apiKey: "rov_pub_your_key_here"
    )
  }

  var body: some Scene {
    WindowGroup { ContentView() }
  }
}

Call from your Application.onCreate():

import android.app.Application
import dev.rovenue.sdk.Rovenue

class App : Application() {
  override fun onCreate() {
    super.onCreate()
    Rovenue.configure(
      context = this,
      apiKey = "rov_pub_your_key_here"
    )
  }
}

Register App in AndroidManifest.xml:

<application android:name=".App" ...>