Cocoapods模块化开发组件化管理

利用CocoaPods集成的优势,管理代码块,组件,实现模块化开发。实现的效果是把封装起来的常用的功能或者组件,放到pod里面去管理,其他人也额可以用pod快速集成

代码模块化的目的:

  • 易于管理代码
  • 方便集成使用代码块进行快速开发,相比直接复制到多个项目,优势比较明显
  • 更新pod里面的内容,那么其他使用到的地方可以实现同步更新
  • 可以随意的组装代码块,实现不同的功能

制作步骤:

  1. 安装cocoapods
  2. github创建代码仓库
  3. 制作本地库(创建和配置podspec文件)
  4. 验证
  5. 创建字库Subspec

一、安装cocoapods

不做过多的介绍

二、github创建代码仓库

1.先创建一个远程的spec索引仓库

截屏2021-03-22 下午1.41.05.png

截屏2021-03-22 下午4.32.25.png

Repository name 为你要创建的代码块(仓库)的名称
Description(optional)描述这个代码块的功能,可选

截屏2021-03-22 下午1.55.28.png

2.将私有的远程索引仓库copy到本地

使用命令:

pod repo add LXHSpec(本地仓库名称) + 刚刚创建的远程索引库地址

命令执行完毕后,在对应目录下会产生一个文件夹
前往文件夹:/Users/lxh(用户名)/.cocoapods/repos/

截屏2021-03-22 下午2.05.56.png

也可以可使用 pod repo 命令 查看

LXHSpec
- Type: git (unknown)
- URL:  https://github.com/Liaoxinhanios/LXHSpec.git
- Path: /Users/lxh/.cocoapods/repos/LXHSpec

master
- Type: git (master)
- URL:  https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/ Specs.git
- Path: /Users/lxh/.cocoapods/repos/master

trunk
- Type: CDN
- URL:  https://cdn.cocoapods.org/
- Path: /Users/lxh/.cocoapods/repos/trunk

至此,私有远程索引仓库LXHSpec生产完成

三、 制作本地库(创建和配置podspec文件)

同创建远程索引库一样,但是要注意不要勾选README file 因为一会我们在上传模板的时候 有自动生成 下面的几个选项都不选


截屏2021-03-22 下午4.32.42.png

3.1创建私有的pod组件库

cd 到要存放的对应的文件夹路径 执行以下命令

pod lib create MyLib

执行后需要填写一些选项,按需选择即可。如下:

截屏2021-03-22 下午2.55.17.png

问题的意思就是这样:

1.你想要使用哪个平台?[iOS / macOs]
2.你想要使用哪种语言?[Swift / ObjC]
3.你的库中是否包含一个示例程序?[Yes / No]
4.你想要使用哪个测试框架?[Specta/ Kiwi / None]
5.你想要View基础测试?[Yes / No]
6.你的类名前缀是什么?(我这里填的是 LXH)

pod组件空模板创建成功后,会自动打开工程.

3.2删除ReplaceMe文件,同时将你封装好的文件,放到class文件夹里面

截屏2021-03-22 下午3.00.35.png

3.2.1 切换到Example下进行pod install (把刚才拖入到class里的文件夹pod进来)

截屏2021-03-22 下午4.23.43.png

3.3 编辑.podspec 文件

如图所示:


截屏2021-03-22 下午3.03.39.png

对应字段说明:

name:框架名
version:当前版本(注意,是当前版本,假如你后续更新了新版本,需要修改此处)
summary:简要描述,在pod search ZCPKit的时候会显示该信息。
description:详细描述
homepage:页面链接
license:开源协议
author:作者
source:源码git地址
platform:支持最低ios版本
source_files:源文件(可以包含.h和.m)
public_header_files:头文件(.h文件)
resources:资源文件(配置的文件都会被放到mainBundle中)
resource_bundles:资源文件(配置的文件会放到你自己指定的bundle中)
frameworks:依赖的系统框架
vendored_frameworks:依赖的非系统框架
libraries:依赖的系统库
vendored_libraries:依赖的非系统的静态库
dependency:依赖的三方库

主要修改一下版本号,核对一下路径是否正确,然后保存!

3.4 校验本地索引文件

cd 到 MyLib.podspec 所在的文件夹,执行以下命令

pod lib lint --allow-warnings

如果成功会出现 passed validation 如下界面:


截屏2021-03-22 下午3.14.01.png

pod lib lint 命令表示在本地校验索引文件

pod spec lint 表示在本地和远程都校验索引文件

pod lib lint参数解析:
--sources:需要引⽤的spec,默认只依赖master,如果当前pod依赖了私有库,需要将其对应的spec包含进来,不然会报找不到对应库的问题。参数可以是本地spec的名称,也可以是git地址。
--allow-warnings:允许警告检测通过。
--verbose:打印详细的检验过程
--use-libraries:⼯程或者依赖⾥⾯了静态库(*.a⽂件)或者是framework

3.5 把本地组件代码推到远端,并打个标签

git add .
git commit -m '第一次提交'
git remote add origin 组件代码库地址
git push origin master
//注意tag和podspec文件里的s.version一样
git tag "0.1.0"
git push —-tags

推送成功后,到组件库git上查看,代码是否已经上传


截屏2021-03-22 下午3.26.39.png

3.6 接下来可以验证podspec索引文件是否正确

首先,通过

pod lib lint FFCategoryKit.podspec --verbose --allow-warnings

验证本地索引文件是否正确
也可以略过本地验证
直接通过

pod spec lint --verbose --allow-warnings 

命令验证podspec索引文件(既验证本地同时验证远程的podspec)

如果检验通过 同样会出现 passed validation

3.7 将MyLib.podspec索引文件到我们最早创建的私有远程索引库 LXHSpec.podspec 命令如下:

执行命令前,要cd 到当前组件库的文件下
格式:pod repo push <本地索引库> <索引文件名> - -verbose - -allow-warnings

pod repo push LXHSpec MyLib.podspec --verbose --allow-warnings

四、验证

4.1 查看本地索引仓库是否引入成功

截屏2021-03-22 下午5.03.33.png

4.2 新建项目,Podfile 引入刚才封装好的库

截屏2021-03-22 下午5.11.54.png

4.3 pod install 查看是否安装成功

截屏2021-03-22 下午5.08.29.png

五、创建子库Subspec

设置子库的作用

在开发中,有时候我们仅仅需要用到一个库里面的部分功能,而其他的一些功能我们不需要使用,那么我们就应该设置子库来实现选择性引入

子库格式

s.subspec '子库名称' do |别名|
  别名.source_files = '本地索引库名称/class/文件夹名称/*.{h,m}'  
end

设置子库

  • 1.我们在刚才创建好的本地私有库,class 文件里面添加一个新的文件夹testView,包含一些封装好的功能


    截屏2021-03-23 上午8.54.32.png
  • 2.修改MyLib.podspec文件
    注意点:
    1、修改版本号
    2、设置子库语法
    修改如下图所示:

    截屏2021-03-23 上午9.10.34.png

  • 3.安装一下子库,cd到Example文件路径

      pod install
    
  • 4.检验本地文件是否符合推送规则

      pod lib lint --allow-warnings
    
  • 5.提交代码并打tag

    git add .
    git commit -m '第二次提交'
    git push origin master
    //注意tag和podspec文件里的s.version一样
    git tag "1.0.2"
    git push —-tags
    1. pod repo push <本地远程索引库名称> <本地索引文件名> - -verbose - -allow-warnings
      例如:

      pod repo push LXHSpec MyLib.podspec --verbose --allow-warnings
      
  • 7.修改工程中的Podfile文件

截屏2021-04-01 上午9.52.06.png
  • 8.cd到工程Podfile文件所在位置,执行pod install


    截屏2021-04-01 上午9.54.00.png
  • 9.最后工程目录结构,仅仅引入了Category这个目录:

    截屏2021-04-01 上午9.55.43.png

至此,子库的配置完成、

你可能感兴趣的:(Cocoapods模块化开发组件化管理)