添加Flutter到iOS工程最新教程

尝试在原iOS工程里添加Flutter模块,碰到问题,发现网上的教程比较陈旧,所以写一篇最新教程。

创建Flutter moudle

一般把Flutter moudle放在iOS工程同级,然后执行命令

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

执行完毕后,Flutter module将会创建在 ios项目/my_flutter目录下,目录结构如下图:


截屏2022-04-29 15.15.29.png

.ios 是隐藏目录,可以单独运行Flutter module,测试此模块的功能,iOS代码添加到现有应用程序的项目或插件中,而不是添加到模块的.ios /目录中。由于.ios /目录是自动生成的,因此请勿对其进行源代码控制。在新机器上构建模块之前,请先在my_flutter目录中运行flutter pub get来重新生成.ios /目录,然后再使用Flutter模块构建iOS项目。

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

修改iOS应用程序中 Podfile 文件,内容如下:

截屏2022-04-29 15.19.38.png

需要注意的是,Flutter模块和iOS工程位于同级目录中,如果在不同的目录中,需要调整相对路径。
执行pod install命令,执行完毕后,再通过命令生成Frameworks:

cd /Users/xxx/Desktop/iOS\ Flutter/my_flutter 
flutter build ios-framework --output=./Flutter/
20201012210833.png

Frameworks 已经生成,然后将 App.framework 和 Flutter.framework 拖入Build Settings > Build Phases > Link Binary With Libraries:


20201012210838.gif

此时在项目的左侧增加 Frameworks 目录:


20201012210848.png

然后开始运行,发现报错:
截屏2022-04-29 11.51.16.png

解决方法: 找到Build Phases > [CP-User],直接叉掉即可。

创建 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)
    }
}
20201012210906.gif

上面的代码使用了缓存 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到iOS工程最新教程)