跳到正文
教程首页
FlutterCH 11ch11_state_management

ch11-state-management

状态管理:从 setState 到 InheritedWidget 再到 Riverpod。完整工程共 105 个文件,其中 65 个文本源文件可在下面在线阅读。

65

在线文本文件

4,024

源码行数

dart / c / yaml

语言

284 KB

打包体积

在线阅读源码

左侧按目录浏览,点击文件切换。右上角可复制代码、复制路径或单独下载文件。在线视图只覆盖文本源码,完整工程请下载 zip。

textxmldartjsonkotlin

65 text files · 4,024 lines

dartlib/providers.dart
/// Riverpod 的核心:把状态从 Widget 树里拿出来,放进一个**容器**(ProviderContainer)。
///
/// 三个概念够用一整本书的 80%:
///   Provider      —— 只读/派生值(相当于"自动缓存的 getter")
///   Notifier      —— 可写状态 + 方法(相当于"带通知的模型")
///   ref.watch     —— 订阅(值变了就重建);ref.read —— 只读一次(事件里用)
///
/// 对照 ch11 的 ChangeNotifier:Riverpod 的 provider 全局可访问、可覆盖、可组合,
/// 而且不需要 BuildContext 就能读到状态。
library;

import 'package:flutter_riverpod/flutter_riverpod.dart';

import 'src/cart_item.dart';

/// 购物车状态。
class CartNotifier extends Notifier<List<CartItem>> {
  /// `build()` 返回初始状态。provider 被销毁时,这里返回的对象也会被丢弃。
  @override
  List<CartItem> build() => const <CartItem>[];

  /// 不可变更新:新建列表再赋给 state —— Riverpod 靠 `identical` 判断"是否变化"。
  void add(CartItem item) {
    // 同一个商品再加一次 → 数量 +1(演示 copyWith 与不可变更新)
    final int index = state.indexWhere((CartItem i) => i.sku == item.sku);
    if (index >= 0) {
      state = <CartItem>[
        for (var i = 0; i < state.length; i++)
          if (i == index) state[i].copyWith(quantity: state[i].quantity + 1) else state[i],
      ];
    } else {
      state = <CartItem>[...state, item];
    }
  }

  void removeAt(int index) =>
      state = <CartItem>[...state]..removeAt(index);

  void clear() => state = const <CartItem>[];
}

/// 全局唯一的购物车。任何 widget、任何页面,`ref.watch(cartProvider)` 都拿到同一份。
final NotifierProvider<CartNotifier, List<CartItem>> cartProvider =
    NotifierProvider<CartNotifier, List<CartItem>>(CartNotifier.new);

/// 派生状态:自动随 cartProvider 重算,且只在依赖变化时重算。
/// 这就是"把业务计算放进 provider"的好处——UI 只管显示。
final Provider<int> cartTotalProvider = Provider<int>((Ref ref) {
  final List<CartItem> items = ref.watch(cartProvider);
  return items.fold(0, (int sum, CartItem i) => sum + i.subtotalCents);
});

/// 带参数的 provider(family):按 sku 查某个商品的数量。
/// 每个参数组合都是独立的缓存槽位。
final quantityProvider = Provider.family<int, String>((Ref ref, String sku) {
  final List<CartItem> items = ref.watch(cartProvider);
  return items
      .where((CartItem i) => i.sku == sku)
      .fold(0, (int sum, CartItem i) => sum + i.quantity);
});

代码构成:text 62 KB · xml 41 KB · dart 29 KB · json 4 KB

本地运行

zip → 解压 → 执行
$cd examples/ch11-state-management && flutter run -d macos

这个 zip 里有什么

  • • 完整工程目录(含 Android / iOS / 桌面平台脚手架)
  • • lib / bin / test / native 全部源码与测试
  • • pubspec.yaml、锁文件与平台配置文件
  • • 已排除 .dart_tool / build / target / ephemeral 等构建产物

已验证

  • flutter analyze 0 告警、flutter test 11 个用例全绿、flutter build macos --debug 真实构建并启动成功
查看全部示例