常见问题（FAQ）

Flutter 构建失败时先看哪里？

优先查看：

• Flutter 运行时排障
• Rive Native 排障
• 构建 rive_native
• 迁移指南

常见原因是版本不匹配、原生产物缓存脏、或跳过原生 setup。

flutter clean
flutter pub get
flutter run

如原生库未下载，执行：

dart run rive_native:setup --verbose --clean --platform <platform>

<platform> 可为 android / ios / macos 等，支持逗号分隔多平台。

LateInitializationError: Field 'makeFlutterFactory' has not been initialized

通常是因为在渲染 Rive 前没有调用 RiveNative.init()。

import 'package:flutter/widgets.dart';
import 'package:rive/rive.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await RiveNative.init();
  runApp(const MyApp());
}

Android 如何启用 16KB Page 支持？

• 0.14.x：默认已支持
• 0.13.x：需在 gradle.properties 设置：

rive.ndk.version=28.1.13356709

参考：

• rive-flutter issue #479