从 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 运行时文档 来帮助你决定项目需要哪个运行时包。
我们改变了包模型以选择使用哪个渲染器(即 CanvasRenderingContext2D 或 WebGL),这会影响包大小和性能。此外,所有新的 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 运行时新包输出。