Mood-Example

Mood Example

情绪记录 样例工程
管理自己的情绪，记录当下所见所想，以及其他实验室功能（不定期更新一些功能）
运用 Flutter 的工程，主要目的是学习、实践。

[!NOTE]
注意：由于是学习实践工程，所以重点在于学习，许多业务逻辑可能并不符合现实。
Emoji 因设备缘故，会存在不同样式。

🌏 相关网站

Flutter 官网（中文）：https://flutter.cn/
Flutter 官网（英文）：https://flutter.dev/
Packages (原始站点) ：https://pub.dev/
Packages (中国镜像) ：https://pub-web.flutter-io.cn/

⭐ 功能

• 国际化 i18n l10n
• 多主题
• 深色模式
• 本地数据管理
• 路由管理
• 状态管理
• 集成测试
• 情绪记录
• 图表统计
• Excel 导入导出
• 无障碍支持 (Semantics)
• Web 访问
• 解锁认证（锁屏密码、生物特征识别）
• 本地通知
• 动画
• 实验室（占用 APP 大部分包体积，源码位置查看项目结构）
  • uniapp 小程序（UniMPSDK v4.85）
  • 游戏合集（Bonfire, Flame）
  • 3D 城市（obj 格式）
  • FFI (Hooks) 异步调用 C/C++
    ……

🛠️ 开发环境

🛠️ 基本环境

Windows:

[√] Flutter (Channel stable, 3.47.4, on Microsoft Windows)
[√] Android toolchain - develop for Android devices (Android SDK version 37.0.0)

macOS:

[✓] Flutter (Channel stable, 3.47.4, on macOS)
[✓] Android toolchain - develop for Android devices (Android SDK version 37.0.0)

🛠️ i18n l10n

官方国际化教程：中文站 | 英文站

├── lib/
│   ├── l10n/                   # l10n 语言包
│   │   ├── gen/                # l10n 语言包生成的文件夹（不用编码，自动生成）
│   │   └── app_zh_CN.arb       # 如 简体中文：zh_CN
│   ├── shared/
│   │   ├── config/
│   │   │   └── language.dart   # 语言配置
├── l10n.yaml                   # l10n 配置
......

🎉 启动

在 开发环境 支持的情况下

# 克隆项目
$ git clone https://github.com/AmosHuKe/Mood-Example.git

# 获取依赖
$ flutter pub get

# 启动项目或相关 IDE 启动
$ flutter run

# 更多启动模式
$ flutter run --debug/release/profile/test

# 清理构建缓存
$ flutter clean

# 集成测试
$ flutter test integration_test/app_test.dart --dart-define=test_mode=true

📑 项目结构

├── android/                                          # Android 工程文件 
│   ├── app/
│   │   ├── libs/                                     # 包含 UniMPSDK 依赖库
│   │   ├── src/
│   │   │   ├── main/
│   │   │   │   ├── assets/                           # 包含 UniMPSDK 内容
│   │   │   │   │   ├── apps/                         # 包含 UniMPSDK 的 uniapp 小程序
│   │   │   │   │   └── data/                         # 包含 UniMPSDK 内容
│   │   │   │   ├── kotlin/com/example/moodexample/
│   │   │   │   │   ├── channel/                      # Flutter 与 Android 原生通信
│   │   │   │   │   │   ├── UniMpMethodCallHandler.kt # UniMPSDK 方法分发
│   │   │   │   │   │   └── UniMpMethodChannel.kt     # UniMPSDK 通道注册
│   │   │   │   │   ├── unimp/
│   │   │   │   │   │   ├── config/
│   │   │   │   │   │   │   └── UniMpConfigFactory.kt # UniMPSDK 初始化配置
│   │   │   │   │   │   ├── manager/
│   │   │   │   │   │   │   └── UniMpManager.kt       # UniMPSDK 管理
│   └── └── └── └── └── MainActivity.kt               # Flutter 的 Android 默认入口
├── assets/                                           # 静态资源文件
├── build/                                            # 编译或运行后产物
├── hook/                                             # FFI Hooks
├── integration_test/                                 # 集成测试
│   └── app_test.dart                                 # 集成测试入口 用例
├── ios/                                              # iOS 工程文件
│   ├── Runner/                                       # Runner
│   │   ├── UniMP/                                    # UniMPSDK 原生接入
│   │   │   ├── Channel/
│   │   │   │   └── UniMPMethodChannel.swift          # UniMPSDK 通道注册
│   │   │   ├── Config/
│   │   │   │   └── UniMPLaunchOptionsBuilder.swift   # UniMPSDK 启动参数构建
│   │   │   ├── Manager/
│   │   │   │   └── UniMPManager.swift                # UniMPSDK 管理
│   │   │   ├── UniMPAppDelegate.swift                # UniMPSDK 生命周期代理
│   │   │   └── UniMPRegistrant.swift                 # UniMPSDK 能力注册
│   │   ├── UniMPSDK/                                 # 包含 UniMPSDK 内容
│   │   │   ├── Apps/                                 # 包含 UniMPSDK 的 uniapp 小程序
│   │   │   └── Core/                                 # 包含 UniMPSDK 依赖库
│   │   ├── AppDelegate.swift                         # Flutter 的 iOS 默认入口
│   │   ├── Info.plist                                # 项目配置
│   │   └── Runner-Bridging-Header.h                  # 依赖库引入
│   └── Podfile                                       # 依赖配置
├── lib/                                              # 工程相关文件（主要编码）
│   ├── data/                                         # 数据层
│   │   ├── dao/                                      # 原始数据访问操作
│   │   ├── database/                                 # 数据基础设施
│   │   │   ├── tables/                               # sqflite 数据表配置
│   │   │   ├── database.dart                         # sqflite 数据库相关
│   │   │   └── shared_preferences_db.dart            # shared_preferences 数据相关
│   │   └── repositories/                             # 仓库实现层（协调业务逻辑）
│   ├── domain/                                       # 领域层（业务抽象）
│   │   ├── models/                                   # 数据模型
│   │   ├── repositories/                             # 仓库抽象层（抽象业务接口）
│   │   └── use_cases/                                # 业务用例
│   ├── features/                                     # 视图
│   │   ├── home/                                     # 首页
│   │   ├── laboratory/                               # 实验室
│   │   │   ├── views/
│   │   │   │   ├── 3d/                               # 3D 城市
│   │   │   │   ├── ffi/                              # FFI 测试
│   │   │   │   ├── game/                             # 游戏合集
│   │   │   │   ├── tilt_example/                     # 倾斜视差卡片
│   │   │   │   ├── unimp_miniapps/                   # uniapp 小程序
│   │   │   └── └── laboratory.dart                   # 实验室首页
│   │   ├── mood/                                     # 心情页
│   │   ├── onboarding/                               # 用户引导页
│   │   ├── settings/                                 # 侧边设置栏
│   │   ├── statistic/                                # 统计页
│   │   ├── web_view/                                 # WebView
│   │   └── main_screen.dart                          # 主屏幕
│   ├── l10n/                                         # l10n 语言包
│   │   └── gen/                                      # l10n 语言包生成的文件夹（不用编码，自动生成）
│   ├── shared/                                       # 共享相关
│   │   ├── config/                                   # 配置
│   │   │   ├── dependencies.dart                     # 依赖注入
│   │   │   ├── language.dart                         # 语言配置
│   │   │   └── multiple_theme_mode.dart              # 多主题配置
│   │   ├── providers/                                # 状态管理
│   │   ├── themes/                                   # 主题相关
│   │   │   ├── multiple_theme_mode/                  # 多主题配色
│   │   │   │   └── theme_default.dart                # 多主题默认配色
│   │   │   └── app_theme.dart                        # 主题基础
│   │   └── utils/                                

提示：代码过长已自动截断

🤔️ 常见问题

Q: 小程序无法使用视频、地图等

├── UniMPSDK/
│   ├── Core/         # 核心库
│   ├── Features/     # 非核心功能库
......

Q: 在 APP 关闭后，通知失效

📦 Packages

感谢开源

🖼️ Illustration

Illustration by Tanya Krasutska from Ouch!

📄 License

Open sourced under the BSD-3-Clause license.
根据 BSD-3-Clause 许可证开源。
© AmosHuKe