Native SDK Version Customization

⚠️ 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 uses the native SDK versions specified in its package.json. For example, @rive-app/react-native 0.5.5 uses:

"runtimeVersions": {
  "ios": "6.28.1",
  "android": "11.12.1"
}

These versions are tested and known to work well with that version of Rive React Native. Check the release notes for the versions used by each release.

Customizing versions

You can override these default versions using platform-specific configuration files. See the available native Rive Android and iOS versions.

Some features need a minimum native SDK version. For example, GPU Canvas requires Rive iOS 6.25.0 and Rive Android 11.12.0 or later.

iOS (vanilla React Native)

Create or edit ios/Podfile.properties.json:

{
  "RiveRuntimeIOSVersion": "6.24.0"
}

Then run:

cd ios && pod install

Android (vanilla React Native)

Add to android/gradle.properties:

Rive_RiveRuntimeAndroidVersion=11.9.2

Expo projects

For Expo projects, use an inline config plugin in your app.config.ts:

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

export default ({ config }: ConfigContext): ExpoConfig => ({
  ...config,
  plugins: [
    (config) => {
      config = withPodfileProperties(config, (config) => {
        config.modResults["RiveRuntimeIOSVersion"] = "6.24.0";
        return config;
      });

      config = withGradleProperties(config, (config) => {
        config.modResults.push({
          type: "property",
          key: "Rive_RiveRuntimeAndroidVersion",
          value: "11.9.2",
        });
        return config;
      });

      return config;
    },
  ],
});

Version resolution priority

The library resolves versions in the following order: iOS:

RIVE_RUNTIME_IOS_VERSION environment variable when running pod install
$RiveRuntimeIOSVersion global in your Podfile
ios/Podfile.properties.json → RiveRuntimeIOSVersion
package.json → runtimeVersions.ios (default)

Android:

RiveRuntimeAndroidVersion in your root project’s ext block (android/build.gradle)
android/gradle.properties → Rive_RiveRuntimeAndroidVersion
package.json → runtimeVersions.android (default)

Runtimes

Integrations

Native SDK Version Customization

Default behavior

Customizing versions

iOS (vanilla React Native)

Android (vanilla React Native)

Expo projects

Version resolution priority

​Default behavior

​Customizing versions

​iOS (vanilla React Native)

​Android (vanilla React Native)

​Expo projects

​Version resolution priority

Default behavior

Customizing versions

iOS (vanilla React Native)

Android (vanilla React Native)

Expo projects

Version resolution priority