Appearance
使用指南
MengHub 开发环境配置与构建指南,基于实际项目源码整理。
项目信息
| 项目 | 值 |
|---|---|
| 包名 | com.menghub.menghub_app |
| 当前版本 | 1.1.0+6 |
| 框架 | Flutter 3.13.5+ |
| Dart SDK | ^3.13.5 |
| 架构 | Feature-first + Clean Architecture |
| 状态管理 | Provider + GetIt |
| 路由 | go_router |
| HTTP | Dio ^5.11.0 |
| 本地存储 | sqflite_sqlcipher(加密) |
| 默认主题 | 深色模式(ThemeMode.dark) |
| 许可证 | Apache 2.0 |
环境准备
必需工具
| 工具 | 版本 | 说明 |
|---|---|---|
| Flutter | 3.13.5+ | 跨平台框架 |
| Dart SDK | ^3.13.5 | 随 Flutter 安装 |
| Java | 17 | Android 编译(JVM target 17) |
| Android SDK | compileSdk 37, minSdk 24 | Android 7.0+ |
| Git | 2.30+ | 版本管理 |
Android 配置
kotlin
// android/app/build.gradle.kts
android {
compileSdk = 37
defaultConfig {
minSdk = 24 // Android 7.0
targetSdk = 35
versionCode = 6
versionName = "1.1.0"
}
compileOptions {
sourceCompatibility = JavaVersion.VERSION_17
targetCompatibility = JavaVersion.VERSION_17
isCoreLibraryDesugaringEnabled = true
}
}快速开始
1. 克隆代码
bash
# MengHub APP 包含在完整发行版中
git clone https://mengstackgit.softunis.com/softunis/mengstack-kernel-dist.git
cd mengstack-kernel-dist2. 安装依赖
bash
flutter pub get3. 运行
bash
# Web(H5 预览)
flutter run -d chrome
# Android
flutter run -d android
# iOS
flutter run -d ios4. 构建发布
bash
# Web 发布
flutter build web --release
# Android APK
flutter build apk --release项目结构
menghub_app/
├── lib/
│ ├── main.dart # 入口:setupDependencies → MaterialApp.router
│ ├── core/
│ │ ├── config/
│ │ │ ├── app_config.dart # 应用配置(版本/API地址/超时/分页)
│ │ │ └── api_endpoints.dart # 全部 API 端点常量
│ │ ├── di/
│ │ │ └── injection.dart # GetIt 依赖注入(8 个 lazy singleton)
│ │ ├── network/
│ │ │ ├── http_client.dart # Dio HTTP 客户端(Auth/Device/Retry 拦截器)
│ │ │ └── ws_client.dart # WebSocket 客户端(心跳/重连/Pinning)
│ │ ├── router/
│ │ │ ├── app_router.dart # go_router 路由定义 + 5 Tab 导航
│ │ │ └── route_names.dart # 22 条路由名称常量
│ │ ├── security/ # 7 个安全组件
│ │ │ ├── screen_protect_service.dart # 防截屏
│ │ │ ├── device_security_service.dart # Root/越狱检测
│ │ │ ├── clipboard_service.dart # 剪贴板自动清除
│ │ │ ├── deep_link_validator.dart
│ │ │ └── url_safety.dart
│ │ ├── services/ # 业务服务
│ │ └── utils/
│ │ └── connectivity.dart # 网络状态监听
│ │ ├── storage/
│ │ │ ├── local_db_mobile.dart # SQLite 加密数据库(6 张表)
│ │ │ └── secure_storage.dart # Token 安全存储
│ │ ├── theme/
│ │ │ └── app_colors.dart # 设计系统(双色系 v2)
│ │ └── utils/
│ ├── data/
│ │ ├── models/ # 6 个数据模型
│ │ │ ├── user_model.dart
│ │ │ ├── message_model.dart
│ │ │ ├── conversation_model.dart
│ │ │ ├── post_model.dart
│ │ │ ├── customer_model.dart
│ │ │ └── h5_app_model.dart
│ │ ├── datasources/
│ │ └── repositories/
│ ├── features/ # 业务功能模块
│ │ ├── auth/pages/ # splash, onboarding, login
│ │ ├── im/pages/ # conversation_list, chat, new_chat, search
│ │ ├── social/pages/ # feed, post_create/edit/detail, audience_select, followers/following
│ │ ├── h5_app/pages/ # app_store
│ │ ├── crm/pages/ # customer_list, customer_detail
│ │ ├── profile/pages/ # my_profile, edit_profile
│ │ └── settings/pages/ # settings, about
│ └── shared/
│ ├── widgets/
│ │ ├── common.dart # 通用组件(AppAvatar, AppBadge, EmptyState 等)
│ │ └── update_dialog.dart # APK 更新弹窗
│ ├── extensions/
│ └── providers/
├── assets/
│ ├── fonts/ # 11 个字体文件
│ │ ├── Sora-Regular.ttf # 标题字体
│ │ ├── Sora-Bold.ttf
│ │ ├── Sora-SemiBold.ttf
│ │ ├── Inter-Regular.ttf # 正文字体
│ │ ├── Inter-Medium.ttf
│ │ ├── Inter-SemiBold.ttf
│ │ ├── NotoSansSC-Regular.ttf # 中文字体
│ │ ├── NotoSansSC-Medium.ttf
│ │ ├── NotoSansSC-Bold.ttf
│ │ ├── FiraCode-Regular.ttf # 等宽字体
│ │ └── ZCOOLXiaoWei-Regular.ttf # 展示字体
│ ├── i18n/
│ │ ├── zh.json # 中文(41 条)
│ │ └── en.json # 英文(41 条)
│ └── images/
├── android/
├── ios/
├── test/
├── deploy.sh # 一键发布脚本
├── serve.js # Web 静态服务器(Node.js, 端口 8080)
└── pubspec.yaml配置说明
API 地址
dart
// lib/core/config/app_config.dart
class AppConfig {
static const String appName = 'MengHub';
static const String apiBaseUrl = 'https://api.menghub.com'; // 生产
static const String wsBaseUrl = 'wss://ws.menghub.com'; // 生产
// 开发: https://dev-api.menghub.com
// 预发: https://staging-api.menghub.com
}HTTP 超时
| 配置 | 值 |
|---|---|
| 连接超时 | 15 秒 |
| 接收超时 | 15 秒 |
| 发送超时 | 15 秒 |
| 默认分页 | 20 条/页 |
HTTP 拦截器链
请求 → _AuthInterceptor(Bearer Token 注入 + 401 自动刷新)
→ _DeviceInterceptor(X-Platform: flutter + X-App-Version)
→ _RetryInterceptor(GET/HEAD/OPTIONS/DELETE 超时自动重试,最多 2 次)依赖注入(GetIt)
8 个 lazy singleton 服务:
| 服务 | 说明 |
|---|---|
| SecureStorageService | Token/密钥安全存储 |
| HttpClient | Dio HTTP 客户端 |
| WsClient | WebSocket 客户端 |
| LocalDatabase | SQLite 加密数据库 |
| ConnectivityService | 网络状态监听 |
| ScreenProtectService | 防截屏服务 |
| DeviceSecurityService | 设备安全检测 |
| ClipboardService | 剪贴板管理 |
一键发布
deploy.sh 执行 7 步发布流程:
bash
# 用法
./deploy.sh <versionName> <versionCode> "<releaseNotes>"
# 示例
./deploy.sh 1.0.4 4 "修复XX问题,新增XX功能"| 步骤 | 操作 |
|---|---|
| 1 | 更新 pubspec.yaml 版本号 |
| 2 | 更新 app_config.dart 版本常量 |
| 3 | flutter build apk --release |
| 4 | SCP APK 到演示服务器下载目录 |
| 5 | 更新服务器 version.json |
| 6 | 更新下载页 index.html |
| 7 | 验证部署 |
APK 下载地址:https://menghubdemo.softunis.com/menghub-v{version}.apk
设计系统(双色系 v2)
品牌色
| 名称 | 色值 | 用途 |
|---|---|---|
| 品牌金 | #EFC25C | 主色 |
| 柔金 | #F7DE94 | 辅助 |
| 深金 | #C98A1E | 强调 |
| 品牌铜 | #CF8E22 | 辅助色 |
深色背景层级
| 层级 | 色值 | 用途 |
|---|---|---|
| Base | #0A0A0C | 页面底色 |
| Card | #161618 | 卡片 |
| Elevated | #1E1E22 | 浮层 |
| Tertiary | #26262B | 三级元素 |
功能色
| 名称 | 色值 |
|---|---|
| 成功 | #3DDC97 |
| 警告 | #EFC25C |
| 错误 | #FF4D6D |
| 信息 | #6BA8FF |
字体配置
| 字体 | 用途 |
|---|---|
| Sora | 标题(H1-H3)、按钮 |
| Inter | 正文 |
| Noto Sans SC | 中文 |
| Fira Code | 等宽/代码 |
| ZCOOL XiaoWei | 默认(AppBar) |
组件库
| 组件 | 说明 |
|---|---|
| AppAvatar | 圆角方形头像 + 渐变回退 |
| AppAvatarCircle | 圆形头像 |
| AppBadge | 通知角标(数字/圆点) |
| EmptyState | 空状态占位 |
| LoadingIndicator | 金色加载圈 |
| GoldGradientText | 金色渐变文字 |
| AppCard | 深色卡片(边框 + 阴影) |
| AppSearchBox | 药丸搜索框 |
| AppChip | 可选筛选标签 |
| UpdateDialog | APK 更新弹窗(进度条) |
国际化
两种语言,41 条翻译键值:
| 语言 | 文件 |
|---|---|
| 中文 | assets/i18n/zh.json |
| 英文 | assets/i18n/en.json |
默认语言:中文。
API 响应格式
json
{
"code": 0,
"message": "success",
"data": {}
}code: 0或code: 200表示成功- 分页响应使用
list/total/page/pageSize字段 PagedData<T>自动计算hasMore
平台支持
| 平台 | 状态 | 说明 |
|---|---|---|
| Android | 活跃 | APK 构建发布,min SDK 24 |
| iOS | 已搭建 | ios/ 目录存在,未发布 |
| Web (H5) | 可用 | flutter build web + Node 服务(端口 8080) |
| Desktop | 未配置 | 无 linux/macos/windows 目录 |
下一步
- 功能模块 — 各模块功能详情
- MengHub 概述 — 返回产品概述

