Files

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

本次更新包含多项核心改进：
1. 新增统一跨平台导航扩展，替换原有GoRouter调用，适配鸿蒙平台路由逻辑
2. 重构状态初始化逻辑，使用Future.microtask避免BuildContext异常
3. 完善Linux桌面端支持，添加桌面文件、AppData配置与WSL构建脚本
4. 修复鸿蒙平台动画渲染异常问题，移除平台特判逻辑
5. 优化NFC配对扫描参数，精简不必要的配置项
6. 更新依赖版本与项目版本号
7. 修复Drift数据库缓存问题，移除冗余的表检测逻辑
8. 添加路由观察者日志，优化鸿蒙端路由调试体验
9. 完善签到与文章发布后的用户数据刷新逻辑
10. 删除冗余的子模块与日志文件，清理项目结构

2026-05-18 08:58:36 +08:00

18 KiB

Raw Permalink Blame History

📦 闲言APP — 三方库清单

更新: 2026-05-18 | 作用: 全部三方库选型与版本 + 跨平台标注 + 鸿蒙适配状态 + 集成状态上次更新: 版本号同步pubspec.yaml + 新增文件传输层/音视频层/安全层 + 鸿蒙30包适配标注

一、核心框架层

库	版本	用途	平台	鸿蒙	优先级
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

二、UI 设计系统层

iOS 26 Liquid Glass

库	版本	用途	平台	鸿蒙	优先级
liquid_glass_widgets	v0.11.0-ohos.1	26个 Glass 组件 + Shader 渲染	全平台	✅ 本地化	P0
liquid_glass_easy	v1.1.1	液态玻璃透镜特效	全平台	✅ 本地化	P1
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	声明式动画	全平台	✅ 纯Dart	P0
lottie	^3.3.0	空状态/庆祝矢量动画	全平台+WASM	✅ 纯Dart	P0
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	^8.1.0	字体加载管理	全平台	✅ 纯Dart	P0
cached_network_image	^3.3.0	图片缓存加载	全平台	✅ 纯Dart	P0
shimmer	^3.0.0	骨架屏	全平台	✅ 纯Dart	P1
flutter_svg	^2.0.0	SVG 渲染	全平台	✅ 纯Dart	P1
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
flutter_sticky_header	^0.8.0	粘性分组头	全平台	✅ 纯Dart	P0
value_layout_builder	^0.5.0	布局阶段值传递	全平台	✅ 纯Dart	P1
pull_down_button	^0.10.1	iOS 下拉菜单按钮	全平台	✅ 纯Dart	P0
sliver_tools	^0.2.12	Sliver 工具集	全平台	✅ 纯Dart	P1
bot_toast	^4.1.0	Toast/通知弹窗	全平台	✅ 纯Dart	P1

内容渲染

库	版本	用途	平台	鸿蒙	优先级
flutter_markdown_plus	^1.0.1	Markdown 渲染	全平台	✅ 纯Dart	P1
flutter_html	^3.0.0-beta.2	HTML 内容渲染	全平台	✅ 纯Dart	P1
pinyin	^3.3.0	汉字转拼音	全平台	✅ 纯Dart	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	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	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 已重新集成 (v12.4.4)，采用 Frosted Glass 主题 + 自定义 ActionBar + WidgetLayer 扩展 (液态玻璃/Lottie/SVG/网络贴纸)。

三、平台能力层

存储与文件

库	版本	用途	平台	鸿蒙	优先级
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
crypto	^3.0.0	SHA-256 校验	全平台	✅ 纯Dart	P0
encrypt	^5.0.3	对称/非对称加密	全平台	✅ 纯Dart	P0
sqflite	v2.4.1-ohos.1	SQLite 轻量数据库	全平台	✅ 本地化	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	v12.0.1	权限管理	全平台	✅ 本地化	P0
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
image_picker	v1.2.2	相册/相机选图	Android+iOS+Web	✅ 本地化	P0
file_picker	v8.3.7	文件选择器	全平台	✅ 本地化	P0
app_links	v7.0.0-ohos.1	深度链接处理	全平台	✅ 本地化	P0
local_auth	v3.0.1	生物识别认证	Android+iOS	✅ 本地化	P1
battery_plus	v7.0.0-ohos.1	电池状态监听	全平台	✅ 本地化	P2

通知与后台

库	版本	用途	平台	鸿蒙	优先级
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

四、文件传输层

传输核心

库	版本	用途	平台	鸿蒙	优先级
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
mobile_scanner	v7.1.4-ohos.1	二维码/条形码扫描	全平台	✅ 本地化	P0
nearby_service	v0.2.1	近场设备发现+通信	Android+iOS	✅ 本地化	P1

远程传输

库	版本	用途	平台	鸿蒙	优先级
flutter_webrtc	v1.4.0-ohos.1	WebRTC 音视频通信	Android+iOS+Web+macOS	✅ 本地化	P0

五、数据与网络层

库	版本	用途	平台	鸿蒙	优先级
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

⚠️ 已移除的不跨平台库

库	原用途	移除原因	替代方案
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	✅ 核心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

📊 鸿蒙适配统计

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/ 目录本地引用，已做鸿蒙适配

18 KiB Raw Permalink Blame History Unescape Escape

📦 闲言APP — 三方库清单

一、核心框架层

二、UI 设计系统层

iOS 26 Liquid Glass

动画与交互

基础 UI 组件

列表交互与布局增强

内容渲染

编辑器组件

3D引擎

图片处理

三、平台能力层

存储与文件

分享与导出

系统能力

通知与后台

音视频

异常捕获

四、文件传输层

传输核心

近场通信

远程传输

五、数据与网络层

六、扩展功能层（P2-P3）

⚠️ 已移除的不跨平台库

📦 归档列表

📊 鸿蒙适配统计

30包适配清单

适配模式说明

18 KiB

Raw Permalink Blame History