什么是FlutterBoost

​ 新一代Flutter-Native混合解决方案。 FlutterBoost是一个Flutter插件，它可以轻松地为现有原生应用程序提供Flutter混合集成方案。FlutterBoost的理念是将Flutter像Webview那样来使用。在现有应用程序中同时管理Native页面和Flutter页面并非易事。 FlutterBoost帮你处理页面的映射和跳转，你只需关心页面的名字和参数即可（通常可以是URL）。

开发环境

flutter和flutter boost版本有很多，技术不断发展，以官方最新版本为准

Flutter 1.12.13+hotfix.5 • channel stable • https://github.com/flutter/flutter.git
Framework • revision 27321ebbad (3 months ago) • 2019-12-10 18:15:01 -0800
Engine • revision 2994f7e1e6
Tools • Dart 2.7.0

AndroidStudio 3.6

flutter-boost版本 task/task_v1.12.13_support_hotfixes，不支持androidx

引入依赖和配置flutterboost

FlutterBoost是flutter混合开发时使用的库，引入依赖时，你需要新建一个安卓工程，并把flutter作为一个安卓工程的子模块引入，安卓flutter混合工程配置请看Flutter系列笔记-9:Android原生Flutter混合编程

flutter_module配置

打开flutter_module子工程，先在 pubspec.yaml 里加入

flutter_boost:
  git:
    url: 'https://github.com/alibaba/flutter_boost.git'
    ref: 'task/task_v1.12.13_support_hotfixes'

完整如下

dependencies:
  flutter:
    sdk: flutter

  # The following adds the Cupertino Icons font to your application.
  # Use with the CupertinoIcons class for iOS style icons.
  cupertino_icons: ^0.1.2
  flutter_boost:
    git:
      url: 'https://github.com/alibaba/flutter_boost.git'
      ref: 'task/task_v1.12.13_support_hotfixes'

添加完成后，执行 Packages get

安卓工程配置

执行完后，切换到安卓工程，在app/build.gradle里添加依赖

implementation project(':flutter_boost')

完整如下

dependencies {
    implementation project(':flutter')
    implementation project(':flutter_boost')
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
    implementation 'com.android.support:appcompat-v7:28.0.0'
    implementation 'com.android.support.constraint:constraint-layout:1.1.3'
    implementation 'com.android.support:support-v4:28.0.0'
    testImplementation 'junit:junit:4.12'
    androidTestImplementation 'com.android.support.test:runner:1.0.2'
    androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
}

同步一下工程。依赖配置成功。

安卓工程初始化FlutterBoost配置

在安卓工程的Application的onCreate方法初始化 flutter boost

public class MyApplication extends Application {
    public final static String TAG = "flutterBoostApplication";

    @Override
    public void onCreate() {
        super.onCreate();

        INativeRouter router = new INativeRouter() {
            @Override
            public void openContainer(Context context, String url, Map<String, Object> urlParams, int requestCode, Map<String, Object> exts) {
                Log.d(TAG,"openContainer url:"+url+"\turlParams:"+urlParams+"\trequestCode:"+requestCode+"\texts:"+exts);
                String assembleUrl = Utils.assembleUrl(url, urlParams);
                PageRouter.openPageByUrl(context, assembleUrl, urlParams);
            }

        };

        FlutterBoost.BoostLifecycleListener boostLifecycleListener = new FlutterBoost.BoostLifecycleListener() {

            @Override
            public void beforeCreateEngine() {
                Log.d(TAG,"beforeCreateEngine");
            }

            @Override
            public void onEngineCreated() {
                Log.d(TAG,"onEngineCreated");
            }

            @Override
            public void onPluginsRegistered() {
                Log.d(TAG,"onPluginsRegistered");
            }

            @Override
            public void onEngineDestroy() {
                Log.d(TAG,"onEngineDestroy");
            }

        };

        //
        // AndroidManifest.xml 中必须要添加 flutterEmbedding 版本设置
        //
        //   <meta-data android:name="flutterEmbedding"
        //               android:value="2">
        //    </meta-data>
        // GeneratedPluginRegistrant 会自动生成 新的插件方式　
        //
        //
        Platform platform = new FlutterBoost
                .ConfigBuilder(this, router)
                .isDebug(true)
                .whenEngineStart(FlutterBoost.ConfigBuilder.ANY_ACTIVITY_CREATED)
                .renderMode(FlutterView.RenderMode.texture)
                .lifecycleListener(boostLifecycleListener)
                .build();

        FlutterBoost.instance().init(platform);


    }
}

app/src/main/AndroidManifest.xml里配置com.idlefish.flutterboost.containers.BoostFlutterActivity

<activity
    android:name="com.idlefish.flutterboost.containers.BoostFlutterActivity"
    android:configChanges="orientation|keyboardHidden|keyboard|screenSize|locale|layoutDirection|fontScale|screenLayout|density"
    android:hardwareAccelerated="true"
    android:theme="@style/Theme.AppCompat"
    android:windowSoftInputMode="adjustResize">
    <meta-data
        android:name="io.flutter.embedding.android.SplashScreenDrawable"
        android:resource="@drawable/page_loading" />

</activity>

flutter_module里初始化flutterboost配置

主要是

FlutterBoost.singleton.registerPageBuilders方法 注册页面路由用

FlutterBoost.singleton.addBoostNavigatorObserver(TestBoostNavigatorObserver());路由生命周期回调

MaterialApp里的 builder: FlutterBoost.init(postPush: _onRoutePushed),

class _MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();

    FlutterBoost.singleton.registerPageBuilders({
      'embeded': (pageName, params, _)=>EmbededFirstRouteWidget(),
      'first': (pageName, params, _) => FirstRouteWidget(),
      'second': (pageName, params, _) => SecondRouteWidget(),
      'tab': (pageName, params, _) => TabRouteWidget(),
      'platformView': (pageName, params, _) => PlatformRouteWidget(),
      'flutterFragment': (pageName, params, _) => FragmentRouteWidget(params),
      ///可以在native层通过 getContainerParams 来传递参数
      'flutterPage': (pageName, params, _) {
        print("flutterPage params:$params");

        return FlutterRouteWidget(params:params);
      },
    });
    FlutterBoost.singleton.addBoostNavigatorObserver(TestBoostNavigatorObserver());
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
        title: 'Flutter Boost example',
        builder: FlutterBoost.init(postPush: _onRoutePushed),
        home: Container(
            color:Colors.white
        ));
  }

  void _onRoutePushed(
      String pageName, String uniqueId, Map params, Route route, Future _) {
  }
}

安卓页面里打开安卓页面

使用普通的startActivity即可

context.startActivity(new Intent(context, NativePageActivity.class));

安卓原生页面里打开flutter页面

url为 flutter_module里FlutterBoost.singleton.registerPageBuilders里配置的页面路由，

params 是原生要传给flutter页面的参数集合

backgroundMode 有两种opaque（不透明）和transparent（透明）两种

//打开flutter页面
Intent intent = BoostFlutterActivity.withNewEngine().url(pageName.get(path)).params(params)
        .backgroundMode(BoostFlutterActivity.BackgroundMode.opaque).build(context);
if(context instanceof Activity){
    Activity activity=(Activity)context;
    activity.startActivityForResult(intent,requestCode);
}else{
    context.startActivity(intent);
}

flutter页面打开安卓原生页面

FlutterBoost.singleton
    .open("sample://nativePage", urlParams: {
  "query": {"aaa": "bbb"}
})

需要指定url和urlParams，

FlutterBoost.singleton.open方法实际上是对应执行安卓代码的 INativeRouter的openContainer方法，原生根据参数按需要使用startActivity打开原生页面

INativeRouter router = new INativeRouter() {
    @Override
    public void openContainer(Context context, String url, Map<String, Object> urlParams, int requestCode, Map<String, Object> exts) {

    }
};

flutter页面使用FlutterBoost打开flutter页面

flutter打开flutter页面（widget）可以使用flutter里普通的路由管理Navigator.push或Navigator.pushName,也可以用FlutterBoost.singleton.open打开一个flutter页面

FlutterBoost.singleton.open("second").then((Map value) {
  print(
      "call me when page is finished. did recieve second route result $value");
})

flutter页面关闭FlutterBoost.singleton.open打开的flutter页面,并返回值给前一个页面

BoostContainerSettings settings =BoostContainer.of(context).settings;
FlutterBoost.singleton.close(settings.uniqueId,result: {"result": "data from second"});

安卓原生页面里使用flutterboost的FlutterFragment的使用

flutterboost的FlutterFragment和安卓的Fragment差不多

com.idlefish.flutterboost.containers.FlutterFragment这个FlutterFragment和flutter官方的io.flutter.embedding.android.FlutterFragment不是同一个

FlutterFragment mFragment = new FlutterFragment.NewEngineFragmentBuilder().url("flutterFragment").build()

使用NewEngineFragmentBuilder创建了FlutterFragment之后，按普通的Fragment使用即可。一般还配合SplashScreenProvider使用，以避免白屏。

flutter页面显示原生控件

暂未整理

项目地址体验地址：
FlutterBoostExample