xdz-app

新大洲智能车控 Android 应用

项目简介

新大洲智能车控是一款基于 Android 平台的智能车辆控制应用，采用现代化的 MVVM 架构和 Clean Architecture 设计理念开发。

技术栈

• 开发语言: Kotlin
• 架构模式: MVVM + Clean Architecture
• UI 框架: AndroidX + Material Design
• 网络请求: Retrofit + OkHttp
• 异步处理: Coroutines + Flow
• 导航: Navigation Component
• 依赖注入: 手动依赖注入（Factory 模式）

项目结构

xdz_android/
├── app/                    # 应用主模块
├── base-core/              # 核心基础模块（日志、存储、工具等）
├── base-common/            # 通用基础模块（网络、配置等）
├── capability-ble/         # BLE 蓝牙能力模块
├── capability-nfc/        # NFC 能力模块
├── capability-push/       # 推送能力模块（极光推送）
├── capability-qrcode/     # 二维码能力模块
├── capability-share/      # 分享能力模块（友盟分享）
└── capability-socketio/   # Socket.IO 能力模块

功能特性

已实现功能

• ✅ 用户系统（登录、注册、Token 管理）
• ✅ 版本更新检查
• ✅ 分享功能（微信、QQ、微博等）
• ✅ 推送功能（极光推送）
• ✅ BLE 蓝牙通信
• ✅ NFC 功能
• ✅ 二维码扫描
• ✅ Socket.IO 实时通信

分享功能

支持分享到以下平台：

• 微信（好友、朋友圈）
• QQ（好友、空间）
• 微博
• 系统分享

推送功能

集成极光推送 SDK，支持：

• 消息推送
• 通知栏推送
• 自定义消息处理

快速开始

环境要求

• Android Studio Hedgehog | 2023.1.1 或更高版本
• JDK 17
• Android SDK API 26+
• Gradle 8.0+

配置步骤

1. 克隆项目

   git clone https://git.flowbb.top/humuyu/xdz-app.git
   cd xdz-app
   

2. 配置本地 SDK 路径

在项目根目录创建或编辑 local.properties 文件：

   sdk.dir=/path/to/your/android/sdk

1. 配置应用密钥
   

编辑 app/src/main/res/values/strings.xml，配置以下密钥：

   <!-- 极光推送配置 -->
   <string name="jpush_app_key">your_jpush_appkey_here</string>
   
   <!-- 友盟分享配置 -->
   <string name="share_umeng_app_key">your_umeng_appkey_here</string>
   
   <!-- 微信分享配置 -->
   <string name="share_wechat_app_id">your_wechat_appid_here</string>
   <string name="share_wechat_app_secret">your_wechat_appsecret_here</string>
   
   <!-- QQ 分享配置 -->
   <string name="share_qq_app_id">your_qq_appid_here</string>
   <string name="share_qq_app_key">your_qq_appkey_here</string>
   
   <!-- 微博分享配置 -->
   <string name="share_weibo_app_key">your_weibo_appkey_here</string>
   <string name="share_weibo_app_secret">your_weibo_appsecret_here</string>

1. 同步项目
   

在 Android Studio 中打开项目，等待 Gradle 同步完成。

1. 运行应用
   

连接 Android 设备或启动模拟器，点击运行按钮。

模块说明

base-core

核心基础模块，提供：

• 日志系统（ILog）
• 存储接口（IStorage）
• 工具类接口（IUtil）
• 执行器接口（IExecutor）
• 配置接口（IConfig）
• 桥接接口（IBridge）

base-common

通用基础模块，提供：

• 网络请求（HttpApiClient）
• 服务器配置管理（ServerConfigManager）
• API 响应解析（ApiResponseParser）

capability-share

分享能力模块，基于友盟分享 SDK：

• 支持多平台分享
• 自动处理回调
• 统一的分享接口

详细文档请参考：capability-share/集成说明.md

capability-push

推送能力模块，基于极光推送 SDK：

• 消息推送
• 通知栏推送
• 自定义消息处理

详细文档请参考：capability-push/集成说明.md

开发规范

代码规范

• 遵循 Kotlin 官方编码规范
• 使用有意义的变量和函数名
• 添加必要的注释和文档
• 保持代码简洁和可读性

提交规范

使用 Conventional Commits 规范：

• feat: 新功能
• fix: 修复 bug
• docs: 文档更新
• style: 代码格式调整
• refactor: 代码重构
• test: 测试相关
• chore: 构建/工具相关

示例：

git commit -m "feat: 添加分享功能"
git commit -m "fix: 修复登录失败问题"

文档

• 项目结构文档
• 开发指南
• MVVM 架构文档

许可证

Copyright © 2024 新大洲本田

联系方式

如有问题或建议，请联系开发团队。