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 等能力

更多渲染策略：

• Choose a Renderer

快速体验

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）：本机构建需要额外工具链支持。