跨平台开发 / 系统课时
安装 flutter_riverpod 依赖
安装 flutter_riverpod 依赖
这一节把 flutter_riverpod 加入现有 Flutter 项目,并用依赖列表和实际启动结果完成验证。完成后,项目已经具备使用 Riverpod API 的条件,同时能确认新增依赖没有破坏原有构建环境。
学习目标
- 使用 Flutter 的 pub 命令添加
flutter_riverpod依赖 - 确认依赖已经被正确解析并写入项目
- 通过运行应用排除依赖接入后的基础构建问题
前置检查
先进入 Flutter 项目根目录,也就是存在 pubspec.yaml 的目录,并确认 Flutter 命令能够正常执行。
flutter --version预期输出
Flutter <VERSION> • channel <CHANNEL> • ...
Dart <VERSION> • ...<VERSION> 和 <CHANNEL> 会随本机 Flutter SDK 而变化。若这里直接提示找不到 flutter 命令,应先修复 Flutter SDK 与 PATH,而不是继续排查 Riverpod。
添加 Riverpod 依赖
在 Flutter 项目中应安装 flutter_riverpod,而不是只添加底层的 riverpod 包。最简单的方式是让 pub 根据当前 SDK 和已有依赖选择兼容版本。
flutter pub add flutter_riverpod
flutter pub deps --style=list预期输出(依赖列表节选)
flutter_riverpod <VERSION>实际版本号可能不同。执行 flutter pub add 后,pubspec.yaml 的 dependencies 中会出现对应声明,同时 pub 会完成依赖解析,因此通常不需要再单独执行一次 flutter pub get。
pubspec.yaml 中最终会包含类似配置:
dependencies:
flutter:
sdk: flutter
flutter_riverpod: ^<VERSION>这里的 <VERSION> 表示由当前依赖解析结果确定的实际版本,不要把占位符原样写入项目。如果团队已经锁定 Riverpod 版本,应遵循项目既有版本策略,而不是随意改成其他约束。
验证项目仍可运行
依赖成功下载并不等于项目一定能构建。选择一个已经配置好的模拟器或真机,从项目根目录启动现有应用:
flutter run预期结果
应用完成构建并在 <DEVICE> 上启动;终端进入 Flutter 调试会话。<DEVICE> 代表实际设备名称。此时应用界面可以仍然是安装 Riverpod 前的内容,因为这一节只完成依赖接入;只要没有新增的依赖解析、编译或启动错误,就说明基础环境可继续使用。
失败时先检查什么
如果 flutter pub add 报依赖求解失败,先阅读错误中指出的 SDK 或包版本约束。不要通过删除 pubspec.lock 反复碰运气;已有项目可能依赖锁定版本来保证团队构建一致。
如果依赖已经解析,但 flutter run 在原有代码中失败,应区分错误是否由本次修改引入。安装阶段通常只改变 pubspec.yaml 和依赖锁定信息,还没有要求业务代码调用 Riverpod API。确认项目能够正常启动后,就可以在应用根节点接入 ProviderScope。