base-common 模块缺失清单
📊 模块对比
✅ 已实现的模块
| 模块 |
状态 |
说明 |
| auth |
✅ 完整 |
ViewModel、Repository、DataSource、Model、State、Page |
| config |
✅ 完整 |
ConfigManager、ServerConfigManager |
| log |
✅ 完整 |
LogHelper |
| network |
✅ 完整 |
ApiBaseService、ApiResponseParser、NetworkHelper、ApiServiceFactory |
| router |
✅ 部分 |
NavigationHelper(功能可能不如 Android 的 RouterHelper 完整) |
| storage |
✅ 完整 |
StorageManager |
| ui |
✅ 部分 |
MessageHelper、PageHelper、BasePage |
| version |
✅ 完整 |
ViewModel、Repository、DataSource、Model、State |
| mvvm |
✅ 完整 |
BaseViewModel、StateFlow、ViewModelHelper(HarmonyOS 特有) |
❌ 缺失的模块
1. dialog - 对话框助手
- 目录状态: 存在但为空
- Android 实现:
DialogHelper.kt
- 功能:
- 提示对话框
- 确认对话框
- 输入对话框
- 列表选择对话框
- 级联选择对话框
- 优先级: 🔴 高(UI 常用功能)
2. permission - 权限管理
- 目录状态: 存在但为空
- Android 实现:
PermissionHelper.kt
- 功能:
- 权限检查
- 权限请求
- 权限说明对话框
- 权限请求结果回调
- 优先级: 🔴 高(应用必需功能)
3. socketio - SocketIO 管理器
- 目录状态: 存在但为空
- Android 实现:
SocketIOManager.kt
- 功能:
- SocketIO 连接管理
- 自动重连
- Token 刷新后重连
- 生命周期管理
- 优先级: 🔴 高(实时通信必需)
4. launch - 应用初始化
- 目录状态: 存在但为空
- Android 实现:
AppInitializer.kt、AppLaunchManager.kt
- 功能:
- 优先级: 🔴 高(应用启动必需)
5. util - 工具管理器
- 目录状态: 存在但为空
- Android 实现:
UtilManager.kt
- 功能:
- 时间格式化/解析
- 字符串加密/解密
- MD5 哈希
- JSON 转换
- 优先级: 🟡 中(工具方法)
6. crash - 崩溃处理
- 目录状态: 不存在
- Android 实现:
CrashHelper.kt
- 功能:
- 优先级: 🟡 中(调试和监控)
7. file - 文件选择器
- 目录状态: 不存在
- Android 实现:
FilePickerHelper.kt
- 功能:
- 优先级: 🟢 低(特定功能)
8. image - 图片加载器
- 目录状态: 不存在
- Android 实现:
ImageLoader.kt
- 功能:
- 优先级: 🟢 低(可使用第三方库)
9. camera - 相机助手
- 目录状态: 不存在
- Android 实现:
CameraHelper.kt
- 功能:
- 优先级: 🟢 低(特定功能)
10. bridge - 桥接管理器
- 目录状态: 不存在
- Android 实现:
BridgeManager.kt
- 功能:
- 优先级: 🟢 低(特定功能)
11. executor - 执行器管理器
- 目录状态: 不存在
- Android 实现:
ExecutorManager.kt
- 功能:
- 优先级: 🟢 低(HarmonyOS 使用 async/await)
🎯 优先级建议
高优先级(必须实现)
dialog - 对话框助手
- 原因: UI 常用功能,几乎所有页面都需要
- 工作量: 中等
permission - 权限管理
- 原因: 应用必需功能,HarmonyOS 权限系统与 Android 不同
- 工作量: 中等
socketio - SocketIO 管理器
- 原因: 实时通信必需,业务核心功能
- 工作量: 较大(需要适配 HarmonyOS WebSocket)
launch - 应用初始化
- 原因: 应用启动必需,统一管理模块初始化
- 工作量: 小
中优先级(建议实现)
util - 工具管理器
crash - 崩溃处理
低优先级(可选实现)
- file - 文件选择器
- image - 图片加载器
- camera - 相机助手
- bridge - 桥接管理器
- executor - 执行器管理器
📝 实现建议
1. dialog 模块
- 使用 HarmonyOS 的
@ohos.promptAction 和自定义 Dialog
- 参考 Android 版本的 API 设计,保持一致性
2. permission 模块
- 使用 HarmonyOS 的权限 API(
@kit.AbilityKit)
- 适配 HarmonyOS 的权限模型(与 Android 不同)
3. socketio 模块
- 使用 HarmonyOS 的 WebSocket API
- 或者使用第三方 Socket.IO 库(如果支持 HarmonyOS)
4. launch 模块
5. util 模块
- 使用 HarmonyOS 的 API 实现工具方法
- 保持与 Android 版本的 API 一致性
✅ 总结
已实现: 9 个模块(auth、config、log、network、router、storage、ui、version、mvvm)
缺失: 11 个模块(dialog、permission、socketio、launch、util、crash、file、image、camera、bridge、executor)
建议优先实现: dialog、permission、socketio、launch(高优先级)
文档版本: v1.0
创建时间: 2024-12