@exodus/rive-react-native

中文文档
9.8.2-exodus.1发布于 2026/04/27MITTypeScriptESM + CJS零依赖近 30 天下载 1.1万

Rive 反应原生

中文使用文档
文档目录12 节
  1. 目录
  2. Rive 概览
  3. 开始
  4. 支持的设备
  5. 实例
  6. 移徙指南
  7. 捐款
  8. 问题
  9. 原生 SDK 版本自定义
  10. 默认行为
  11. 自定义版本
  12. 版本分辨率优先级

Build Status Discord badge Twitter handle

Rive 反应原生

Rive hero image

新运行时间可用 !

新的 Rive React Industrial 运行时间现已可用. 与硝基相建,以提高性能并更好地反应原生融合.

现在试试:

我们正在积极收集反馈,以改善新的运行时间. 请分享你的想法,报告你遇到的任何问题.

迁移时间线:

  • 短期: 完成新的运行时间, 看 特性支持 财务报告和审定财务报表 路线图
  • 中期: 在支持移徙的同时,处理这一遗产包中的主要关切问题
  • 长期: 完全迁移到新软件包

React 本地运行时库 纵横。 。 。 .

这个库是一个围绕iOS/Android运行时间的包装器,为React Industrial应用程序提供组件和校正模式.

目录

Rive 概览

纵横 是一种实时互动设计和动画工具,帮助团队在任何地方创建和运行互动动画. 设计者和开发者使用我们的合作编辑器来创建响应不同状态和用户输入的运动图形. 我们的轻量级开源运行时间库允许他们将动画装入应用程序,游戏和网站.

: 有花园的房屋: 主页

:蓝色 书: 一般帮助文件

🛠 里夫建筑资源

开始

跟着下面的链接,快速开始将 Rive React Industrial 集成到您的多平台应用程序中.

以 Rive 启动本地反应

API 文档

支持的设备

因为这个运行时的图书馆依赖 旋转Android 财务报告和审定财务报表 运行iOS 运行时间,被支持设备与这些依赖性最小支持设备的每一项一致,以及React Natural框架的最低设备要求.

  • iOS: (英语) 14.0+ (中文(简体) )
  • 机器人:
    • 最小 SDK 版本 : 21国
    • 目标SDK版本 : 33个

实例

看看这个 example/ 使用 Rive React 本地运行时间运行示例应用程序的文件夹。 它运行在这个图书馆的局部建筑上,并展示一些使用Rive组件的方法,以及 useRef 钩状图案 :

  • 通过 URL 设置 Rive 文件, 或在 Android/ iOS 项目中设置资产
  • 在一个组件上显示单个或多个动画/艺术板
  • 通过输入设置和操纵国家机器
  • ...还有更多!

步骤 :

  1. 运行 yarn bootstrap
  2. 页:1 example
  3. yarn expo run:android 或者说 yarn expo run:ios

iOS: (英语)

  • 您可能需要运行 pod install (第一次)或 pod update RiveRuntime (更新 rive iOS 运行时间) example/iOS 要安装或更新运行时间的文件夹

移徙指南

使用更古老的运行时间并需要学习如何升级到最新版本? 查看我们帮助中心下面的迁移指南, 帮助引导您通过版本突起; 打破更改和所有!

移徙指南

捐款

我们爱贡献! 看看我们 提供文件 获得更多细节 如何运行这个项目, 实例, 更多的地方.

问题

是否有使用运行时间的问题,或者想建议一个功能/API来帮助您改善发展生活? 记录一个问题 在我们 问题 选项卡! 你也可以浏览那里老问题和讨论线索,看看可能对共同问题起作用的解决办法.

原生 SDK 版本自定义

高级配置 本节针对需要使用Rive本土SDK的特定版本的高级用户. 在大多数情况下,您应该使用随库而来的默认版本. 只有当您有特定的要求并理解潜在的相容性影响时,才会自定义这些版本.

重要内容: 如果您自定义了本地的 SDK 版本并随后更新 rive-react-native 到更新版本时,您应当重温您的自定义版本设置。 您指定的自定义版本可能与更新版本不兼容 rive-react-native 版本。 总是在新发行中检查默认版本并彻底测试.

默认行为

默认, rive-react-native 使用在 package.json数字 :

"runtimeVersions": {
  "ios": "6.18.2",
  "android": "11.4.0"
}

这些版本经过了测试,已知与这个版本的操作良好 rive-react-native。 。 。 .

自定义版本

您可以使用平台特定配置文件来覆盖这些默认版本 :

iOS (Vanilla React Introduct) (瓦尼拉反应原生)

创建或编辑 ios/Podfile.properties.json数字 :

{
  "RiveRuntimeIOSVersion": "6.18.2"
}

然后运行 :

cd ios && pod install

Android (瓦尼拉反应原生)

添加为 android/gradle.properties数字 :

Rive_RiveRuntimeAndroidVersion=11.4.0

博览项目

对于 Expo 项目,请在您的配置插件中使用 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.18.2',
      },
    ],
    [
      withGradleProperties,
      {
        Rive_RiveRuntimeAndroidVersion: '11.4.0',
      },
    ],
  ],
});

版本分辨率优先级

库按以下顺序解决版本:

iOS: (英语)

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

机器人:

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

版本与发布记录

@exodus/rive-react-native 共发布 11 个版本,首次发布于 2025/09/03;过去 12 个月发布了 3 个版本。

版本发布日期距今
9.8.2-exodus.1latest2026/04/276 个月前
9.8.2-exodus.02026/04/246 个月前
9.5.12026/03/068 个月前
9.5.02025/09/261.1 年前
9.5.0-exodus.52025/09/211.1 年前
9.5.0-exodus.42025/09/211.1 年前

关于 @exodus/rive-react-native 的常见问题

@exodus/rive-react-native 是什么?

Rive 反应原生

如何安装 @exodus/rive-react-native?

在项目目录运行 npm install @exodus/rive-react-native,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(*)、react-native(*)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@exodus/rive-react-native 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@exodus/rive-react-native 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@exodus/rive-react-native 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=16。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@exodus/rive-react-native 可以商用吗?

@exodus/rive-react-native 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@exodus/rive-react-native 的下载量有多少?

根据 npm 官方下载统计,@exodus/rive-react-native 在 2026/10/14 – 2026/11/12 这 30 天内被下载 10,687 次,日均约 356 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@exodus/rive-react-native 还在维护吗?

最新版本 9.8.2-exodus.1 发布于 2026/04/27(6 个月前);至今共发布 11 个版本,其中过去 12 个月发布了 3 个;首次发布于 2025/09/03。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。