Android已有項目接入Flutter及互相通信

一.Android已有項目接入Flutter module(官方提供的module方式)

官方文檔:https://github.com/flutter/flutter/wiki/Add-Flutter-to-existing-apps

1.創建Flutter module

(1)在已有的flutter項目中 輸入命令:flutter create -t module moduleName,將生成的module複製到原生項目中
(2)或者在已有Android項目中輸入上面命令,同樣會生成一個module

2.在Android項目工程的settings.gradle增加以下配置

setBinding(new Binding([gradle: this]))
evaluate(new File(
        settingsDir.parentFile,
        'AndroidFlutterProject/flutter_module/.android/include_flutter.groovy'
))

flutter_module和app是同一級
AndroidFlutterProject:是Android項目的工程名
flutter_module:是剛纔通過命令生成的module

3.在app的build.gradle增加以下依賴

implementation project(':flutter')

注意:原生項目中minSdkVersion 至少爲16,否則編譯不過

通過以上三步就將Flutter集成到原生項目中了。

二:Android原生調Flutter代碼

Flutter提供兩種引入方法:一個是View,會默認生成一個View,一個是FlutterFragment方式。
View方式:可以自己設置新View的大小,位置

FlutterView flutterView = Flutter.createView(this, getLifecycle(), "路由信息,自己自定義");
FrameLayout.LayoutParams layout = new FrameLayout.LayoutParams(100, 100);
layout.leftMargin = 0;
layout.topMargin = 0;
addContentView(flutterView, layout);

FlutterFragment方式:

setContentView(R.layout.activity_main);
FragmentTransaction fragmentTransaction = getSupportFragmentManager().beginTransaction();
fragmentTransaction.replace(R.id.fl_flutter_view, Flutter.createFragment("路由信息,自己自定義"));
fragmentTransaction.commit();

通過以上任意一種方式,都會調用fluttermodule中lib包下main.dart這個文件,我們可以在這個文件下面配置路由信息,控制頁面跳轉展示。

void main() => runApp(widgetForRoute(window.defaultRouteName));

Widget widgetForRoute(String route) {
  switch (route) {
    case '路由信息,自己自定義':
      return Center(
        child: Text('route: $route', textDirection: TextDirection.ltr),
      );
      return Center(
        child: Text('Unknown route: $route', textDirection: TextDirection.ltr),
      );
  }
}

三:Flutter調用Android原生代碼

Flutter調用原生主要使用插件方式,通過MethodChannel的方式。

1.在Application onCreate方法中進行初始化,關鍵

FlutterMain.startInitialization(this);

2.實現插件,創建一個類實現MethodChannel.MethodCallHandler,在onMethodCall回調方法中對Flutter指令分發處理。

public class FlutterPluginJumpToAct implements MethodChannel.MethodCallHandler {

    //channel信息,可以自己隨便定義
    public static String CHANNEL = "com.qyh.jump/plugin";

    static MethodChannel channel;

    private Activity activity;

    private FlutterPluginJumpToAct(Activity activity) {
        this.activity = activity;
    }
    // 此方法需要外界進行調用註冊
    public static void registerWith(PluginRegistry.Registrar registrar) {
        channel = new MethodChannel(registrar.messenger(), CHANNEL);
        FlutterPluginJumpToAct instance = new FlutterPluginJumpToAct(registrar.activity());
        //setMethodCallHandler在此通道上接收方法調用的回調
        channel.setMethodCallHandler(instance);
    }


    @Override
    public void onMethodCall(MethodCall methodCall, MethodChannel.Result result) {
        //通過methodCall可以獲得參數和方法名,原生這面做對應業務
        //result可以給Flutter設置回調
        // "test1":是Flutter代碼設置的調用指令
        if (methodCall.method.equals("test1")) {
            // do something
            result.success("suc");
        }
    }
}

3.在Activity中註冊,此Activity需要繼承FlutterActivity

public class MainActivity extends FlutterActivity  {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        GeneratedPluginRegistrant.registerWith(this);
        registerCustomPlugin(this);
    }

    private static void registerCustomPlugin(PluginRegistry registrar) {
        FlutterPluginJumpToAct.registerWith(registrar.registrarFor(FlutterPluginJumpToAct.CHANNEL));
    }
}

FlutterActivity繼承的是Activity,如果想用其他Activity,比如AppCompatActivity,我們可以創建抽象Base類,繼承AppCompatActivity實現FlutterView.Provider, PluginRegistry, FlutterActivityDelegate.ViewFactory一系列方法。然後讓我們的Activity直接繼承這個基類就可以了。

4.在Flutter代碼中實現跳轉邏輯編寫

void main() => runApp(widgetForRoute(window.defaultRouteName));

Widget widgetForRoute(String route) {
    // com.qyh.jump/plugin是原生代碼中定義好的,要對應起來
  const jumpPlugin = const MethodChannel('com.qyh.jump/plugin');
  //test1 就是我們Flutter代碼回調原生的指令名字
  jumpPlugin.invokeMethod('test1');
}

當Flutter代碼執行到widgetForRoute(),會回調到插件FlutterPluginJumpToAct類的onMethodCall回調方法中,我們就可以通過methodCall.method獲取到指令(test1)名,進行原生邏輯編寫了,以上步驟就是Flutter調用原生代碼的方法。

4.1.在Flutter代碼中給原生傳遞參數
Flutter代碼中通過Map的方式對數據進行拼接,然後回傳給原生

void main() => runApp(widgetForRoute(window.defaultRouteName));

Widget widgetForRoute(String route) {
  // com.qyh.jump/plugin是原生代碼中定義好的,要對應起來
  const jumpPlugin = const MethodChannel('com.qyh.jump/plugin');
  Map<String, String> mapData = {"flutterKey1": "flutterValue1","flutterKey2": "flutterValue2"};
  jumpPlugin.invokeMethod('test1',mapData);
}

原生代碼中通過methodCall.arguments獲取,解析

@Override
public void onMethodCall(MethodCall methodCall, MethodChannel.Result result) {
    //通過methodCall可以獲得參數和方法名,原生這面做對應業務
    if (methodCall.method.equals("test1")) {
        if (methodCall.arguments != null) {
            Map<String, String> arguments = (Map<String, String>) methodCall.arguments;
        }
    }
}

以上就是Android原生跟Flutter交互方式,在實際項目中我遇到一個實際問題,原生、Flutter混合開發會遇到棧混亂的情況,之後引入阿里的[flutter_boost] (https://github.com/alibaba/flutter_boost),詳細接入可以參考開源庫,下面總結一下我接入這個庫遇到一些問題:

1.Android appcation中不能引用FlutterBoostPlugin
在原生項目 app下面gradle引入flutter_boost

implementation project(':flutter_boost')

2.v4 v7庫版本衝突
將xservice_kit 、flutter_boost、 flutter_module、 app下gradle裏版本統一。

3.Android接收Flutter中傳參中文字符串亂碼

String decodeValue = URLDecoder.decode(value, "UTF-8");

四、接入Flutter後調試問題

1.Android原生代碼不能快速debug
解決方法:將Android Studio升級到最新版本,目前最新版本3.4.1

2.Flutter熱加載
在flutter_module目錄下 輸入命令 flutter attach,這個時候會提示等待連接設備,然後 Run一次項目,當項目重新運行起來後,就可以在Terminal 中輸入r(熱加載)、R(熱重啓)命令進行愉快的開發了。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章