Flutter 与 iOS 混合项目初探

背景

大厂小厂都在搞Flutter,就问你慌不慌!

国内一些混合集成方案的文章大部分都太老了,参考价值不高,并且很容易让初学者头大。

前言

本文非阐述Flutter相关的原理,优势,发展现状等问题,只介绍在与现有的iOS项目做混合开发的实践,以及混合过程中的一些坑。目前混合开发已有2个页面开发完成,等待用户检验。

开发工具

  1. Xcode版本 10.2
  2. Visual Studio Code 1.41.0

环境依赖

Flutter开发环境配置过程就不细说了,官网文档已经写的很详细了。

目前使用Flutter SDK版本为 v1.9.1+hotfix.6

环境配置完成后执行 flutter doctor 做下检查

Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel unknown, v1.9.1+hotfix.6, on Mac OS X 10.14.4 18E226,
    locale zh-Hans-CN)
 
[!] Android toolchain - develop for Android devices (Android SDK version 29.0.2)
    ! Some Android licenses not accepted.  To resolve this, run: flutter doctor
      --android-licenses
[!] Xcode - develop for iOS and macOS (Xcode 10.2)
    ! CocoaPods out of date (1.6.0 is recommended).
        CocoaPods is used to retrieve the iOS and macOS platform sides plugin
        code that responds to your plugin usage on the Dart side.
        Without CocoaPods, plugins will not work on iOS or macOS.
        For more info, see https://flutter.dev/platform-plugins
      To upgrade:
        sudo gem install cocoapods
[✓] Android Studio (version 3.5)
[✓] VS Code (version 1.41.0)
[✓] Connected device (1 available)

! Doctor found issues in 2 categories.

可以看到要求CocoaPods版本为1.6.0及以上,目前我们在使用1.5.3版本,不过这只是个警告,影响不大,后续升级CocoaPods自然会解决这个问题。

混合方案

混合方案这一块官方也是经历了好几个版本的变更,最初混合的方案比较麻烦,官方文档写的也不是很详细,不过在Flutter1.12 发布后,混合方案文档做了更新,2种混合方案写的也很简单易懂。 这里我们也是采用了官方推荐的方案(使用CocoaPods依赖管理)。

  • 创建Flutter模块(Flutter相关页面的代码都在这里)。
cd some/path/
flutter create --template module my_flutter

这里推荐将Flutter模块跟iOS工程模块放在同级目录下

some/path/
├── my_flutter/
└── MyApp/
  • 修改Podfile
  1. CocoaPods依赖本地Flutter模块
flutter_application_path = '../my_flutter'
 load File.join(flutter_application_path, '.ios', 'Flutter', 'podhelper.rb')
  1. 每个target嵌入Flutter
target 'MyApp' do
   install_all_flutter_pods(flutter_application_path)
 end
  1. 执行pod install这里是通过podhelper.rb脚本将Flutter工程里面.ios目录下相关的产物嵌入到iOS工程。
  • Flutter.framework(Flutter engine bundle)
  • App.framework(Dart code)
  • Flutter plugins

相关产物的生成记得在Flutter模块下执行flutter build ios操作。

按照上面3步操作完成后我们可以看到Flutter产物已经集成到iOS工程了

Analyzing dependencies
Fetching podspec for `Flutter` from `../../finance-flutter-module/.ios/Flutter/engine`
Fetching podspec for `FlutterPluginRegistrant` from `../../finance-flutter-module/.ios/Flutter/FlutterPluginRegistrant`
Fetching podspec for `connectivity` from `../../finance-flutter-module/.ios/Flutter/.symlinks/connectivity/ios`
Fetching podspec for `flutter_boost` from `../../finance-flutter-module/.ios/Flutter/.symlinks/flutter_boost/ios`
Fetching podspec for `rrd_flutter` from `../../finance-flutter-module/.ios/Flutter`
Fetching podspec for `url_launcher` from `../../finance-flutter-module/.ios/Flutter/.symlinks/url_launcher/ios`
Downloading dependencies
Installing Flutter (1.0.0)
Installing FlutterPluginRegistrant (0.0.1)
Installing Reachability (3.2)
Installing connectivity (0.0.1)
Installing flutter_boost (0.0.2)
Installing rrd_flutter (0.0.1)
Installing url_launcher (0.0.1)
Generating Pods project
Integrating client project

解决报错

完成混合后run工程出现如下error

/Build/Products/Debug-iphonesimulator/investment.app/Frameworks/Flutter.framework: Permission denied

这里应该是Flutter1.9的签名冲突Bug,官方在1.10.2已经修复这个问题。

解决方案有两种:

  1. 执行 channel master 或者 channel dev 先换个channel用。
  2. 修改Flutter SDK文件,打开flutter/packages/flutter_tools/bin/xcode_backend.sh文件,将
RunCommand find "${derived_dir}/engine/Flutter.framework" -type f -exec chmod a-w "{}" \;

替换为

RunCommand find "${derived_dir}/engine/Flutter.framework" -type f -iname '.h' -exec chmod a-w "{}" \;

我们采用了第二种方案,修改后再次run发现工程已经可以运行了,到这里Flutter和iOS的初步混合已经完成了。

调试和Hot Reload

flutter attach之后使用终端或者VSCode做Flutter页面调试非常方便,这里还是推荐使用VSCode,毕竟在代码和终端之间来回切换不停的按r很烦。

bogon:my_flutter yin$ flutter attach
Checking for advertised Dart observatories...
Waiting for a connection from Flutter on iPhone X...
Done.
Syncing files to device iPhone X...                              1,328ms

🔥  To hot reload changes while running, press "r". To hot restart (and rebuild
state), press "R".
An Observatory debugger and profiler on iPhone X is available at:
http://127.0.0.1:63823/uO5BqqTmOrE=/
For a more detailed help message, press "h". To detach, press "d"; to quit,
press "q".

不过Android Studio对Flutter开发调试支持的要更好,毕竟是同厂出品,会有一些新的调试功能和特性可以使用,感兴趣的同学可以研究下。作为一个用惯了Xcode的人,目前来说VSCode已经可以满足我的开发需求了,就不去折腾Android Studio,毕竟开发React Native也还是要用VSCode,搞太多IDE怕自己凌乱~

这里有一点需要注意下就是 flutter attach 之后可能会一直为等待状态

Checking for advertised Dart observatories...
Waiting for a connection from Flutter on iPhone X...

这时我们杀掉APP进程重新启动就可以连接了。这里猜测是每次Native工程做Flutter相关初始化时候才会做一次attach

总结

我们目前使用的方案是Flutter官方推荐的混合方案,优点缺点并存:

  • 优点:混合集成简单,混合过程很多事情Flutter官方已经帮我们做好了
  • 缺点:虽然iOS工程仓库和Flutter Module工程仓库是分离的,但紧紧做到了代码分离,实际运行两个工程是相互依赖的,也就是iOS和Android端的开发者本地都要安装一套Flutter环境。

目前这套混合方案还比较适合我们(iOS和Android都为3人)这种较小的团队,如果团队人员比较多或者还有Flutter单独的项目组的话,这种混合方案可能就比较笨重了,当然网上还有一些Flutter混合开发工程化的方案,这里我们暂时不做讨论,后续如果去研究了在做补充吧~

相关链接

Flutter环境配置

官方混合文档

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,560评论 4 361
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,104评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,297评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,869评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,275评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,563评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,833评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,543评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,245评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,512评论 2 244
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,011评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,359评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,006评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,062评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,825评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,590评论 2 273
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,501评论 2 268

推荐阅读更多精彩内容