Native 项目依赖 Flutter AAR

07-27, 2019

为了降低 Flutter 对于原生项目的侵入性，方便项目组里 Native 开发人员编译开发，考虑将 Flutter Module 开发的跨平台功能模块单独抽离打包为 AAR，Google 一番结合实际操作，记录要点如下：

创建 Flutter Module 开发跨平台端的功能

这里就按照 Flutter Project 来开发就好了，不用跟 native 工程一起编译，比较方便的体验热重载功能。

打包 Flutter Module 成为 AAR 文件

android 目录下 app 层级下：

def isLib = true
if(isLib) {
    apply plugin: 'com.android.library'
} else  {
    apply plugin: 'com.android.application'
}

apply from: "$flutterRoot/packages/flutter_tools/gradle/flutter.gradle"

if(isLib) {
    apply plugin: 'com.kezong.fat-aar'
}

android {
    compileSdkVersion 28
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }

    if (isLib){
        resourcePrefix "flutter_module"
    }

    lintOptions {
        disable 'InvalidPackage'
    }

    defaultConfig {
        if(!isLib) {
            applicationId "com.example.flutter_aar_test"
        }
        minSdkVersion 16
        targetSdkVersion 28
        versionCode flutterVersionCode.toInteger()
        versionName flutterVersionName
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"

        if(isLib) {
            ndk {
                // 设置支持的SO库架构
                abiFilters  'armeabi-v7a'
            }
        }
    }
}

flutter {
    source '../..'
}

dependencies {
	// ...
    if(isLib) {
        def flutterProjectRoot = rootProject.projectDir.parentFile.toPath()
        def plugins = new Properties()
        def pluginsFile = new File(flutterProjectRoot.toFile(), '.flutter-plugins')

        if (pluginsFile.exists()) {
            pluginsFile.withReader('UTF-8') { reader -> plugins.load(reader) }
        }

        plugins.each { name, _ ->
            println name
            embed project(path: ":$name", configuration: 'default')
        }
    }
}

Project 层级下的 build.gradle 如下

 dependencies {
       classpath 'com.android.tools.build:gradle:3.2.1'
       classpath 'com.kezong:fat-aar:1.1.10'
  } 

解压 AAR 文件对齐 so 类型

AAR 文件中解压出的 so 类型，要跟 native 项目中的 so 类型一致，否则会出现错误，建议统一为 armeabi-v7a 类型。

Native 端调用

Android 端桥接页面，直接导航至 Flutter 的默认路由界面：

public class FlutterBridgeActivity extends FlutterActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        GeneratedPluginRegistrant.registerWith(this);
    }
}

跳转至导航页面之前的初始化：

Flutter.startInitialization(this.getApplicationContext());
Intent intent = new Intent(this, FlutterBridgeActivity.class);
startActivity(intent);

容易出现的问题

主要是打包 AAR 文件时，对于 Plugin 的引入，之前以为 Plugin 所有的内容以及依赖都包含在 Plugin 产物中，但是实际上不是，Plugin 的一些 compile 依赖并不会包含在其中，所以在 Native 引用 Flutter AAR 时要注意，如果没有对应的类和文件，要在 Native Project 中自己加上依赖。

如果觉得本文对你有帮助，请打赏以回报我的劳动