Flutter与Android混合编码配置笔记

学习Flutter一小段时间，对纯Flutter项目有了一些基本的了解，但更趋近实际开发的应该是将Flutter模块作为一个依赖库添加到原生的Android项目中。

本文笔者将尝试分享个人针对Flutter与Android混编时的配置步骤，以及踩坑过程。

一、初始化Flutter-Module

参考官方文档，首先需要确认Flutter-Module依赖库文件夹的位置，简单来说，这里有两种方式：

1.创建在项目的根目录下（内部）；
2.创建和项目文件夹的同一层级（外部），这也是官方推荐的方式。

其实这些方式没什么区别，但是个人更倾向于第二种，我们在项目文件夹的目录层级下对Flutter-Module文件夹进行创建并 初始化：

$ flutter create -t module module_flutter

成功后，Flutter-Module和Android项目本身应该是这样的（红框内的两个项目）：

image

二、配置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。

截止笔者发文前，FlutterV1.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，它们就必须都保持同一个状态：

image

？？？这是不是意味着所有的module的build.gradle都配置相同的productFlavors信息？

实践给予我答案，是的。

image

虽然折腾了很久，还好前人栽树，后人乘凉，解决了问题还是happy ending, Github大法好。

六、更多Flutter混编姿势

本文提供了 官方文档 提供混合开发的集成方式，实际上，国内很多大厂都分享过相关的技术文章，这里也一并放出来：

关于我

Hello，我是却把清梅嗅，如果您觉得文章对您有价值，欢迎 ❤️，也欢迎关注我的博客或者Github。

如果您觉得文章还差了那么点东西，也请通过关注督促我写出更好的文章——万一哪天我进步了呢？

Flutter与Android混合编码配置笔记