跨平台开发 / 系统课时

安装 flutter_riverpod 依赖

安装 flutter_riverpod 依赖

这一节把 flutter_riverpod 加入现有 Flutter 项目,并用依赖列表和实际启动结果完成验证。完成后,项目已经具备使用 Riverpod API 的条件,同时能确认新增依赖没有破坏原有构建环境。

学习目标

  • 使用 Flutter 的 pub 命令添加 flutter_riverpod 依赖
  • 确认依赖已经被正确解析并写入项目
  • 通过运行应用排除依赖接入后的基础构建问题

前置检查

先进入 Flutter 项目根目录,也就是存在 pubspec.yaml 的目录,并确认 Flutter 命令能够正常执行。

bash
flutter --version

预期输出

text
Flutter <VERSION> • channel <CHANNEL> • ...
Dart <VERSION> • ...

<VERSION> 和 <CHANNEL> 会随本机 Flutter SDK 而变化。若这里直接提示找不到 flutter 命令,应先修复 Flutter SDK 与 PATH,而不是继续排查 Riverpod。

添加 Riverpod 依赖

在 Flutter 项目中应安装 flutter_riverpod,而不是只添加底层的 riverpod 包。最简单的方式是让 pub 根据当前 SDK 和已有依赖选择兼容版本。

bash
flutter pub add flutter_riverpod
flutter pub deps --style=list

预期输出(依赖列表节选)

text
flutter_riverpod <VERSION>

实际版本号可能不同。执行 flutter pub add 后,pubspec.yaml 的 dependencies 中会出现对应声明,同时 pub 会完成依赖解析,因此通常不需要再单独执行一次 flutter pub get。

pubspec.yaml 中最终会包含类似配置:

yaml
dependencies:
  flutter:
    sdk: flutter
  flutter_riverpod: ^<VERSION>

这里的 <VERSION> 表示由当前依赖解析结果确定的实际版本,不要把占位符原样写入项目。如果团队已经锁定 Riverpod 版本,应遵循项目既有版本策略,而不是随意改成其他约束。

验证项目仍可运行

依赖成功下载并不等于项目一定能构建。选择一个已经配置好的模拟器或真机,从项目根目录启动现有应用:

bash
flutter run

预期结果

text
应用完成构建并在 <DEVICE> 上启动;终端进入 Flutter 调试会话。

<DEVICE> 代表实际设备名称。此时应用界面可以仍然是安装 Riverpod 前的内容,因为这一节只完成依赖接入;只要没有新增的依赖解析、编译或启动错误,就说明基础环境可继续使用。

失败时先检查什么

如果 flutter pub add 报依赖求解失败,先阅读错误中指出的 SDK 或包版本约束。不要通过删除 pubspec.lock 反复碰运气;已有项目可能依赖锁定版本来保证团队构建一致。

如果依赖已经解析,但 flutter run 在原有代码中失败,应区分错误是否由本次修改引入。安装阶段通常只改变 pubspec.yaml 和依赖锁定信息,还没有要求业务代码调用 Riverpod API。确认项目能够正常启动后,就可以在应用根节点接入 ProviderScope。

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

目录与阅读设置

阅读设置

17

记录一个想法

安装 flutter_riverpod 依赖

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

登录哪都通