迁移指南（Migration Guide）

从 v0.1.0 到 v0.2.0

该版本主要升级 Nitro 主版本以修复 view recycling 问题。核心动作：升级 Nitro 依赖版本。

从 rive-react-native 迁移到 @rive-app/react-native

新版是基于 Nitro Modules 的重写版本，性能与集成体验更好。

迁移收益

• 你直接持有 RiveFile（更易缓存与复用）
• 数据绑定能力增强（直接操作 ViewModelInstance）
• 错误处理更完善

环境要求

• React Native 0.78+
• Expo SDK 53+
• iOS 15.1+
• Android SDK 24+
• Xcode 16.4+
• JDK 17+
• Nitro Modules 0.25.2+

迁移步骤（建议）

1. 卸载旧包并安装新包

npm uninstall rive-react-native
npm install @rive-app/react-native react-native-nitro-modules

2. 更新导入

// old
import Rive from 'rive-react-native';
// new
import { RiveView } from '@rive-app/react-native';

3. 文件加载改为 useRiveFile
4. 组件改为 RiveView
5. ref 控制改为 useRive + hybridRef
6. 输入/事件/TextRun 方案逐步迁移到 Data Binding（旧接口已弃用）

更多分项：

• 属性（Props）
• Ref 方法（Rive Ref Methods）
• 错误处理（Error Handling）

获取帮助

• 文档入口：/docs/Runtimes/React Native/React Native
• Example App：https://github.com/rive-app/rive-nitro-react-native/tree/main/example
• 社区：https://community.rive.app
• Issues：https://github.com/rive-app/rive-nitro-react-native/issues