Flutter Mudule 接入 Android native「 2020 大前端混合开发」

圆号本昊

发布于 2021-09-24 11:05:29

5800

发布于 2021-09-24 11:05:29

文章被收录于专栏：github@hornhuang

一、前言

2020 年 flutter 不再是什么新的技术，以‘闲鱼’为首各大 app 纷纷拥抱 flutter，目前最理想的就是完全用 flutter 开发，但是由于各自的 app 都以成型，完全抛弃以前的代码全面上 flutter ，无论是人力还是物力都是不切实际的，所以目前大多数产品的思路都是进行混合开发，逐步 flutter 化
由于各大 app 牵入 flutter 较早，使用技术过于老旧，鉴于这一点，我结合 Google 最新的官方文档和网上的总结，研究出一套切实可行的方案，供大家参考

二、准备

既然是混合开发，首先需要两个工程：一个 Android 工程，一个 flutter工程

2.1 打开 android 工程

Android studio 直接 new 或者打开现有的就行，没有特殊要求

2.2 新建 flutter 工程

flutter 工程这里有两种情况：
- flutter 工程已存在，直接导入使用
- 纯新项目，直接以 module 新式新建即可

2.2.1 已存在 flutter 工程

直接打开就行
进入到 Terminal（mac 系统是：同时按下 command + shirft + p 打开）

2.2.2 需要新建 flutter 项目

如果你还没有 flutter 项目，需要新建则选择 Android studio 进行：
打开 Android studio 在 file 里选 new - new module

输入名字新建即可，没有什么特殊的配置

新建完可以 sync 一下

三、接入

接入继承上面所讲，分接入已存在 flutter 工程和接入 module
在这之前我们先要对 Android 项目进行配置

3.1 Android 项目公共配置

步骤如下

3.1.1 配置 ndk

android {
  //...
  defaultConfig {
    ndk {
      // Filter for architectures supported by Flutter.
      abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86_64'
    }
  }
}

位置如下

3.1.2 配置 Java 8

在 build.gradle 配置 Java 8，新版默认已经配置

android {
  //...
  compileOptions {
    sourceCompatibility 1.8
    targetCompatibility 1.8
  }
}

配置路径如下：

3.2 接入 Flutter Module

老样子 flutter 工程这里有两种情况：
- 已有的 flutter 工程
- 刚刚以 module 形式新建的 flutter 工程
这里先讲刚刚以 module 形式新建的 flutter 工程的接入方法

3.2.1 Android Flutter Module 接入

通过 Terminal cd 到 module 下直接打 arr

根据提示对 build.gradle 进行修改

  1. Open <host>/app/build.gradle
  2. Ensure you have the repositories configured, otherwise add them:

      repositories {
        maven {
            url '/Users/huangyuanhao/StudioProjects/flutter_module/build/host/outputs/repo'
        }
        maven {
            url 'http://download.flutter.io'
        }
      }

  3. Make the host app depend on the Flutter module:

    dependencies {
      debugImplementation 'com.superpentagon.fluttermodule:flutter_debug:1.0
      profileImplementation 'com.superpentagon.fluttermodule:flutter_profile:1.0
      releaseImplementation 'com.superpentagon.fluttermodule:flutter_release:1.0
    }


  4. Add the `profile` build type:

    android {
      buildTypes {
        profile {
          initWith debug
        }
      }
    }

修改后如下：

⚠️ 注意：有些内容需要修改
获得 repo 路径并替换，替换成你自己机子的的 repo 路径

替换国内镜像，这里我用的是清华的镜像，如果失效的话请到这里进行选择：flutter 社区镜像获取

    maven {
        url 'https://mirrors.tuna.tsinghua.edu.cn/flutter/download.flutter.io'
    }

修改如下

最后在这里替换成你本地的包名哈

3.2.2 测试运行

在 MainActivity 里调用 Flutter ，部分工具代码详见：Super-Pentagon - p01_android_proj

        // 初始化 Flutter
        FlutterMain.Settings settings=new FlutterMain.Settings();
        settings.setLogTag("MyFlutter");
        FlutterMain.startInitialization(this,settings);
        String[] args = {"info", "data"};
        FlutterMain.ensureInitializationComplete(this,args);

        // 初始化 FlutterEngine.
        FlutterEngine flutterEngine = new FlutterEngine(this);
        // Configure an initial route.
        flutterEngine.getNavigationChannel().setInitialRoute(FlutterEngineUtils.Home.HOME_PAGE_ROUTE + "?{\"message\":\"StephenCurry\"}");
        // Start executing Dart code to pre-warm the FlutterEngine.
        flutterEngine.getDartExecutor().executeDartEntrypoint(
                DartExecutor.DartEntrypoint.createDefault()
        );
        // Cache the FlutterEngine to be used by FlutterActivity or FlutterFragment.
        FlutterEngineCache
                .getInstance()
                .put(FlutterEngineUtils.Home.HOME_PAGE_ROUTE, flutterEngine);


        FlutterOperationUtil.init().initFragmentById(FlutterEngineUtils.Home.HOME_PAGE_ROUTE).initLayoutId(R.id.main_container).startFlutterTransation(getSupportFragmentManager());

布局如下

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:orientation="vertical">

    <RelativeLayout
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:layout_weight="1">

        <FrameLayout
            android:id="@+id/main_container"
            android:visibility="visible"
            android:layout_width="match_parent"
            android:layout_height="match_parent" />

    </RelativeLayout>

</LinearLayout>