跳到主要内容

Rive Native（Flutter）

Rive Native 与 Rive 的关系​

  • rive_native：Flutter 插件，负责桥接 C++ Runtime 与 Flutter
  • rive：上层易用 API，内部依赖 rive_native

建议业务侧直接依赖 rive，通常会更省心。

说明（Note）：rive_native 替代了旧的 rive_common。

能力摘要​

  • 基于 C++ Runtime（FFI）
  • 支持 Rive Renderer
  • 带来 Data Binding / Layout / Scrolling / N-Slicing / Vector Feathering 等能力

更多渲染策略：

快速体验​

dart pub unpack rive_native
cd rive_native/example
flutter create .
flutter pub get
flutter run

平台支持​

  • iOS：Flutter Renderer ✅ / Rive Renderer ✅
  • Android：✅ / ✅
  • macOS：✅ / ✅
  • Windows：✅ / ✅
  • Linux：❌ / ❌
  • Web：✅ / ✅

排障（Troubleshooting）​

原生库通常会在 flutter run 或 flutter build 时自动下载。

若失败：

flutter clean
flutter pub get
flutter run

也可手动 setup：

dart run rive_native:setup --verbose --clean --platform macos

Android 特殊说明​

若自动 setup 失败，可在 gradle.properties 设置：

rive.native.skipSetup=true

然后手动执行：

dart run rive_native:setup --verbose --clean --platform android

构建 rive_native​

默认下载预构建库；如需本机构建：

flutter clean
dart run rive_native:setup --verbose --clean --build --platform macos

注意（Note）：本机构建需要额外工具链支持。