一.前言
flutter发布到现在也有一年多了,越来越多的猿加入flutter的大军当中。所在公司也非常鼓励使用新的技术,所以就想着把目前android项目中的某些页面替换为flutter。利用flutter的优点来提高移动端的开发效率。
二.集成方式介绍
flutter与原生native项目集成大致分为两种方式:
1. 官方解决方案:就是将flutter作为module让原生native工程直接依赖
2.闲鱼flutter集成方案:将flutter项目打包成aar上传至maven,原生native工程通过maven引用
两种方式各有优缺点,在这里我采用的是第二种方案。
三.集成步骤
因为也是初学flutter,在网上找了一大堆资料,最开始看到闲鱼团队的文章说是如果要把flutter项目打包成aar,需要自己手动编写脚本把flutter编译后的产物打包到aar中才能用。最后找到《Flutter混合开发之打包aar并上传到nexus》这篇文章,发现其实打包aar很简单,完全不需要写拷贝flutter编译后产物。当然也可能是闲鱼的解决方案对应的早起beta版本的flutter,目前我采用的flutter版本是1.8.3,下面结合网上找的资料把整个集成流程梳理下。
1. 运行命令创建flutter工程
flutter create -t module xxxx(工程名称)
以这种方式创建的工程结构如下,其中.android就跟我们原生native工程一样,里面有java代码,有build.gradle文件。一般我们不会选择去直接修改.android工程下的build.gradle文件,因为一旦flutter项目引用了新的第三方框架之后,运行 flutter pub get 命令之后,.android目录会重新被生成一次,对build.gradle文件做的修改都会丢失。
2.执行打包命令
flutter build apk
就会发现在工程根目录/.android/Flutter/build/outputs/aar目录下会生成个aar文件,这个aar文件就是我们原生native工程需要引用的aar文件。
如果flutter工程中没有引用第三方插件的话,那么集成步骤到这里就基本结束了,只需要把这里生成的aar文件直接放到原生native工程lib文件夹中或者上传至maven 给原生nativie工程依赖就行了。
但是随着flutter越来越完善,pub.dev上的开源插件也越来越多,本着不要重复造轮子的原则,我们不可避免的会使用一些优秀的第三方插件。但是使用 flutter build apk 命令打出来的aar是不包含第三方插件的jar的,那么我们原生native工程使用aar的时候,在涉及到第三方插件的功能处就会挂掉,会报NoSuchClassError。
拿connectivity这个插件来举例,正常的打包命令无法将下图中的jar打进最终的aar中
3.借助fat-aar打包完整的aar
前人栽树,后人乘凉。所幸flutter 插件不能被打进aar包的问题在网上已经有解决方案了,那就是借助fat-aar来把第三方插件的jar打进aar中。这里我就直接用了github上现成的方案了。
但是这个方案必须要去修改.android目录下的gradle脚本,来达到正确打包aar的目的。前面也说了.android目录会随着flutter pub get命令重新生成,这样就导致我们可能会时不时的去修改gradle文件,显得非常麻烦。不过网上的大佬为了解决这个问题,采用shell脚本来实现自动修改gradle文件然后打包上传aar,我这里结合自己的项目,精简了下shell脚本。
4.借助shell脚本完成flutter的打包上传一条龙服务
集成所需要的脚本如下:
flutter.sh: 打包脚本,完成对gradle文件配置修改、编译打包aar、上传aar的工作。
dependencies_gradle_plugin.gradle: 这个脚本在打包过程中会自动被.android/Flutter/build.gradle引用
setting_gradle_plugin.gradle:这个脚本在打包过程中会自动被.android/setting.gradle引用
gradle.properties:上传maven的配置信息
uploadArchives.gradle:上传aar脚本
这几个文件保持目录结构不变的话,只需要将gradle.properties里面的配置成自己的maven服务器地址,然后就可以直接用了。
文件下载地址:链接:https://pan.baidu.com/s/1_0aHcOYP58SbLwKZD8ehdw 密码:cb5v
5.原生native工程引用aar
flutter的aar上传到maven后,原生native工程就可以直接使用啦
implementation 'cn.thecover.flutter:thecover-flutter:1.0.18@aar'
四.后记
由于自己也是刚开始学习flutter,连这个集成工作都搞了一周,期间也大大小小踩了很多坑。文中如果有说的不对的地方,请多多指正。