一款零侵入的高效Flutter混合栈管理方案,你值得拥有!

Posted 涂程

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了一款零侵入的高效Flutter混合栈管理方案,你值得拥有!相关的知识,希望对你有一定的参考价值。

在实际的工作场景中,我们很难从零开始用纯Flutter去建设一个项目,也正是因为这样,Native+Flutter混合栈跳转管理使我们在混合开发的时候不得不首先考虑的问题,因为我们很难保证不会遇到下面的情况。

那么如何做技术选型困惑了不少想要做混开的同学,毕竟Flutter的生态还不是十分成熟,现成的解决方案和轮子并不多,而且还不一定好用,要么资源占用过高,要么侵入性太强。好在经过这几天的摸索,总结出来了一套方案,供大家学习参考,相互交流。


按照国际惯例,我先介绍一下目前市场上的一些解决方案以及存在的问题。

本文章基于Flutter版本:2.2 & Platform:Android

1.Google官方(多引擎方案)

即每次使用一个新的FlutterEngine来渲染Widget树。虽然Flutter 2.0之后的创建FlutterEngine的开销大大降低,但是依然没有解决每个FlutterEngine是一个单独isolate,如果需要Flutter①和Flutter②之间交互数据的话,将会非常麻烦。我们同样无法保证他们之间不会进行数据交互,因此Pass。

2.大名鼎鼎的闲鱼flutter_boost(单引擎方案)

flutter_boost最近发布了3.0的bate版本,摒弃了2.0版本对引擎的侵入(赞!),但是依然存在不少问题:

①:高居不下的未关闭issues与回复不及时之间的矛盾(可以理解,竟然还是有工作要做的)。

②:复杂的设计,在出现使用问题的时候,通过改flutter_boost源码解决的成本很高。

③:flutter方面耦合度较高,我必须使用flutter_boost提供的一系列Route相关的工具和Widget才能达到混合栈跳转的效果,如果我以后想要更换框架,那对代码的修改将是海量的。

于是乎成功把我劝退。

3.哈喽单车团队的flutter_thrio(单引擎方案)

该库的优劣作者已经说得很详细了,这里就不再赘述,感兴趣的朋友可以进传送门亲自查看。

4.字节跳动团队的Isolate复用方案和腾讯心悦团队的TRouter方案

很可惜,目前这两个方案并没有开源出来,但很可能字节团队的方案的侵入性相当高。


既然没有现成的方案,那就撸起袖子造一个,先来一个混合栈跳转的效果演示:

项目地址:github.com/wangkunhui/…

那么现在开始把上面的功能实现吧。

首先,要确定最终实现的目标,然后一步步朝着目标去完善:

目标一:复用FlutterEngine,避免额外的资源开销与FlutterEngine之间的通信成本。

目标二:Flutter Widget之间的跳转无需通过Native层控制(flutter_boost需要)。

目标三:每个打开的Flutter能且只能管理自己内部的栈,当前Flutter的Widget全部出栈后,退出当前Flutter。

目标四:支持Flutter带参数打开Native页面(返回值也可以支持,但目前还未添加进去)。

根据这些目标设计出来的模型图如下:

上图是依次交叉打开的5个Activity的栈信息示意图,可以分为三列,具体解释如下:

左侧的是Activity的栈信息,其中第二个和第四个挂载了Flutter,又分别打开了几个Flutter的Widget。

中间是FlutterEngine中的Widget栈示意图,因为复用FlutterEngine的原因,Widget A到Widget P都存在于一个栈中,而处在最底部的是一个空白的HostWidget,不负责任何业务逻辑,其目的就是保证其上方的业务相关的Widget能正常被Pop出栈(因为Flutter Navigator的最后一个Widget是无法被Pop的)。

右侧是对中间的FlutterEngine中Widget栈的管线信息说明,就是那些Widget是关联在那些HostActivity实例上的,为的就是能够控制我对Widget进行退栈操作的时候,知道退到哪个Widget时需要finish掉关联的Activity。

如果上面的描述不是很直观的话,那我举个栗子说明,我在HostActivity 实例2里打开两个Flutter页面,Widget O和Widget P,当这两个Widget完成自己的任务后,就要进行退出操作,当我退出Widget P时,界面就变成了Widget O,这是没问题的,然后我继续退出WIdget O,如果不进行特殊处理的话,FlutterEngine将会展示Widget N,这显然不是我们想要的。我们预期的结果是此时要finish掉HostActivity 实例2,展示NativeOneActivity,想要达到这样的效果,就需要认为的把FlutterEngine 栈里面在不同HostActivity实例中显示的Widget进行特殊的区分。

好了,理论工作已经做完了,接下来就是愉快的Coding时光,我们面临任务清单有以下几个:

一、如何对FlutterEngine进行复用?

二、FlutterActivity、FlutterFragment还是FlutterView?

三、如何监听FlutterEngine的栈变化信息?

四、如何把监听到的栈信息同步到宿主Activity实例?

五、如何处理宿主Activity和Flutter页面的同步?


第一个问题,首先实例化FlutterEngine:

/**
 * 初始化FlutterEngine
 * @param context 上下文
 * @param block 初始化状态回调 0 不需要初始化 1 开始初始化 2 初始化完毕
 */
@Synchronized
fun initFlutterEngine(context: Context, block: (status: Int) -> Unit) 
    //判断缓存已存在
    if (!FlutterEngineCache.getInstance().contains(FLUTTER_ENGINE)) 

        block(1)
        //初始化FlutterEngine
        var engine = FlutterEngine(context.applicationContext)
        //初始化BasicMessageChannel
        messageChannel = BasicMessageChannel(
             engine.dartExecutor,
             FLUTTER_MIX_STACK_CHANNEL,
             StringCodec.INSTANCE
        )
        //添加消息监听
        messageChannel?.setMessageHandler(messageHandler)

        this.initCallback = block
        //开始运行dart代码
        engine.dartExecutor.executeDartEntrypoint(
               DartExecutor.DartEntrypoint.createDefault()
        )					
        //缓存FlutterEngine
        FlutterEngineCache.getInstance().put(FLUTTER_ENGINE, engine)
     else 
        block(0)
    

FlutterEngineCache已经帮我们封装好了FlutterEngine的缓存功能,不过要怎么使用这个缓存呢?

官方提供的FlutterActivity类中有一个withCachedEngine的静态方法,可以帮助我们获取使用缓存的Intent实例,也可以继承FlutterActivity重写getCachedEngineId方法,达到FlutterEngine复用的效果,直接启动FlutterActivity就可以加载Flutter页面,非常的简单方便,但是如果有一些稍微复杂的场景时,FlutterActivity就有些不太够用了。

第二个问题,Flutter 2.0 为我们提供了三种Flutter容器,分别是FlutterActivity(FlutterFragmentActivity)、FlutterFragment和FlutterView,以满足我们不同场景下的使用,从这三个类注释文档的丰富程度上来看,官方是非常推荐我们直接使用FlutterActivity的。简单看下源码就能发现,不管是FlutterActivity还是FLutterFragment,都是基于FlutterView实现的。如果项目有指定的基类需要继承或者要实现原生UI+Flutter UI的情况,或是想要更早的预热Flutter的Widget,FlutterView无疑会更灵活一些,所以这里我就选择使用了普通的Activity+FlutterView,伪代码如下:

class HostActivity : AppCompatActivity()

  var flutterEngine //缓存中拿到的FlutterEngine
  var flutterChannel // BasicMessageChannel 下面会有专门的介绍
  var flutterView 
  onCreate()
    //在onCreate方法调用之初,就提前预热FlutterEngine,可以使Widget加载更流畅
    flutterEngine.lifecycleChannel.appIsResumed()
    //同样在onCreate中发送消息给FluuterEngine,提前替换我们要加载的Widget,方式有过渡效果
    flutterChannel.sendMessage(routePath)
    super.onCreate()
    setContentView(flutterView = createFlutterView())
  

  onResume()
    super()
    flutterEngine.lifecycleChannel.appIsResumed()
  

  onPause()
    super()
    flutterEngine.lifecycleChannel.appIsPaused()
  

  onDestroy()
    super()
    flutterView.detachFromFlutterEngine()
  

第三个问题,监听FlutterEngine里Widget栈信息的变化,在MaterialApp初始化的时候,有一个navigatorObservers的参数,支持我们添加navigator的变化信息(Navigator是Flutter提供的页面切换类)。

void main() 
  //这里使用了Get框架来演示,但这不是必须的
  var getApp = GetMaterialApp(
    initialRoute: RouterMapper.ROUTER_HOME,
    getPages: [
      GetPage(
          name: RouterMapper.ROUTER_HOST, //空白的HostView
          page: () => Host(),
          transition: Transition.rightToLeft),
      ...
    ],
    navigatorObservers: [RouteNavigatorObserver()],
  );
  runApp(getApp);
  RouterHelper.registerApp(); //在这里注册消息监听


class RouteNavigatorObserver extends NavigatorObserver 
  @override
  void didPush(Route<dynamic> route, Route<dynamic>? previousRoute) 
  	// 有Widget入栈 可以从route中获取name信息并同步到Native
  

  @override
  void didPop(Route<dynamic> route, Route<dynamic>? previousRoute) 
    // 有Widget出栈 可以从route中获取name信息并同步到Native
  

  @override
  void didReplace(Route<dynamic>? newRoute, Route<dynamic>? oldRoute) 
    // 新的Widget替换了前一个Widget 可以从newRoute&oldRoute中获取name信息并同步到Native
  

  @override
  void didRemove(Route<dynamic> route, Route<dynamic>? previousRoute) 
    // 一个Widget被remove了,一般不建议这么做
  

通过继承NavigatorObserver类并注册到navigatorObservers中,我们实现了对FlutterEngine中路由信息变化的监听,那么接着来下一个问题,我们如何把消息同步给Native?

**第四个问题,**Flutter提供了三种方式用来和Native交互数据,分别是BasicMessageChannel,MethodChannel和EventChannel,其中前两个是可以双向传递数据的,EventChannel只支持Native给Flutter传递数据,常用语系统消息的一个通知。MethodChannel用来传递方法调用,BasicMessageChannel用来传二进制数据,更适合我们的试用场景,接下来我们需要在Flutter和Native层住的BasicMessageChannel用来数据的交互。

那我们分别在Flutter和Native层创建BasicMessageChannel:

//Flutter
class RouterHelper 
  //注册消息通道
  static final _routerMessageChannel =
      BasicMessageChannel<String?>("flutter_router_channel", StringCodec());

  static registerApp() 
    //防止下面空异常
    WidgetsFlutterBinding.ensureInitialized();
    //注册消息监听
    _routerMessageChannel.setMessageHandler((String? message) async 
      if (message != null) 
        //native层传递过来的消息
      
    );
  

//Kotlin
fun initMessageChannel()
  var messageChannel = BasicMessageChannel(
      engine.dartExecutor,
      "flutter_router_channel",
      StringCodec.INSTANCE)

  messageChannel.setMessageHandler message, reply ->
      //处理Flutter发送的消息
  

消息的发送由BasicMessageChannel提供的send方法实现,在上面的一个问题中,我们已经通过监听Navigator来判断Flutter中页面的变化信息,接下来就要在监听方法中,把对应的信息发送到Native层进行处理,在Native层我们可以抽象出来一个接口,让HostActivity实现这接口,通过面向接口编程的方式,把消息分发到当前活跃的HostActivity中。而HostActivity中维护了一个栈来记录Flutter中栈信息的变化。

/**
 * flutter路由变化回调
 */
interface RouteCallback 
		//flutter route入栈消息
    fun onPush(route: String)
		//flutter route出栈消息
    fun onPop(route: String)
		//flutter route栈替换消息
    fun onReplace(newRoute: String, oldRoute: String)
		//flutter route被移除的消息
    fun onRemove(route: String)
		//flutter申请打开Native页面的消息
    fun routeNative(nativeRoute: String, params: HashMap<String, Any>? = null)
		//flutter route出栈消息
    fun getLifecycleOwner(): LifecycleOwner


class HostActivity : AppCompatActivity(), RouteCallback 
	  //记录flutter的路由栈信息
    private val routeStack: Stack<String> by lazy 
        Stack()
    

    //TODO RouteCallback接口的实现方法,在方法中对routeStack进行入栈和出栈操作

最后一个问题,我们需要用户进行返回操作的时候,Widget页面要和HostActivity保持同步,例如当前HostActivity只打开了一个Widget,那么这个Widget退出的时候,HostActivity也要同步finish掉,即使FlutterEngine中还存在其他的Widget。我们可以通过HostActivity中维护的routeStack来实现。

override fun onBackPressed() 
 		//判断当前栈的长度,如果当前HostActivity栈的长度小于等于1,那么Activity就要finsih
    if (routeStack.size <= 1) 
      super.onBackPressed()
      flutterEngine.navigationChannel.popRoute()
     
    //正常执行Navigator的pop操作
    else 
      flutterEngine.navigationChannel.popRoute()
    

当然还有一个问题需要注意,有些Widget的返回并不是通过返回键处理的,那我们就需对onPop方法进行一些特殊处理:

override fun onPop(route: String) 
    //正常处理出栈逻辑
    if (routeStack.isEmpty() && !isFinishing) 
      	//如果已经全部出栈,则当前HostActivity的业务已完成  
      	finish()
    

这样,就能把HostActivity和该宿主内打开的Widget进行关联,做到共同进退,主要的逻辑实现起来也不负责,也不需要使用任何第三方的框架,这样就有了很大的灵活性,尤其是对Flutter来说,Flutter的生态还不是十分成熟,避免使用侵入性过大的框架,也为以后技术的迭代留有足够的空间。


缺点和不足

虽然通过对Flutter内栈信息变化的监听和通过BasicMessageChannel的消息同步来做好混合栈管理,但是目前依然有一些问题需要解决。

1:Flutter和Native页面的返回值监听,OneActivity打开了一个HostActivity并想要在HostActivity退出的时候给OneActivity一个返回值,这个功能实例代码中还没有实现,等有空继续完善该框架。

2:跨域返回的问题,这个“跨域”是我自己定义的一个名字,就是如果我打开了两个HostActivity,第二个HostActivity通过Navigator的remove方法想要关闭掉第一个HostActivity中打开的Widget,这个是可以做到了,因为这两个HostActivity使用的是同一个FlutterEngine,如果出现这种操作,那就会让第一个HostActivity的页面显示出现问题。其实我在想,理想的混合管理框架应该是把每个打开的HostActivity当做一个WebView来看待,想要在第二个WebView中关闭第一个WebView里打开的页面,这显然也是不太合适的。这种跨域返回是否需要支持,也是一个值得考虑的问题。

最后

小编在网上收集了一些 android 开发相关的学习文档、面试题、Android 核心笔记等等文档,希望能帮助到大家学习提升,如有需要参考的可以直接去我 CodeChina地址:https://codechina.csdn.net/u012165769/Android-T3 访问查阅。

以上是关于一款零侵入的高效Flutter混合栈管理方案,你值得拥有!的主要内容,如果未能解决你的问题,请参考以下文章

还在用Swagger?我推荐这款零代码侵入的接口管理神器!

Flutter 2.x 混合栈路由管理

还在用Swagger?我推荐这款零代码侵入的接口管理神器!

一款零注解API接口文档生成工具

Flutter之禅 内存优化篇

「编程工具」Flutter-Native 混合解决方案 FlutterBoost