见识不一样的Flutter 之原生混合开发

Posted 码农 小生

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了见识不一样的Flutter 之原生混合开发相关的知识,希望对你有一定的参考价值。


开始之前,我们需要了解一下 flutter 的四种项目结构

  • application:纯 flutter 应用
  • plugin:基于原生的 flutter 插件
  • package:纯 dart 插件
  • module:原生上集成 flutter 模块

一、将 flutter 集成到 android 项目

在原生应用的目录下运行命令:

flutter create -t module --org com.example flutter_lib

会在目录下面生成如下文件:

我们需要将生成 flutter module 集成进我们的 native 应用,集成方法有两种:

  • aar 依赖
  • 源码依赖

1、flutter module 集成

1、aar 依赖

在 flutter_lib 目录下,我们运行命令:

flutter build aar

很贴心的是,flutter 会在命令行中告诉我们如何在原生应用中去集成 aar

优点:

  • 依赖一个包含 Flutter 产物的 aar 包,这个的好处就是其他不开发 flutter 的同学可以不用配置 flutter 环境,它和其他模块包无异

2、源码依赖

打开原生项目的 setting.gradle 文件:

include ':app'
rootProject.name = "NativeToFlutter"

// 加入如下代码
setBinding(new Binding([gradle: this]))                                 
evaluate(new File(                                                      
        'flutter_lib/.android/include_flutter.groovy'                          
))
include ':flutter_lib'

在 app 项目的 build.gradle 依赖 flutter module 模块

dependencies {
  implementation project(':flutter')
}

缺点:

  • 需要 flutter 环境,并且各个开发人员环境不一致,导致集成因为版本不一致报各种错误

2、原生接入 flutter 页面

flutter 依赖提供了 FlutterActivity 来直接加载 flutter 页面,我们只需要在清单文件中配置该 Activity :

<activity
  android:name="io.flutter.embedding.android.FlutterActivity"
  android:theme="@style/LaunchTheme"
  android:configChanges="orientation|keyboardHidden|keyboard|screenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
  android:hardwareAccelerated="true"
  android:windowSoftInputMode="adjustResize"
  />

在需要打开 flutter 页面的地方 startActivity 即可:

 val intent = FlutterActivity
            .withNewEngine() 
            // 背景颜色,透明 or 不透明
            .backgroundMode(FlutterActivityLaunchConfigs.BackgroundMode.transparent)
            // 指定跳转的路由 home 页面
            .initialRoute("home")
            .build(this)
startActivity(intent)

3、原生指定跳转 Flutter 页面

Flutter 提供 initialRoute 来供原生层跳到 flutter 对应的指定路由页面,官方解释,该路由是有限制的:

当使用已预热的 FlutterEngine 构建 FlutterFragment 时,指定的 Dart 入口是无效的。因为已预热的 FlutterEngine 已经执行了一个入口函数。只有 FlutterEngine 在预热之时是可以明确选择入口的。

所以,我们必须使用 withNewEngine 创建新的引擎来打开一个页面:

 val intent = FlutterActivity
            .withNewEngine() 
            // 指定跳转到 home 路由页面
            .initialRoute("home")
            .build(this)
startActivity(intent)

由于初始化 engine 需要很长的时间,再加上打开指定路由,打开效果十分不理想

4、入口点 EntryPoint

我们在打开 flutter 页面时,默认是从 flutter 的 main 函数开始执行,如果我们有多个独立 flutter 模块供原生层去打开,这就会导致我们的独立模块都必须集中到 main 函数中,然后通过路由的方式来决定打开的模块页面,但路由的方式上面我们已经证明了性能是有多么的糟糕,如果先初始化 flutter engine,就会导致路由效果失效。

很幸运的是,flutter 提供了入口点这个功能,我们可以指定入口点是我们想要跳转的 flutter 页面,并且该功能提前初始化引擎并不影响页面的打开,使用方法很简单,如下:

void main() => runApp(MyApp(Colors.blue));

@pragma('vm:entry-point')
void home() => runApp(HomePage(Colors.green));

对比 main 方法只多了个 pragma 注解,方法名 home 即为 entryPoint。

在 native 层我们就可以写成:

// 在 application 中初始化 home 页面的 flutter engine
val dartEntryPoint = DartExecutor.DartEntrypoint(
  FlutterInjector.instance().flutterLoader().findAppBundlePath(), "home"
)
val engineId = "home_engine_id"
val engine = enginesGroup.createAndRunEngine(app, engineId) // 创建引擎
FlutterEngineCache.getInstance().put(engineId, engine) // 根据引擎 id 缓存 engine

// 在原生页面嵌入的 flutter 页面绑定 entrypoint
class MainFlutterActivity : AppCompatActivity(){
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_my_flutter)

        val flutterFragment = FlutterFragment
            	// 指定缓存的 engineId	
                .withCachedEngine("home_engine_id")
                .build<FlutterFragment>()

        supportFragmentManager.beginTransaction()
            .add(R.id.flutter_container, flutterFragment)
            .commit()
    }
}

这时候,原生层直接打开 MainFlutterActivity 即可,效果如下:

5、flutter 热重载

在原生接入 flutter 模块时,我们期望原生项目的运行能够像 flutter 应用开发一样,实时的去调试 flutter 代码。flutter 为我们提供了 flutter attach 命令来调试 flutter 页面,我们只需要运行该命令,然后使项目进入到 flutter 页面即可调试:

我们可以更改 flutter 代码,然后输入指定的 commands 即可,例如输入 r,就会 hot reload 热重载当前页面

6、总结

我们可以画一个依赖图来总结一下:

目前 demo 的 flutter 代码是直接在 flutter module 中进行编码,这种很不适合团队协作开发,不要忘了,flutter 提供了四种项目结构方式,我们可以利用 plugin 和 package 模块进行组件化开发,然后再将组件依赖放入到 flutter module 来集成,这样的话,就可以不干扰其他成员编码

7、最后

小编在网上收集了一些 Android 开发相关的学习文档、面试题、Android 核心笔记等等文档,希望能帮助到大家学习提升,如有需要参考的可以直接点击这里免费领取

以上是关于见识不一样的Flutter 之原生混合开发的主要内容,如果未能解决你的问题,请参考以下文章

Flutter基础系列之混合开发

Flutter 之原生混合开发

Flutter混合开发之FlutterFragment

教你如何使用Flutter和原生App混合开发

错误记录Flutter 混合开发获取 BinaryMessenger 报错 ( FlutterActivityAndFragmentDelegate.getFlutterEngine() )(代码片段

8-4 Flutter Android混合开发实战-调试与发布