利用CocoaPods集成的优势,管理代码块,组件,实现模块化开发。实现的效果是把封装起来的常用的功能或者组件,放到pod里面去管理,其他人也额可以用pod快速集成
代码模块化的目的:
- 易于管理代码
- 方便集成使用代码块进行快速开发,相比直接复制到多个项目,优势比较明显
- 更新pod里面的内容,那么其他使用到的地方可以实现同步更新
- 可以随意的组装代码块,实现不同的功能
制作步骤:
- 安装cocoapods
- github创建代码仓库
- 制作本地库(创建和配置podspec文件)
- 验证
- 创建字库Subspec
一、安装cocoapods
不做过多的介绍
二、github创建代码仓库
1.先创建一个远程的spec索引仓库
Repository name 为你要创建的代码块(仓库)的名称
Description(optional)描述这个代码块的功能,可选
2.将私有的远程索引仓库copy到本地
使用命令:
pod repo add LXHSpec(本地仓库名称) + 刚刚创建的远程索引库地址
命令执行完毕后,在对应目录下会产生一个文件夹
前往文件夹:/Users/lxh(用户名)/.cocoapods/repos/
也可以可使用 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 因为一会我们在上传模板的时候 有自动生成 下面的几个选项都不选
3.1创建私有的pod组件库
cd 到要存放的对应的文件夹路径 执行以下命令
pod lib create MyLib
执行后需要填写一些选项,按需选择即可。如下:
问题的意思就是这样:
1.你想要使用哪个平台?[iOS / macOs]
2.你想要使用哪种语言?[Swift / ObjC]
3.你的库中是否包含一个示例程序?[Yes / No]
4.你想要使用哪个测试框架?[Specta/ Kiwi / None]
5.你想要View基础测试?[Yes / No]
6.你的类名前缀是什么?(我这里填的是 LXH)
pod组件空模板创建成功后,会自动打开工程.
3.2删除ReplaceMe文件,同时将你封装好的文件,放到class文件夹里面
3.2.1 切换到Example下进行pod install (把刚才拖入到class里的文件夹pod进来)
3.3 编辑.podspec 文件
如图所示:
对应字段说明:
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 如下界面:
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上查看,代码是否已经上传
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 查看本地索引仓库是否引入成功
4.2 新建项目,Podfile 引入刚才封装好的库
4.3 pod install 查看是否安装成功
五、创建子库Subspec
设置子库的作用
在开发中,有时候我们仅仅需要用到一个库里面的部分功能,而其他的一些功能我们不需要使用,那么我们就应该设置子库来实现选择性引入
子库格式
s.subspec '子库名称' do |别名|
别名.source_files = '本地索引库名称/class/文件夹名称/*.{h,m}'
end
设置子库
-
1.我们在刚才创建好的本地私有库,class 文件里面添加一个新的文件夹testView,包含一些封装好的功能
-
2.修改MyLib.podspec文件
注意点:
1、修改版本号
2、设置子库语法
修改如下图所示:
-
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
-
-
pod repo push <本地远程索引库名称> <本地索引文件名> - -verbose - -allow-warnings
例如:pod repo push LXHSpec MyLib.podspec --verbose --allow-warnings
-
7.修改工程中的Podfile文件
-
8.cd到工程Podfile文件所在位置,执行pod install
-
9.最后工程目录结构,仅仅引入了Category这个目录:
至此,子库的配置完成、