【Flutter 混合开发】添加 Flutter 到 iOS

Flutter 混合开发系列 包含以下：

• 嵌入原生View-Android
• 嵌入原生View-iOS
• 与原生通讯-MethodChannel
• 与原生通讯-BasicMessageChannel
• 与原生通讯-EventChannel
• 添加 Flutter 到 Android Activity
• 添加 Flutter 到 Android Fragment
• 添加 Flutter 到 iOS

每一个工做日分享一篇，欢迎关注、点赞及转发。

Flutter 能够做为 frameworks 添加到 iOS 项目，iOS项目引入Flutter module须要安装Xcode，另外Flutter支持iOS8及以上。

建立 Flutter module

因为 Xcode 没法像 Android Studio 同样安装插件，所以只能经过命令建立 Flutter module，打开终端，输入以下：

cd ios 项目根目录
flutter create --template module my_flutter

执行完毕后，Flutter module将会建立在 ios项目/my_flutter目录下，目录结构如图：

.ios 是隐藏目录，能够单独运行Flutter module，测试此模块的功能，iOS代码添加到现有应用程序的项目或插件中，而不是添加到模块的.ios /目录中。

因为.ios /目录是自动生成的，所以请勿对其进行源代码控制。在新机器上构建模块以前，请先在my_flutter目录中运行flutter pub get来从新生成.ios /目录，而后再使用Flutter模块构建iOS项目。

将Flutter模块嵌入到现有应用程序中

将Flutter模块嵌入到现有iOS应用程序中有两种方式：

• 使用CocoaPods和已安装的Flutter SDK（推荐）。
• 为Flutter引擎，已编译的Dart代码和全部Flutter插件建立 frameworks。手动嵌入 frameworks，并在Xcode中更新现有应用程序的构建设置。

应用程序没法在 Release 模式下的模拟器上运行，由于Flutter尚不支持为Dart代码提早输出x86 / x86_64二进制（AOT）二进制文件。在模拟器或真实设备上以调试模式运行，而在真实设备上以Release模式运行。

下面的两种方式是将 Release frameworks 添加到 iOS 应用程序，所以编译的时候设备不能选择模拟器，不然编译失败。

编译成功：

选择模拟器编译失败：

使用CocoaPods和已安装的Flutter SDK

此方法须要全部的相关开发的人员安装 Flutter 环境。

假设现有应用程序和Flutter模块位于同级目录中。若是您使用其余目录结构，则可能须要调整相对路径，目录以下：

修改iOS应用程序中 Podfile 文件，若是没有则手动建立，内容以下：

flutter_application_path = '../my_flutter'
load File.join(flutter_application_path, '.ios', 'Flutter', 'podhelper.rb')

target 'My App' do
 install_all_flutter_pods(flutter_application_path)
end

CocoaPods 相关请参考官网。

执行 pod install 命令：

当在my_flutter / pubspec.yaml中更改Flutter插件的依赖性或者第一次运行时，请在Flutter模块目录中运行flutter pub get来刷新podhelper.rb脚本读取的插件列表。而后，从应用程序目录再次运行pod install。

podhelper.rb脚本将插件Flutter.framework和App.framework嵌入到项目中。

用 Xcode 打开 My App.xcworkspace，若是已经打开则须要关闭从新打开，使用 ⌘B 编译项目，编译成功。

在Xcode中嵌入 Flutter Frameworks

经过命令生成必要的 Frameworks，并经过手动编辑现有的Xcode项目将它们嵌入到应用程序中。若是团队成员没法在本地安装Flutter SDK和CocoaPods，或者您不想在现有应用程序中将CocoaPods用做依赖项管理器，则能够使用此方式。每次在Flutter模块中进行代码更改时，都必须运行 flutter build ios 。

运行以下命令生成 Frameworks：

flutter build ios-framework --output=./Flutter/

执行完毕后在对应的目录下生成相关编译产物：

frameworks 已经生成，将 frameworks 连接到 iOS 应用程序有不少中方法，下面介绍一种， 打开 Xcode，

将 App.framework 和 Flutter.framework 拖入Build Settings > Build Phases > Link Binary With Libraries：

此时在项目的左侧增长 Frameworks 目录：

在 Build Settings -> Search Paths -> Framework Search Paths 中添加 ${PODS_ROOT}/../my_flutter/Flutter/Release

使用 ⌘B 编译项目，编译成功。

建立 FlutterEngine 和 FlutterViewController

将 Flutter 页面嵌入 iOS 应用程序须要建立 FlutterEngine（Flutter 引擎） 和 FlutterViewController，FlutterEngine 是Dart VM和Flutter运行时的 host，FlutterViewController 附着于 FlutterEngine，做用是通讯和显示 Flutter UI。

建立 FlutterEngine：

import UIKit
import Flutter

@UIApplicationMain
class AppDelegate: FlutterAppDelegate {
  lazy var flutterEngine = FlutterEngine(name: "my flutter engine")

  override func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    
    flutterEngine.run();
    
    return super.application(application, didFinishLaunchingWithOptions: launchOptions);
  }
}

添加一个按钮，跳转到 Flutter 页面：

import UIKit
import Flutter

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        let button = UIButton(type:UIButton.ButtonType.custom)
        button.addTarget(self, action: #selector(showFlutter), for: .touchUpInside)
        button.setTitle("显示 Flutter", for: UIControl.State.normal)
        button.frame = CGRect(x: 80.0, y: 210.0, width: 160.0, height: 40.0)
        button.backgroundColor = UIColor.blue
        self.view.addSubview(button)
    }
    
    @objc func showFlutter() {
      let flutterEngine = (UIApplication.shared.delegate as! AppDelegate).flutterEngine
      let flutterViewController =
          FlutterViewController(engine: flutterEngine, nibName: nil, bundle: nil)
      present(flutterViewController, animated: true, completion: nil)
    }


}

上面的代码使用了缓存 FlutterEngine，固然这也是推荐的一种方式。

还有一种方式是是使用隐含的FlutterEngine，使用隐含的FlutterEngine会明显增长显示Flutter UI的时间，一般不建议这样作，若是不多显示 Flutter 屏幕，没有好的方法来肯定什么时候启动Dart VM以及什么时候Flutter不须要在视图控制器之间保持状态，则这可能颇有用。

func showFlutter() {
  let flutterViewController = FlutterViewController(project: nil, nibName: nil, bundle: nil)
  present(flutterViewController, animated: true, completion: nil)
}

指定入口点

默认状况下 FlutterEngine 加载 lib/main.dart 文件中的 main() 方法，也能够指定其余文件的方法：

flutterEngine.run(withEntrypoint: "newEntrypoint", libraryURI: "main.dart")

初始化路由

从Flutter 1.22版开始，能够指定路由

let flutterEngine = FlutterEngine()
flutterEngine.run(
  withEntrypoint: FlutterDefaultDartEntrypoint, initialRoute: "/one_page")

交流

老孟Flutter博客（330个控件用法+实战入门系列文章）：http://laomengit.com

欢迎加入Flutter交流群（微信：laomengit）、关注公众号【老孟Flutter】：