Bedrock——基于MVVM+Provider的Flutter快速开发框架

简介

增长项目的扩展性,下降耦合性,提升开发速度。使数据双向流动,状态控制更为灵活,开发更为规范,项目结构更为清晰。git

凭着一些开发经验(其实就是从各原生/Flutter大佬na借鉴),整理出这款MVVM+Provider快速开发框架,同时在Pub里面收藏了经常使用且效果不错的插件,彻底能够知足平常开发(非基础性的临时注释掉了),我在pub和demo里尽量加了详尽的注释以及根据本身的开发经验所添加的一些想法,方便你们快速接入并使用。github

主要特性

一、MVVM+Provider,低耦合、逻辑分明、页面代码清晰。Provider提供的状态管理使页面控制和展示更为灵活方便

二、全局异常捕捉:接口业务型和语法型,业务型可根据须要进行处理(如未登陆、未受权、超时、无网等等)并实现页面自动切换,语法型能够跳转到指定页面避免红屏(还可在此页面作日志上传)。

三、基础类Basestate-State、BaseStatelessWidget-StatelessWidget和BaseSkeletonWidget,对经常使用功能函数进行了封装,轻松配 置骨架屏、屏幕适配、异形屏适配等

四、基类ProviderWidget-Provider和ViewstateModel-ChangeNotifier对 provider等的封装、底层封装了一些经常使用状态和异常处理功能

五、全局cookie默认SharedPreferences,基础拦截器自动上传app版本等(能够根据需求自定)

六、页面侧滑退出,路由管理模块,经常使用页面跳转动画的封装等

七、全局toast、骨架屏、缓存、格式化文字、图片选择裁剪和上传、瀑布流和各类Util这些都是优秀的插件所提供的功能(再次感谢全部开源做者)

八、基于Intl的国际化、APP主题切换。

九、你的viewmodel只要是继承ViewStateModel,并注册CacheDataFactory,就能够实现首次加载自动缓存,无网自动显示上次缓存(缓存方式采用的mmkv 高速缓存)
复制代码

使用方法

墙裂建议运行DEMO并查看源码和注释,以及pub中的注释(其中有不少使用频率很高的插件,能够查看他们的文档,熟练使用能提升开发效率)。api

很简单,以下操做:
    一、页面/wiget,继承Basestate/BaseStatelessWidget
    二、骨架屏继承BaseSkeletonWidget
    三、ViewModel(VM)继承 ViewStateModel的子类,如:SingleViewStateModel、RefreshListViewStateModel(也能够根据需求本身封装)
    
页面代码以下(页面请使用Basestate):

class APageState extends BaseState<APage>{
@override
 Widget build(BuildContext context) {
     return switchStatusBar2Dark(
     ///全局VM 如:用户VM,能够在登陆登出时对整个项目进行状态刷新和管理。
     ///框架本身也定义了一些经常使用地全局VM  可见DEMO
        child: Consumer<全局VM>(
        builder:(ctx,全局VM,child){
            ///当前页面的VM
            return ProviderWidget<当前页面VM>(
                model:初始化你的vm
                onModelReady:(model){
                    启动你的model,///可选
                }
                builder(ctx,你的vm,child){
                    reutrn 你的页面;
                }
            );
            
        }
        )
     );
 }

}
    
    
你的ViewModel(VM)代码:
///自定义ViewModel话,继承自ViewStateModel便可
class YourPageViewModel extends SingleViewStateModel{
    
}
复制代码

具体使用方法能够见DEMO缓存

GITHUB 集成

当你clone下项目后,能够看到一下几个文件:
    main ///入口
    base_framework ///bedrock 框架核心文件夹
    I10n  /// I10n插件建立,也多是得你本身手动建立,具体能够百度I10n 了解
    generated ///I10n 在你编辑语言文件后自动生成的 ,请不要编辑这个文件夹下的内容
    page ///你的项目页面  
    service_api  ///项目接口 对应原生的repository
    

我暂时没有打算把base_framework摘出来,经过pub来集成,由于我的可能都有本身的定制需求,pub集成并不便于按照本身的需求修改。 
何况,直接clone集成仍是很是简单的,只须要clone项目后将除了base_framework的其它文件夹删除便可。
复制代码

DEMO

主要分为两部分:功能性演示和综合性演示。请直接clone项目进行运行浏览,我在DEMO加了详尽的注释,强烈建议运行和阅读DEMO的代码。
复制代码

连接:Bedrockcookie

github.com/bladeofgod/…app

感谢

再次感谢广大开源者的奉献和大佬的分享,菜鸟的成长离不开各位的帮助。
此框架属于菜鸡初试身手,稚嫩之处还请海涵,不足之处欢迎斧正,不胜感激。复制代码
相关文章
相关标签/搜索