Migrating from v4 to v6

Migrating from v4 to v6

This article is out of date! Find the new version here.

If you are migrating to rive-react-native note the following changes below. Since there were not any minor/patch versions released on v5, we're consolidating the migration guidance from v4 to v5 and v5 to v6, which we recommend migrating to stay up-to-date.

No breaking API changes!

Dependencies

React Native

We updated the react-native and react devDependencies to support the following versions:

• React: 18.2.0

• React Native: 0.72.3

Out of an abundance of caution, we've bumped a major version on rive-react-native to account for any discrepancies that arise from going from v0.66.4 -> v0.72.3.

Rive Android

We also bumped the rive-android runtime dependency from v5.1.5 to v8.1.0 to support the Rive follow-path feature and Text feature. A slight bundle size increase may be seen as it introduces a Text Engine dependency.

If you run into issues building, you may try setting a higher NDK version.

The rive-android NDK version defines the ndkVersion in build.gradle at "25.1.8937393"

You may want to consult the rive-react-native example app included in the repository to see an example configuration to follow if you run into issues.

Rive iOS

We also bumped the rive-ios runtime dependency from v4.0.5 to v5.0.1 to support the Text feature. A slight bundle size increase may be seen as it introduces a Text Engine dependency.

New APIs

Dynamic Text

Starting in v6.0.0, rive-react-native has support for not only displaying Rive graphics that include Rive Text, but the ability to set text dynamically via the Rive ref.

Check the Rive ref methods page to see how to set text run values.