Native SDK Version Customization

How to override the underlying iOS or Android Rive Native SDK version used by Rive React Native

⚠️ Advanced Configuration This section is for advanced users who need to use specific versions of the Rive native SDKs. In most cases, you should use the default versions that come with the library. Only customize these versions if you have a specific requirement and understand the potential compatibility implications.

Important: If you customize the native SDK versions and later update Rive React Native to a newer version, you should revisit your custom version settings. The custom versions you specified may not be compatible with the updated Rive React Native version. Always check the default versions in the new release and test thoroughly.

Default Behavior

By default, Rive React Native pins the native SDK versions in the library’s own package.json under runtimeVersions. The current release uses:

"runtimeVersions": {
  "ios": "6.21.1",
  "android": "11.7.2"
}

These are tested and known to work with this version of Rive React Native. To confirm the exact versions your installed release bundles, check runtimeVersions in node_modules/@rive-app/react-native/package.json.

Customizing Versions

You can override these default versions using platform-specific configuration files.

See the available native Rive Android and iOS versions.

iOS (Vanilla React Native)

Create or edit ios/Podfile.properties.json:

{
  "RiveRuntimeIOSVersion": "6.21.1"
}

Then run:

cd ios && pod install

Android (Vanilla React Native)

Add to android/gradle.properties:

Rive_RiveRuntimeAndroidVersion=11.7.2

Expo Projects

For Expo projects, use config plugins in your app.config.ts:

import { ExpoConfig, ConfigContext } from "expo/config";
import { withPodfileProperties } from "@expo/config-plugins";
import { withGradleProperties } from "@expo/config-plugins";

export default ({ config }: ConfigContext): ExpoConfig => ({
  ...config,
  plugins: [
    [
      withPodfileProperties,
      {
        RiveRuntimeIOSVersion: "6.21.1",
      },
    ],
    [
      withGradleProperties,
      {
        Rive_RiveRuntimeAndroidVersion: "11.7.2",
      },
    ],
  ],
});

Version Resolution Priority

The library resolves versions in the following order:

iOS:

1. ios/Podfile.properties.json → RiveRuntimeIOSVersion
2. package.json → runtimeVersions.ios (default)

Android:

1. android/gradle.properties → Rive_RiveRuntimeAndroidVersion
2. package.json → runtimeVersions.android (default)