CocoaPods 组件化实践 - 私有Pod

CocoaPods 组件化实践

项目在开发到一定阶段后工程会变得异常庞大，模块间的依赖错综复杂，维护成本非常大，并且模块间紧耦合不利于代码复用。

基于上述背景，公司对现有项目进行组件化重构。首先对现有模块进行拆分，分为两部分业务模块和基础模块。其次是搭建私有 Spec 仓库，拆分的模块作为私有 Pod 上传至私有 Spec 仓库。

本文将重点介绍如何使用 CocoaPods 进行组件化开发，通过搭建私有 Spec 仓库、提交私有 Pod 和更新私有 Pod 让读者对组件化开发有一个更深入的理解和认识。

总体步骤

1. 创建私有 Spec 仓库来管理私有 podspec 文件；
2. 创建私有 Pod 工程文件，并提交远程 git 托管平台；
3. 创建私有 Pod 对应的 podspec 文件；
4. 验证 podspec 文件有效性；
5. 提交 podspec 至私有 Spec 仓库；
6. 新建项目测试私有 Pod；
7. 更新私有 Pod 的版本；

创建私有 Spec 仓库

私有 Spec 仓库和 CocoaPods 官方结构一致，用于存放各个开源库的 spec 文件。安装 CocoaPods 是会将官方库 clone 至本地，当执行 pod update 时更新此本地仓库。

私有 Spec 仓库需要在 git 托管平台托管，现有的免费私有仓库有 Coding、CSDN 以及自己搭建 Gitlab，本文选用 Coding 托管平台演示如何进行组件化开发。

在 Coding 上新建项目 CCSpesc，访问地址：https://git.coding.net/renguochao/CCSpecs.git。

在终端中执行：pod repo add CCSpec https://git.coding.net/renguochao/CCSpecs.git

执行完毕后，cocoapods 会把 CCSpec clone 在 ~/.cocoapods/repos 目录。

Paste_Image.png

创建私有 Pod 工程文件

在 Coding 上新建项目用于存放私有 Pod 工程源码，本地创建工程文件，添加至 git 管理并 push 到远端仓库。

组件化开发时，我们希望某些基础模块的内容是稳定的，不会经常变更。基础模块开发稳定后需要打 tag，保证主工程的开发过程中不会因为子工程的变更而变化。

这里我们在工程上打 tag 并 push 到远程仓库。

Paste_Image.png

创建私有 Pod 的 podspec

在工程的根目录下执行：pod spec create RRCache，这里 RRCache 是你工程名，创建成功后会在根目录下创建 RRCache.podspec 文件。

Paste_Image.png

根据实际情况配置 podsec 文件：

Paste_Image.png

验证 podspec 文件有效性

1. 执行 pod lib lint

Paste_Image.png

2. 执行 pod spec lint

Paste_Image.png

都验证通过后，podspec 文件配置成功。

提交 podspec 至私有 Spec 仓库

在 podspec 文件目录执行：pod repo push CCSpecs RRCache.podspec，执行完毕后会在 CCSpecs 仓库中创建 RRCache 目录。

Paste_Image.png

新建项目测试

新建 Xcode 工程，在工程根目录执行：pod init 生成 Podfile。使用 pod search RRCache，得到如下结果：

Paste_Image.png

在 Podfile 文件开头中添加：

source 'https://git.coding.net/renguochao/CCSpecs.git'
source 'https://github.com/CocoaPods/Specs.git'

注：如果不添加官方库地址，若私有库的类库的子依赖，依赖了公有库某个类库，会导致pod install失败

在 Target 下添加依赖：pod 'RRCache', '~>0.0.2。

Paste_Image.png

执行 pod install 完成安装。

更新 Pod

如果在开发过程中发现某基础组件存在 bug 需要更新 Pod，具体操作步骤如下：

1. 修改 podspec 文件中的 s.version;
2. 修复 bug 并对项目打 tag，tag 名称和 s.version 一直并 push 到远程仓库。
3. 验证 podspec 文件的有效性；
4. 推送 podspec 文件到远程仓库；
5. 执行 pod search RRCache 验证结果；

pod 操作命令

1. 显示本地repo列表

pod repo list

2. 删除本地 repo

pod repo remove 

3. 更新某个 repo

pod repo update 

Reference:

1. Private Pods
2. The Podfile
3. 利用Pod进行组件化开发
4. 私有库管理和模块化管理
5. 基于 CocoaPods 和 Git 的 iOS 工程组件化实践