跳到主要内容

从 rive.js 迁移

rive-js 包的迁移指南

之前,web 运行时会部署到 npm 上的 rive-js 包。我们已经从这个单包模型转移到了一个基于你的 API/渲染级别需求的多包模型中。

  • @rive-app/webgl
  • @rive-app/webgl-advanced
  • @rive-app/canvas
  • @rive-app/canvas-advanced

除了这些新包之外,上述每个包都有一个 *-single 版本,其中 WASM 被编码在 JS 中。查看 web 运行时文档 来帮助你决定项目需要哪个运行时包。

我们改变了包模型以选择使用哪个渲染器(即 CanvasRenderingContext2DWebGL),这会影响包大小和性能。此外,所有新的 web 运行时包都将支持最新的 Rive 功能,如光栅资源。

在任何情况下,就使用 rive 实例而言,不需要对高级 API 的使用方式做任何改变。你只需要更改项目中安装的包和相应的导入位置。

例如,不再使用以下集成方式:

npm i rive-js
import rive from 'rive-js';

const foo = new rive.Rive({
src: "https://cdn.rive.app/animations/vehicles.riv",
});

你可以替换为:

npm i @rive-app/canvas 
import {Rive} from '@rive-app/canvas';

const foo = new Rive({
src: "https://cdn.rive.app/animations/vehicles.riv",
});

或者,你可以根据需要将 @rive-app/canvas 替换为任何适合你的 web 运行时新包输出。