Flutter 79: 圖解 Android Native 內建 FlutterBoost 小嘗試 (二)

      小菜前幾天剛嘗試接入 FlutterBoost，主要對其頁面路由的跳轉及傳參等有了初步的認識，接下來是對日常操作的基本學習；

      FlutterBoost 作為 Native 與 Flutter 之間的橋接方式，兩端之間的資料傳遞是必不可少的；FlutterBoost 也是采用同樣 Platform Channel 進行橋接，最常用的就是 MethodChannel；

插件注冊

      小菜在使用 Flutter Module 時會根據不同的業務子產品注冊不同的插件，小菜以前嘗試單純采用 Flutter 時需要 FlutterMain.startInitialization 初始化，而 FlutterBoost 也不例外；但是根據 FlutterBoost 的版本疊代，其注冊的方式也随着有所變更，且必不可少；

      小菜嘗試的是 v1.12.13-hotfixes 版本，可以在 AndroidManifest.xml 中必須要添加 flutterEmbedding 版本設定注冊插件方式，同時也可以通過 GeneratedPluginRegistrant 手動方式注冊，此時均無需繼承 FlutterApplication；

// AndroidManifest 方式注冊
<meta-data android:name="flutterEmbedding"
    android:value="2">
</meta-data>

// GeneratedPluginRegistrant 方式注冊
FlutterBoost.BoostPluginsRegister pluginsRegister = new FlutterBoost.BoostPluginsRegister() {
    @Override
    public void registerPlugins(PluginRegistry mRegistry) {
        GeneratedPluginRegistrant.registerWith(FlutterBoost.instance().engineProvider());
    }
};           

建立通信通道 Platform Channel

      小菜在單純使用 Flutter 時，建立通信通道嘗試通過 MethodChannel / BasicMessageChannel / EventChannel，其中初始化時均需 FlutterView，小菜接入 FlutterBoost 後在 MainActivity 中建立通信通道，監聽 onMethodChannel，在 Flutter 端監聽到方法是可以正常通信的；

new MethodChannel(getFlutterView(), "test.ace.com/main").setMethodCallHandler(new MethodChannel.MethodCallHandler() {
    @Override
    public void onMethodCall(MethodCall call, MethodChannel.Result result) {
        if (call.method.equals("ace_demo_user")) {
            Toast.makeText(this, "目前 method 為 ace_demo_user", Toast.LENGTH_LONG).show();
        } else {
            result.notImplemented();
        }
    }
});           

      但是小菜是把 MainActivity 作為 FlutterView 來處理的，這樣對于後期的維護以及業務方面的處理均不符合要求，并且據 FlutterBoost-issues 中提及在 v1.9 以後優化了建立通道的方法，在初始化 FlutterBoost 時會對 FlutterBoost LifeCycle 生命周期做監聽；可在 onPluginsRegistered() 方法中進行建立；這樣可以免去針對不同頁面的 FlutterView 設定；

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

    @Override
    public void onEngineCreated() {

    }

    @Override
    public void onPluginsRegistered() {
        BinaryMessenger messenger = FlutterBoost.instance().engineProvider().getDartExecutor();
        initMainMethod(messenger);
    }

    @Override
    public void onEngineDestroy() {

    }
};

private void initMainMethod(BinaryMessenger messenger) {
    MethodChannel mMainChannel = new MethodChannel(messenger, "test.ace.com/main");
    mMainChannel.setMethodCallHandler(new MethodChannel.MethodCallHandler() {
        @Override
        public void onMethodCall(MethodCall call, MethodChannel.Result result) {
            if (call.arguments != null) {
                Log.e("TAG", "回調内容：" + call.arguments.toString());
            }
            if (call.method != null) {
                Log.e("TAG", "回調方法：" + call.method.toString());
            }
            if (call.method.equals("ace_demo_user")) {
                result.success("");
            } else {
                result.notImplemented();
            }
        }
    });
}           

監聽關閉路由

      在使用 FlutterBoost 時，小菜按照官網方式封裝了 openPageUrl 開啟路由的方法，對于特殊頁面的路由專場動畫也可以單獨設定，但對于關閉路由動畫卻不能直接設定；

      小菜分析源碼，在 Platform 中提供了 closeContainer() 方法，而其中 finishContainer() 可以通過擷取目前 Activity 來關閉路由；

// 源碼
public void closeContainer(IContainerRecord record, Map<String, Object> result, Map<String, Object> exts) {
    if (record == null) return;
    record.getContainer().finishContainer(result);
}

@Override
public void finishContainer(Map<String, Object> result) {
    if (result != null) {
        setBoostResult(this.host.getActivity(), new HashMap<>(result));
        this.host.getActivity().finish();
    } else {
        this.host.getActivity().finish();
    }
}           

      closeContainer() 該方法并非抽象方法，但 Platform 是抽象類，是以小菜直接重寫 closeContainer() 即可；

Platform platform = new Platform() {
    @Override
    public Application getApplication() {
        return BaseApplication.getInstance();
    }

    @Override
    public void openContainer(Context context, String url, Map<String, Object> urlParams, int requestCode,
        Map<String, Object> exts) {
        router.openContainer(context, url, urlParams, requestCode, exts);
    }

    @Override
    public void closeContainer(IContainerRecord record, Map<String, Object> result, Map<String, Object> exts) {
        super.closeContainer(record, result, exts);
        // 擷取路由 Activity 設定轉場動畫
    }

    @Override
    public int whenEngineStart() {
        return FlutterBoost.ConfigBuilder.ANY_ACTIVITY_CREATED;
    }

    @Override
    public FlutterView.RenderMode renderMode() {
        return FlutterView.RenderMode.texture;
    }

    @Override
    public boolean isDebug() {
        return true;
    }

    @Override
    public String initialRoute() {
        return "/";
    }
};           

小擴充

      小菜在一個曆史項目中內建 Flutter 和 FlutterBoost 遇到 Cause: assert appProject != null 如下問題；

Cause: assert appProject != null
|          |
null       false           

      小菜确定內建方式是正确的，于是查閱資料發現很容易解決；小菜曆史項目的主 Module 是 news 更換為 app 即可；這個問題并非大問題，希望有相同問題的朋友可以提前避免；

      小菜對 Flutter 及 FlutterBoost 的研究還不夠深入，還在繼續學習探索，如有錯誤請多多指導！

來源： 阿策小和尚