Flutter系列筆記-10:安卓flutter混合編程開發(fā)之2 FlutterBoost集成體驗

什么是FlutterBoost

? 新一代Flutter-Native混合解決方案。 FlutterBoost是一個Flutter插件,它可以輕松地為現(xiàn)有原生應(yīng)用程序提供Flutter混合集成方案。FlutterBoost的理念是將Flutter像Webview那樣來使用。在現(xiàn)有應(yīng)用程序中同時管理Native頁面和Flutter頁面并非易事。 FlutterBoost幫你處理頁面的映射和跳轉(zhuǎn),你只需關(guān)心頁面的名字和參數(shù)即可(通??梢允荱RL)。

開發(fā)環(huán)境

flutter和flutter boost版本有很多,技術(shù)不斷發(fā)展,以官方最新版本為準(zhǔn)

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混合開發(fā)時使用的庫,引入依賴時,你需要新建一個安卓工程,并把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'

添加完成后,執(zhí)行 Packages get

安卓工程配置

執(zhí)行完后,切換到安卓工程,在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 版本設(shè)置
        //
        //   <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());路由生命周期回調(diào)

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 來傳遞參數(shù)
      '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頁面的參數(shù)集合

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方法實際上是對應(yīng)執(zhí)行安卓代碼的 INativeRouter的openContainer方法,原生根據(jù)參數(shù)按需要使用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頁面關(guān)閉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創(chuàng)建了FlutterFragment之后,按普通的Fragment使用即可。一般還配合SplashScreenProvider使用,以避免白屏。

flutter頁面顯示原生控件

暫未整理

項目地址體驗地址:
FlutterBoostExample

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容