Flutter 应用开发模板

这是一个 Flutter 应用开发模板，一个音乐搜索播放 Demo App，集成了当前 Flutter 生态中最佳实践和主流技术栈。

相关项目

• lyrics_parser
• dart_music_api

Features

• 完整的项目结构设计
• 现代化的状态管理方案
• 类型安全的路由系统
• 日志追踪
• 支持暗黑模式切换

🛠 技术栈

核心依赖

• 状态管理: riverpod + hooks_riverpod - 官方推荐的反应式状态管理与缓存框架，搭配 hooks 使用
• 路由方案: go_router - 支持类型安全的声明式路由
• 网络请求: dio + retrofit - 类型安全的网络请求方案
• 数据序列化: freezed + json_serializable - 数据类生成方案
• 工具扩展: dartx - Dart 语言扩展集合
• 日志系统: talker - 日志追踪解决方案
• UI组件：styled_widget - 一种更简单的方式来构建 Flutter UI
• 简单持久化: 使用 shared_preferences 来保存用户设置等

🎯 快速开始

环境准备

确保已经安装了最新版本的 Flutter SDK，然后执行：

安装依赖

flutter pub get

运行 app 之前，运行 build_runner 来生成代码

flutter pub run build_runner watch

确保 build_ruunner 生成的代码是最新的

flutter test test/ensure_build_test.dart

📚 相关资源

• rierpod 阅读资料

  • 官方文档
  • 原理讲解博客, Flutter Riverpod 全面深入解析，为什么官方推荐它？

• styled_widget官方文档

• 寻找优秀 dart & flutter 库: https://fluttergems.dev/

• dart 宏 (试验中): https://dart.dev/language/macros

TODOS

• talker router logger and riverpod logger
• script to create new project from this template
• 保存日志到文件
• 路由权限管理 Demo
• Database
• test on windows or linux
• Make it work on web (remove cookieManager)
• musc_api logger
• music_api error handler
• music_api cancel network request when riverpod dispose
• Support web
• i18n
• 语义错误设计
  • 音乐 API error handler 返回统一错误，在统一的 CommonHandler 进行处理