通過CocoaPods創(chuàng)建開源庫、私有庫鸭限，最關鍵的是*.podspec的編寫。
如果電腦上還未安裝CocoaPods两踏，可以參考：新版CocoaPods的安裝败京。

創(chuàng)建項目和.podspec文件

如果你已經(jīng)有了項目代碼，可以使用pod命令創(chuàng)建.podspec：

# 項目路徑下
pod spec create 'KMPinHeaderLayout'

如果還沒有項目缆瓣，可以使用：

pod lib create 'KMPinHeaderLayout'

根據(jù)命令行的提示和引導喧枷，會為你創(chuàng)建一個模板工程和.podspec文件虹统、README.md文件弓坞、MIT LICENSE文件等隧甚。

編輯.podspec文件

文件內(nèi)容可以根據(jù)模板和注釋來修改和填寫，對其中一些內(nèi)容進行記錄說明：

1. s.source_files 指明哪些源文件會被包含進去渡冻，比如s.source_files = "KMPinHeaderLayout/Classes/**/*.{h,m}"戚扳，多條之間用逗號,分隔，用**表示匹配所有子目錄族吻，用*表示匹配所有文件帽借，.{h,m}表示匹配其中的.h和.m文件。其中的路徑是以.podspec所在目錄為根目錄超歌。
   
   
2. s.exclude_files 規(guī)則同上砍艾，指定不被包含的文件、目錄巍举。
   
   
3. s.license脆荷，一般寫法有s.license = 'MIT' 或 s.license = { :type => 'MIT', :file => 'LICENSE' }， LICENSE對應.podspec所在目錄下的名為LICENSE文件懊悯。
   
   
4. 指定可用平臺和版本蜓谋，s.platform = :ios, "7.0"，s.ios.deployment_target = '7.0'炭分。如果支持多個平臺應該使用后者桃焕，并指定其他平臺的版本如s.osx.deployment_target = "10.7"。
   
   
5. s.public_header_files捧毛，公開的頭文件观堂，如果指定，在pod lint驗證時岖妄，會以framework的形式驗證型将，一般可以不用這個配置。
   
   
6. s.framework(s)荐虐、s.libraries七兜，指定依賴的系統(tǒng)庫。兩者內(nèi)容都需要去除后綴福扬，其中s.libraries需要去除前綴lib腕铸，如靜態(tài)庫依賴是libz.tbd，則s.libraries = 'z'铛碑。
   
   
7. s.vendored_libraries 狠裹、s.vendored_frameworks如果開源庫中是一個靜態(tài)庫，使用這個指定靜態(tài)庫汽烦。如微博的podspec中s.vendored_libraries = 'libWeiboSDK/libWeiboSDK.a'
   
   
8. s.xcconfig 指定項目配置涛菠，如HEADER_SEARCH_PATHS 、OTHER_LDFLAGS等，e.g s.xcconfig = { "OTHER_LDFLAGS" => "-ObjC" }
   
   
9. s.resource(s) 指定包含的資源文件俗冻。
   
   
10. s.dependency 指定依賴礁叔，如s.dependency = 'AFNetworking'
    
    
11. s.source 指定源，s.source = { :git => 'https://github.com/sleepEarlier/PinHeaderLayout.git', :tag => s.version.to_s }
    更多信息可以查閱官方:http://guides.cocoapods.org/syntax/podspec.html

示例：

Pod::Spec.new do |s|
  s.name         = "KMPinHeaderLayout"
  s.version      = "0.1.0"
  s.summary      = "Float header for collectionview, support both vertical and horizon."
  s.description  = <<-DESC
  A custom UICollectionViewFlowLayout support float header just like UITablebiew section header does.
                   DESC
  s.homepage     = "https://github.com/sleepEarlier/PinHeaderLayout"
  s.license      = { :type => "MIT", :file => "LICENSE"}
  s.author       = { "sleepEarlier" => "xxx@qq.com" }
  s.platform     = :ios, "7.0"
  s.source       = { :git => "https://github.com/sleepEarlier/PinHeaderLayout.git", :tag => s.version }
  s.source_files  = "CollectionView/*Layout.{h,m}"
  s.ios.deployment_target = "7.0"
  s.framework  = "UIKit"
  s.requires_arc = true
end

驗證podspec

驗證命令：

pod lib lint KMPinHeaderLayout.podspec --verbose

--verbose會給出詳細的信息迄薄。
--allow-warnings允許警告琅关，默認有警告的podspec會驗證失敗。
--fail-fast 遇到錯誤馬上停止讥蔽，默認會完成全過程再停止涣易。
--use-libraries 如果項目中引用了.a、.framework冶伞，在驗證和提交時需要加新症。
--sources 如果此podspec 依賴了其他不包含在官方specs里的pod，則用它來指明源响禽，比如依賴了某個私有庫账劲。多個值以逗號分隔。

由于我們在podspec的source中指定了tag金抡，因此一般需要先打tag并push瀑焦，再來驗證:

# tag 0.1.0
git tag 0.1.1

# push tag
git push --tags

但是這樣有一個問題，如果驗證失敗了梗肝，這個tag相當于無效了榛瓮，我們需要刪除tag重打：

# 刪除本地tag 0.1.0
git tag -d 0.1.0

# 刪除遠端tag 0.1.0
git push origin --delete tag 0.1.0

當多次驗證失敗時上面的步驟就略顯繁瑣，因此巫击，我們可以先在.podspec中不指定tag：

s.source       = { :git => "https://github.com/sleepEarlier/PinHeaderLayout.git", }

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

等驗證通過后坝锰，我們再編輯podspec中的tag粹懒，并打tag然后push到遠端。
最好在push tag后再進行一次驗證顷级，以防萬一凫乖。由于已經(jīng)打了tag，所以這一次驗證不需要加--allow-warnings弓颈。

發(fā)布podspec

查看當前PC是否注冊：

pod trunk me

如已注冊帽芽，會顯示相關信息，否則進行注冊：

pod trunk register xxx@example.com "some description" --verbose

命令會向CocoaPods注冊一個賬號翔冀，如果切換電腦需要重新執(zhí)行命令注冊导街，注冊命令中的description可以用來區(qū)分不同的設備。

發(fā)布podspec

pod trunk push KMPinHeaderLayout.podspec

如果在驗證時纤子，使用了--allow-warnings搬瑰、--use-libraries款票，則在發(fā)布時也需要加上相同的選項。

搜索自己的pod

發(fā)布成功后泽论，會把podspec更新到官方的repo中徽职，也可以在CocoaPods官網(wǎng)搜索到自己的pod。
也可以執(zhí)行下面的命令來搜索：

pod search KMPinHeaderLayout

但是...有時候你發(fā)現(xiàn)佩厚，在官網(wǎng)搜到了，但是你在終端執(zhí)行pod search...時結(jié)果卻是：

pod search KMPinHeaderLayout
[!] Unable to find a pod with name, author, summary, or description matching `KMPinHeaderLayout`

由于pod search 是在本地的~/.cocoapods/repos/master/Specs中進行搜索的说订，上面的結(jié)果可能是由于
①. 本地的Specs不是最新的抄瓦，我們可以進行更新，然后重新搜索：

pod repo update --verbose

②. 還是搜不到陶冷？可能是因為搜索的緩存導致钙姊，刪除緩存重新搜索：

# delete cached index
rm ~/Library/Caches/CocoaPods/search_index.json

# search again
$ pod search KMPinHeaderLayout 

私有倉庫

創(chuàng)建私有倉庫與上面的步驟類似，區(qū)別是：

創(chuàng)建倉庫

需要先創(chuàng)建倉庫：

pod repo add 'repoName' 'repo URL'
# e.g
pod repo add 'KMPinHeaderLayout' 'http://internal.git.com/sleepEarlier/PinHeaderLayout.git'

編輯podspec

方法與上文中一樣埂伦。

驗證podspec

方法與上文中一樣煞额，如果依賴了其他私有庫，需要使用--sources指定source沾谜。
注意膊毁，依賴關系不能出現(xiàn)閉環(huán)，比如A依賴B基跑，B依賴C婚温，C依賴A。

pod lib lint PinHeaderLayoutpodspec --sources=https://github.com/CocoaPods/Specs.git,http://interal.git.com/sleepEarlier/Specs.git

發(fā)布podspec

pod repo push 'KMPinHeaderLayout' KMPinHeaderLayout.podspec

如果依賴了其他私有庫媳否，需要使用--sources指定source栅螟。

使用私有庫

可以直接在Podfile中使用

platform :ios, '10.3'

target 'PointerTest' do
  # Pods for PointerTest
  pod 'PinHeaderLayout', :git => 'http://internal.git.com/xxx/PinHeaderLayout.git'
end

必要時，可以在Podfile中列出source

source 'http://interal.git.com/sleepEarlier/Specs.git'

platform :ios, '10.3'

target 'PointerTest' do
  # Pods for PointerTest
  pod 'PinHeaderLayout', :git => 'http://internal.git.com/xxx/PinHeaderLayout.git'
end

很多時候篱竭，在開發(fā)過程中力图，我們希望在開發(fā)私有庫的過程中，修改代碼后不用一直打tag并執(zhí)行pod update掺逼，我們可以這樣寫Podfile:

# 本地路徑
pod 'PinHeaderLayout', :path => '~/Desktop/PinHeaderLayout'

這樣在普通的修改代碼時吃媒，不需要重新打tag并pod update，但是當工程結(jié)構(gòu)有變化(文件移動吕喘，增刪等)晓折、podspec修改，最好執(zhí)行一次pod update兽泄。

參考文章：

1. Cocoapods系列教程(一)——入門
2. Cocoapods系列教程(二)——開源主義接班人
3. Cocoapods系列教程(三)——私有庫管理和模塊化管理
4. 3分鐘讓你的框架支持cocoapods,podspec文件講解