本篇将带你深入了解 Flutter 中打包和插件安装等原理,帮你快速完成 Flutter 集成到现有 Android 项目,实现混合开发支持。
前文:
一、前言
随着各种跨平台框架的不断涌现,很多时候我们会选择混合开发模式作为脚手架 ,因为企业一般不会把业务都压在一个框架上,同时除非是全新项目,不然出于对原有业务重构的 成本和风险 考虑,都会选择混合开发去尝试入坑。
但是混合开发会对 打包、构建和启动等流程熟悉度要求较高 ,同时遇到的问题也更多,以前我在React Native也写过类似的文章 :《从Android到React Native开发(四、打包流程解析和发布为Maven库)》 ,而这方面是有很多经验可以通用的,所以适当的混开模式有利于避免一些问题,同时只有了解Flutter整体项目的构建思路,才有可能更舒适的躺坑。
额外唠叨一句,跨平台的意义更多在于解决多端逻辑的统一 ,至少避免了逻辑重复实现,所以企业刚开始,一般会选择一些轻量级业务进行尝试。
官方未来将有Flutter build aar的方法可提供使用。
二、打包
一般跨平台混合开发会有两种选择:
- 1、将Flutter整体框架依赖和打包脚本都集成到主项目中。
- 2、以aar的完整库集成形式添加到主项目。
两种实现方法各有利弊:
-
第一种方式可以更方便运行时修改问题,但是对主项目“污染”会比较高,同时改动会大一些。
-
第二种方式 需要单独调试后,更新aar文件再集成到项目中调试,但是这类集成方式更干净,同时Flutter相关代码可独立运行测试,且改动较小。
一般而言,对于普通项目我是建议以 第二种方式集成到项目中的 ,通过新建一个Flutter工程,然后对工程进行组件化脚本处理,让它 既能以 apk形式单独运行调试,又能打包为aar形式对外提供支持。
相信对于原生平台熟悉的应该知道,我们可以通过简单修改项目gradle脚本,让它快速支持这个能力,如下图片所示,图片中为省略的部分脚本代码,完整版可见 flutter_app_lib 。
我们通过了isLib标记为去简单实现了项目的打包判断,当项目作为lib发布时,设置isLib为 true,之后执行./gradlew assembleRelease即可 ,剩下的工作依旧是Flutter自身的打包流程,而对于打包后的aar文件直接在原生项目里引入即可完成依赖。
而一般接入时,如果需要token、用户数据等信息,推荐提供定义好原生接口,如init(String token, String userInfo)等,然后通过MethodChannel将信息同步到Flutter中。
对于原生主工程,只需要接入aar文件,完成初始化并打开页面,而无需关心其内部实现,和引入普通依赖并无区别。
你可能需要修改的还有AndroidManifset中的启动MainActivity移除,然后添加一个自定义Activity去继承FlutterActivity完成自定义。
三、插件
如果普通情况下,到上面就可以完成Flutter的集成工作了,但是往往事与愿违,一些Flutter插件在提供功能时,往往是通过原生层代码实现的,如flutter_webview、android_intent、device_info等等,那这些代码是怎么被引用的呢?
这里稍微提一下,用过React Native的应该知道,带有原生代码的React Native插件,在npm安装以后,需要通过react-native link命令完成安装处理。 这个命令会触发脚本修改原生代码,从而修改gradle脚本增加对插件项目的引用,同时修改java代码实现插件的模版引入,这使得项目在一定程度被插件“污染”。
在React Native中带有原生代码的插件,会被以本地Module工程的方式引入,那Flutter呢?
其实原理上 Flutter带有原生代码的插件,在插件安装后,也是会以本地Module Project的形式引入 ,但是它整个过程更加巧妙,让开发中对这个过程几乎无感。
如下图所示,不知道你注意过没有,在插件安装之后,所有带原生代码的插件,都会以路径和插件名的key=value形式 存在.flutter-plugins文件中。
而在android工程的settings.gradle里,如下图所示,会通过读取该文件将.flutter-plugins文件中的项目一个个include到主工程里。
之后就是主工程里的apply from: "$flutterRoot/packages/flutter_tools/gradle/flutter.gradle"脚本的引入了,这个脚本一般在于flutterSDK/packages/flutter_tools/gradle/目录下,如下代码所示,其中最关键的部分同样是 读取.flutter-plugins文件中的项目,然后一个一个再implementation到主工程里完成依赖。
自此所有原生代码的Flutter插件,都被作为本地Module Project的形式引入主工程了 ,最后脚本会自动生成一个 GeneratedPluginRegistrant.java 文件,实现原生代码的引用注册, 而这个过程对你完全是无感的。
说了那么多就是为了说明,既然插件是被当作本地Module Project的形式引入,那么这时候按照原来直接打包 aar 是会有问题的:
`Android` 默认 `gradle` 脚本打包时,对于 `project` 和远程依赖只会打包引用而不会打包源码和资源。
所以这时候就需要fat-aar的加持了,关于fat-aar的详细概念可见 :《从Android到React Native开发(四、打包流程解析和发布为Maven库)》 ,这里可以简单理解为,这是一个支持将引用代码和资源到合并到一个 aar 的插件。
如下代码所示,我们在原本的组件化脚本上,通过增加apply plugin: 'com.kezong.fat-aar'引入插件,然后参考Flutter脚本对.flutter-plugins文件中的项目进行embed依赖引用即可 ,这时候再打包出的aar文件即为完整Flutter项目代码。
http://www.developcls.com/qa/85f978c0aafc4fa8bdf99f9f826b2e27.html
完整版可见 flutter_app_lib 。
四、堆栈
最后需要说的问题就是堆栈了。
如果说混合开发中最难处理的是什么,那一定是各平台之间的堆栈管理,一般情况下我们都会避免混合堆栈的相互调用 ,但是面对不得不如此为之的情况下,闲鱼给出了他们的答案:fluttet_boost。
我们知道Flutter整个项目都是绘制在一个Surface画布上,而fluttet_boost将堆栈统一到了原生层,通过一个单例的flutter engine进行绘制。
每个FlutterFragment和FlutterActivity都是一个Surface承载容器,切换页面时就是切换Surface渲染显示,而对于不渲染的页面通过Surface截图缓存画面显示。
这样整个Flutter的路由就被映射到原生堆栈中,统一由原生页面堆栈管理,Flutter内每push一个页面就是打开一个Activity。
flutter_boost截止到我测试的时间 2019-05-16, 只支持 1.2之前的版本。flutter_boost的整体流程相对复杂,同时对于Dialog的支持并不好,且业务跳转深度太深时会出现黑屏问题。
自此,第十四篇终于结束了!(///▽///)
资源推荐
- Github : github.com/CarGuo
- 本文Demo :github.com/CarGuo/flut…
- 推荐完整代码 :github.com/CarGuo/GSYG…
- 开源 Flutter 多案例学习型项目: github.com/CarGuo/GSYF…