学习Flutter
一小段时间,对纯Flutter
项目有了一些基本的了解,但更趋近实际开发的应该是将Flutter
模块作为一个依赖库添加到原生的Android
项目中。
本文笔者将尝试分享个人针对Flutter
与Android
混编时的配置步骤,以及踩坑过程。
一、初始化Flutter-Module
参考 官方文档 ,首先需要确认Flutter-Module
依赖库文件夹的位置,简单来说,这里有两种方式:
- 1.创建在项目的根目录下(内部);
- 2.创建和项目文件夹的同一层级(外部),这也是官方推荐的方式。
其实这些方式没什么区别,但是个人更倾向于第二种,我们在项目文件夹的目录层级下对Flutter-Module
文件夹进行 创建 并 初始化:
$ flutter create -t module module_flutter
成功后,Flutter-Module
和Android
项目本身应该是这样的(红框内的两个项目):
二、配置Android项目
接下来我们需要将这个项目和刚刚创建的module-flutter
进行依赖,我们先打开Android
原生项目,并为项目根目录下的settings.gradle
文件中添加如下配置:
setBinding(new Binding([gradle: this]))
evaluate(new File(
settingsDir.parentFile,
'module_flutter/.android/include_flutter.groovy'
))
如果module-flutter
模块是创建在项目内部,那么需要稍微改一改:
setBinding(new Binding([gradle: this]))
evaluate(new File(
settingsDir.path,
'module_flutter/.android/include_flutter.groovy'
))
然后,我们需要打开app
的build.gradle
文件,添加对flutter
的依赖:
dependencies {
implementation fileTree(dir: 'libs', include: ['*.jar'])
implementation 'androidx.appcompat:appcompat:1.0.0'
implementation 'androidx.annotation:annotation:1.0.0'
......
implementation project(':flutter')
}
这样,对于简单的Android
原生项目而言,Flutter
已经配置成功了。
三、AndroidX的迁移
由于笔者的项目迁移了AndroidX
, 但是低版本的Flutter
命令生成的module
默认依赖的是support
包, 因此我们需要将默认support
的依赖手动迁移到AndroidX
。
截止笔者发文前,
Flutter
V1.7已经提供了对AndroidX
的支持,当创建Flutter
项目的时候,你可以通过添加--androidx
来确保生成的项目文件支持AndroidX
,详情参考这里。
手动迁移的方式有两种:
- 1.通过
Android Studio
自动迁移 过去。
首先通过Android Studio
打开flutter-module
,这时候是不能直接迁移AndroidX
的,需要通过flutter
- Open Android module in AS
方式新打开一个窗口。
这样编译成功后,就可以点击Refactor
- Migrate to AndroidX
进行迁移了,后续步骤网上有很多,不赘述。
- 2.手动配置过去,这个方式也很简单,打开
Flutter
-build.gradle
文件,对依赖进行更新:
android {
//...
defaultConfig {
// ...
testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
}
// ...
}
dependencies {
testImplementation 'junit:junit:4.12'
implementation 'androidx.appcompat:appcompat:1.0.0'
implementation 'androidx.annotation:annotation:1.0.0'
// ...
}
手动配置网上有很多博客,不赘述。
需要注意的是,一定要保证Flutter
模块中对AndroidX
相关依赖的版本和实际原生项目中相关依赖的版本是一致的,否则可能会导致依赖冲突。
四、多模块项目的配置
上文说到,简单的项目已经配置完毕了,但是多模块的项目来说则稍显复杂,比如笔者的项目:
image首先,需要在底层library
(本文中是library-core
)的build.gradle
文件中添加对flutter
的依赖:
dependencies {
// ...
api project(':flutter')
}
添加之后并进行同步,原生的项目就会对settings.gradle
文件中指向的module-flutter
文件夹进行依赖。
同步、编译成功后,我运行了项目,但我很快遇到了问题:
[ERROR:flutter/runtime/dart_vm_data.cc(19)] VM snapshot invalid and could not be inferred from settings.
[ERROR:flutter/runtime/dart_vm.cc(241)] Could not setup VM data to bootstrap the VM from.
[ERROR:flutter/runtime/dart_vm_lifecycle.cc(89)] Could not create Dart VM instance.
[FATAL:flutter/shell/common/shell.cc(218)] Check failed: vm. Must be able to initialize the VM.
五、ProductFlavors的坑
这个问题纠结了很久,最后在 这个issue中 找到了答案:
image经 @yk3372 大佬提示,原来是以为项目中配置了ProductFlavors
, 因此,Flutter
模块中对应的build.gradle
文件也需要进行对应的配置,比如这样:
buildTypes {
release {}
debug {}
}
flavorDimensions "environment"
productFlavors {
dev {}
qa {}
prod {}
}
配置好之后,还需要手动将相关module
的ProductFlavors
配置相同,否则会提示一堆错误,比如我的一个原生的module
依赖了flutter
的module
,它们就必须都保持同一个状态:
???这是不是意味着所有的module
的build.gradle
都配置相同的productFlavors
信息?
实践给予我答案,是的。
image虽然折腾了很久,还好前人栽树,后人乘凉,解决了问题还是happy ending
, Github
大法好。
六、更多Flutter混编姿势
本文提供了 官方文档 提供混合开发的集成方式,实际上,国内很多大厂都分享过相关的技术文章,这里也一并放出来:
关于我
Hello,我是却把清梅嗅,如果您觉得文章对您有价值,欢迎 ❤️,也欢迎关注我的博客或者Github。
如果您觉得文章还差了那么点东西,也请通过关注督促我写出更好的文章——万一哪天我进步了呢?
网友评论