跨平台开发 / 系统课时
定义第一个 Provider
定义第一个 Provider
Provider 是 Riverpod 中最基础的状态入口。本节用一个同步字符串作为共享值,完成 Provider 的定义、应用根节点接入与页面读取,并明确它适合承载什么、不适合承载什么。
学习目标
- 能使用
Provider<T>定义一个同步只读值 - 理解 Provider 回调中的
ref与对外暴露值的关系 - 能在 Flutter 页面中读取并验证 Provider 的结果
Provider 负责暴露什么
Provider 用来描述“如何得到一个值”。页面和其他 Provider 只通过 Provider 读取结果,不直接依赖值的创建细节。它适合配置对象、服务实例、同步计算结果,以及不需要由界面直接修改的共享值。
Provider 通常定义在类外部并保存为顶层 final 变量。这样它拥有稳定身份,也方便多个页面、其他 Provider 和测试代码复用。
final appMessageProvider = Provider<String>((ref) {
return 'Hello Riverpod';
});这里的 Provider<String> 表示它对外提供 String。回调参数 ref 用于访问其他 Provider 或监听生命周期;当前示例不依赖其他状态,所以只返回固定字符串。
完成一个可运行示例
下面的程序在应用根节点放置 ProviderScope,再通过 Consumer 读取 appMessageProvider。ProviderScope 是 Provider 状态容器进入 Flutter Widget 树的入口,缺少它时页面无法正常读取 Riverpod 状态。
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);
},
),
),
),
);
}
}预期结果
应用启动后,页面中央显示:
Hello Riverpod实际设备的窗口尺寸、字体和系统样式可能不同,但文本内容应一致。
为什么这里使用 watch
ref.watch(appMessageProvider) 会读取当前值,并让当前 Consumer 建立对这个 Provider 的依赖。Provider 的值以后如果因为依赖变化或被重新计算而改变,相关消费区域会重新构建。
如果只是临时取一次值,Riverpod 还提供 ref.read。但在 build 中展示状态时,优先使用 watch,否则界面可能不会随着状态变化更新。
只读 Provider 的边界
Provider 暴露的是一个值,没有供界面直接赋值的入口,因此适合“读取”而不是“修改”。例如应用名称、格式化器、Repository、同步派生值都很合适。
如果状态需要响应按钮点击、表单输入或业务动作持续变化,应把修改逻辑放到 NotifierProvider 等可变状态方案中,而不是尝试给普通 Provider 赋值。先把稳定的共享读取入口定义清楚,后续状态组合和测试也会更容易。