將 Flutter View 加入 Android 應用程式
透過 FlutterView 進行整合 比起前述透過 FlutterActivity 與 FlutterFragment 的方式,需要多做一些工作。
從根本上來說,Dart 端的 Flutter framework 需要存取各種 activity 層級的事件與生命週期,才能正常運作。由於 FlutterView(即 android.view.View) 可以被加入到開發者應用程式所擁有的任何 activity 中,而 FlutterView 並無法直接存取 activity 層級的事件,因此開發者必須手動將這些事件橋接到 FlutterEngine。
你要如何將應用程式 activity 的事件傳遞給 FlutterView,會依你的應用程式而有所不同。
範例
#
與 FlutterActivity 和 FlutterFragment 的教學不同,FlutterView 的整合更適合以範例專案來說明。
有一個範例專案位於 https://github.com/flutter/samples/tree/main/add_to_app/android_view, 展示了一個簡單的 FlutterView 整合,如上方 gif 所示,FlutterView 被用於 RecycleView 卡片清單中的部分 cell。
一般做法
#FlutterView 層級整合的一般要點是,你必須在自己的應用程式程式碼中,重新建立 Activity、FlutterView 以及 FlutterEngine 與 FlutterActivityAndFragmentDelegate 之間的各種互動。 這些連結在 FlutterActivityAndFragmentDelegate 中,若使用 FlutterActivity 或 FlutterFragment 時會自動完成,但由於這裡的 FlutterView 是被加入到你應用程式中的 Activity 或 Fragment, 因此你必須手動建立這些連結。 否則,FlutterView 將無法渲染任何內容,或會缺少其他功能。
一個範例 FlutterViewEngine 類別展示了如何在 Activity、FlutterView 與 FlutterEngine 之間,建立應用程式專屬連結的實作方式。
需要實作的 API
#為了讓 Flutter 至少能夠繪製任何內容,最基本的實作需求如下:
- 當
FlutterView被加入到一個已恢復(resumed)Activity的 view 階層且可見時,呼叫attachToFlutterEngine; - 當承載
FlutterView的Activity可見時,呼叫appIsResumed於FlutterEngine的lifecycleChannel欄位。
相反地,detachFromFlutterEngine 以及 LifecycleChannel 類別中的其他生命週期方法,也必須在 FlutterView 或 Activity 不再可見時呼叫,以避免資源洩漏。
此外,請參考 FlutterViewEngine 範例類別或 FlutterActivityAndFragmentDelegate 中的其餘實作,以確保剪貼簿、系統 UI 覆蓋層、外掛(plugin)等其他功能能正確運作。