摘要:
理想的iOS原生集成Flutter,需要满足以下条件:1.Flutter模块由单独一位同学负责维护,其他同学不关心Flutter模块; 2. 考虑到Flutter环境的版本问题,其他同学不需安装Flutter环境,避免Flutter版本差异产生未知问题; 3.负责Flutter模块的同学不需要过多手动操作,就可以方便实现Flutter模块的开发,调试,迭代。
本文主要讲解我个人使用的iOS与Flutter集成方案,已在项目中实施,暂时未产生问题,如果有问题,欢迎来沟通。另外,个人写了一套Python脚本来支持此方案,如果没有脚本能力,不建议尝试此方案。此文章仅做抛砖引玉,欢迎各位大牛来指正。
- iOS原生集成Flutter产出的本质
iOS集成Flutter模块,本质上是iOS工程嵌入Flutter工程产出的多个FrameWork。
Flutter环境给出了一个podhelper.rb的ruby脚本,帮助iOS集成Flutter。脚本使用方式如下,【在podfile文件,编写如下代码】:
@flutter_application_path = '../flutter_module_xxxx'
def flutter_source_project_embased_function()
load File.join(@flutter_application_path, ‘.ios’, ‘Flutter’, ‘podhelper.rb’)
install_all_flutter_pods(@flutter_application_path)
end
target 'FFlutterKit' do
flutter_source_project_embased_function
end
终端执行
pod install –verbose
之后查看iOS工程目录,会产生如下文件夹:
产生了6个Development Pods,清单如下:
connectivity, Flutter,flutter_module_fresh,path_provider,sqflite,url_launcher
至于为什么是Development Pods,这需要分析podhelper.rb脚本,可以发现如下语句:
pod plugin_name, :path => File.join(symlink, 'ios'), :inhibit_warnings => true
如图:
即,podhelper.rb脚本是通过嵌入 .podspec 文件的形式来集成Flutter产出。
【.podspec文件用法,此处不做介绍,不熟悉的同学,自己去网上百度 私有pod库的制作】
以上简单分析了通过podhelper.rb脚本集成Flutter模块。此方式有个问题, 每个同学的电脑都需要安装Flutter环境,而Flutter环境是存在版本差异的,且更新比较快。故,这种方式不是理想的集成方式。
理想的集成方式,应当满足如下要求:
1. Flutter模块由单独一位同学负责维护,其他同学不关心Flutter模块。
2. 考虑到Flutter环境的版本问题,其他同学不需安装Flutter环境,避免Flutter版本差异产生未知问题。
3. 负责Flutter模块的同学不需要过多手动操作,就可以方便实现Flutter模块的开发,调试,迭代。
那么重头戏来了。
我们换个思路,我们是不是可以自己把这些Flutter产出的.podspec文件筛选出来, 并把每个.podspec文件对应的资源文件、代码文件以及二进制文件也筛选出来,制作为私有pod,通过cocoapod集成这些私有pod。如此一来,集成Flutter就变得和集成常规pod一样简单了。
如果可以,我们是否可以通过编写脚本,将这些步骤自动化执行,工程师只需要简单一条指令,就可以去喝茶了,坐等脚本成功。好消息是,此想法已在我的项目中实现,且已线上验证。
至于制作私有pod,此处不做赘述,有需要的同学,需要去问度娘 ‘iOS 私有pod制作’以及‘.podspec文件语法’,建议查看cocoapods官网https://guides.cocoapods.org/making/specs-and-specs-repo.html
下面来分析一下需要做的工作:
1. 筛选出每个.podspec文件;
2. 解析每个.podspec文件,收集每个.podspec文件关联到的文件;
3. 整理每个.podspec文件以及其资源文件,形成自己的私有pod;
4. 将每个.podspec制作为私有pod,并交由git管理;iOS原生项目集成私有pod
以下是重头戏,请仔细品味
-
筛选出.podspec文件
分析Flutter module工程,会发现,所有关于ios的产出,都集中在.ios文件夹下。我们可以以此为切入点来搜索.podspec格式的文件。
此处有个问题, Flutter也有很多三方供开发者使用,随着项目的迭代,可能会增加或删除Flutter三方,就导致了.podspec文件个数的变化。 故,筛选出来的.podspec文件个数是不确定的。而且.podspec文件所处的目录层级也是不确定的。
- **解析.podspec文件
.podspec文件是ruby脚本文件,不容易解析。但是,cocoapods提供了指令,可以将.podspec转换为.json文件, 而cocoapods本省是可以解析.podspec.json格式的文件。 GitHub官方的spec索引文件最终也是转换成了.podspec.json文件。 转换指令如下:
pod ipc spec xxx.podspec >> xxx.podspec.json
文件转化为.json格式,下一步就好做了,分析json中引用了哪些路径的问题,把这些文件暂存起来,为制作私有pod做准备**
-
为每个.podspec文件制作私有pod
Flutter产生的.podspec文件数目是不确定的,这就意味着,我们制作的私有pod的个数是存在变化的, 那么如何交由git管理呢,难道要为每个私有pod都创一个git仓库? 这不是我们想要的, 我的目标是一个git仓库来管理多个私有pod。 幸运的是通过查看cocoapods官网,我找到了解决办法。 我最终产出的目录结构如下:
此处有个细节,我将每个.podspec.json文件放在了git仓库的根目录,每个.podspec文件的资源文件放在了与pod同名的一个文件夹下统一管理, 并在解析.podspec.json文件时候,对资源文件的路径做了修改,新添了名称的层级,如图:
原始:
修改后:
- 私有pod的git管理
将.podspec文件解析并修改后,放置在一个git仓库中,并将对应的资源文件也放置在这个git仓库中。 每次Flutter模块打包后,都筛选,解析一次spec文件, 并修改版本号。 - iOS原生集成Flutter私有pod
iOS原生项目集成这些私有pod,并声明对应版本。【此处的集成方式与常规集成GitHub的pod有细微差别,欢迎留言沟通。】
Flutter模块之外的同学,不需要配置Flutter环境,不需要关心Flutter模块的状态,只需要在每次拉取代码后执行pod install,即可。 - 如果项目配置了打包机,且打包机负责Flutter模块的打包,那么负责Flutter模块的同学,只需要保证打包机的Flutter环境版本无误, 其他不负责甚至不懂Flutter开发的同学也可以打包Flutter模块。
写在最后:
如果有不对之处,欢迎留言沟通。