1. 若主工程为Flutter工程,可在Flutter工程中的".ios/"".android/"文件夹中的宿主工程进行开发原生项目。
2. 若Native工程为主工程,需建立 Flutter 工程向双端分别集成。
一、集成步骤(iOS端):
1. 推荐管理方式:Git中submodule功能
2. 推荐集成方式:CocoaPods
3. Podfile 文件中写入如下代码后,pod install集成。
flutter_application_path = '../SubModule/XXX'
load File.join(flutter_application_path,'.ios','Flutter','podhelper.rb')
install_all_flutter_pods(flutter_application_path)
注意事项:
1. 默认情况下,Flutter是不支持Bitcode的。
在Xcode中需要依次选择【TAGETS】—>【Build Setttings】—>【Build Options】—>【Enable Bitcode】选项来禁用Bitcode。
2.原生编译时报错:Command PhaseScriptExecution failed with a nonzero exit code。
此报错说明pod所集成代码有问题,需要检查Flutter项目是否能单独独立运行(确保代码正确性)。
3. flutter项目为submodule方式管理,当.dart文件修改后,每次原生编译前需重新pod install。
二、交互通信(iOS端):
1. 交互步骤(swift):
// MARK: - 需要在AppDelegate中初始化,可根据需要 自行设置单例并懒加载 引擎/容器/信道。
let channelName = "XXX"
let flutterEngin = FlutterEngine.init(name:"flutter_native", project:nil)
flutterEngin.run(withEntrypoint:nil, initialRoute:"/XXX")
GeneratedPluginRegistrant.register(with: flutterEngin)
let vc = FlutterViewController.init(engine:flutterEngin, nibName:nil, bundle:nil)
let channel = FlutterMethodChannel.init(name:channelName, binaryMessenger:checkVC as! FlutterBinaryMessenger)
channel.setMethodCallHandler {[weak self] (call, result)in
if call.method == "XXX"{
if let jsonDic = call.arguments as? String{
}
result(FlutterMethodNotImplemented)
}
2.主要类介绍:
(引擎)FlutterEngine: 一个引擎 对应 一个容器。
(容器)FlutterViewController: 一个容器 对应 一个/多个 Flutter 页面。
(信道)FlutterMethodChannel:一个信道 对应一个容器。
注意事项 * :
1. 原生跳转:跳转至 FlutterViewController实例 即可。Flutter 页面跳转:.dart中实现。
2. FlutterViewController 的此实例化方法不推荐使用。
[[FlutterViewController alloc]initWithProject:nil nibName:nil bundle:nil];
原因:此方法会自动生成一个Flutter引擎。在实际开发过程中,需要在程序启动时初始化Flutter引擎。
坑1: 引擎初始化需要一定时间,在页面跳转时初始化会产生白页。
坑2: 信道交互时需要先“setMethodCallHandler”,后“invokeMethod”。易产生交互失败。
3. 引擎FlutterEngine 占用内存较大,不易过多。
故尽量避免 多个容器分别对应多个Flutter页面的情况,尽量使用一个容器对应多个Flutter页面,Flutter内部跳转的方式。
故尽量避免 new 原生VC -> new FlutterViewController -> new 原生VC -> new FlutterViewController 的情况发生。
4. 信道使用方式:FlutterMethodChannel(用于传递方法调用):
01. Native及Flutter端需定义唯一相同 channelName。根据channelName指定唯一信道。
iOS 端(swift):
static let channelName = "XXX.XXX.XXX"
let _methodChannel = FlutterMethodChannel.init(name:channelName, binaryMessenger:XXXVC as! FlutterBinaryMessenger)
Flutter 端(swift):
const MethodChannel _methodChannel = MethodChannel("XXX.XXX.XXX");
02,iOS 向Flutter 端:传递数据时 Flutter端使用setMethodCallHandler 方法接收数据,iOS端使用invokeMethod方法传递数据。反之相同。
5. 信道使用方式:FlutterEventChannel(用于事件流的发送),FlutterMessageChannel(用于传递字符串和半结构化的消息) 待补充。