情绪记录
样例工程
管理自己的情绪,记录当下所见所想,以及其他实验室
功能(不定时更新一些功能)
运用 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.15)
- 3D 城市(obj 格式)
- 游戏合集(Bonfire, Flame)
- FFI 异步调用 C/C++
……
Windows:
[√] Flutter (Channel stable, 3.24.3, on Microsoft Windows [版本 10.0.22621.3007], locale zh-CN)
[√] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
[√] Visual Studio - develop Windows apps (Visual Studio Community 2022 17.11.5)
[√] Android Studio (version 2024.2)
[√] IntelliJ IDEA Ultimate Edition (version 2024.2)
[√] VS Code (version 1.94.2)
macOS:
[✓] Flutter (Channel stable, 3.24.3, on macOS 14.7 23H124 darwin-x64, locale zh-Hans-CN)
[✓] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
[✓] Xcode - develop for iOS and macOS (Xcode 15.4)
[✓] Android Studio (version 2024.2)
[✓] VS Code (version 1.94.2)
├── lib/
│ ├── config/
│ │ └── language.dart # 语言配置(用于列表选项)
│ ├── l10n/ # l10n 语言包
│ │ ├── gen/ # l10n 语言包生成的文件夹(不用编码,自动生成)
│ │ └── app_zh_CN.arb # 如 简体中文:zh_CN
├── 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
├── android/ # Android 工程文件
│ ├── app/
│ │ ├── libs/ # 包含 UniMPSDK 依赖库
│ │ └── src/
│ │ └── main/
│ │ ├── assets/ # 包含 UniMPSDK 内容
│ │ │ ├── apps/ # 包含 UniMPSDK 的 uniapp 小程序
│ │ │ ├── data/ # 包含 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.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 数据相关
│ ├── l10n/ # l10n 语言包
│ │ ├── gen/ # l10n 语言包生成的文件夹(不用编码,自动生成)
│ ├── models/ # 数据模型
│ ├── providers/ # 状态管理
│ ├── services/ # 数据服务
│ ├── themes/ # 主题相关
│ │ ├── multiple_themes_mode/ # 多主题配色
│ │ │ └── theme_default.dart.dart # 多主题默认配色
│ │ └── app_theme.dart # 主题基础
│ ├── 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 代码规范配置
├── l10n.yaml # l10n 配置
├── pubspec.lock # 依赖生成的文件(锁定依赖版本等)
└── pubspec.yaml # 核心配置文件(项目配置、依赖等)
点击展开
这是因为项目中只集成了核心基础库(因为仅作为集成演示),
许多功能库(比如视频、地图、分享、支付、登录、直播 pusher 等 SDK)没有集成,
如果你需要这些功能就需要自行集成。
比如在 iOS 中集成,需要先下载 UniMP_iOS_SDK ,
然后你会看见如下结构:
├── UniMPSDK/
│ ├── Core/ # 核心库
│ ├── Features/ # 非核心功能库
......
之后根据以下两个官方教程进行集成:
点击展开
在确认应用开启了通知的情况下,关闭 APP 后依旧无法通知。
这是因为部分品牌 Android 默认使用了电池节能策略。
解决:关闭应用的电池节能策略,并打开自启动
感谢开源
Illustration by Tanya Krasutska from Ouch!
Design by Mindfulness Concept App from Bogusław Podhalicz.
Open sourced under the BSD-3-Clause license.
根据 BSD-3-Clause 许可证开源。
© AmosHuKe