Flutter完整开发实战详解(十四、混合开发打包 Android 篇)
本篇将带你深入了解 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项目代码。
完整版可见 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 : https://github.com/CarGuo
- 本文Demo :https://github.com/CarGuo/flutter_app_lib
- 推荐完整代码 :https://github.com/CarGuo/GSYGithubAppFlutter
完整开源项目推荐:
文章
《Flutter完整开发实战详解(一、Dart语言和Flutter基础)》
《Flutter完整开发实战详解(四、Redux、主题、国际化)》
《Flutter完整开发实战详解(六、 深入Widget原理)》
《Flutter完整开发实战详解(十、 深入图片加载流程)》
《Flutter完整开发实战详解(十一、全面深入理解Stream)》
《Flutter完整开发实战详解(十二、全面深入理解状态管理设计)》
《Flutter完整开发实战详解(十三、全面深入触摸和滑动原理)》
- Flutter 完整开发实战详解(一、Dart 语言和 Flutter 基础)
- Flutter完整开发实战详解(十七、 实用技巧与填坑二)
- Flutter完整开发实战详解(十六、详解自定义布局实战)
- Flutter完整开发实战详解(十五、全面理解State与Provider)
- Android网络开发技术实战详解
- android应用开发详解(十四)------------------Intent的ComponentName属性
- 在Android开发中使用Ant 二:进行一次完整的打包
- 【书摘001】android 底层开发技术实战详解 - 基础 - 进程管理的一些常用命令
- 混合APP开发之android离线打包环境搭建
- Flutter开发之Android应用打包发布(22)
- android应用开发详解(十四)-------------Intent的Extras属性(续)
- 混合开发-cordova打包Android
- 【备忘】2016年黑马android安卓74期完整实战开发基础就业视频
- 2019新版高级Android开发之移动架构篇项目实战(完整)
- Android 软件开发之数据的 新建 储存 读取 删除 详解(十四)
- android应用开发详解(十四)--------------Intent的Action属性(续)
- Android底层开发技术实战详解——内核、移植和驱动
- b+c 模式 H5 与 Android 混合 开发详解
- 【转载】Android 软件开发之数据的 新建 储存 读取 删除 详解(十四)
- 在Android开发中使用Ant 二:进行一次完整的打包