flutter1.8打包aar上传maven集成到原生android工程

一.前言

    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文件做的修改都会丢失。

flutter1.8打包aar上传maven集成到原生android工程_第1张图片

    2.执行打包命令

flutter build apk

    就会发现在工程根目录/.android/Flutter/build/outputs/aar目录下会生成个aar文件,这个aar文件就是我们原生native工程需要引用的aar文件。

flutter1.8打包aar上传maven集成到原生android工程_第2张图片

    如果flutter工程中没有引用第三方插件的话,那么集成步骤到这里就基本结束了,只需要把这里生成的aar文件直接放到原生native工程lib文件夹中或者上传至maven 给原生nativie工程依赖就行了。

    但是随着flutter越来越完善,pub.dev上的开源插件也越来越多,本着不要重复造轮子的原则,我们不可避免的会使用一些优秀的第三方插件。但是使用 flutter build apk 命令打出来的aar是不包含第三方插件的jar的,那么我们原生native工程使用aar的时候,在涉及到第三方插件的功能处就会挂掉,会报NoSuchClassError。

    拿connectivity这个插件来举例,正常的打包命令无法将下图中的jar打进最终的aar中

flutter1.8打包aar上传maven集成到原生android工程_第3张图片

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的打包上传一条龙服务

    集成所需要的脚本如下:

flutter1.8打包aar上传maven集成到原生android工程_第4张图片

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,连这个集成工作都搞了一周,期间也大大小小踩了很多坑。文中如果有说的不对的地方,请多多指正。

你可能感兴趣的:(flutter1.8打包aar上传maven集成到原生android工程)