产品级Flutter开源项目FunAndroid，Provider MVVM的最佳实践

基于Google的Flutter,及官方推荐状态管理Provider和玩Android开放的API，打造的一款产品级开源App《Fun Android》

Logo的里F，既表明了Fun也表明了Flutter.

先来点样图

项目地址

github.com/phoenixsky/…

下载地址

蒲公英下载页

代码编译

• Flutter SDK (Channel dev, v1.10.4)

• 若是要查看运行效果,必定要使用Release模式,流畅程度差距很是大

  Flutter的Debug和Release的编译模式不一样,下分别是 JIT 和 AOT.Debug模式支持hot reload.

• iOS运行在splash页面卡住,须要检查当前的scheme,若是为release,需在命令行执行flutter build ios

  

• 项目国际化部分依赖了AndroidStudio的插件flutter_i18n 须要在plugin仓库中,搜索Flutter i18n.安装插件成功后,重启AndroidStudio后,会生成lib/generated/i18n.dart文件

  具体方案和使用参考掘金-rhyme_lphlv的博文

介绍

借用群里水友的两句对白，在预览版出来时候

• 1A：话说玩Android的开源项目已经多如牛毛了。

• 3C：我想看最漂亮的。

感谢这位朋友对Fun Android的承认。

关于App的主题风格，不全是Google倡导的Material Design 也不全是Apple的Cupertino Style。因为我是一个Android开发者，但又长期使用的iPhone，因此App的风格是二者的结合又夹杂了点私货。我的认为iOS版本的确实好看点。

代码中存在的问题，请你们积极提Issue.

更新

V0.1.12 2019-10-21 (未发布)

• 下拉刷新列表在加载失败时,若是当前页没有数据显示错误提示页,有数据则弹出toast提示

V0.1.11 2019-10-17

• 增长网络加载失败的提示

V0.1.10 2019-10-16

• 修复收藏页面'shareUser'字段为空致使报错的bug

V0.1.9 2019-10-14

• 极致黑(Native的闪屏页面适配darkMode)
• 首页banner高度根据屏幕宽高适应
• 签名文件调整

V0.1.8 2019-10-13

• 文章列表加入分享人
• 首页加入数据为空的逻辑判断
• ViewStateModel中逻辑优化,bug fix
• 状态栏字体颜色优化
• 修复TextField中hint为中文时不居中的问题

V0.1.7 2019-09-23

• DarkMode自动跟随系统设置
• App更新组件调整
• 适配Dio3.0版本
• pull_to_refresh更新:加入国际化

V0.1.6 2019-09-20

• 修复收藏列表进入详情时,页面报错的bug

V0.1.5 2019-09-19

• Flutter SDK更新至Channel dev, v1.10.3,修复个人页面莫名卡死的问题
• 修改Android端App名称为Fun Android

V0.1.4 2019-09-18

• 适配Flutter 1.9.x
• Android加入版本更新
• 加入LeanCloud API云服务
• 移除修复首页黑屏问题的代码官方在1.10.1版本已修复
• 移除以前屏幕适配方案,对NativeView影响过大
• 修复版本更新致使的AppBar中进度条颜色与背景色不明显的问题
• 重构Http使用方式,解耦性更好
• 首页banner高度调整
• Android状态栏透明

2019-09-10

• flutter版本更新
• 适配更新AppBar区域CupertinoActivityIndicator的主题色彩冲突
• 移除OffState和Indicator的组合使用,优化性能
• 调整textField的clear实现方式,防止报错

2019-09-09

• 修复各页面里文章 收藏 状态没有同步的问题
  • 首页收藏后,其余tab页对应item的收藏状态同步
  • 个人收藏页面里移除收藏.其余页面状态同步
  • 登陆登出后各页面收藏状态刷新
  • 若是相同帐号在其余平台修改过收藏状态,只须要刷新列表便可同步收藏状态.(WanAndroid接口目前存在问题)
• 优化Dropdown弹出动画
• 首页初次加载数据禁用上拉记载更多功能
• 登陆页面输入框可经过回车键切换

2019-08-30

• 修复积分数值在登陆后没有刷新的bug
• 修复进入Splash页面短暂黑屏的bug
• 修复未登陆时,点击收藏还能够播放动画的bug
• 默认主题色调整为亮色

2019-08-29

• 添加积分记录和排行榜功能

2019-08-28

• 在设置中添加WebViewPlugin的开关
• 在详情中移除收藏后,回到收藏列表页面自动刷新

2019-08-26

• 更新收藏动画的实现方式,以前实现的方式侵入性太强，每一个页面都要先隐藏一个小❤❤。如今换了路由➕Hero的思路，从新调整了Flare。显示动画一行代码就ok。(若是你运行代码以后发现,该动画与图上会有一丝丝不一致,列表项右下角的当心会闪一下.不用担忧那是flutter的bug,目前在master分支已经修复.见pr-37341)

项目结构

Provider MVVM的简单使用方式

• 快速添加一个拥有下拉刷新,上拉加载更多的页面.好比开发一个玩Android首页列表页面
  1. Model

     

  2. ViewModel

     

  3. View

     

以上是Provider结合ViewModel的基础使用方式,考虑了App中会出现的比较全面的状况,但愿你们一块儿探讨使用方式

另外在判断页面状态的时候,其实拿model.viewState == ViewState.busy会更严谨一点.为了书写方便,加了一个对应方法

这里能找到什么？

1. Provider状态管理的最佳实践，虽然Google很早就废弃了Provide，宣布Provider为推荐的状态管理工具，但是在开发中，咱们老是会遇到不少问题。

   1. 好比Provider的几个衍生类在具体的业务中应该怎么使用？

   2. 页面最初须要的数据何时进行初始化,在哪里初始化。

   3. 如何将页面的几个经常使用状态loading、error、empty、idle、unAuthorized进行组合使用。

   4. 经常使用的下拉刷新，上拉加载更多应如何服用才能效果更佳。

   5. Widget在dispose后，model再也不notify()。

2. 清晰的代码结构。

   1. 让页面归页面，让业务归业务，全部的业务逻辑都在view_model中，Widget只关注页面自己。

3. 不要再满屏幕的setState()。

   1. 同一页面内能够利用Flutter框架给咱们提供的各类XxxBuilder,来局部刷新。

   2. 多层嵌套可以使用前边提到的Provider。

   3. 固然颗粒度足够细的Widget，仍是要使用setState()。eg: ChangeLogPage中的ChangeLogView 功能单一，刷新不会影响别的widget。

4. 实现了App的基础功能，可copy看成模板代码快速开发

   1. 主题切换

   2. 夜间模式切换

   3. 字体切换

   4. 漂亮的骨架屏

   5. 利用IDE插件i18n进行国际化

   6. Dio结合Cookjar，实现玩Android的登陆功能

   7. AnimationList结合SmartRefresh的常规数据加载

5. 固然还有WanAndroid自己也有不错的内容，每日闲暇时，能够读一读。

未完成的功能

1. 首页二楼目前是我我的的blog，也没法前进后退。后期会放一个flutter专题。

2. Hero动画，在非最后一个tab登录时，logo的动画会漂移到最后一个，须要加状态判断。

3. 退出登录加入动效。

目前已知存在的问题

1. webview_flutter 插件的问题仍是不少，有些连接点击会没有反应，不会跳转。因此接入了两套WebView方案

2. webview_flutter 不能结合CustomScrollView滑动。见issue 。

3. 两个一样颜色的widget，中间莫名其妙的会多一条背景色的线。见issue 。

Future

• 后期会上线大量博客，来说述这个项目里所遇到的问题及解决的思路。

寻找组织

• Fun Flutter微信交流群
  

做者的话

• 坐标上海,打算找Flutter方向的工做.4年Android开发经验.

感谢

1. 感谢 V2Lf 开源项目，很早就在TestFlight中下载了该App,那时还没开源。萌生了想作一个开源的App的想法。

2. 借鉴了goweiiWanAndroid项目的UI，最美原生版WanAndroid，感谢。

3. 在实践Provider时，发现了Tutorials,做者Youtube的教程很好。

4. 感谢优秀的pull_to_refresh刷新库。

5. 感谢站酷提供的开源的字体。

6. 感谢WanAndroid提供的API。

关于做者

• Github
• 我的博客
• 掘金
• 简书
• Email: moran.fc@gmail.com

License

Copyright 2019 phoenixsky

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

www.apache.org/licenses/LI…

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.