欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.csdn.net。

前言

在鸿蒙（OpenHarmony）中大型项目中，开发者常在 Bloc 的严谨性与 Riverpod 的灵活性之间权衡。riverbloc 作为桥接库，允许将 Bloc 作为 Provider 管理，兼具了事件溯源与全局依赖注入的优势，是构建可维护业务中枢的理想选择。

一、核心价值

1.1 基础概念

riverbloc 引入了 BlocProvider 系列函数，使 Bloc 融入 Riverpod 的依赖树。

1.2 进阶概念

• State Sync (状态同步)：Riverpod 会自动监听 Bloc 的状态流，并将最新状态同步给订阅的 Widget，无需显式的 BlocBuilder。
• Scoped Injection：利用 Riverpod 轻松在鸿蒙应用的不同层级注入特定的 Bloc 实例。

二、核心 API / 组件详解

2.1 创建 Bloc 并定义 Provider

在鸿蒙工程中，先写好经典的 Cubit：

import 'package:riverbloc/riverbloc.dart';

// 1. 定义基础的 Cubit
class CounterCubit extends Cubit<int> {
  CounterCubit() : super(0);
  void increment() => emit(state + 1);
}

// 2. ✅ 重点：将其包装为 Riverpod Provider
final counterProvider = BlocProvider((ref) => CounterCubit());

2.2 在 UI 中通过 Provider 操作 Bloc

void onAction(WidgetRef ref) {
  // 💡 获取 Bloc 实例执行逻辑
  ref.read(counterProvider.notifier).increment();
}

三、场景示例

3.1 场景一：鸿蒙级应用的“多模块复合”状态

当一张复杂的订单页面需要同时引用“用户信息 Bloc”和“商品明细 Bloc”动态计算总价时。

final totalPriceProvider = Provider((ref) {
  // 💡 技巧：利用 Riverpod 的 ref.watch 聚合多个 Bloc 的状态
  final userOrder = ref.watch(orderBlocProvider);
  final discount = ref.watch(couponBlocProvider);
  
  return userOrder.total - discount.value;
});

四、OpenHarmony 平台适配挑战

4.1 内存自动释放与单例膨胀

Bloc 往往包含大量的业务缓冲区。如果在一个鸿蒙长生命周期的应用中无节制使用。

✅ 适配策略建议：

1. Auto-Dispose：riverbloc 支持 BlocProvider.autoDispose。当鸿蒙页面销毁后，Bloc 实例也会自动执行 close()，防止内存泄露。
2. Provider Scope 隔离：在鸿蒙的分屏（Multi-Window）或特定 Tab 页面下，利用 ProviderScope 的覆盖能力为不同的小窗口提供独立的业务 Bloc。

五、综合实战示例代码

这是一个包含了“自动增量”逻辑的鸿蒙业务计算器：

import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:riverbloc/riverbloc.dart';

// 1. 定义业务逻辑
class ThemeCubit extends Cubit<Color> {
  ThemeCubit() : super(Colors.blue);
  void toggle() => emit(state == Colors.blue ? Colors.orange : Colors.blue);
}

// 2. 注入 Provider
final themeBlocProvider = BlocProvider((ref) => ThemeCubit());

class HarmonyApp extends ConsumerWidget {
  const HarmonyApp({super.key});

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    // 💡 监听状态变化：直接像 Riverpod 一样使用 watch
    final currentColor = ref.watch(themeBlocProvider);

    return Scaffold(
      appBar: AppBar(backgroundColor: currentColor, title: const Text('Riverbloc 鸿蒙架构实战')),
      body: Center(
        child: ElevatedButton(
          onPressed: () => ref.read(themeBlocProvider.notifier).toggle(),
          child: const Text('点击切换 Bloc 状态（Riverpod 观察）'),
        ),
      ),
    );
  }
}

六、总结

riverbloc 满足了鸿蒙开发者对“严谨性”和“灵活性”的双重追求。它让复杂的 BLoC 设计模式能在 Riverpod 及其便捷的 DI 环境中重获新生。

✅ 核心建议：

1. 涉及核心财务、交易等需要严密审计的逻辑，用 Bloc 编写并用 riverbloc 注入。
2. 每一个 Bloc 业务块都尽量开启 autoDispose。

📦 更多的底层指导代码可进入：AtomGit 示例专栏

---

欢迎加入开源鸿蒙跨平台社区：开源鸿蒙跨平台开发者社区