Skip to content

使用指南 ​

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
HTTPDio ^5.11.0
本地存储sqflite_sqlcipher(加密)
默认主题深色模式(ThemeMode.dark)
许可证Apache 2.0

环境准备 ​

必需工具 ​

工具版本说明
Flutter3.13.5+跨平台框架
Dart SDK^3.13.5随 Flutter 安装
Java17Android 编译(JVM target 17)
Android SDKcompileSdk 37, minSdk 24Android 7.0+
Git2.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-dist

2. 安装依赖 ​

bash
flutter pub get

3. 运行 ​

bash
# Web(H5 预览)
flutter run -d chrome

# Android
flutter run -d android

# iOS
flutter run -d ios

4. 构建发布 ​

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 服务:

服务说明
SecureStorageServiceToken/密钥安全存储
HttpClientDio HTTP 客户端
WsClientWebSocket 客户端
LocalDatabaseSQLite 加密数据库
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 版本常量
3flutter build apk --release
4SCP 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可选筛选标签
UpdateDialogAPK 更新弹窗(进度条)

国际化 ​

两种语言,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 目录

下一步 ​

Released under the Apache 2.0 License.