对于Android老项目来说接入flutter的最佳方式就是添加 flutter module,让主module通过模块依赖方式来依赖flutter。
回顾下小步骤,因为网上资料很多,不详细描述了。
1 创建 flutter module
在当前project下 运行命令
flutter create -t module my_flutter(my_flutter为生成的flutter module名称)
复制代码
2增加配置代码
在工程的settings.gradle增加以下配置
setBinding(new Binding([gradle: this])) // new
evaluate(new File( // new
settingsDir.parentFile, // new
'yq_flutter/.android/include_flutter.groovy' // new
))
复制代码
在app 的gradle里添加
implementation project(':my_flutter')
复制代码
这样就可以边开发,边编译看效果了。
合成中间产物
不过随之而来的问题是:现在flutter毕竟属于小众开发,团队内部只有几个人来做,而其他人不需要关注flutter的东西,上边的依赖方式需要安装flutter 环境,下载sdk等,否则无法编译项目,所以还需要以依赖jar/aar的方式来集成。
下边具体描述一下。 你新建的flutter module可以用另一个Android studio 窗口独立打开,基本的目录结构是 在as终端里输入
flutter build apk
复制代码
可以生成一个release的apk,同时在rootProj/.android/Flutter/build/outputs/aar/目录下生成aar,把这个aar拷出来直接放到你原生项目里取依赖便可以摆脱依赖module的麻烦。 不过要规范点的话还需要在你们公司的自建nexus maven(或jcenter)上上传aar,通过地址依赖。参考普通aar的打包上传方式会发现能生成aar,但是运行会失败,因为aar中没有打包进Flutter的编译产物。 正常生成的aar中结构图
assets 文件夹中的 isolate_snapshot_instr , isolate_snapshot_data, vm_snapshot_data , vm_snapshot_instr 为Flutter编译中间产物,flutter_assets 内为资源文件,包含字体,图片,此外还有需要的插件部分原生代码和sdk的jar等。普通的gradle构建无法打包进中间产物和资源文件,所以参考flutter 项目中的gradle 文件内容,可以看到,是在普通的gradle构建过程中加入了flutter gradle脚本
具体内容可以进入sdk目录去查看,它的工作其实就是copy那些产物进你的apk文件,所以我们可以先本地构建apk,然后解压它,取出产物,复制到你的项目中,然后重新构建然后上传到maven,参考网上的一些资料,修改了一个脚本供使用。其中你可能需要修改的部分就是你们公司自用的uploadArchives脚本了。
构建脚本
然后在你的项目中依赖,甚至增加配置开关控制是aar依赖还是module依赖
gradle.properties 开关
FLUTTER_DEBUG = true
复制代码
原生module中依赖
if(FLUTTER_DEBUG.equals("true")){
implementation project(':flutter')
}else {
implementation 'com.xxx.xxx:my-flutter:1.0.0.@aar'
}
复制代码
附:
1、遇到的gradle版本兼容问题
我目前用的andrdoid studio 3.1.4, android gradle plugin 插件版本是3.2.1, gradle版本是4.10.2,打包aar的时候报错提示:本地gradle是4.4,最低要求4.6,我很是不解,本地明明比4.6还高,查看了下官网gradle和plugin的匹配版本,貌似也没问题。一番折腾后,把plugin版本降低到了3.1.2,gradle改为4.4才运行正常,查看了flutter sdk的gradle版本也是3.1.2。只是这个报错提示让我很无奈。
2、我本地的flutter 环境,供参考
[✓] Flutter (Channel master, v1.5.9-pre.235, on Mac OS X 10.13.6 17G65, locale zh-Hans-CN)
[✓] Android toolchain - develop for Android devices (Android SDK version 28.0.3)
[✓] iOS toolchain - develop for iOS devices (Xcode 10.1)
[✓] Android Studio (version 3.2)
[✓] VS Code (version 1.30.2)
[✓] Connected device (1 available)
复制代码
【更新】
2019.5.27
之前的打包有个问题,假如你的flutter module又依赖了三方的flutter plugin,打包之后没法把plugin内容也打进去。
恋猫的小郭给了一个方案: github.com/CarGuo/flut…, 借助fat-aar来构建。
一、 flutter module 中
1 使用插件
apply plugin: 'com.kezong.fat-aar'
2 在dependencies 中添加
def flutterProjectRoot = rootProject.projectDir.parentFile.toPath()
def plugins = new Properties()
def pluginsFile = new File(flutterProjectRoot.toFile(), '.flutter-plugins')
if (pluginsFile.exists()) {
pluginsFile.withReader('UTF-8') { reader -> plugins.load(reader) }
}
plugins.each { name, _ ->
println name
embed project(path: ":$name", configuration: 'default')
}
二、 project 中的 build.gradle 里添加
classpath 'com.kezong:fat-aar:1.0.3'
三、setting.gradle 中 添加
def flutterProjectRoot = rootProject.projectDir.parentFile.toPath()
def plugins = new Properties()
def pluginsFile = new File(flutterProjectRoot.toFile(), '.flutter-plugins')
if (pluginsFile.exists()) {
pluginsFile.withReader('UTF-8') { reader -> plugins.load(reader) }
}
plugins.each { name, path ->
def pluginDirectory = flutterProjectRoot.resolve(path).resolve('android').toFile()
include ":$name"
project(":$name").projectDir = pluginDirectory
}
复制代码
此外,我又优化了下脚本,打包aar时中间产物和asset资源直接生成,不再需要去解压本地生成好的apk来获取了。 构建脚本