跨平台开发 / 系统课时

定义第一个 Provider

定义第一个 Provider

Provider 是 Riverpod 中最基础的状态入口。本节用一个同步字符串作为共享值,完成 Provider 的定义、应用根节点接入与页面读取,并明确它适合承载什么、不适合承载什么。

学习目标

  • 能使用 Provider<T> 定义一个同步只读值
  • 理解 Provider 回调中的 ref 与对外暴露值的关系
  • 能在 Flutter 页面中读取并验证 Provider 的结果

Provider 负责暴露什么

Provider 用来描述“如何得到一个值”。页面和其他 Provider 只通过 Provider 读取结果,不直接依赖值的创建细节。它适合配置对象、服务实例、同步计算结果,以及不需要由界面直接修改的共享值。

Provider 通常定义在类外部并保存为顶层 final 变量。这样它拥有稳定身份,也方便多个页面、其他 Provider 和测试代码复用。

dart
final appMessageProvider = Provider<String>((ref) {
  return 'Hello Riverpod';
});

这里的 Provider<String> 表示它对外提供 String。回调参数 ref 用于访问其他 Provider 或监听生命周期;当前示例不依赖其他状态,所以只返回固定字符串。

完成一个可运行示例

下面的程序在应用根节点放置 ProviderScope,再通过 Consumer 读取 appMessageProvider。ProviderScope 是 Provider 状态容器进入 Flutter Widget 树的入口,缺少它时页面无法正常读取 Riverpod 状态。

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

final appMessageProvider = Provider<String>((ref) {
  // 页面只依赖 Provider,不需要知道字符串如何创建。
  return 'Hello Riverpod';
});

void main() {
  runApp(
    const ProviderScope(
      child: MyApp(),
    ),
  );
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: Center(
          child: Consumer(
            builder: (context, ref, child) {
              final message = ref.watch(appMessageProvider);
              return Text(message);
            },
          ),
        ),
      ),
    );
  }
}

预期结果

text
应用启动后,页面中央显示:
Hello Riverpod

实际设备的窗口尺寸、字体和系统样式可能不同,但文本内容应一致。

为什么这里使用 watch

ref.watch(appMessageProvider) 会读取当前值,并让当前 Consumer 建立对这个 Provider 的依赖。Provider 的值以后如果因为依赖变化或被重新计算而改变,相关消费区域会重新构建。

如果只是临时取一次值,Riverpod 还提供 ref.read。但在 build 中展示状态时,优先使用 watch,否则界面可能不会随着状态变化更新。

只读 Provider 的边界

Provider 暴露的是一个值,没有供界面直接赋值的入口,因此适合“读取”而不是“修改”。例如应用名称、格式化器、Repository、同步派生值都很合适。

如果状态需要响应按钮点击、表单输入或业务动作持续变化,应把修改逻辑放到 NotifierProvider 等可变状态方案中,而不是尝试给普通 Provider 赋值。先把稳定的共享读取入口定义清楚,后续状态组合和测试也会更容易。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

定义第一个 Provider

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通