纯 Flutter 工程的分层架构设计以及工程化实践

一家之言,勿喷。若有更好方案,欢迎共享。

前言

关于 Flutter 的教程已经有很多了,也有很多优秀的开源项目,这在一定程度上也增加了社区的活跃度。同时也有很多商业项目在实践,不过多数是将Flutter工程作为一个module来嵌入原生工程。官方有对应的教程来指导相关的工程化,网上的教程也很多。

但是一个纯 Flutter 工程的分层架构设计以及工程化的教程并不是很多。恰巧最近有个项目需要基于 Flutter 工程来搭建,对分层设计以及相应的工程化做了一些思考和调研,此仓库的目的即在于记录方案,与大家分享。

分层设计

分层设计和目前成熟的移动端的分层设计差不多,都是根据基础能力和业务模块对 App 进行分层以及组件划分,从而达到组件化的目的。
例如下图是一个很常见的移动端分层设计。

移动端分层.png

将与业务无关的基础能力剥离出来,沉淀到最底层,上层的业务都会基于这些能力去构建;中间划出一个业务能力层,多数是一些弱业务逻辑的模块,像分享、支付这样的能力;然后是业务模块,这些基本上就是用户可感知的界面以及业务逻辑了;最后是宿主App。基于这样的分层设计,宿主App一般都是个壳工程。

针对这样的设计,相应的组件间通信方案、工程化方案都已经很成熟,而且可选方案也很多。这里不再赘述,感兴趣的可以自行Google

所以我们的Flutter应该也是可以按照这样的分层去设计,但是由于Flutter开发中可能会遇到需要原生提供能力的场景,这样就会有一部分能力是基于原生能力封装的插件,但总的分层设计还是类似的。例如下图的分层设计:

flutter分层.png

工程化实践

目前网络上关于这一块的讨论比较少,如果你有看到相关的文章,欢迎共享。鉴于组内iOS的小伙伴是使用VSCode来开发的,所以工程化实践也是基于VSCode来操作的,不过这个应该影响不大。

模板工程介绍

我们先了解一下Flutter为我们提供的4中模板工程:App、Module、Plugin、Package

  1. App

我们一般都是创建一个App工程,这个模板工程会有androidios目录,对应存放的是两个平台的工程。

  1. Module

使用这个模板创建出来的工程,会有.android.ios目录,从模板的名称可以猜到应该是作为Module来使用的,官方对于这个模板的应用场景是将Flutter作为原生的一个子Module。这个模板创建的时候也会有main.dart文件,可以单独运行在你的设备上。

  1. Plugin

如果你需要封装基于原生能力的插件,就需要用到这个模板。

  1. Package

这是一个纯Flutter模块,没有androidios目录。

pubspec.yaml 配置介绍

看过Flutter教程的应该都了解,如果我们需要引用一些第三方库,就可以在这里配置,一般我们配置的都是发布在 pub.dev 上的开源项目。但其实,除了可以直接依赖pub.dev,他还支持本地依赖,git 仓库依赖。你可以这样操作:

dependencies:
  plugin1:
    git:
      url: "git://github.com/flutter/plugin1.git"
  fish_redux:
    path: my_package/fish_redux-0.3.1

另外git依赖还支持指定branch,指定子目录等。

好了,铺垫了这么多,是时候介绍我们的工程化方案了。

具体方案

鉴于目前还处于初步实践阶段,所以并没有将各个组件上传到git仓库,而是采用基于本地依赖的方式。因为各个组件可能会频繁变动,就会不停的切换工程等。等后期稳定后,可以采用git依赖的方式,达到供多个App使用的目的。

先来看一下整个工程的目录结构,如果你有一定的分层设计经验,应该很容易理解这个目录结构的设计。

目录结构.png

HostApp :壳工程目录
BusinessModule :业务模块目录
BusinessLib:业务能力目录,里面还有个二级的UI目录,存放一些和业务相关的公共UI组件
CommonLib :基础能力目录

按照上面的思路,我们首先需要一个壳工程,我们使用VSCode新建一个App工程,这里放在HostApp目录下。

接着我们在BusinessModule中新建四个业务模块工程,这次我们不再新建App工程,而是新建Module工程。我这边新建了module_homemodule_usermodule_taskmodule_setting四个工程。

同样,我们在BusinessLib中也新建几个工程,供测试使用,这里新建了lib_accountlib_pushlib_share,然后在UI目录中新建了lib_alertlib_bannerlib_loading。在CommonLib新建lib_databaselib_loglib_network。其中lib_accountlib_databaselib_networkPackage工程,lib_pushlib_sharelib_alertlib_bannerlib_loadingModule工程,lib_logPlugin工程。大家根据自己的实际场景去新建对应的模板工程。

这样所有的工程都放在对应的目录,为了方便管理,我们新建一个workspace来管理所有的工程。具体可以这样操作:

  1. VSCodeNew Window
  2. Add Folder to Workspace...,选择我们的根目录
  3. Save Workspace As...,保存到我们的根目录

下次可以直接打开我们的workspace文件。

现在打开host_app工程的pubspec.yaml做如下配置,将BusinessModule中的组件引入进来。

dependencies:
  module_home:
    path: ../../BusinessModule/module_home
  module_user:
    path: ../../BusinessModule/module_user
  module_setting:
    path: ../../BusinessModule/module_setting
  module_task:
    path: ../../BusinessModule/module_task

保存后运行flutter pub get

这里有个小问题,就是使用workspace后,在host_app里面去引用module_home内定义的页面,没有代码提示,但是手动import后,编译都正常。不知道是Bug还是我使用的有问题。

我们在module_homemodule_usermodule_settingmodule_task中各新建一个页面,HomePageUserPageSettingPageTaskPage

我们在host_app的入口构建一个Tab页面,将我们的HomePageUserPage作为两个Tab加载进来。试着运行一下,感觉良好。

哇哦,基本的框架已经搭建出来了,虽然后续需要处理的事情还有很多,例如组件间的页面如何跳转、组件间如何通信,都需要有对应的方案实现。

且等我继续调研实践。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,126评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,254评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,445评论 0 341
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,185评论 1 278
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,178评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,970评论 1 284
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,276评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,927评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,400评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,883评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,997评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,646评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,213评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,204评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,423评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,423评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,722评论 2 345

推荐阅读更多精彩内容