refactor: 兼容后端返回数字类型波动,清理废弃代码

主要变更:
1.  全局修复类型转换问题,将多处`as int?`改为`(num?)?.toInt()`兼容浮点/字符串类型的数字字段
2.  移除废弃的nearby_p2p配对方式和对应的依赖包
3.  优化鸿蒙端快捷方式、引导页、路由导航的稳定性
4.  合并日志输出避免鸿蒙端IDE卡顿
5.  修复安卓端蓝牙权限冗余声明
This commit is contained in:
Developer
2026-06-07 08:04:38 +08:00
parent 2db07728a4
commit ae6804e8bd
122 changed files with 2727 additions and 1908 deletions

View File

@@ -10,9 +10,13 @@
| 日期 | 版本 | 变更内容 |
|---|---|---|
<<<<<<< Updated upstream
| 2026-06-07 | v10 | 修正 §2.3 dependency_overrides 行数4→5行/40+→46行修正 §2.6 补丁引用§2.8→§2.9);简化 §2.8.1 pro_image_editor 过时回退建议;删除 §5.4 pro_image_editor 本地包条目和 bitsdojo_window 废弃条目;简化 §3.3 pubspec.yaml 处理策略git stash → 双模板脚本生成);更新 §3.2/§3.5/§6 与双模板机制对齐 |
| 2026-06-06 | v9 | 清理未使用依赖:移除 animations、animate_do、value_layout_builder、flutter_advanced_canvas_editor、flutter_blue_plus、http_cache_file_store、dartx、vector_math删除差异对照表中 flutter_nfc_kit 过时条目 |
| 2026-06-06 | v8 | 新增 `app_tracking_transparency` 差异对照条目;新增 `nearby_connections` 鸿蒙端本地stub包说明新增 §2.10 nearby_connections鸿蒙适配说明 |
=======
| 2026-06-06 | v8 | 移除 `nearby_connections` 库及P2P功能本地stub包影响Android构建更新差异对照表新增 §2.8.7 app_tracking_transparency说明 |
>>>>>>> Stashed changes
| 2026-06-02 | v7 | **重大变更**pubspec.yaml 拆分为双模板pubspec.ohos.yaml + pubspec.macos.yamlpubspec.yaml 不再提交到 Git新增三方库变更通知机制新增 setup_pubspec.ps1 脚本 |
| 2026-06-02 | v6 | 鸿蒙端 pubspec.yaml 同步 bitsdojo_window → window_manager 迁移;更新 file_picker 本地包版本注释(v8.3.7→v11.0.0-ohos.1);更新 speech_to_text(^7.0.0→^7.4.0)、live_activities(^2.0.0→^2.4.9) 远程版本号;补充 dependency_overrides 中 bitsdojo_window_windows 移除说明 |
| 2026-06-01 | v5 | 新增 §2.6 pub cache 补丁说明;标记 bitsdojo_window 迁移完成file_picker 升级到 12.x |
@@ -176,7 +180,6 @@ Error: The getter 'ohos' isn't defined for the class 'TargetPlatform'
| mobile_scanner | `path: packages/mobile_scanner` | `^7.1.4` |
| wifi_iot | `path: packages/wifi_iot` | `^0.3.19` |
| nearby_service | `path: packages/nearby_service` | `^0.2.1` |
| nearby_connections | `path: packages/nearby_connections` (stub) | `^4.1.1` |
| sqflite | `path: packages/sqflite` | `^2.4.1` |
| workmanager | `path: packages/workmanager` | `^0.9.0` |
| flutter_tts | `path: packages/flutter_tts` | `^4.2.0` |
@@ -344,24 +347,13 @@ MacBook Pro 端使用 pub.dev 版本 `^0.9.1`,鸿蒙端的 `ohosName` 参数
home_widget: ^0.9.1
```
#### 2.8.7 nearby_connections鸿蒙端本地stub包
#### 2.8.7 nearby_connections已移除
`nearby_connections` 仅支持 Android/iOS 平台Google Nearby Connections API,不支持鸿蒙
鸿蒙端使用本地 stub 包 `packages/nearby_connections/`,提供与 4.x API 一致的类型定义和方法签名,
但所有方法调用抛出 `UnsupportedError`。代码中通过 `isP2pSupported` 守卫,鸿蒙端不会实际调用 P2P 方法
`nearby_connections`Google Nearby Connections API已从项目中完全移除
原因:该库仅支持 Android/iOS鸿蒙端需要本地 stub 包,但本地包会影响 Android 端构建。
近场通信功能由 `nearby_service` 统一承担Android Wi-Fi Direct / iOS MultipeerConnectivity / 鸿蒙)
```yaml
# 鸿蒙端使用本地 stub 包
nearby_connections:
path: packages/nearby_connections
# MacBook Pro 端使用远程版本
nearby_connections: ^4.1.1
```
> **注意**:鸿蒙端 stub 包的 Dart API 与远程版本完全一致(枚举、类型、方法签名),
> 编译不会报错。运行时由 `NearbyServiceAdapter.isP2pSupported` 守卫,
> 鸿蒙端 P2P 功能不可用,仅 `nearby_service` 原生引擎可用。
> **注意**:移除后,蓝牙 P2P 发现功能不再可用,设备配对通过配对码/扫码/雷达/Wi-Fi Direct 进行。
#### 2.8.8 app_tracking_transparency两端均使用远程版本