参考官网文档,进行简单整理
第一步,Flutter工程需要使用Flutter module,并放在iOS工程相邻目录(只要方便设置相对路径的地方就行)
别的没啥可说
第二步,iOS工程接入flutter
两种方法,各有利弊。
第一种方法:使用CocoaPods集成
优点:集成简单,xcode运行即可编译最新flutter代码,方便flutter与原生通信开发或其他兼容性调试。
缺点:需要配置flutter sdk开发环境,同时两个工程都配置好才能在xcode运行,如果原生和flutter分别开发不则方便,相互依赖过强;如果碰上xcode、pod、flutter有大升级时可能会产生短期的兼容性问题。
具体步骤:只需要配置好pod即可
platform :ios, '10.0'
#flutter
flutter_application_path = '../flutter_module' #相对路径
load File.join(flutter_application_path, '.ios', 'Flutter', 'podhelper.rb')
target 'MyApp' do
# Comment the next line if you're not using Swift and don't want to use dynamic frameworks pod install --no-repo-update
use_frameworks!
#flutter
install_all_flutter_pods(flutter_application_path)
# Pods for MyApp
pod 'xxx'
...
然后 pod install 即可
第二种方法:手动集成framework
优点:工程依赖性弱,framework已经集成在xcode工程中,可独立运行;分别开发时可以相互独立不用配置flutter环境或关心flutter开发细节;编译时速度较快;如果遇到xcode、pod、flutter大升级时稳定性兼容性更高。
缺点:在初期flutter与原生环境联调时较麻烦;版本管理需要加入framework而不仅仅是源码,占用空间较大不够灵活。接入时环境配置较复杂,后期如果增加了新库需要继续手动导入。
这种方法文档写的稍乱,整理了一下:
1、flutter工程目录下运行命令输出framwork:flutter build ios-framework --output=some/path/MyApp/Flutter/
output为输出存放framework的路径,经测试不能使用相对路径的写法,我用sh脚本来实现,以后输出时直接运行脚本即可。用不到profile模式可以增加--no-profile,最后还要把release中的所有库去掉x86_64和i386架构,否则xcode11中大包会失败,可以写入脚本批量处理参考。
输出路径最好为xcode工程相邻路径方便之后xcode设置,以下都以xcode相邻路径举例。
2、设置Framework Search Paths 增加"$(PROJECT_DIR)/../Flutter/$(CONFIGURATION)",这里不要选择debug或者release,而是编辑总体项自动选择
3、把输出后的所有动态链接库(随意选Debug或Release一个目录中的)拖入工程General面板,设置为Embed & Sign。(注意:静态库,比如FlutterPluginRegistrant.framework不要加入,否则不能上架AppStore,判断其他packge插件生成的framework是静态还是动态,请看官网给的链接)
4、编辑MyApp.xcodeproj/project.pbxproj文件:查找替换所有path = ../Flutter/Debug或Release/xx.framework;替换为path = "../Flutter/$(CONFIGURATION)/xx.framework";(注意添加引号 ")。可以根据Debug或Release编译时使用对应的framework。注意:flutter的生成的debug的framework可以运行在模拟器和真机,release的只能运行在真机。
5、bitcode设为了NO,否则这里遇到了编译release版出错
最后注意:flutter工程以后开发时如果增加了新的packge,要对新增加生成的framework做3-4步骤(若为静态库则不用加入)