Flutter 之原生混合开发

简介: Flutter 之原生混合开发

参考文档:


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

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

一、将 flutter 集成到 Android 项目


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


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

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

image.png

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

  • aar 依赖
  • 源码依赖

1、flutter module 集成


1、aar 依赖


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


flutter build aar

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

image.png

优点:


  • 依赖一个包含 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 需要很长的时间,再加上打开指定路由,打开效果十分不理想


image.png

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 即可,效果如下:


image.png

5、flutter 热重载


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

image.png


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


6、总结


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

image.png

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

目录
相关文章
|
2月前
|
Android开发 iOS开发 容器
鸿蒙harmonyos next flutter混合开发之开发FFI plugin
鸿蒙harmonyos next flutter混合开发之开发FFI plugin
|
10天前
|
传感器 前端开发 Android开发
在 Flutter 开发中,插件开发与集成至关重要,它能扩展应用功能,满足复杂业务需求
在 Flutter 开发中,插件开发与集成至关重要,它能扩展应用功能,满足复杂业务需求。本文深入探讨了插件开发的基本概念、流程、集成方法、常见类型及开发实例,如相机插件的开发步骤,同时强调了版本兼容性、性能优化等注意事项,并展望了插件开发的未来趋势。
23 2
|
2月前
|
开发者
鸿蒙Flutter实战:07-混合开发
鸿蒙Flutter混合开发支持两种模式:1) 基于har包,便于主项目开发者无需关心Flutter细节,但不支持热重载;2) 基于源码依赖,利于代码维护与热重载,需配置Flutter环境。项目结构包括AppScope、flutter_module等目录,适用于不同开发需求。
83 3
|
27天前
|
传感器 开发框架 物联网
鸿蒙next选择 Flutter 开发跨平台应用的原因
鸿蒙(HarmonyOS)是华为推出的一款旨在实现多设备无缝连接的操作系统。为了实现这一目标,鸿蒙选择了 Flutter 作为主要的跨平台应用开发框架。Flutter 的跨平台能力、高性能、丰富的生态支持和与鸿蒙系统的良好兼容性,使其成为理想的选择。通过 Flutter,开发者可以高效地构建和部署多平台应用,推动鸿蒙生态的快速发展。
179 0
|
29天前
|
Dart 安全 UED
Flutter&鸿蒙next中的表单封装:提升开发效率与用户体验
在移动应用开发中,表单是用户与应用交互的重要界面。本文介绍了如何在Flutter中封装表单,以提升开发效率和用户体验。通过代码复用、集中管理和一致性的优势,封装表单组件可以简化开发流程。文章详细讲解了Flutter表单的基础、封装方法和表单验证技巧,帮助开发者构建健壮且用户友好的应用。
66 0
|
2月前
|
开发框架 移动开发 Android开发
安卓与iOS开发中的跨平台解决方案:Flutter入门
【9月更文挑战第30天】在移动应用开发的广阔舞台上,安卓和iOS两大操作系统各自占据半壁江山。开发者们常常面临着选择:是专注于单一平台深耕细作,还是寻找一种能够横跨两大系统的开发方案?Flutter,作为一种新兴的跨平台UI工具包,正以其现代、响应式的特点赢得开发者的青睐。本文将带你一探究竟,从Flutter的基础概念到实战应用,深入浅出地介绍这一技术的魅力所在。
84 7
|
2月前
|
编解码 Dart API
鸿蒙Flutter实战:06-使用ArkTs开发Flutter鸿蒙插件
本文介绍了如何开发一个 Flutter 鸿蒙插件,实现 Flutter 与鸿蒙的混合开发及双端消息通信。通过定义 `MethodChannel` 实现 Flutter 侧的 token 存取方法,并在鸿蒙侧编写 `EntryAbility` 和 `ForestPlugin`,使用鸿蒙的首选项 API 完成数据的读写操作。文章还提供了注意事项和参考资料,帮助开发者更好地理解和实现这一过程。
76 0
|
2月前
|
Dart Android开发
鸿蒙Flutter实战:03-鸿蒙Flutter开发中集成Webview
本文介绍了在OpenHarmony平台上集成WebView的两种方法:一是使用第三方库`flutter_inappwebview`,通过配置pubspec.lock文件实现;二是编写原生ArkTS代码,自定义PlatformView,涉及创建入口能力、注册视图工厂、处理方法调用及页面构建等步骤。
61 0
|
3月前
|
JSON Dart Java
flutter开发多端平台应用的探索
flutter开发多端平台应用的探索
53 6
|
3月前
|
JSON Dart Java
flutter开发多端平台应用的探索 下 (跨模块、跨语言通信之平台通道)
flutter开发多端平台应用的探索 下 (跨模块、跨语言通信之平台通道)