iOS老项目集成Flutter产物 pod集成

摘要：
$~~~~~~$ 理想的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截图

即，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文件
.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 筛选后目录结构

此处有个细节，我将每个.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模块。

$~~~$ 写在最后：
$~~~$ 如果有不对之处，欢迎留言沟通。