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

摘要:
~~~~~~理想的iOS原生集成Flutter,需要满足以下条件:1.Flutter模块由单独一位同学负责维护,其他同学不关心Flutter模块; 2. 考虑到Flutter环境的版本问题,其他同学不需安装Flutter环境,避免Flutter版本差异产生未知问题; 3.负责Flutter模块的同学不需要过多手动操作,就可以方便实现Flutter模块的开发,调试,迭代。

~~~~~~本文主要讲解我个人使用的iOS与Flutter集成方案,已在项目中实施,暂时未产生问题,如果有问题,欢迎来沟通。另外,个人写了一套Python脚本来支持此方案,如果没有脚本能力,不建议尝试此方案。此文章仅做抛砖引玉,欢迎各位大牛来指正。

  1. 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

以下是重头戏,请仔细品味

  1. 筛选出.podspec文件
    分析Flutter module工程,会发现,所有关于ios的产出,都集中在.ios文件夹下。我们可以以此为切入点来搜索.podspec格式的文件。
    此处有个问题, Flutter也有很多三方供开发者使用,随着项目的迭代,可能会增加或删除Flutter三方,就导致了.podspec文件个数的变化。 故,筛选出来的.podspec文件个数是不确定的。而且.podspec文件所处的目录层级也是不确定的。

    ~
    .podspec分布
  2. **解析.podspec文件
    .podspec文件是ruby脚本文件,不容易解析。但是,cocoapods提供了指令,可以将.podspec转换为.json文件, 而cocoapods本省是可以解析.podspec.json格式的文件。 GitHub官方的spec索引文件最终也是转换成了.podspec.json文件。 转换指令如下:
pod ipc spec xxx.podspec >> xxx.podspec.json

文件转化为.json格式,下一步就好做了,分析json中引用了哪些路径的问题,把这些文件暂存起来,为制作私有pod做准备**

  1. 为每个.podspec文件制作私有pod
    Flutter产生的.podspec文件数目是不确定的,这就意味着,我们制作的私有pod的个数是存在变化的, 那么如何交由git管理呢,难道要为每个私有pod都创一个git仓库? 这不是我们想要的, 我的目标是一个git仓库来管理多个私有pod。 幸运的是通过查看cocoapods官网,我找到了解决办法。 我最终产出的目录结构如下:
    ~
    .podspec.json 筛选后目录结构

    此处有个细节,我将每个.podspec.json文件放在了git仓库的根目录,每个.podspec文件的资源文件放在了与pod同名的一个文件夹下统一管理, 并在解析.podspec.json文件时候,对资源文件的路径做了修改,新添了名称的层级,如图:
    原始:
    ~
    在这里插入图片描述

    修改后:~
    在这里插入图片描述
  2. 私有pod的git管理
    将.podspec文件解析并修改后,放置在一个git仓库中,并将对应的资源文件也放置在这个git仓库中。 每次Flutter模块打包后,都筛选,解析一次spec文件, 并修改版本号。
  3. iOS原生集成Flutter私有pod
    iOS原生项目集成这些私有pod,并声明对应版本。【此处的集成方式与常规集成GitHub的pod有细微差别,欢迎留言沟通。】
    Flutter模块之外的同学,不需要配置Flutter环境,不需要关心Flutter模块的状态,只需要在每次拉取代码后执行pod install,即可。
  4. 如果项目配置了打包机,且打包机负责Flutter模块的打包,那么负责Flutter模块的同学,只需要保证打包机的Flutter环境版本无误, 其他不负责甚至不懂Flutter开发的同学也可以打包Flutter模块。

~~~写在最后:
~~~如果有不对之处,欢迎留言沟通。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。