/Mood-Example

🐦 Flutter 3.0 心情记录 样例工程 - 国际化 i18n、uni 小程序、深色模式、多主题、本地数据管理、路由管理、状态管理(MVVM)、无障碍(Semantics)、集成测试、图表统计、Excel 导入导出、游戏……

Primary LanguageDartBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

Preview1


Logo Mood Example

Mood-Example v1.7.7 Flutter v3.3.8 Dart v2.18.4 BSD-3-Clause License

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

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

🌏 相关网站

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

⭐ 功能

  • 国际化 i18n
  • 多主题
  • 深色模式
  • 本地数据管理
  • 路由管理
  • 状态管理(MVVM)
  • 集成测试
  • 情绪记录
  • 图表统计
  • Excel 导入导出
  • 无障碍支持(Semantics)
  • Web 访问
  • 本地通知
  • 动画
  • 实验室(占用 APP 大部分包体积,源码位置查看项目结构)
    • uniapp 小程序(UniMPSDK v3.4.7)
    • 3D 城市(obj 格式)
    • 游戏合集(Flame、Bonfire)
      ……
  • 隐私解锁
    ……

📱 测试运行环境

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

🛠️ 开发环境

基本环境

Windows

[√] Flutter (Channel stable, 3.3.8, on Microsoft Windows [版本 10.0.22000.1098], locale zh-CN)
[√] Android toolchain - develop for Android devices (Android SDK version 31.0.0)
[√] Visual Studio - develop for Windows (Visual Studio Community 2022 17.4.0)
[√] Android Studio (version 2021.3)
[√] VS Code (version 1.70.0)

macOS

[✓] Flutter (Channel stable, 3.3.8, 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.1)
[✓] Android Studio (version 2021.3)
[✓] VS Code (version 1.73.0)

国际化环境支持

安装编辑器插件: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 默认入口
├── assets                                          # 静态资源文件
├── build                                           # 编译或运行后产物
├── integration_test                                # 集成测试
│   └── app_test.dart                               # 集成测试入口 用例
├── ios                                             # iOS 工程文件
│   ├── 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_notifications.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 城市
│   │   │   │   ├── game                            # 游戏合集
│   │   │   │   ├── unimp_miniapps                  # uniapp 小程序
│   │   │   │   └── index.dart                      # 实验室首页
│   │   ├── statistic                               # 统计页
│   │   └── web_view                                # WebView
│   ├── widgets                                     # 通用组件相关
│   ├── application.dart                            # 主应用
│   ├── home_screen.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 库(如链接失效,请麻烦联系我)

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

  • 使用 Xcode 打开 Mood-Example/ios 目录
  • 选择 Runner -> TARGETS(Runner) -> Build Phases -> Link Binary With Libraries
  • 点击 + 号并选择 Add Other... 找到下载好的 UniMPSDK 目录
  • 全选 UniMPSDK/Core/Libs 中所有库,完成添加

3、调用库并使用代码,具体如下:

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

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

5、其他

🖼️ Illustration

style--woolly
Illustration by Svetlana Tulenina from Ouch!

🎨 Design

Packages 许可证

感谢开源

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

License 许可证

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