前言:

Flutter 因其自建的渲染引擎，背靠谷歌的支持，近来俘获了不少的开发小伙伴，越来越多的开发者尝试使用Flutter进行开发，在原生项目中嵌入Flutter来完成复杂度不高的页面成为了一个不错的选择。本篇文章记录了一次在原生项目中嵌入Flutter的过程。

准备工作：搭建好 Flutter 的开发环境

[简书抽风可能无法显示]

在原生项目中加入Flutter模块

之前网上对混合开发有一些现成的库，目前效果不是很理想，本文采用的是官方文档中的方法。

1. 创建 Flutter 模块

到需要创建模块的文件夹下(本文为原生项目下)，执行创建模块的命令：

$: flutter create --template module flutter_moudle

// 此处根据网络状况可能会耗时很久，耐心等待即可。

创建成功后，能在目下看到一个 flutter_moudle 的文件:

flutter_moudle文件结构

Tips:

使用"shift+cmd+."可查看文件夹隐藏文件

2. 配置 Flutter 模块

官方在项目中启用Flutter模块提供了多种方法，本文主要介绍其中两种：

(1)方法1: CocoaPods

在Podfile中添加定义，并配置对应的Target

添加如下两句到定义：

# flutter模块的路径(本文的flutter模块与Podfile在同一目录下)

flutter_application_path = 'flutter_moudle'

# 加载podhelper.rb

load File.join(flutter_application_path, '.ios', 'Flutter', 'podhelper.rb’)

# 配置对应Target：

target 'MyApp' do

install_all_flutter_pods(flutter_application_path)

end

添加完毕后执行更新项目的pod

$: pod install

完成后打开原生项目的 xxx.xcworkspace ，可以看到Pods新增DevelopmentPods文件:

DevelopmentPods

(2)方法2: Framework

进入到我们第一步创建的Flutter组件的文件中，将相应的模块添加到原生项目的Framework即可，对应模块为：

flutter.framework (路径：/flutter_moudle/.ios/Flutter/App.framework)

app.framework (路径：/flutter_moudle/.ios/Flutter/engine/Flutter.framework)

Framework

使用两种方法任何一种均可，配置完成后执行编译(cmd+b)，编译成功后表示我们已经成功将Flutter加入到了原生项目中。

Tips1:

【Bitcode 相关】

默认情况下，原生项目是开启了Bitcode选项的，而 Flutter 目前并不支持，需要手动关闭(Build Setting -> Enable Bitcode 设置为 NO)

Tips2:**

【编译报错：Command PhaseScriptExecution failed with a nonzero exit code】**：

这个错误发生在原生项目的文件名改变后，错误信息还提示了“flutter/XXXX/XXX no such file found”的内容，说明找不到Flutter路径了，我们看到在 .ios/Flutter/Generated.xcconfig 中看到了Flutter的各种路径，而我们改变文件名后，还需要更新Flutter配置，可在 “.ios” 目录下使用自动更新命令：

$: flutter pub get

Tips3:**

【编译卡死在：/Users/xurenjie/Desktop/AppStore/ProjectName/flutter_moudle/.ios/Flutter/flutter_export_environment.sh: line 8: inherited: command not found】**

该问题在多次编译项目后出现，频率较高，可临时通过清除项目缓存解决。

使用Flutter

预热并配置 Flutter 引擎

AppDelegate

调用Flutter页面

然后在需要展示 Flutter 页面的时候使用 FlutterViewController：

跳转Flutter页面

至此，我们就完成了在原生应用中加入Flutter模块的配置

热更新

热更新是 Flutter 的一大特性，在VSCode，AndroidStudio中开发时可以很容易的使用，而在Xcode下，打开热更新的方式：

[方法1]

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

$ flutter attach

调试时需要使用：

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

[方法2]

此方法可以等待项目中的flutter engin启动，不同1那种需要在启动的情况下才可以启用：

在VSCode中运行:

$ Attach to Flutter on Device

Tips:

【isolate相关错误】

需要在main.dart的main函数添加如下设置：

isolate错误解决方式

总结

可以看到，将Flutter加入到原生项目中非常简单。

Flutter 也给项目的开发增加了复杂度，一方面使得开发团队必须形成规范，以在Android、iOS、Flutter、Web均存在的项目中不会发生混合开发的坑。

Flutter的优点在于一次开发，多处使用，且借助其自建引擎在不同平台上都有接近于原生的表现。

明显的是，引入Flutter会明显直接增大包体积。

加入Flutter的原生项目的编译速度降低，尤其是初次编译非常明显，不严谨的用小项目测试多次，加入前初次编译不到20s左右，而加入后最长的一次等待了5分钟，(可能是提醒我该换电脑了)。

鉴于上述情况，将Flutter加入开发中，需要根据项目当下的实际情况(团队成员技术构成，项目业务特点等等)确定，不可一概而论，也不可能一劳永逸。