pd_load_state 0.3.0

Flutter plugin for request load states (loading/error/empty/success) with enhanced UI, multi-platform support and generic data carrying.

更新日志

本文档记录了 pd_load_state 插件的所有重要更改。

格式基于 Keep a Changelog， 并且本项目遵循 语义化版本。

0.3.0 - 2026-07-03

🎯 新增功能 New Features

• 📦 泛型数据携带 - PDLoadState<T> 支持泛型数据携带，成功状态时可传递强类型数据
• 🔧 双 Builder 设计 - 新增 dataBuilder 参数，支持带数据的成功视图构建，完全向后兼容旧 API
• 🎨 抽象基类重构 - 新增 PDLoadStateBase 抽象基类，PDLoadState<T> 继承自基类，支持 Stream 广播
• 📝 类型定义扩展 - 新增 PDDataWidgetBuilder<T> 类型定义，支持带数据的视图构建器
• ⚡ typedef 便捷别名 - 新增 PDLoadStateVoid 作为 PDLoadState<void> 的便捷别名

🔧 改进优化 Improvements

• 📖 API 文档更新 - 更新所有公共 API 的文档注释，包含泛型数据携带的使用说明
• 🎯 示例项目增强 - 新增 DataDemoPage 演示页面，展示单条数据和集合数据的携带用法
• 🔄 Stream 类型优化 - _LoadStateManager 的 Stream 使用 PDLoadStateBase 类型，兼容泛型子类
• 📊 代码结构优化 - 重构状态管理架构，支持泛型扩展和类型安全

📖 向后兼容性 Backward Compatibility

• ✅ 完全兼容 - 旧 API builder: (context) => ... 无需修改即可继续使用
• ✅ 无缝升级 - 新增 dataBuilder 为可选参数，用户可选择性使用新功能
• ✅ 类型推断 - 未指定泛型时自动推断为 dynamic，保持旧代码兼容性

📦 示例项目更新 Example Project

• 🚀 数据携带演示 - 新增 data_demo.dart，演示单条数据和集合数据的携带用法
• 🎮 导航入口 - 在主页面添加数据携带演示的导航按钮

0.2.5 - 2026-06-17

🔧 改进优化 Improvements

• 🏷️ 命名规范统一 - 将 PdLoadStateConfigure 重命名为 PDLoadStateConfigure，统一所有类的前缀为 PD
• ✨ 代码一致性 - 提升代码可读性和用户体验，避免用户混淆 PD 和 Pd 前缀

0.2.4 - 2026-06-17

🔧 改进优化 Improvements

• 📝 文档注释完善 - 为所有公共 API 添加完整的 dartdoc 注释，文档覆盖率达 98.7%
• 🧪 测试工具类 - 新增 PDLoadStateTestUtils 公开测试工具类，支持测试时资源释放和状态重置
• 🎯 枚举扩展 - 为 PDLoadStateEnum 添加便捷的扩展方法（description、isLoading、isSuccess 等）
• 📚 API 文档优化 - 完善所有类、方法、属性的文档注释，提升 pana 评分

0.2.3 - 2026-06-17

🔧 改进优化 Improvements

• ⚡ 状态管理器优化 - 引入全局懒加载管理器 _LoadStateManager，支持 StreamController 自动清理机制
• 🧹 内存管理改进 - 优化全局 Stream 生命周期管理，避免潜在内存泄漏风险
• 🏗️ 代码结构优化 - 将状态管理器独立为单独文件 pd_load_state_manager.dart，提升代码可维护性
• ✨ 测试友好性 - 提供 dispose() 方法支持测试时状态重置

0.2.2 - 2026-06-08

🔧 改进优化 Improvements

• ⚡ 刷新逻辑优化 - 优化 _update 状态更新逻辑，避免特定场景下重复触发导致两次 rebuild

0.2.1 - 2025-08-26

📝 文档更新 Documentation Updates

• 📖 说明文档优化 - 更新和完善了项目说明文档
• 🔧 版本信息同步 - 同步更新了版本相关信息

0.2.0

🎨 新增功能 New Features

• ✨ 增强版UI设计 - 添加了现代化的加载动画、优雅的渐变效果和流畅的状态转换
• 🎬 动画效果 - 支持旋转加载动画、脉动错误提示、渐变状态切换等丰富的视觉效果
• 📱 多平台支持 - 完整支持 Android、iOS、Web、macOS、Windows、Linux 平台
• 🎯 平台演示 - 新增平台特定功能演示页面，展示不同平台的优化特性
• 📊 SVG演示图 - 创建了动画SVG文件，直观展示插件的各种状态效果

🔧 改进优化 Improvements

• 📝 文档完善 - 添加了增强版UI使用指南和完整的示例项目说明
• 🏗️ 代码结构 - 重构了组件架构，分离了默认UI和增强版UI组件
• 🎛️ 配置选项 - 新增 useEnhancedUI 配置项，支持一键启用增强版设计
• 🔄 状态管理 - 优化了状态切换逻辑，提供更流畅的用户体验

📦 示例项目 Example Project

• 🚀 完整示例 - 创建了包含移动端和桌面端的完整Flutter示例项目
• 🎮 交互演示 - 支持随机状态演示、固定状态切换和自定义UI展示
• 📖 使用指南 - 提供了详细的快速开始指南和最佳实践

0.1.4

• 一些参数校验、命名等优化.

0.1.3

• 修改软件许可协议, 使用标准 MIT 许可。

0.1.2

• 修复 pub.dev 能够链接到的资源，从而提高项目的透明度和可访问性。

0.1.1

• 修复文档链接.

0.1.0

• 修改了软件许可协议, 符合 MIT 许可协议的标准规范.

0.0.8

• 修复文档链接.

0.0.7

• 针对PDLoadStateLayout对象添加一些debug调试信息.

0.0.6

• 修复了PdLoadStateConfigure类中的加载中视图loadingWidgetBuilder无法正常使用的问题.

0.0.5

• 撤回了0.0.4版本中的更改, 重新添加了PDLoadStateLayout类中的padding、width、height等属性.

0.0.4

• 修复PdLoadStateConfigure类中的全局状态视图问题.
• 在README文件中添加了更多使用说明.
• 去除了PDLoadStateLayout类中的padding、width、height等属性, 交给其父组件处理.

0.0.3

• 修复了在 pd_load_state_configure.dart 文件中的命名重复问题.

0.0.2

• 修复了在 pd_load_state_widget.dart 文件中的警告问题.
• 添加了远程库地址.

0.0.1

• 包的第一个测试版本.