Cocoapods是非常好用的一个iOS依赖管理工具，使用它可以方便的管理和更新项目中所使用到的第三方库，以及将自己的项目中的公共组件交由它去管理。Cocoapods的介绍及优点本文就不在赘述，我开始使用Cocoapods还是在6年前，那个时候它刚刚出现，网上的资料还非常的少，就连他们自己的HomePage都十分的简单，我就着手尝试着使用了一下，用它管理起第三方库确实是十分的方便顺手。后来它有了更强大的功能就是自己创建podspec，更可以设置私有的库。
这里学习一下创建私有的podspec并在项目中部署使用，以及pods的subspec的创建及使用。
整体先说明一下创建一个私有的podspec包括如下那么几个步骤：
- 创建并设置一个私有的Spec Repo。
- 创建Pod的所需要的项目工程文件，并且有可访问的项目版本控制地址。
- 创建Pod所对应的podspec文件。
- 本地测试配置好的podspec文件是否可用。
- 向私有的Spec Repo中提交podspec。
- 在个人项目中的Podfile中增加刚刚制作的好的Pod并使用。
- 更新维护podspec。
在这一系列的步骤中需要创建两个Git仓库，分别是第一步和第二步（第二步不一定非要是Git仓库，只要是可以获取到相关代码文件就可以，也可以是SVN的，也可以说zip包，区别就是在podspec中的source项填写的内容不同），并且第一步只是在初次创建私有podspec时才需要，之后在创建其他的只需要从第二步开始就可以。本文只介绍在Git环境下的操作，其他环境其他方式暂不说明。
创建私有Spec Repo
先来说第一步，什么是Spec Repo？它是所有的Pods的一个索引，就是一个容器，所有公开的Pods都在这个里面，它实际是一个Git仓库remote端在GitHub上，但是当你使用了Cocoapods后它会被clone到本地的~/.cocoapods/repos目录下，可以进入到这个目录看到master文件夹就是这个官方的Spec Repo了。这个master目录的结构是这个样子的
.
├── Specs
└── [SPEC_NAME]
└── [VERSION]
└── [SPEC_NAME].podspec
因此我们需要创建一个类似于master的私有Spec Repo，这里我们可以fork官方的Repo，也可以自己创建，个人建议不fork，因为你只是想添加自己的Pods，没有必要把现有的公开Pods都copy一份。所以创建一个 Git仓库，这个仓库你可以创建私有的也可以创建公开的，不过既然私有的Spec Repo，还是创建私有的仓库吧，需要注意的就是如果项目中有其他同事共同开发的话，你还要给他这个Git仓库的权限。因为GitHub的私有仓库是收费的，我还不是GitHub的付费用户，所以我使用了其他Git服务，我使用的是CODING，当然还有其他的可供选择开源中国、Bitbucket以及CSDN Code.
创建完成之后在Terminal中执行如下命令
# pod repo add [Private Repo Name] [GitHub HTTPS clone URL]
$ pod repo add WTSpecs https://coding.net/wtlucky/WTSpecs.git
此时如果成功的话进入到~/.cocoapods/repos目录下就可以看到WTSpecs这个目录了。至此第一步创建私有Spec Repo完成。
PS：如果有其他合作人员共同使用这个私有Spec Repo的话在他有对应Git仓库的权限的前提下执行相同的命令添加这个Spec Repo即可。
创建Pod项目工程文件
这个第二步没有什么好介绍的，如果是有现有的组件项目，并且在Git的版本管理下，那么这一步就算完成了，可以直接进行下一步了。
如果你的组件还在你冗余庞大的项目中，需要拆分出来或者需要自己从零开始创建一个组件库，那么我建议你使用Cocoapods提供的一个工具将第二步与第三步结合起来做。
现在来说一下这个工具，相关的文档介绍是Using Pod Lib Create 就拿我创建的podTestLibrary为例子具体讲一下这里是如何操作的，先cd到要创建项目的目录然后执行
$ pod lib create podTestLibrary
之后他会问你四个问题，1.是否需要一个例子工程；2.选择一个测试框架；3.是否基于View测试；4.类的前缀；4个问题的具体介绍可以去看官方文档，我这里选择的是1.yes；2.Specta/Expecta；3.yes；4.PTL。 问完这4个问题他会自动执行pod install命令创建项目并生成依赖。
$ tree PodTestLibrary -L 2
PodTestLibrary
├── Example #demo APP
│ ├── PodTestLibrary
│ ├── PodTestLibrary.xcodeproj
│ ├── PodTestLibrary.xcworkspace
│ ├── Podfile #demo APP 的依赖描述文件
│ ├── Podfile.lock
│ ├── Pods #demo APP 的依赖文件
│ └── Tests
├── LICENSE #开源协议 默认MIT
├── Pod #组件的目录
│ ├── Assets #资源文件
│ └── Classes #类文件
├── PodTestLibrary.podspec #第三步要创建的podspec文件
└── README.md #markdown格式的README
9 directories, 5 files
以上是项目生成的目录结构及相关介绍。
接下来就是向Pod文件夹中添加库文件和资源，并配置podspec文件，我把一个网络模块的共有组件放入Pod/Classes中，然后进入Example文件夹执行pod update命令，再打开项目工程可以看到，刚刚添加的组件已经在Pods子工程下Development Pods/PodTestLibrary中了，然后编辑demo工程，测试组件，我并没有使用提供的测试框架进行测试，这里就先不介绍了。
注：这里需要注意的是每当你向Pod中添加了新的文件或者以后更新了podspec的版本都需要重新执行一遍pod update命令。
测试无误后需要将该项目添加并推送到远端仓库，并编辑podspec文件。
通过Cocoapods创建出来的目录本身就在本地的Git管理下，我们需要做的就是给它添加远端仓库，同样去GitHub或其他的Git服务提供商那里创建一个私有的仓库，拿到SSH地址，然后cd到PodTestLibrary目录
$ git add .
$ git commit -s -m "Initial Commit of Library"
$ git remote add origin [email protected]:wtlucky/podTestLibrary.git #添加远端仓库
$ git push origin master #提交到远端仓库
注意：如果git push origin master失败，那么我们可以先排查下当前库的分支有哪些：
$ git branch -limage.png由上图可见，本地只有main分支。到github仓库查看，远程主机也只有main分支。
我们这里将git push origin master命令改为 git push origin main即可$ git push origin main #提交到远端仓库
做完这些就可以开始编辑podspec文件了，它是一个Ruby的文件，把编辑器的格式改成Ruby就能看到语法高亮，下面我贴上我的podspec文件，并在后面以注释的形式说明每个字段的含义，没有涉及到的字段可以去官方文档查阅
# # 井号可以在 podspec 文件中添加注释说明
# s 代表一级目录文件相关属性
# ss 代表二级（子级）文件目录相关属性
Pod::Spec.new do |s|
# 开源库文件名称
s.name = 'LXKBaseKit'
# 库文件当前版本号，必须保证此处版本号和 GitHub（也可能不是码云之类的代码托管平台）中的 tag 版本号保持一致，否则无法提交成功
s.version = '1.0.0'
# 遵循的开源协议
s.license = { :type => 'MIT', :file => 'LICENSE' }
# 开源库的简要介绍，会在通过 pod search 指令搜索时显示出来的
s.summary = 'A Library for iOS to get result fasterly with some methods.'
# 开源库的主页地址,如果是私有库就填私有库的主页地址
s.homepage = 'https://github.com/lxkboy/LXKBaseKit'
# 开源库作者信息
s.authors = { 'luoxiankang' => '[email protected]' }
# 项目地址（此处建议使用 :tag => s.version）,如果是私有库就填私有库的地址
s.source = { :git => 'https://github.com/lxkboy/LXKBaseKit', :tag => s.version }
# 支持的版本号
s.platform = :ios, '10.0'
# pod 支持的开源库语言最低版本号
s.ios.deployment_target = '10.0'
# 是否支持 ARC
s.requires_arc = false
# 开放共用头文件地址
s.public_header_files = 'LXKBaseKitDemo/LXKBaseKit/LXKBaseKitHeader.h'
# 头文件地址
s.source_files = 'LXKBaseKitDemo/LXKBaseKit/LXKBaseKitHeader.h'
# 资源包地址（建议使用 bundle 资源包形式）
s.resource = 'LXKBaseKitDemo/LXKBaseKit/LXKBaseKitResource/LXKBaseKit.bundle'
# 遵循的公共头文件
s.prefix_header_contents = '#import ', '#import '
# 一级子目录结构
s.subspec 'LXKBaseKitOthers' do |ss|
ss.source_files = 'LXKBaseKitDemo/LXKBaseKit/LXKBaseKit Others/**/*.{h,m}'
end
s.subspec 'LXKBaseKitDefine' do |ss|
ss.source_files = 'LXKBaseKitDemo/LXKBaseKit/LXKBaseKitDefine/**/*.{h,m}'
ss.public_header_files = 'LXKBaseKitDemo/LXKBaseKit/LXKBaseKitDefine/**/*.{h}'
end
s.subspec 'LXKBaseKitObject' do |ss|
ss.source_files = 'LXKBaseKitDemo/LXKBaseKit/LXKBaseKitObject/**/*.{h,m}'
ss.public_header_files = 'LXKBaseKitDemo/LXKBaseKit/LXKBaseKitObject/**/*.{h}'
# pod成功的库，每个子文件夹都是对应一个子库，子库的目的是为了防止一个 kit 太大，把功能模块都分出来减少包体积；所以子库原则上是不进行相互依赖的；如果库中有必须依赖的话，可以通过该方式进行依赖；其中依赖的对应为 pod 成功后显示的库路径，非真实路径
ss.dependency 'LXKBaseKit/LXKBaseKitDefine'
end
s.subspec 'LXKBaseKitCategory' do |ss|
ss.source_files = 'LXKBaseKitDemo/LXKBaseKit/LXKBaseKitCategory/**/*.{h,m}'
ss.public_header_files = 'LXKBaseKitDemo/LXKBaseKit/LXKBaseKitCategory/**/*.{h}'
ss.dependency 'LXKBaseKit/LXKBaseKitDefine'
ss.dependency 'LXKBaseKit/LXKBaseKitObject'
end
# 二级（子级）目录结构（注：ss 可以换成任意非 s 的名称，即子级目录代称）
s.subspec 'LXKBaseKitView' do |ss|
# 子级目录下所有文件（* 代表通配符）
ss.source_files = 'LXKBaseKitDemo/LXKBaseKit/LXKBaseKitView/**/*.{h,m}'
ss.public_header_files = 'LXKBaseKitDemo/LXKBaseKit/LXKBaseKitView/**/*.{h}'
# 子级目录下文件需要的依赖文件（如果需要依赖多个，官方写法是分别写出，且子级目录依赖只能单方向依赖，不能相互依赖）
ss.dependency 'LXKBaseKit/LXKBaseKitDefine'
ss.dependency 'LXKBaseKit/LXKBaseKitObject'
ss.dependency 'LXKBaseKit/LXKBaseKitCategory'
end
# 依赖第三方库文件
s.dependency 'MBProgressHUD', '1.1.0'
# 依赖系统静态库文件
s.framework = 'UIKit', 'Foundation', 'QuartzCore', 'CoreText', 'CoreGraphics'
end
1、当项目工程代码完成后，需要先将代码提交到远程端，并打上 tag 标签
$ git commit -m "提交文件日志" # 提交所有更新过的文件
$ git tag # 查询当前已存在的 tag 标签
$ git tag 1.0.0 # 添加 tag 本地标签（必须）
$ git push --tags # 提交所有 tag 标签到远程端（必须）
#$ git tag -d 1.0.0 # 删除 tag 本地标签
#$ git push origin :refs/tags/1.0.0 # 删除远程端指定 tag 标签
2、验证 podpsec 文件的合法性
提交tag后，需要验证一下这个文件是否可用，如果有任何WARNING或者ERROR都是不可以的，它就不能被添加到Spec Repo中，不过xcode的WARNING是可以存在的，验证需要执行一下命令
出现 passed validation 代表验证成功
一下是一些本地和远程单的验证方法，本地验证通过后再验证远程单即可：
## pod lib lint 从本地验证 pod 能否通过验证
## pod spec lint 从本地和远程端验证 pod 能否通过验证
## pod spec lint --verbose 详细编译验证 podspec 合法性
## --allow-warnings 带有警告需要的语法
## --use-libraries 依赖三方库需要的语法（比如：s.dependency 'MBProgressHUD', '1.1.0'）
## 从本地验证 pod 能否通过验证
pod lib lint LXKBaseKit.podspec
## 从本地验证依赖三方库的 pod 能否通过验证
pod lib lint LXKBaseKit.podspec --use-libraries
## 从本地验证带有警告的 pod 能否通过验证
pod lib lint LXKBaseKit.podspec --allow-warnings
## 从本地验证依赖三方库且有警告的 pod 能否通过验证
pod lib lint LXKBaseKit.podspec --use-libraries --allow-warnings
## 从本地和远程端验证 pod 能否通过验证
pod spec lint LXKBaseKit.podspec
## 从本地和远程端验证依赖三方库的 pod 能否通过验证
pod spec lint LXKBaseKit.podspec --use-libraries
## 从本地验和远程端证带有警告的 pod 能否通过验证
pod spec lint LXKBaseKit.podspec --allow-warnings
## 从本地和远程端验证依赖三方库且有警告的 pod 能否通过验证
pod spec lint LXKBaseKit.podspec --use-libraries --allow-warnings
## 详细编译验证 podspec 合法性
pod spec lint --verbose
a、开始先验证本地pod的合法性，如果有waring，可以带命令 --allow-warnings
$ pod lib lint
-> LXKBaseKit (0.1.0)
LXKBaseKit passed validation.
如果报错：- ERROR | [iOS] xcodebuild: Returned an unsuccessful exit code.
那么我们需要在.podspec文件中添加如下代码：s.pod_target_xcconfig = { 'VALID_ARCHS' => 'x86_64 armv7 arm64' }
b、验证远程端的合法性
pod spec lint LXKBaseKit.podspec --allow-warnings
LXKBaseKit.podspec passed validation.
证明远程验证通过
c、验证成功后，将库文件推送到服务器：
向Spec Repo提交podspec
向Spec Repo提交podspec需要完成两点一个是podspec必须通过验证无误，在一个就是删掉无用的注释（这个不是必须的，为了规范还是删掉吧）。 向我们的私有Spec Repo提交podspec只需要一个命令
$ pod repo push WTSpecs PodTestLibrary.podspec --allow-warnings #前面是本地Repo名字 后面是podspec名字
完成之后这个组件库就添加到我们的私有Spec Repo中了，可以进入到~/.cocoapods/repos/WTSpecs目录下查看
.
├── LICENSE
├── PodTestLibrary
│ └── 0.1.0
│ └── PodTestLibrary.podspec
└── README.md
再去看我们的Spec Repo远端仓库，也有了一次提交，这个podspec也已经被Push上去了。
至此，我们的这个组件库就已经制作添加完成了，使用pod search命令就可以查到我们自己的库了
$ pod search PodTestLibrary
-> PodTestLibrary (0.1.0)
Just Testing.
pod 'PodTestLibrary', '~> 0.1.0'
- Homepage: https://coding.net/u/wtlucky/p/podTestLibrary
- Source: https://coding.net/wtlucky/podTestLibrary.git
- Versions: 0.1.0 [WTSpecs repo]
这里说的是添加到私有的Repo，如果要添加到Cocoapods的官方库了，可以使用trunk工具，具体可以查看官方文档。
对于私有库的特别处理
对于私有库，在验证和推送到spec时可能会出现失败，这里需要特殊处理
在索引库验证 pod lib lint 时
正常的做法是执行pod spec lint --verbose --allow-warnings ，但是如果引用的依赖库既有github官网库，又有自己的服务器git库时，需要指定两个url地址
pod lib lint --sources='http://192.168.***.***/r/***frame/xx_repo.git,https://github.com/CocoaPods/Specs.git' --private --allow-warnings
在推送索引库到Spec Repo时
和上面的验证原则一样
pod repo push <本地索引库> <索引文件名> --sources='http://192.168.***.***/r/***frame/xx_repo.git,https://github.com/CocoaPods/Specs.git' --verbose --allow-warnings
使用制作好的Pod
在完成这一系列步骤之后，我们就可以在正式项目中使用这个私有的Pod了只需要在项目的Podfile里增加以下一行代码即可
$ pod 'PodTestLibrary', '~> 0.1.0'
然后执行pod update，更新库依赖，然后打卡项目可以看到，我们自己的库文件已经出现在Pods子项目中的Pods子目录下了，而不再是Development Pods。
更新维护podspec
最后再来说一下制作好的podspec文件后续的更新维护工作，比如如何添加新的版本，如何删除Pod。
我已经制作好了PodTestLibrary的0.1.0版本，现在我对他进行升级工作，这次我添加了更多的模块到PodTestLibrary之中，包括工具类，底层Model及UIKit扩展等，这里又尝试了一下subspec功能，给PodTestLibrary创建了多个子分支。
具体做法是先将源文件添加到Pod/Classes中，然后按照不同的模块对文件目录进行整理，因为我有四个模块，所以在Pod/Classes下有创建了四个子目录，完成之后继续编辑之前的PodTestLibrary.podspec，这次增加了subspec特性
Pod::Spec.new do |s|
s.name = "PodTestLibrary"
s.version = "1.0.0"
s.summary = "Just Testing."
s.description = <<-DESC
Testing Private Podspec.
* Markdown format.
* Don't worry about the indent, we strip it!
DESC
s.homepage = "https://coding.net/u/wtlucky/p/podTestLibrary"
# s.screenshots = "www.example.com/screenshots_1", "www.example.com/screenshots_2"
s.license = 'MIT'
s.author = { "wtlucky" => "[email protected]" }
s.source = { :git => "https://coding.net/wtlucky/podTestLibrary.git", :tag => "1.0.0" }
# s.social_media_url = 'https://twitter.com/'
s.platform = :ios, '7.0'
s.requires_arc = true
#s.source_files = 'Pod/Classes/**/*'
#s.resource_bundles = {
# 'PodTestLibrary' => ['Pod/Assets/*.png']
#}
#s.public_header_files = 'Pod/Classes/**/*.h'
s.subspec 'NetWorkEngine' do |networkEngine|
networkEngine.source_files = 'Pod/Classes/NetworkEngine/**/*'
networkEngine.public_header_files = 'Pod/Classes/NetworkEngine/**/*.h'
networkEngine.dependency 'AFNetworking', '~> 2.3'
end
s.subspec 'DataModel' do |dataModel|
dataModel.source_files = 'Pod/Classes/DataModel/**/*'
dataModel.public_header_files = 'Pod/Classes/DataModel/**/*.h'
end
s.subspec 'CommonTools' do |commonTools|
commonTools.source_files = 'Pod/Classes/CommonTools/**/*'
commonTools.public_header_files = 'Pod/Classes/CommonTools/**/*.h'
commonTools.dependency 'OpenUDID', '~> 1.0.0'
end
s.subspec 'UIKitAddition' do |ui|
ui.source_files = 'Pod/Classes/UIKitAddition/**/*'
ui.public_header_files = 'Pod/Classes/UIKitAddition/**/*.h'
ui.resource = "Pod/Assets/MLSUIKitResource.bundle"
ui.dependency 'PodTestLibrary/CommonTools'
end
s.frameworks = 'UIKit'
#s.dependency 'AFNetworking', '~> 2.3'
#s.dependency 'OpenUDID', '~> 1.0.0'
end
因为我们创建了subspec所以项目整体的依赖dependency，源文件source_files，头文件public_header_files，资源文件resource等都移动到了各自的subspec中，每个subspec之间也可以有相互的依赖关系，比如UIKitAddition就依赖于CommonTools。
编辑完成之后，在测试项目里pod update一下，几个子项目都被加进项目工程了，写代码验证无误之后，就可以将这个工程push到远端仓库，并打上新的tag->1.0.0。
最后再次使用pod lib lint验证编辑好的podsepc文件，没有自身的WARNING或者ERROR之后，就可以再次提交到Spec Repo中了，命令跟之前是一样的
$ pod repo push WTSpecs PodTestLibrary.podspec
之后再次到~/.cocoapods/repos/WTSpecs目录下查看
.
├── LICENSE
├── PodTestLibrary
│ ├── 0.1.0
│ │ └── PodTestLibrary.podspec
│ └── 1.0.0
│ └── PodTestLibrary.podspec
└── README.md
3 directories, 4 files
已经有两个版本了，使用pod search查找得到的结果为
$ pod search PodTestLibrary
-> PodTestLibrary (1.0.0)
Just Testing.
pod 'PodTestLibrary', '~> 1.0.0'
- Homepage: https://coding.net/u/wtlucky/p/podTestLibrary
- Source: https://coding.net/wtlucky/podTestLibrary.git
- Versions: 1.0.0, 0.1.0 [WTSpecs repo]
- Sub specs:
- PodTestLibrary/NetWorkEngine (1.0.0)
- PodTestLibrary/DataModel (1.0.0)
- PodTestLibrary/CommonTools (1.0.0)
- PodTestLibrary/UIKitAddition (1.0.0)
完成这些之后，在实际项目中我们就可以选择使用整个组件库或者是组件库的某一个部分了，对应的Podfile中添加的内容为
platform :ios, '7.0'
pod 'PodTestLibrary/NetWorkEngine', '1.0.0' #使用某一个部分
pod 'PodTestLibrary/UIKitAddition', '1.0.0'
pod 'PodTestLibrary', '1.0.0' #使用整个库
最后介绍一下如何删除一个私有Spec Repo，只需要执行一条命令即可
$ pod repo remove WTSpecs
这样这个Spec Repo就在本地删除了，我们还可以通过
$ pod repo add WTSpecs [email protected]:wtlucky/WTSpecs.git
再把它给加回来。
如果我们要删除私有Spec Repo下的某一个podspec怎么操作呢，此时无需借助Cocoapods，只需要cd到~/.cocoapods/repos/WTSpecs目录下，删掉库目录
wtlucky@wtluckydeMacBook-Pro:~/.cocoapods/repos/WTSpecs$ rm -Rf PodTestLibrary
然后在将Git的变动push到远端仓库即可
wtlucky@wtluckydeMacBook-Pro:~/.cocoapods/repos/WTSpecs$ git add --all .
wtlucky@wtluckydeMacBook-Pro:~/.cocoapods/repos/WTSpecs$ git ci -m "remove unuseful pods"
wtlucky@wtluckydeMacBook-Pro:~/.cocoapods/repos/WTSpecs$ git push origin master