b5157c19f4
- 新增壁纸图库相关组件(WallpaperGalleryView/WallpaperSearchBar等) - 优化编辑器主题服务和系统UI管理 - 新增虚线边框和拖拽描边风格支持 - 完善今日诗词服务和阅读报告功能 - 修复多个UI问题和空指针异常 - 更新依赖库版本和SVG资源 - 优化交互动画和状态管理 - 补充文档和API测试脚本
8.5 KiB
8.5 KiB
📦 闲言APP — 三方库清单
更新: 2026-04-27 | 作用: 全部三方库选型与版本 + 跨平台标注 + 集成状态
一、核心框架层
| 库 | 版本 | 用途 | 平台 | 优先级 |
|---|---|---|---|---|
| flutter_riverpod | ^2.5.0 | 状态管理 + 依赖注入 | 全平台 | P0 |
| go_router | ^14.0.0 | 声明式路由 | 全平台 | P0 |
| dio | ^5.4.0 | 网络请求 | 全平台 | P0 |
| drift | ^2.16.0 | SQLite 数据库 | 全平台 | P0 |
| freezed | ^2.5.0 | 不可变数据模型 | 全平台 | P0 |
| json_serializable | ^6.8.0 | JSON 序列化 | 全平台 | P0 |
二、UI 设计系统层
iOS 26 Liquid Glass
| 库 | 版本 | 用途 | 平台 | 优先级 |
|---|---|---|---|---|
| liquid_glass_widgets | ^0.7.17 | 26个 Glass 组件 + Shader 渲染 | 全平台 | P0 |
| liquid_glass_easy | ^1.1.1 | 液态玻璃透镜特效 | 全平台 | P1 |
| stupid_simple_sheet | ^0.9.1+1 | iOS 26 Glass/Cupertino Sheet | 全平台 | P0 |
| heroine | ^0.7.2 | Hero 弹簧动画替代 | 全平台 | P0 |
动画与交互
| 库 | 版本 | 用途 | 平台 | 优先级 |
|---|---|---|---|---|
| flutter_animate | ^4.5.0 | 声明式动画 | 全平台 | P0 |
| lottie | ^3.3.0 | 空状态/庆祝矢量动画 | 全平台+WASM | P0 |
| confetti | ^0.8.0 | 点赞/创作完成撒花 | 全平台+WASM | P0 |
| animate_do | ^4.2.0 | 列表交错入场动画 | 全平台+WASM | P0 |
| custom_refresh_indicator | ^4.0.1 | 液态玻璃风格下拉刷新 | 全平台 | P0 |
| animations | ^2.0.11 | Material 转场动画 | 全平台 | P1 |
基础 UI 组件
| 库 | 版本 | 用途 | 平台 | 优先级 |
|---|---|---|---|---|
| google_fonts | ^6.2.0 | 字体加载管理 | 全平台 | P0 |
| cached_network_image | ^3.3.0 | 图片缓存加载 | 全平台 | P0 |
| shimmer | ^3.0.0 | 骨架屏 | 全平台 | P1 |
| flutter_svg | ^2.0.0 | SVG 渲染 | 全平台 | P1 |
| fl_chart | ^0.68.0 | 图表绘制 | 全平台 | P2 |
编辑器组件
| 库 | 版本 | 用途 | 平台 | 优先级 |
|---|---|---|---|---|
| pro_image_editor | ^4.1.2 | 专业图片编辑器 (Frosted Glass 主题) | 全平台 | P0 |
| flutter_quill | ^11.0 | 富文本编辑器 (Delta格式) | 全平台 | P0 |
| dotted_border | ^2.1 | 虚线边框 (拖拽描边) | 全平台 | P2 |
| image | ^4.1.0 | 图片底层处理 (缩放/裁剪/压缩/格式转换) | 全平台 | P0 |
| gal | ^2.3.0 | 保存图片到相册 (替代 image_gallery_saver) | 全平台 | P0 |
| flex_color_picker | ^3.0.0 | HSL色轮颜色选择器 | 全平台 | P1 |
| flutter_screenutil | ^5.9.0 | 屏幕适配 | 全平台 | P1 |
| flutter_shaders_ui | ^0.1.0 | GLSL Shader效果渲染 (模糊/发光/噪点) | 全平台 | P1 |
3D引擎
| 库 | 版本 | 用途 | 平台 | 优先级 | 状态 |
|---|---|---|---|---|---|
| flutter_3d_controller | ^1.3.0 | 3D模型交互预览 (WebView+model-viewer) | Android+iOS+Web | P0 | ✅ 已集成-3D贴纸+3D预览页 |
| flutter_scene | — | 3D GPU渲染 (Impeller) | macOS+iOS | P0 | ❌ v0.23.0已移除，统一flutter_3d_controller |
| device_info_plus | ^10.0.0 | 设备信息+低端设备检测 | 全平台 | P1 | ✅ 已集成-3D降级检测 |
图片处理
| 库 | 版本 | 用途 | 平台 | 优先级 | 状态 |
|---|---|---|---|---|---|
| image_size_getter | ^2.4.1 | 图片尺寸/格式检测 (读文件头) | 全平台 | P0 | ✅ 已集成-ImageInfoService |
| extended_image | ^10.0.1 | 增强图片组件+裁剪编辑器+内存优化 | 全平台 | P0 | ✅ 已集成-裁剪+大图优化 |
| photo_view | ^0.15.0 | 图片缩放查看器+画廊 | 全平台 | P0 | ✅ 已集成-全屏预览+画廊 |
| flutter_image_compress | ^2.4.0 | 原生图片压缩 (JPEG/WebP/PNG/HEIC) | 全平台 | P0 | ✅ 已集成-导出压缩+缩略图 |
编辑器说明: pro_image_editor 已重新集成 (v4.1.2)，采用 Frosted Glass 主题 + 自定义 ActionBar + WidgetLayer 扩展 (液态玻璃/Lottie/SVG/网络贴纸)。
三、平台能力层
存储与文件
| 库 | 版本 | 用途 | 平台 | 优先级 |
|---|---|---|---|---|
| shared_preferences | ^2.2.0 | 轻量 KV 存储 | 全平台 | P0 |
| flutter_secure_storage | ^9.2.0 | 加密存储 | 全平台(Web内存模拟) | P0 |
| path_provider | ^2.1.0 | 文件路径管理 | 全平台 | P0 |
| archive | ^3.4.0 | ZIP 压缩/解压 | 全平台 | P0 |
| crypto | ^3.0.0 | SHA-256 校验 | 全平台 | P0 |
分享与导出
| 库 | 版本 | 用途 | 平台 | 优先级 |
|---|---|---|---|---|
| share_plus | ^8.0.0 | 系统分享 | 全平台 | P0 |
| qr_flutter | ^4.1.0 | 二维码生成 | 全平台 | P1 |
系统能力
| 库 | 版本 | 用途 | 平台 | 优先级 |
|---|---|---|---|---|
| permission_handler | ^11.3.0 | 权限管理 | Android+iOS+Web+Windows | P0 |
| url_launcher | ^6.2.0 | 打开外部链接 | 全平台 | P0 |
| package_info_plus | ^6.0.0 | 应用版本信息 | 全平台 | P0 |
| connectivity_plus | ^6.0.0 | 网络状态检测 | 全平台 | P0 |
| device_info_plus | ^10.0.0 | 设备信息+低端设备检测 | 全平台 | P1 |
| image_picker | ^1.2.1 | 相册/相机选图 | Android+iOS+Web | P0 |
通知与后台
| 库 | 版本 | 用途 | 平台 | 优先级 |
|---|---|---|---|---|
| flutter_local_notifications | ^17.0.0 | 本地通知 | Android+iOS | P1 |
| home_widget | ^0.6.0 | 桌面小组件 | Android+iOS | P1 |
四、数据与网络层
| 库 | 版本 | 用途 | 平台 | 优先级 |
|---|---|---|---|---|
| uuid | ^4.3.0 | UUID 生成 | 全平台 | P0 |
| intl | ^0.19.0 | 国际化/日期格式化 | 全平台 | P0 |
| html | ^0.15.0 | HTML 解析 | 全平台 | P1 |
| logger | ^2.3.0 | 日志记录 | 全平台 | P0 |
| dio_cache_interceptor | ^3.5.0 | Dio 缓存拦截器 | 全平台 | P1 |
| supabase_flutter | ^2.5.0 | Supabase 客户端 | 全平台 | P0 |
五、扩展功能层（P2-P3）
| 库 | 版本 | 用途 | 平台 | 优先级 |
|---|---|---|---|---|
| just_audio | ^0.9.0 | 音频播放 | Android+iOS+macOS | P2 |
| flutter_tts | ^4.0.0 | 文字转语音 | Android+iOS | P3 |
| in_app_purchase | ^3.2.0 | 应用内支付 | Android+iOS | P1 |
| table_calendar | ^3.1.0 | 日历组件 | 全平台 | P2 |
⚠️ 已移除的不跨平台库
| 库 | 原用途 | 移除原因 | 替代方案 |
|---|---|---|---|
| image_gallery_saver | 保存到相册 | 仅 Android+iOS | gal (全平台) |
| flutter_wallpaper_manager | 设置壁纸 | 仅 Android，iOS 系统限制 | 暂不实现 |
| workmanager | 后台定时任务 | 仅 Android+iOS，暂无需求 | 暂不实现 |
| flutter_scene | 3D GPU渲染 | v0.23.0统一3D路径，WebView方案更稳定 | flutter_3d_controller (WebView) |
📦 归档列表
已完成集成的三方库，记录集成版本、产出文件和状态
| 库 | 集成版本 | 产出文件 | 状态 | 归档日期 |
|---|---|---|---|---|
| flutter_advanced_canvas_editor | v0.20.0 | LayerManagerService, LayerSnapshotService, LayerPanel | ✅ 核心92% | 2026-04-24 |
| flutter_3d_controller | v0.21.0 | Model3DPreviewPage, Sticker3DPanel, Flutter3DViewer | ✅ 核心71% | 2026-04-24 |
| flutter_scene | v0.23.0 | 已移除，统一flutter_3d_controller | ✅ 已移除 | 2026-04-27 |
| image_size_getter | v0.22.0 | ImageInfoService, ImageInfoPanel, EditorStatusBar | ✅ 100% | 2026-04-25 |
| extended_image | v0.22.0 | ImageCropPage, ExtendedResizeImage, ImageImportService | ✅ 100% | 2026-04-25 |
| photo_view | v0.22.0 | ImagePreviewPage, ImageGalleryPage | ✅ 100% | 2026-04-25 |
| flutter_image_compress | v0.22.0 | ImageCompressService, ExportService压缩集成 | ✅ 100% | 2026-04-25 |
平台标注说明: "全平台" = Android + iOS + Web + macOS + Windows + Linux "WASM" = 支持 WebAssembly 运行时