# @exodus/rive-react-native 中文文档

规范地址：https://npmcn.com/package/%40exodus/rive-react-native/

版本：9\.8\.2-exodus\.1
npm 元数据更新时间：2026-10-06T21:03:21.017Z
中文译文更新时间：2026-11-14T04:13:48.789Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40exodus/rive-react-native
原文对照：https://npmcn.com/package/%40exodus/rive-react-native/?lang=original
项目主页：https://github.com/rive-app/rive-react-native#readme
源码仓库：https://github.com/rive-app/rive-react-native

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：420 kB，81 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=16
- 运行依赖：0 个
- peer 依赖：react \*，react-native \*
- 首次发布：2025-09-03T07:13:49.479Z
- 最新版本发布：2026-04-27T15:16:30.928Z
- 近 30 天下载量：10687（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 3 个）

## 中文简介

Rive 反应原生

## 安装

```sh
npm install @exodus/rive-react-native
```

也可以使用：`pnpm add @exodus/rive-react-native`、`yarn add @exodus/rive-react-native`、`bun add @exodus/rive-react-native`

## README

![Build Status](https://github.com/rive-app/rive-react-native/actions/workflows/typecheck-lint.yml/badge.svg) ![Discord badge](https://img.shields.io/discord/532365473602600965) ![Twitter handle](https://img.shields.io/twitter/follow/rive_app.svg?style=social&label=Follow)

# Rive 反应原生

![Rive hero image](https://cdn.rive.app/rive_logo_dark_bg.png)

> **新运行时间可用 !**
> 
> 新的 Rive React Industrial 运行时间现已可用. 与硝基相建,以提高性能并更好地反应原生融合.
> 
> **现在试试:**
> 
> -   [GitHub 图像](https://github.com/rive-app/rive-nitro-react-native)
> -   [国家预防机制](https://www.npmjs.com/package/@rive-app/react-native)
> 
> 我们正在积极收集反馈,以改善新的运行时间. 请分享你的想法,报告你遇到的任何问题.
> 
> **迁移时间线:**
> 
> -   **短期:** 完成新的运行时间, 看 [特性支持](https://github.com/rive-app/rive-nitro-react-native?tab=readme-ov-file#feature-support) 财务报告和审定财务报表 [路线图](https://github.com/rive-app/rive-nitro-react-native?tab=readme-ov-file#roadmap)
> -   **中期:** 在支持移徙的同时,处理这一遗产包中的主要关切问题
> -   **长期:** 完全迁移到新软件包

React 本地运行时库 [纵横](https://rive.app/)。 。 。 .

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

## 目录

-   星号: [Rive 概览](https://npmcn.com/package/%40exodus/rive-react-native/#readme-rive-overview)
-   🚀 [正在获取 & API 文件](https://npmcn.com/package/%40exodus/rive-react-native/#readme-getting-started)
-   : mag : (中文(简体) ) [支持的设备](https://npmcn.com/package/%40exodus/rive-react-native/#readme-supported-devices)
-   :书: [实例](https://npmcn.com/package/%40exodus/rive-react-native/#readme-examples)
-   🏃 [移徙指南](https://npmcn.com/package/%40exodus/rive-react-native/#readme-migration-guides)
-   👨‍💻 [捐款](https://npmcn.com/package/%40exodus/rive-react-native/#readme-contributing)
-   问: [问题](https://npmcn.com/package/%40exodus/rive-react-native/#readme-issues)
-   :扳手: [原生 SDK 版本自定义](https://npmcn.com/package/%40exodus/rive-react-native/#readme-native-sdk-version-customization)

## Rive 概览

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

: 有花园的房屋: [主页](https://rive.app/)

:蓝色 书: [一般帮助文件](https://help.rive.app/)

🛠 [里夫建筑资源](https://rive.app/resources/)

## 开始

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

[以 Rive 启动本地反应](https://help.rive.app/runtimes/overview/react-native)

[API 文档](https://help.rive.app/runtimes/overview/react-native/props)

## 支持的设备

因为这个运行时的图书馆依赖 [旋转Android](https://github.com/rive-app/rive-android) 财务报告和审定财务报表 [运行iOS](https://github.com/rive-app/rive-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` 要安装或更新运行时间的文件夹

## 移徙指南

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

[移徙指南](https://help.rive.app/runtimes/overview/react-native/migrating-from-v3-to-v4)

## 捐款

我们爱贡献! 看看我们 [提供文件](https://npmcn.com/package/%40exodus/rive-react-native/CONTRIBUTING.md) 获得更多细节 如何运行这个项目, 实例, 更多的地方.

## 问题

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

## 原生 SDK 版本自定义

> **高级配置** 本节针对需要使用Rive本土SDK的特定版本的高级用户. 在大多数情况下,您应该使用随库而来的默认版本. 只有当您有特定的要求并理解潜在的相容性影响时,才会自定义这些版本.
> 
> **重要内容:** 如果您自定义了本地的 SDK 版本并随后更新 `rive-react-native` 到更新版本时,您应当重温您的自定义版本设置。 您指定的自定义版本可能与更新版本不兼容 `rive-react-native` 版本。 总是在新发行中检查默认版本并彻底测试.

### 默认行为

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

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

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

### 自定义版本

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

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

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

```json
{
  "RiveRuntimeIOSVersion": "6.18.2"
}
```

然后运行 :

```bash
cd ios && pod install
```

#### Android (瓦尼拉反应原生)

添加为 `android/gradle.properties`数字 :

```properties
Rive_RiveRuntimeAndroidVersion=11.4.0
```

#### 博览项目

对于 Expo 项目,请在您的配置插件中使用 `app.config.ts`数字 :

```typescript
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 是什么？

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 和提交记录判断。