Skip to content

DEPENDENCIES.md

Latest commit

 

History

History
138 lines (104 loc) · 2.98 KB

DEPENDENCIES.md

File metadata and controls

138 lines (104 loc) · 2.98 KB
Raw

项目依赖说明

核心依赖

provider ^6.1.1

  • 用途: 状态管理
  • 说明: 用于管理应用的全局状态，包括配置、商品、订单等数据
  • 替代方案: Riverpod, Bloc, GetX

dio ^5.4.0

  • 用途: HTTP网络请求
  • 说明: 封装WooCommerce REST API调用
  • 特性: 支持拦截器、超时设置、错误处理

hive ^2.2.3 & hive_flutter ^1.1.0

  • 用途: 本地数据库
  • 说明: 存储商品缓存、扫描记录等数据
  • 优势: 轻量级、高性能、无需原生代码

shared_preferences ^2.2.2

  • 用途: 简单键值对存储
  • 说明: 存储应用配置、用户偏好等
  • 替代方案: Hive也可以完成类似功能

功能依赖

mobile_scanner ^4.0.1

  • 用途: 条码扫描
  • 说明: 调用摄像头扫描商品条码
  • 特性: 支持多种条码格式 (QR, EAN, UPC等)

cached_network_image ^3.3.0

  • 用途: 图片缓存
  • 说明: 缓存商品图片，提升加载速度
  • 特性: 自动管理内存和磁盘缓存

connectivity_plus ^5.0.2

  • 用途: 网络状态检测
  • 说明: 检测网络连接状态，实现离线模式
  • 替代方案: data_connection_checker

permission_handler ^11.1.0

  • 用途: 权限管理
  • 说明: 请求摄像头、存储等权限
  • 特性: 跨平台支持

UI依赖

flutter_svg ^2.0.9

  • 用途: SVG矢量图
  • 说明: 支持SVG图标和图片
  • 替代方案: 直接使用PNG图片

开发依赖

build_runner ^2.4.7

  • 用途: 代码生成工具
  • 说明: 生成Hive适配器、JSON序列化代码

hive_generator ^2.0.1

  • 用途: Hive代码生成
  • 说明: 自动生成Hive类型适配器

json_serializable ^6.7.1

  • 用途: JSON序列化生成
  • 说明: 自动生成fromJson/toJson方法

flutter_lints ^3.0.1

  • 用途: 代码检查
  • 说明: 提供代码风格和质量检查

依赖更新指南

更新所有依赖

flutter pub upgrade

更新特定依赖

flutter pub upgrade provider

查看过期依赖

flutter pub outdated

依赖移除

如果需要移除某个依赖:

flutter pub remove package_name

版本兼容性

当前项目要求:

  • Flutter SDK: >=3.0.0 <4.0.0
  • Dart SDK: >=3.0.0 <4.0.0

依赖已针对Flutter 3.x进行测试。

安全性建议

  1. 定期更新依赖: 检查安全漏洞
flutter pub upgrade --major-versions
  1. 使用固定版本: 生产环境使用固定版本号
dependencies:
  provider: 6.1.1  # 不使用^符号
  1. 审计依赖: 检查依赖的依赖
flutter pub deps

常见依赖问题

问题1: 版本冲突

解决方案:

  • 使用 dependency_overrides 覆盖版本
  • 或降级冲突的包版本

问题2: 缓存问题

解决方案:

flutter pub cache repair
flutter clean
flutter pub get

问题3: 平台兼容性

解决方案: 查看依赖文档确认平台支持情况