Mood Example

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

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

🌏 相关网站

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

⭐ 功能

📱 测试运行环境

环境	支持版本
Android	最低：Android 5.0 (API 21)
iOS	最低：iOS 12.4

🛠️ 开发环境

🛠️ 基本环境

Windows

[√] Flutter (Channel stable, 3.10.2, on Microsoft Windows [版本 10.0.22000.1936], locale zh-CN)
[√] Android toolchain - develop for Android devices (Android SDK version 33.0.1)
[√] Visual Studio - develop for Windows (Visual Studio Community 2022 17.5.5)
[√] Android Studio (version 2021.3)
[√] VS Code (version 1.78.2)

macOS

[✓] Flutter (Channel stable, 3.10.2, on macOS 13.0 22A380 darwin-x64, locale zh-Hans-CN)
[✓] Android toolchain - develop for Android devices (Android SDK version 33.0.0)
[✓] Xcode - develop for iOS and macOS (Xcode 14.3)
[✓] Android Studio (version 2021.3)
[✓] VS Code (version 1.78.2)

🛠️ 国际化环境支持

安装编辑器插件：Flutter Intl

Visual Studio Code: Flutter Intl
IntelliJ / Android Studio: Flutter Intl

# 插件指令

# 初始化
Flutter Intl: Initialize

# 添加 Locale
Flutter Intl: Add locale

# 删除 Locale
Flutter Intl: Remove locale

等等...

使用 Flutter Intl: Add locale 输入 国际化（i18n）地区对照语言码，如简体中文：zh_CN，插件会自动在 lib/l10n 目录下生成对应的 arb 文件，我们只需要在 arb 文件中进行翻译。
arb 翻译工作完成后，将对应的语言添加到 lib/config/language.dart 内。
即可 适配设备首选语言 以及 在应用语言设置内进行切换。

├── lib
│   ├── config
│   │   └── language.dart   # 语言配置
│   ├── generated           # intl 语言包生成的文件夹（不用编码，使用 Flutter Intl 插件自动生成）
│   ├── l10n                # intl 语言包
│   │   └──intl_zh_CN.arb   # 如 简体中文：zh_CN
......

iOS 支持语言本地化还需要在 ios/Runner/Info.plist 进行如下编辑。

<key>CFBundleLocalizations</key>
<array>
    <string>en</string>
    <string>zh_CN</string>
    ...
</array>

🎉 启动

在开发环境支持的情况下

# 拷贝项目
$ 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

📑 项目结构

├── android                                         # Android 工程文件 
│   ├── app                       
│   │   ├── libs                                    # 包含 UniMPSDK 依赖库
│   │   └── src 
│   │   │   └── main                  
│   │   │   │   ├── assets                          # 包含 UniMPSDK 内容
│   │   │   │   │   ├── apps                        # 包含 UniMPSDK 的 uniapp 小程序
│   │   │   │   │   ├── data                        # 包含 UniMPSDK 内容
│   │   │   │   │   ├── uni-jsframework-vue3.js     # UniMPSDK
│   │   │   │   │   └── uni-jsframework.js          # UniMPSDK
│   │   │   │   └── kotlin                          
│   │   │   │   │   └── com                      
│   │   │   │   │   │   └── example    
│   │   │   │   │   │   │   └── moodexample
│   │   │   │   │   │   │   │   └── MainActivity.kt # Flutter 的 Android 默认入口
│   └── CMakeLists.txt                              # CMake（目前编译 FFI 需要的文件）
├── assets                                          # 静态资源文件
├── build                                           # 编译或运行后产物
├── integration_test                                # 集成测试
│   └── app_test.dart                               # 集成测试入口 用例
├── ios                                             # iOS 工程文件
│   ├── Classes                                     # Classes（目前存放 FFI 相关文件）
│   │   ├── include
│   │   │   └── dart_native_api                     # DartNativeAPI 接口库
│   │   └── ffi.cpp                                 # FFI 逻辑测试
│   ├── Runner                                      # Runner
│   │   ├── UniMPSDK                                # 包含 UniMPSDK 内容
│   │   │   ├── Apps                                # 包含 UniMPSDK 的 uniapp 小程序
│   │   │   └── Core                                # 包含 UniMPSDK 依赖库
│   │   ├── AppDelegate_UniMPSDK.swift              # 调用 UniMPSDK 主要逻辑代码
│   │   ├── AppDelegate.swift                       # Flutter 的 iOS 默认入口
│   │   ├── Info.plist                              # 项目配置
│   │   └── Runner-Bridging-Header.h                # 依赖库引入
│   └── Podfile                                     # 依赖配置
├── lib                                             # 工程相关文件（主要编码）
│   ├── common                                      # 公共相关
│   │   ├── local_auth_utils.dart                   # 本地认证（生物特征识别）
│   │   ├── notification.dart                       # 本地通知
│   │   ├── utils_intl.dart                         # 国际化工具
│   │   └── utils.dart                              # 工具
│   ├── config                                      # 配置
│   │   ├── language.dart                           # 语言配置
│   │   └── multiple_themes.dart                    # 多主题配置
│   ├── db                                          # 数据存储相关
│   │   ├── database                                # sqflite 数据表配置
│   │   ├── db.dart                                 # sqflite 数据库相关
│   │   └── preferences_db.dart                     # shared_preferences 数据相关
│   ├── generated                                   # intl 语言包生成的文件夹（不用编码，使用 Flutter Intl 插件自动生成）
│   ├── l10n                                        # intl 语言包
│   ├── models                                      # 数据模型
│   ├── services                                    # 数据服务
│   ├── themes                                      # 主题相关
│   │   ├── multiple_themes_mode                    # 多主题配色
│   │   │   └── theme_default.dart.dart             # 多主题默认配色
│   │   └── app_theme.dart                          # 主题基础
│   ├── view_models                                 # 业务逻辑
│   ├── views                                       # 视图
│   │   ├── home                                    # 首页
│   │   ├── menu_screen                             # 侧边设置栏
│   │   ├── mood                                    # 心情页
│   │   ├── onboarding                              # 用户引导页
│   │   ├── settings                                # 侧边设置栏-其他页面组件（实验室等）
│   │   │   └── laboratory                          # 实验室
│   │   │   │   ├── 3d                              # 3D 城市
│   │   │   │   ├── ffi                             # ffi 测试
│   │   │   │   ├── game                            # 游戏合集
│   │   │   │   ├── unimp_miniapps                  # uniapp 小程序
│   │   │   │   └── index.dart                      # 实验室首页
│   │   ├── statistic                               # 统计页
│   │   └── web_view                                # WebView
│   ├── widgets                                     # 通用组件相关
│   ├── application.dart                            # 主应用
│   ├── home_screen.dart                            # 主应用导航相关
│   ├── init.dart                                   # 初始化相关
│   ├── main.dart                                   # 主应用入口
│   └── routes.dart                                 # 路由管理
├── test                                            # 测试
├── .gitignore                                      # Git 提交仓库忽略文件配置
├── .metadata                                       # 当前 workspace 配置记录
├── analysis_options.yaml                           # Dart 语言代码规范
├── pubspec.lock                                    # 依赖生成的文件
└── pubspec.yaml                                    # 核心配置文件（项目配置、依赖等）

🤔️ 常见问题

Q: 在 iOS 无法打开 uni小程序或无法使用 UniMPSDK

点击展开

这是由于 UniMPSDK 官方提供的依赖超过大小限制。
本项目为了 iOS 端主要功能不受限，剔除了 UniMPSDK 中 Core/Libs 所有库。
详细目录说明可查看项目结构说明
跟着以下步骤可以恢复正常使用：

1、下载 UniMPSDK_iOS 库（如链接失效，请麻烦联系我）

链接: https://pan.baidu.com/s/1j1FgMfiFTwg5H8i5Rr0m_A 提取码: qbit

2、将 UniMPSDK 中 Core/Libs 所有库添加到项目中，具体如下：

使用 Xcode 打开 Mood-Example/ios 目录

右键项目目录 Runner/UniMPSDK/Core 文件夹
点击 Add Files to "Runner"...
找到下载的库，选中 UniMPSDK/Core/Libs 文件夹，
勾选 Destination: Copy items if needed，
选择 Added folders: Create groups，
点击 Add 添加完成

3、调用库并使用代码，具体如下：

解除 ios/Runner/Runner-Bridging-Header.h 中 #import "DCUniMP.h" 的注释
将 ios/Runner/AppDelegate_UniMPSDK.swift 中的所有逻辑代码复制到 ios/Runner/AppDelegate.swift 中

4、完成，启动 iOS，测试打开小程序

5、其他

官方 UniMPSDK iOS 集成教程

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

点击展开

在确认应用开启了通知的情况下，关闭 APP 后依旧无法通知。
这是因为部分品牌 Android 默认使用了电池节能策略。

解决：关闭应用的电池节能策略，并打开自启动

🖼️ Illustration

Illustration by Svetlana Tulenina from Ouch!

🎨 Design

Outcrowd. Mobile App - Onboarding with 3D
Taras Migulko. The Brainbob mobile app
Bogusław Podhalicz. Mindfulness Concept App

📦 Packages

感谢开源

Packages	License
bonfire	MIT License
card_swiper	MIT License
cupertino_icons	MIT License
ditredi	MIT License
excel	MIT License
fluro	MIT License
file_picker	MIT License
flutter_slidable	MIT License
flutter_zoom_drawer	MIT License
flutter_screen_lock	MIT License
flutter_smart_dialog	MIT License
provider	MIT License
remixicon	MIT License
awesome_notifications	Apache-2.0 License
flutter_screenutil	Apache-2.0 License
flutter_native_timezone	Apache-2.0 License
table_calendar	Apache-2.0 License
sqflite	BSD-2-Clause License
vibration	BSD-2-Clause License
animations	BSD-3-Clause License
fl_chart	BSD-3-Clause License
flutter_lints	BSD-3-Clause License
intl	BSD-3-Clause License
local_auth	BSD-3-Clause License
path_provider	BSD-3-Clause License
share_plus	BSD-3-Clause License
shared_preferences	BSD-3-Clause License
webview_flutter	BSD-3-Clause License

AmosHuKe/Mood-Example

AmosHuKe

Reviews

Repository Details