美文网首页Flutter
iOS集成Flutter与热重载问题

iOS集成Flutter与热重载问题

作者: KB_MORE | 来源:发表于2021-04-22 11:16 被阅读0次

    Flutter 可以作为 frameworks 添加到 iOS 项目,iOS项目引入Flutter module需要安装Xcode,另外Flutter支持iOS8及以上。

    由于 Xcode 无法像 Android Studio 一样安装插件,因此只能通过命令创建 Flutter module,打开终端,输入如下:

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

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

    image

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

    由于.ios /目录是自动生成的,因此请勿对其进行源代码控制。在新机器上构建模块之前,请先在my_flutter目录中运行flutter pub get来重新生成.ios /目录,然后再使用Flutter模块构建iOS项目。

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

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

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

    应用程序无法在 Release 模式下的模拟器上运行,因为Flutter尚不支持为Dart代码提前输出x86 / x86_64二进制(AOT)二进制文件。在模拟器或真实设备上以调试模式运行,而在真实设备上以Release模式运行。

    下面的两种方式是将 Release frameworks 添加到 iOS 应用程序,因此编译的时候设备不能选择模拟器,否则编译失败。

    编译成功:

    image

    选择模拟器编译失败:

    image
    第一种: 使用cocoapods和已安装的flutter-sdk) 使用CocoaPods和已安装的Flutter SDK

    此方法需要所有的相关开发的人员安装 Flutter 环境。

    假设现有应用程序和Flutter模块位于同级目录中。如果您使用其他目录结构,则可能需要调整相对路径,目录如下:

    image

    修改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
    
    
    image

    CocoaPods 相关请参考官网

    执行 pod install 命令:

    image

    当在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) 在Xcode中嵌入 Flutter Frameworks

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

    运行如下命令生成 Frameworks:

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

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

    image

    frameworks 已经生成,将 frameworks 链接到 iOS 应用程序有很多中方法,下面介绍一种, 打开 Xcode,

    App.frameworkFlutter.framework 拖入Build Settings > Build Phases > Link Binary With Libraries

    image

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

    image

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

    image

    使用 ⌘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)
        }
    
    }
    
    
    image

    上面的代码使用了缓存 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之后, 我们修改flutter的部分可以实现原生APP flutter部分的热重载, 两种方式

    方法一

    此方法必须等APP中成功启动了FlutterEngin后才能生效,本文的FlutterEngin在AppDelegate中项目启动时就启动了,所以运行项目后,可直接在flutter模块的文件中(本文模块文件为flutter_moudle)运行命令:

    1. vs中执行flutter attach , 进入等待阶段


      图片.png
    2. xcode运行APP, attach成功, 修改flutter代码, r进行hot reload, 可以进行调试


      图片.png

    调试时需要使用:

    $ flutter attach --isolate-filter='debug'

    方法二
    1. Attach to Flutter on Device
    图片.png
    进入launching 等待阶段
    图片.png
    2 运行APP

    launching会变成 Syncing files to device 阶段

    图片.png

    此时可以进行修改flutter代码进行调试了, 修改flutter代码 然后cmd + s 保存,
    就会进行自动同步文件和hot reload, APP页面随之更新

    图片.png

    断开Attach, 再运行APP, 发现上面的改动并未生效, 其实APP在没有Attach的情况下运行, 加的的是flutter build产物 APP.framework


    图片.png

    APP.framework 是执行pod install 时生成的, 所以执行pod update 才能更新framework, 也就是加载到更新代码后的flutter, 或者删除 APP.framework, 然后pod install也是可以的

    相关文章

      网友评论

        本文标题:iOS集成Flutter与热重载问题

        本文链接:https://www.haomeiwen.com/subject/nzexrltx.html