520kiss/xianyan
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 发布v5.3.0正式版本，完善跨平台适配与功能优化

Browse Source 
本次更新包含多项核心改进：
1. 新增统一跨平台导航扩展，替换原有GoRouter调用，适配鸿蒙平台路由逻辑
2. 重构状态初始化逻辑，使用Future.microtask避免BuildContext异常
3. 完善Linux桌面端支持，添加桌面文件、AppData配置与WSL构建脚本
4. 修复鸿蒙平台动画渲染异常问题，移除平台特判逻辑
5. 优化NFC配对扫描参数，精简不必要的配置项
6. 更新依赖版本与项目版本号
7. 修复Drift数据库缓存问题，移除冗余的表检测逻辑
8. 添加路由观察者日志，优化鸿蒙端路由调试体验
9. 完善签到与文章发布后的用户数据刷新逻辑
10. 删除冗余的子模块与日志文件，清理项目结构
This commit is contained in:
Developer
2026-05-18 08:58:36 +08:00
parent 1bca322600
commit a60957cc0e
94 changed files with 3957 additions and 5358 deletions
Download Patch File Download Diff File Expand all files Collapse all files

327
docs/07_三方库清单.md
View File

@@ -1,19 +1,23 @@
# 📦 闲言APP — 三方库清单
> 更新: 2026-04-27 | 作用: 全部三方库选型与版本 + 跨平台标注 + 集成状态
> 更新: 2026-05-18 | 作用: 全部三方库选型与版本 + 跨平台标注 + 鸿蒙适配状态 + 集成状态
> 上次更新: 版本号同步pubspec.yaml + 新增文件传输层/音视频层/安全层 + 鸿蒙30包适配标注
---
## 一、核心框架层
| 库 | 版本 | 用途 | 平台 | 优先级 |
|----|------|------|------|--------|
| 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 |
| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| flutter_riverpod | ^3.0.0 | 状态管理 + 依赖注入 | 全平台 | ✅ 纯Dart | P0 |
| riverpod_annotation | ^4.0.0 | Riverpod 代码生成注解 | 全平台 | ✅ 纯Dart | P0 |
| go_router | ^17.2.3 | 声明式路由 | 全平台 | ✅ 纯Dart | P0 |
| dio | ^5.4.0 | 网络请求 | 全平台 | ✅ 纯Dart | P0 |
| drift | ^2.16.0 | SQLite 数据库 | 全平台 | ✅ 纯Dart | P0 |
| freezed | ^3.2.0 | 不可变数据模型 | 全平台 | ✅ 纯Dart | P0 |
| json_serializable | ^6.11.0 | JSON 序列化 | 全平台 | ✅ 纯Dart | P0 |
| hive | ^2.2.3 | 高性能 NoSQL 数据库 | 全平台 | ✅ 纯Dart | P0 |
| hive_flutter | ^1.1.0 | Hive Flutter 适配 | 全平台 | ✅ 纯Dart | P0 |
---
@@ -21,65 +25,91 @@
### iOS 26 Liquid Glass
| 库 | 版本 | 用途 | 平台 | 优先级 |
|----|------|------|------|--------|
| liquid_glass_widgets | ^0.7.17 | 26个 Glass 组件 + Shader 渲染 | 全平台 | P0 |
| liquid_glass_easy | ^1.1.1 | 液态玻璃透镜特效 | 全平台 | P1 | ✅ 已集成-4种预设 |
| stupid_simple_sheet | ^0.9.1+1 | iOS 26 Glass/Cupertino Sheet | 全平台 | P0 |
| heroine | ^0.7.2 | Hero 弹簧动画替代 | 全平台 | P0 |
| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| liquid_glass_widgets | v0.11.0-ohos.1 | 26个 Glass 组件 + Shader 渲染 | 全平台 | ✅ 本地化 | P0 |
| liquid_glass_easy | v1.1.1 | 液态玻璃透镜特效 | 全平台 | ✅ 本地化 | P1 | ✅ 已集成-4种预设 |
| stupid_simple_sheet | v0.9.1+1 | iOS 26 Glass/Cupertino Sheet | 全平台 | ✅ 纯Dart | P0 |
| heroine | ^0.7.2 | Hero 弹簧动画替代 | 全平台 | ✅ 纯Dart | P0 |
### 动画与交互
| 库 | 版本 | 用途 | 平台 | 优先级 |
|----|------|------|------|--------|
| flutter_animate | ^4.5.0 | 声明式动画 | 全平台 | P0 | ✅ 已集成-入场动画+庆祝 |
| lottie | ^3.3.0 | 空状态/庆祝矢量动画 | 全平台+WASM | P0 | ✅ 已集成-6种本地动画 |
| 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 |
| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| flutter_animate | ^4.5.0 | 声明式动画 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成-入场动画+庆祝 |
| lottie | ^3.3.0 | 空状态/庆祝矢量动画 | 全平台+WASM | ✅ 纯Dart | P0 | ✅ 已集成-6种本地动画 |
| confetti | ^0.8.0 | 点赞/创作完成撒花 | 全平台+WASM | ✅ 纯Dart | P0 | ✅ 已集成-导出庆祝 |
| animate_do | ^5.1.0 | 列表交错入场动画 | 全平台+WASM | ✅ 纯Dart | P0 | ✅ 已集成 |
| custom_refresh_indicator | ^4.0.1 | 液态玻璃风格下拉刷新 | 全平台 | ✅ 纯Dart | P0 |
| animations | ^2.0.11 | Material 转场动画 | 全平台 | ✅ 纯Dart | P1 |
| flutter_tilt | ^4.0.0 | 3D 倾斜交互效果 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成 |
| flutter_card_swiper | v7.2.0 | 卡片滑动切换 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成 |
| flutter_spritesheet_animation | v1.0.2 | 精灵图帧动画 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成
### 基础 UI 组件
| 库 | 版本 | 用途 | 平台 | 优先级 |
|----|------|------|------|--------|
| google_fonts | ^6.2.0 | 字体加载管理 | 全平台 | P0 | ✅ 已集成-15种字体 |
| cached_network_image | ^3.3.0 | 图片缓存加载 | 全平台 | P0 | ✅ 已集成-6类36张贴纸 |
| shimmer | ^3.0.0 | 骨架屏 | 全平台 | P1 | ✅ 已集成 |
| flutter_svg | ^2.0.0 | SVG 渲染 | 全平台 | P1 | ✅ 已集成-8种本地SVG |
| fl_chart | ^0.68.0 | 图表绘制 | 全平台 | P2 |
| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| google_fonts | ^8.1.0 | 字体加载管理 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成-15种字体 |
| cached_network_image | ^3.3.0 | 图片缓存加载 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成-6类36张贴纸 |
| shimmer | ^3.0.0 | 骨架屏 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成 |
| flutter_svg | ^2.0.0 | SVG 渲染 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成-8种本地SVG+分类图标 |
| fl_chart | ^1.2.0 | 图表绘制 | 全平台 | ✅ 纯Dart | P2 |
| adaptive_palette | ^3.0.0 | 图片主色提取+流体背景 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成-句子卡片取色 |
| badges | v3.2.0 | 角标/徽章组件 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成 |
| flutter_staggered_grid_view | ^0.7.0 | 瀑布流网格 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成 |
| visibility_detector | ^0.4.0+2 | 组件可见性检测 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成
### 列表交互与布局增强
| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| flutter_slidable | ^4.0.3 | 列表项滑动操作 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成-AppSlidable封装 |
| flutter_sticky_header | ^0.8.0 | 粘性分组头 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成-AppStickyHeader封装 |
| value_layout_builder | ^0.5.0 | 布局阶段值传递 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成(sticky_header依赖) |
| pull_down_button | ^0.10.1 | iOS 下拉菜单按钮 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成-AppPopupMenu封装 |
| sliver_tools | ^0.2.12 | Sliver 工具集 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成 |
| bot_toast | ^4.1.0 | Toast/通知弹窗 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成-AppToast封装
### 内容渲染
| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| flutter_markdown_plus | ^1.0.1 | Markdown 渲染 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成-AppMarkdown封装 |
| flutter_html | ^3.0.0-beta.2 | HTML 内容渲染 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成 |
| pinyin | ^3.3.0 | 汉字转拼音 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成-汉语工具
### 编辑器组件
| 库 | 版本 | 用途 | 平台 | 优先级 |
|----|------|------|------|--------|
| pro_image_editor | ^4.1.2 | 专业图片编辑器 (Frosted Glass 主题) | 全平台 | P0 | ✅ 已集成-本地源码v12.4.3 |
| 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 | ✅ 已集成 |
| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| pro_image_editor | v12.4.4 | 专业图片编辑器 (Frosted Glass 主题) | 全平台 | ✅ 本地化 | P0 | ✅ 已集成-本地源码 |
| flutter_quill | v11.5.0 | 富文本编辑器 (Delta格式) | 全平台 | ✅ 本地化 | P0 | ✅ 已集成-编辑器富文本 |
| dotted_border | ^3.1.0 | 虚线边框 (拖拽描边) | 全平台 | ✅ 纯Dart | P2 | ✅ 已集成 |
| image | ^4.3.0 | 图片底层处理 (缩放/裁剪/压缩/格式转换) | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成 |
| gal | v2.3.0-ohos.1 | 保存图片到相册 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成 |
| flex_color_picker | v3.8.0 | HSL色轮颜色选择器 | 全平台 | ✅ 本地化 | P1 | ✅ 已集成-色轮+色板 |
| flutter_screenutil | ^5.9.0 | 屏幕适配 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成 |
| flutter_shaders_ui | v0.1.1 | 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降级检测 |
| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 | 状态 |
|----|------|------|------|:----:|--------|------|
| flutter_3d_controller | 2.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 | v13.1.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 | ✅ 已集成-导出压缩+缩略图 |
| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 | 状态 |
|----|------|------|------|:----:|--------|------|
| image_size_getter | v2.4.1 | 图片尺寸/格式检测 (读文件头) | 全平台 | ✅ 本地化 | P0 | ✅ 已集成-ImageInfoService |
| extended_image | v10.0.1 | 增强图片组件+裁剪编辑器+内存优化 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成-裁剪+大图优化 |
| photo_view | v0.15.0 | 图片缩放查看器+画廊 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成-全屏预览+画廊 |
| flutter_image_compress | v2.4.0 | 原生图片压缩 (JPEG/WebP/PNG/HEIC) | 全平台 | ✅ 本地化 | P0 | ✅ 已集成-导出压缩+缩略图 |
> **编辑器说明**: pro_image_editor 已重新集成 (v4.1.2)，采用 Frosted Glass 主题 + 自定义 ActionBar + WidgetLayer 扩展 (液态玻璃/Lottie/SVG/网络贴纸)。
> **编辑器说明**: pro_image_editor 已重新集成 (v12.4.4)，采用 Frosted Glass 主题 + 自定义 ActionBar + WidgetLayer 扩展 (液态玻璃/Lottie/SVG/网络贴纸)。
---
@@ -87,62 +117,121 @@
### 存储与文件
| 库 | 版本 | 用途 | 平台 | 优先级 |
|----|------|------|------|--------|
| 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 | ✅ 已集成-.xycard导出 |
| crypto | ^3.0.0 | SHA-256 校验 | 全平台 | P0 | ✅ 已集成 |
| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| shared_preferences | v2.5.5 | 轻量 KV 存储 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成 |
| flutter_secure_storage | v9.2.4 | 加密存储 | 全平台(Web内存模拟) | ✅ 本地化 | P0 | ✅ 已集成 |
| path_provider | v2.1.5 | 文件路径管理 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成 |
| archive | ^4.0.0 | ZIP 压缩/解压 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成-.xycard导出 |
| crypto | ^3.0.0 | SHA-256 校验 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成 |
| encrypt | ^5.0.3 | 对称/非对称加密 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成 |
| sqflite | v2.4.1-ohos.1 | SQLite 轻量数据库 | 全平台 | ✅ 本地化 | P1 | ✅ 已集成-鸿蒙端数据库 |
### 分享与导出
| 库 | 版本 | 用途 | 平台 | 优先级 |
|----|------|------|------|--------|
| share_plus | ^8.0.0 | 系统分享 | 全平台 | P0 | ✅ 已集成 |
| qr_flutter | ^4.1.0 | 二维码生成 | 全平台 | P1 |
| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| share_plus | v13.1.0 | 系统分享 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成 |
| qr_flutter | ^4.1.0 | 二维码生成 | 全平台 | ✅ 纯Dart | P1 |
| receive_sharing_intent | v1.8.1 | 接收外部分享内容 | Android+iOS | ✅ 本地化 | P1 | ✅ 已集成 |
### 系统能力
| 库 | 版本 | 用途 | 平台 | 优先级 |
|----|------|------|------|--------|
| permission_handler | ^11.3.0 | 权限管理 | Android+iOS+Web+Windows | P0 | ✅ 已集成-PermissionService |
| 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 | ✅ 已集成-3D降级检测 |
| image_picker | ^1.2.1 | 相册/相机选图 | Android+iOS+Web | P0 | ✅ 已集成-ImageImportService |
| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| permission_handler | v12.0.1 | 权限管理 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成-PermissionService |
| url_launcher | v6.3.2 | 打开外部链接 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成 |
| package_info_plus | v10.1.0 | 应用版本信息 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成 |
| connectivity_plus | v7.1.1 | 网络状态检测 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成-工具状态监测 |
| device_info_plus | v13.1.0 | 设备信息+低端设备检测 | 全平台 | ✅ 本地化 | P1 | ✅ 已集成-3D降级检测 |
| image_picker | v1.2.2 | 相册/相机选图 | Android+iOS+Web | ✅ 本地化 | P0 | ✅ 已集成-ImageImportService |
| file_picker | v8.3.7 | 文件选择器 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成 |
| app_links | v7.0.0-ohos.1 | 深度链接处理 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成-DeepLinkService |
| local_auth | v3.0.1 | 生物识别认证 | Android+iOS | ✅ 本地化 | P1 | ✅ 已集成-应用锁 |
| battery_plus | v7.0.0-ohos.1 | 电池状态监听 | 全平台 | ✅ 本地化 | P2 | ✅ 已集成
### 通知与后台
| 库 | 版本 | 用途 | 平台 | 优先级 |
|----|------|------|------|--------|
| flutter_local_notifications | ^17.0.0 | 本地通知 | Android+iOS | P1 |
| home_widget | ^0.6.0 | 桌面小组件 | Android+iOS | P1 |
| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| flutter_local_notifications | v21.0.0 | 本地通知 | Android+iOS | ✅ 本地化 | P1 | ✅ 已集成 |
| home_widget | v0.9.1 | 桌面小组件 | Android+iOS | ✅ 本地化 | P1 | ✅ 已集成 |
| wakelock_plus | v1.4.0-ohos.1 | 屏幕常亮控制 | 全平台 | ✅ 本地化 | P1 | ✅ 已集成
### 音视频
| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| audioplayers | v6.5.0-ohos.1 | 音频播放 | 全平台 | ✅ 本地化 | P2 | ✅ 已集成 |
| record | v6.0.0-ohos.1 | 录音 | Android+iOS+Web | ✅ 本地化 | P2 | ✅ 已集成-语音消息 |
| video_player | v2.10.0-ohos.1 | 视频播放 | 全平台 | ✅ 本地化 | P2 | ✅ 已集成 |
| video_compress | v3.1.2-ohos.1 | 视频压缩 | Android+iOS | ✅ 本地化 | P2 | ✅ 已集成
### 异常捕获
| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| catcher_2 | v2.1.9 | 全局异常捕获+上报 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成 |
---
## 四、数据与网络层
## 四、文件传输层
| 库 | 版本 | 用途 | 平台 | 优先级 |
|----|------|------|------|--------|
| 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 |
### 传输核心
| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| shelf | ^1.4.0 | HTTP 服务器框架 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成 |
| shelf_router | ^1.1.0 | 路由中间件 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成 |
| shelf_web_socket | ^3.0.0 | WebSocket 支持 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成 |
| web_socket_channel | ^3.0.3 | WebSocket 客户端 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成 |
| mime | ^2.0.0 | MIME 类型识别 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成 |
| basic_utils | ^5.7.0 | 通用工具集 (Base64/ASN1) | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成 |
| cross_file | any | 跨平台文件抽象 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成 |
### 近场通信
| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| network_info_plus | v8.1.0-ohos.1 | WiFi 网络信息 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成 |
| wifi_iot | v0.3.19-ohos.1 | WiFi IoT 设备连接 | Android | ✅ 本地化 | P1 | ✅ 已集成 |
| flutter_blue_plus | v2.1.0-ohos.1 | 蓝牙 BLE 通信 | Android+iOS | ✅ 本地化 | P1 | ✅ 已集成-蓝牙配对 |
| flutter_nfc_kit | v3.6.0-rc.6-ohos | NFC 读写 | Android+iOS | ✅ 本地化 | P2 | ✅ 已集成-NFC配对 |
| mobile_scanner | v7.1.4-ohos.1 | 二维码/条形码扫描 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成-QR配对 |
| nearby_service | v0.2.1 | 近场设备发现+通信 | Android+iOS | ✅ 本地化 | P1 | ✅ 已集成
### 远程传输
| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| flutter_webrtc | v1.4.0-ohos.1 | WebRTC 音视频通信 | Android+iOS+Web+macOS | ✅ 本地化 | P0 | ✅ 已集成-WebRTC传输 |
---
## 五、扩展功能层（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 |
| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| uuid | ^4.5.0 | UUID 生成 | 全平台 | ✅ 纯Dart | P0 |
| intl | ^0.20.2 | 国际化/日期格式化 | 全平台 | ✅ 纯Dart | P0 |
| logger | ^2.5.0 | 日志记录 | 全平台 | ✅ 纯Dart | P0 |
| collection | ^1.19.0 | 集合操作扩展 | 全平台 | ✅ 纯Dart | P1 |
| supabase_flutter | ^2.8.0 | Supabase 客户端 | 全平台 | ✅ 纯Dart | P0 |
| flutter_cache_manager | ^3.3.0 | 文件缓存管理 | 全平台 | ✅ 纯Dart | P1 |
| mailer | ^7.1.0 | SMTP 邮件发送 | 全平台 | ✅ 纯Dart | P2 |
| vector_math | any | 向量数学运算 | 全平台 | ✅ 纯Dart | P1 |
| timezone | any | 时区数据库 | 全平台 | ✅ 纯Dart | P1 |
---
## 六、扩展功能层（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 | 日历组件 | 全平台 | ✅ 纯Dart | P2 |
---
@@ -150,7 +239,7 @@
| 库 | 原用途 | 移除原因 | 替代方案 |
|----|--------|----------|----------|
| image_gallery_saver | 保存到相册 | 仅 Android+iOS | `gal` (全平台) |
| 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) |
@@ -164,14 +253,64 @@
| 库 | 集成版本 | 产出文件 | 状态 | 归档日期 |
|----|---------|---------|------|---------|
| 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_3d_controller | v0.21.0 | Model3DPreviewPage, Sticker3DPanel, Flutter3DViewer | ✅ 核心85% | 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 |
| flutter_slidable | v1.9.0 | AppSlidable, SlideActionConfig, DeleteConfirm | ✅ 100% | 2026-04-29 |
| flutter_sticky_header | v1.9.0 | AppStickyHeaderSliver, 分类吸顶 | ✅ 100% | 2026-04-29 |
| flutter_markdown_plus | v1.9.0 | AppMarkdownBody, AppMarkdown | ✅ 100% | 2026-04-29 |
| pull_down_button | v1.9.0 | AppPopupMenu | ✅ 100% | 2026-04-29 |
| sliver_tools | v1.9.0 | SliverPinnedHeader, AppToast | ✅ 100% | 2026-04-29 |
---
> **平台标注说明**: "全平台" = Android + iOS + Web + macOS + Windows + Linux
## 📊 鸿蒙适配统计
### 30包适配清单
| # | 包名 | 适配模式 | 鸿蒙子包 |
|---|------|---------|---------|
| 1 | shared_preferences | 联合插件 | shared_preferences_ohos |
| 2 | path_provider | 联合插件 | path_provider_ohos |
| 3 | url_launcher | 联合插件 | url_launcher_ohos |
| 4 | image_picker | 联合插件 | image_picker_ohos |
| 5 | local_auth | 联合插件 | local_auth_ohos |
| 6 | video_player | 联合插件 | video_player_ohos |
| 7 | permission_handler | 直接插件 | permission_handler_ohos |
| 8 | flutter_secure_storage | 联合插件 | flutter_secure_storage_ohos |
| 9 | share_plus | 联合插件 | share_plus_ohos |
| 10 | battery_plus | 联合插件 | battery_plus_ohos |
| 11 | connectivity_plus | 联合插件 | — |
| 12 | flutter_local_notifications | 直接插件 | — |
| 13 | file_picker | 直接插件 | — |
| 14 | receive_sharing_intent | 直接插件 | — |
| 15 | wakelock_plus | 联合插件 | — |
| 16 | mobile_scanner | 联合插件 | — |
| 17 | wifi_iot | 联合插件 | — |
| 18 | audioplayers | 联合插件 | audioplayers_ohos |
| 19 | record | 联合插件 | record_ohos |
| 20 | sqflite | 联合插件 | sqflite_ohos |
| 21 | fluttertoast | 联合插件 | fluttertoast_ohos |
| 22 | video_compress | 联合插件 | — |
| 23 | flutter_blue_plus | 联合插件 | flutter_blue_plus_ohos |
| 24 | gal | 联合插件 | — |
| 25 | network_info_plus | 联合插件 | network_info_plus_ohos |
| 26 | app_links | 联合插件 | app_links_ohos |
| 27 | pro_image_editor | 直接插件 | — |
| 28 | home_widget | 直接插件 | — |
| 29 | nfc_manager | 联合插件 | nfc_manager_ohos |
| 30 | nearby_service | 直接插件 | — |
### 适配模式说明
- **联合插件模式**: ohos 原生代码在独立 `*_ohos` 子包，主包声明 `default_package`
- **直接插件模式**: ohos 原生代码在主包 `ohos/` 目录，pubspec 声明 `pluginClass`
---
> **平台标注说明**: "全平台" = Android + iOS + Web + macOS + Windows + Linux + 鸿蒙
> "WASM" = 支持 WebAssembly 运行时
> "本地化" = packages/ 目录本地引用，已做鸿蒙适配