Basic Utils 基础工具模块群
模块群概述
Basic Utils 模块群是 OneApp 的基础工具集合，提供了应用开发中必需的底层工具和通用组件。该模块群包含了网络通信、日志系统、配置管理、平台适配、推送服务等核心基础设施。
子模块列表
核心基础模块
- basic_network - 网络通信模块
- basic_logger - 日志系统模块
- basic_config - 配置管理模块
- basic_platform - 平台适配模块
- basic_push - 推送服务模块
- basic_utils - 基础工具模块
架构框架模块
- base_mvvm - MVVM架构模块
下载和监控模块
- flutter_downloader - 文件下载器模块
- kit_app_monitor - 应用监控工具包
第三方集成模块
- flutter_plugin_mtpush_private - 美团云推送插件
使用指南
基础依赖配置
dependencies:
basic_utils:
path: ../oneapp_basic_utils/basic_utils
basic_config:
path: ../oneapp_basic_utils/basic_config
basic_logger:
path: ../oneapp_basic_utils/basic_logger
basic_network:
path: ../oneapp_basic_utils/basic_network
basic_platform:
path: ../oneapp_basic_utils/basic_platform
初始化配置
// 应用初始化时配置基础模块
await BasicUtils.initialize();
await BasicConfig.initialize();
await BasicLogger.initialize();
await BasicNetwork.initialize();
await BasicPlatform.initialize();
开发规范
模块设计原则
- 单一职责: 每个模块只负责特定的功能领域
- 接口抽象: 提供清晰的接口定义，隐藏实现细节
- 配置驱动: 通过配置控制模块行为，提高灵活性
- 错误处理: 统一的错误处理和日志记录机制
代码规范
- 遵循 Dart 官方编码规范
- 使用静态分析工具检查代码质量
- 编写完整的单元测试和文档
- 版本化管理和变更日志
总结
oneapp_basic_utils 模块群为 OneApp 提供了坚实的技术基础，通过模块化设计和统一抽象，实现了基础功能的复用和标准化。这些模块不仅支撑了当前的业务需求，也为未来的功能扩展提供了良好的基础架构。