缺失模块清单.md 5.5 KB

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.ktAppLaunchManager.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
  • 功能:
    • WebView 与原生通信
    • JS 桥接
  • 优先级: 🟢 低(特定功能)

11. executor - 执行器管理器

  • 目录状态: 不存在
  • Android 实现: ExecutorManager.kt
  • 功能:
    • 线程池管理
    • 任务调度
  • 优先级: 🟢 低(HarmonyOS 使用 async/await)

🎯 优先级建议

高优先级(必须实现)

  1. dialog - 对话框助手

    • 原因: UI 常用功能,几乎所有页面都需要
    • 工作量: 中等
  2. permission - 权限管理

    • 原因: 应用必需功能,HarmonyOS 权限系统与 Android 不同
    • 工作量: 中等
  3. socketio - SocketIO 管理器

    • 原因: 实时通信必需,业务核心功能
    • 工作量: 较大(需要适配 HarmonyOS WebSocket)
  4. launch - 应用初始化

    • 原因: 应用启动必需,统一管理模块初始化
    • 工作量: 小

中优先级(建议实现)

  1. util - 工具管理器

    • 原因: 常用工具方法,提高开发效率
    • 工作量: 小
  2. crash - 崩溃处理

    • 原因: 调试和监控必需
    • 工作量: 中等

低优先级(可选实现)

  1. file - 文件选择器
  2. image - 图片加载器
  3. camera - 相机助手
  4. bridge - 桥接管理器
  5. 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