Cocoapods模块化开发组件化管理

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

代码模块化的目的：

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

制作步骤：

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

一、安装cocoapods

不做过多的介绍

二、github创建代码仓库

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

image.png

image.png

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

使用命令：

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

可以使用 pod repo 命令 查看是否copy成功

HJSpec
- Type: git (main)
- URL:  https://github.com/948769029/HJSpec.git
- Path: /Users/admin/.cocoapods/repos/HJSpec

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

至此，私有远程索引仓库HJSpec生产完成

三、 制作本地库（创建和配置podspec文件）

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

image.png

3.1创建私有的pod组件库

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

pod lib create HJSwiftExtension

image.png

问题的意思就是这样：

1.你想要使用哪个平台？[iOS / macOs]
2.你想要使用哪种语言？[Swift / ObjC]
3.你的库中是否包含一个示例程序？[Yes / No]
4.你想要使用哪个测试框架？[Specta/ Kiwi / None]
5.你想要View基础测试？[Yes / No]

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

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

image.png

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

image.png

3.3 编辑.podspec 文件

image.png

对应字段说明：

name：框架名
version：当前版本（注意，是当前版本，假如你后续更新了新版本，需要修改此处）
summary：简要描述，在pod search HJSwiftExtension的时候会显示该信息。
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：依赖的三方库

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

source来源 一定要填写正确 可以打开

3.4 校验本地索引文件

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

pod lib lint --allow-warnings

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

注意：如果提交报错

image.png

请打开这个链接https://blog.csdn.net/weixin_41010198/article/details/119698015

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

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

首先，通过

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

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

pod spec lint --verbose --allow-warnings 

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

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

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

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

pod repo push HJSpec HJSwiftExtension.podspec --verbose --allow-warnings

四、验证

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

image.png

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

image.png

4.3 pod install 查看是否安装成功

image.png

五、创建子库Subspec

设置子库的作用

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

子库格式

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

设置子库

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

     
     
     image.png

• 2. 修改HJSwiftExtension.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

• 6. pod repo push <本地远程索引库名称> <本地索引文件名> - -verbose - -allow-warnings
     例如：

pod repo push HJSpec HJSwiftExtension.podspec --verbose --allow-warnings

• 7. 修改工程中的Podfile文件

image.png

• 8. cd到工程Podfile文件所在位置，执行pod install
• 9. 最后工程目录结构，仅仅引入了Category这个目录：

image.png

至此，子库的配置完成、