使用Flutter Module
实现组件化的思路:
Flutter组件化
使用Flutter Package
实现组件化思路:
Flutter 组件化开发实践概述
组件化的优点:
- 各个模块相互独立,方便管理
- 抽离出功能,方便多个
app
复用 - 方便单元测试
组件化思路:
一、选择模块化的方式
有2种方式可实现:Flutter Package
和Flutter Module
区别:
Flutter Package
:用于单独的Flutter
、Dart
代码,不依赖与原生iOS/Android
代码,生成的Package
目录里没有iOS/Android
目录,可创建example
flutter
项目配合测试。Flutter Module
:常用于在原生iOS/Android
项目中集成Flutter
项目的混合开发,创建的Module
中有.iOS
/.android
目录,单独的Module
可单独在iOS
和Android
上运行测试。
二、模块存放位置
- 可与原有项目放在一起,在
pubspec.yaml
中使用path
来引入 - 将模块放入
git
库中,在pubspec.yaml
中使用url
来引入 - 建立私有
pub
,将模块发布到私有pub
上
三、将项目划分不同的模块
- 网络模块(
Network Package
) - 通用的基础类和工具类(多个
Common Package
) - 业务模块A(
A Package
) - 业务模块B(
B Package
) - 业务模块...
单个模块提供一个对外的dart
来供导入使用,模块内部使用export
对内部文件进行细粒度的暴露。
library common_service;
export 'a.dart';
export 'b.dart';
四、单独测试模块
- 如果使用
Flutter Module
,可单独运行Module
- 如果使用
Flutter Package
,可创建Flutter example
测试项目来测试
五、加载Package
或Module
里的资源文件
单个组件的安装包和整个组件的安装包资源位置不一样。
- 在
Package
或Module
里运行:正常的使用方法,比如'images/base/login_button.png'
- 在主项目里运行
Package
或Module
:在正常使用方法的路径前增加'packages/模块名/'
,比如'packages/login_module/images/base/login_button.png'
资源引入路径不一致解决方案:
可通过主项目运行时,往模块中传入自定义参数,根据参数判断资源引用的路径前是否添加'packages/模块名/'
。
bool.fromEnvironment
可用来判断是否是生产环境,比如final isProduct = const bool.fromEnvironment('dart.vm.product');
,也可以用来判断自定义参数,比如flutter run --dart-define=IS_ADD_PACKAGE_PATH=true
,参数名称为IS_ADD_PACKAGE_PATH
,值为true
。
代码中使用:
// 定义全局变量
static const IS_ADD_PACKAGE_PATH = bool.fromEnvironment('IS_ADD_PACKAGE_PATH', defaultValue: true);
// 具体使用
'${IS_ADD_PACKAGE_PATH ? 'packages/login_module/' : ''}images/base/login_button.png'
- 命令行
flutter run
运行添加自定义参数:
flutter run --dart-define=IS_ADD_PACKAGE_PATH=true
- Android Studio运行添加自定义参数:
在main.dart
的run/debug configrations中配置,如下:
六、减少各模块之间的耦合
比如主项目引用模块,模块引用主项目,会出现很多耦合,尽量减少。
解决思路:
- 组件引入主项目的耦合部分,尽量抽取为公共库
- 在路由上做文章,减少引入