前言

CocoaPods是iOS项目的依赖管理工具，使用它可以方便的管理和更新项目中所使用到的第三方库，我们一般用的是公有库，代码存放在Github上。个人或公司在开发过程中，会积累很多可以复用的代码包，有些我们不想开源，又想像开源库一样在CocoaPods中管理它们，那么通过私有库来管理就很必要。

原理

在创建私有库之前，我们有必要理解私有库的原理，

Podfile:工程的依赖描述文件。
Spec: 该仓库存放索引描述文件.podspec，CocoaPods通过该文件对你真正存储代码工程的 Git 仓库进行索引与下载,下面会有对podspec的详细介绍。通过spec库来控制pod私有库的版本。

Lib : 你上传到远程Git仓库的代码工程，将来用于开源共享或则私有

CocoaPods 根据podfile中的库的名称，通过spec索引库，来找到真正的代码库。这里有同学可能要问为什么需要两个仓库呢，我的理解是为了快速检索和版本控制。如果没有spec索引库，我们每次pod update的时候都需要在GitHub所有的代码库中检索。显然效率很低。

Pod私有库的创建步骤

1. 创建两个仓库：索引库和代码仓库。
2. 创建并设置本地私有Spec Repo。
3. 创建Pod所对应的podspec文件。
4. 本地测试配置好的podspec文件。
5. 向私有的Spec Repo中提交podspec。

创建两个仓库：索引库和代码仓库

在github上创建索引库 ZJMaricleSpec**和代码库ZJMaricle**

创建并设置本地私有Spec Repo

两个仓库创建完成后在Terminal中执行如下命令

 # pod repo add [Private Repo Name] [GitHub HTTPS clone URL]
$ pod repo add ZJMaricleSpec https://github.com/MaricleZhang/ZJMaricleSpec.git

需要特别注意的是这里的URL是Spec索引库的地址，如果写成代码库的地址就会出现

[!] An unexpected version directory Assets was encountered for the /Users/zhangjian/.cocoapods/repos/mariclezhang/YTVestSDK Pod in the YTVestSDK repository.

执行完成后

$ cd ~/.cocoapods/repos

如果存在ZJMaricleSpec则说明本地repo Spec 创建成功

创建Pod所对应的podspec文件

cd 到要创建项目的目录然后执行

$ pod lib create ZJMaricle

然后会问一些问题

What language do you want to use?? [ Swift / ObjC ]
 > Objc
//这里特别说明一下，最好带上demo方便我们以后的代码调试
Would you like to include a demo application with your library? [ Yes / No ]
 > Yes

Which testing frameworks will you use? [ Specta / Kiwi / None ]
 > None

Would you like to do view based testing? [ Yes / No ]
 > Yes

What is your class prefix?
 > ZJ

问完这4个问题他会自动执行pod install命令创建项目并生成依赖。
下面是生成的文件目录及介绍

$ tree ZJMaricle -L 2
ZJMaricle
├── Example                                            #demo 
│   ├── Podfile                                        #demo 的依赖描述文件
│   ├── Podfile.lock
│   ├── Pods                                           #demo 的依赖文件
│   ├── Tests                                           
│   ├── ZJMaricle
│   ├── ZJMaricle.xcodeproj
│   └── ZJMaricle.xcworkspace
├── LICENSE
├── README.md
├── ZJMaricle
│   ├── Assets                                         #资源文件
│   └── Classes                                        #类文件
├── ZJMaricle.podspec                                  #podspec pod库的描述文件
└── _Pods.xcodeproj -> Example/Pods/Pods.xcodeproj

10 directories, 5 files

接下来把库文件添加到ZJMaricle/Classes文件夹下，终端进入ZJMaricle/Example下，执行pod update命令,完成后打开项目工程可以看到，刚刚添加的组件已经在Pods子工程下Development Pods/ZJMaricle中了。这里需要注意的是：每次向Pods 中添加文件或者podspec中的版本升级都要执行pod update命令。

配置podspec文件

#
# Be sure to run `pod lib lint ZJMaricle.podspec' to ensure this is a
# valid spec before submitting.
#
# Any lines starting with a # are optional, but their use is encouraged
# To learn more about a Podspec see http://guides.cocoapods.org/syntax/podspec.html
#

Pod::Spec.new do |s|
  s.name             = 'ZJMaricle'                              #名称
  s.version          = '0.1.0'                                  #版本号
  s.summary          = 'description of ZJMaricle.'              #库的描述

# This description is used to generate tags and improve search results.
#   * Think: What does it do? Why did you write it? What is the focus?
#   * Try to keep it short, snappy and to the point.
#   * Write the description between the DESC delimiters below.
#   * Finally, don't worry about the indent, CocoaPods strips it!

  s.description      = <<-DESC
TODO: Add long description of the pod here.
                       DESC

  s.homepage         = 'https://github.com/MaricleZhang/ZJMaricle.git' #主页,这里要填写可以访问到的地址，不然验证不通过
  # s.screenshots     = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { '929006968@qq.com' => 'jian.zhang@yuntu-inc.com' }
  s.source           = { :git => 'https://github.com/MaricleZhang/ZJMaricle.git', :tag => s.version.to_s }  #项目地址，这里不支持ssh的地址，验证不通过，只支持HTTP和HTTPS，最好使用HTTPS
  # s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'

  s.ios.deployment_target = '8.0'

  s.source_files = 'ZJMaricle/Classes/**/*'                        #库文件
  
  # s.resource_bundles = {                                         #库资源文件
  #   'ZJMaricle' => ['ZJMaricle/Assets/*.png']
  # }

  # s.public_header_files = 'Pod/Classes/**/*.h'
  # s.frameworks = 'UIKit', 'MapKit'
  # s.dependency 'AFNetworking', '~> 2.3'
end

本地测试配置好的podspec文件。

编辑.podspec完成后本地校验是否合格，这里有必要解释一下pod lib lint校验本地.podspec文件和pod库中的文件的合法性，如果不合法，则需要修改再校验，直到校验通过。如果有警告则需要使用pod lib lint --allow-warnings命令通过校验。

$ pod lib lint

当出现下面情况时说明本地校验成功

 -> ZJMaricle (0.1.0)

ZJMaricle passed validation.

提交代码，我这里使用的sourcetree,本地代码库与远程库建立连接，这里就不在赘述了。并且给远程仓库打上tag，需要注意的是这里的tag就是创建私有库的版本号，需与 .podspec文件中的版本号保持一致。重要的事情说三遍：本地校验成功后在打tag，本地校验成功后在打tag，本地校验成功后在打tag。

向私有的Spec Repo中提交podspec

确认本地校验成功，并且打上tag后，终端进入到ZJMaricle.podspec同一目录下执行

$ pod repo push ZJMaricleSpec ZJMaricle.podspec  #前面是本地Repo名字 后面是podspec名字

出现

$ pod repo push ZJMaricleSpec ZJMaricle.podspec

Validating spec
 -> ZJMaricle (0.1.0)

Updating the `ZJMaricleSpec' repo

Your configuration specifies to merge with the ref 'refs/heads/master'
from the remote, but no such ref was fetched.

Adding the spec to the `ZJMaricleSpec' repo

 - [Add] ZJMaricle (0.1.0)

Pushing the `ZJMaricleSpec' repo

到索引库Spec Repo远端仓库，会发现有了一次提交，说明podspec已经push上去了，并且索引库已经与代码库建立了有效连接。再到本地的Sepc repo中

$ cd ~/.cocoapods/repos/ZJMaricleSpec

会发现目录结构变成

ZJMaricle
└── 0.1.0
    └── ZJMaricle.podspec

到这里pod私有库的创建已经完成，怎么样检验我的pod私有库有没有建立成功呢。执行pod search ZJMaricle出现说明创建成功。

-> ZJMaricle (0.1.0)
   description of ZJMaricle.
   pod 'ZJMaricle', '~> 0.1.0'
   - Homepage: https://github.com/MaricleZhang/ZJMaricle.git
   - Source:   https://github.com/MaricleZhang/ZJMaricle.git
   - Versions: 0.1.0 [ZJMaricleSpec repo]
(END)

这里讨论的是pod私有库，如果建立共有库的话，请使用 trunk工具,详细请参考官方文档。

Pod 私有库的使用

1. 私有库的引用

当我们在Example下执行pod install 的时候会出现[!] Unable to find a specification for ZJMaricle ,Cocoapods并不能找到对应的私有库。这是因为默认情况下会在公有库https://github.com/CocoaPods/Specs.git 中查询，我们的私有库并不在这里，所以当然查询不到。下面是解决的办法，在podfile的顶部添加

source 'https://github.com/CocoaPods/Specs.git'  #官方仓库的地址
source 'https://github.com/MaricleZhang/ZJMaricleSpec.git'  #我们自己的私有spec仓库的地址

这里添加的一定为Spec库的地址，如果写成代码库则会出现

[!] An unexpected version directory Assets was encountered for the /Users/.cocoapods/repos/mariclezhang/ZJMaricleSpec Pod in the ZJMaricleSpec repository.

2.Pod库的校验

pod lib lint 和 pod spec lint 命令的区别

pod lib lint是只从本地验证你的pod能否通过验证
pod spec lint是从本地和远程验证你的pod能否通过验证
在提交代码之前打tag之前，使用pod lib lint 验证一般不会出现问题，如果出现问题需要验证远程的代码则使用pod spec lint来验证。
本地校验pod lib lint如果出现

[!] ZJMaricle did not pass validation, due to 1 warning (but you can use `--allow-warnings` to ignore it).

在代码中警告无法清除时，在提提交代码时使用

pod repo push ZJMaricle ZJMaricleSpec.podspec --allow-warnings

参考文档：
使用Cocoapods创建私有podspec
Cocoapods使用私有库中遇到的坑
Cocoapods 应用第二部分-私有库相关