第一次制作 CocoaPods 開源庫,簡單的記錄一下。
1、創(chuàng)建項目的Podspec描述文件
以 MBHUD 項目為例,把項目發(fā)布到github后,要打上tag。
項目根目錄下執(zhí)行
git tag -a 0.0.1 -m 'Version 0.0.1’
git push origin 0.0.1
之后我們在工程根目錄中初始化一個Podspec文件:
pod spec create MBHUD
該命令將在本目錄產(chǎn)生一個名為MBHUD.podspec文件。用編輯器打開該文件,里面已經(jīng)有非常豐富的說明文檔。下面介紹如何聲明第三方庫的代碼目錄和資源目錄,還有該第三方庫所依賴ios核心框架和第三方庫。這是我的podspec文件:
Pod::Spec.new do |s|
s.name = "MBHUD"
s.version = "0.0.3"
s.summary = "站在巨人的肩上,MBProgressHUD 簡單封裝"
s.description = <<-DESC
Let MBProgressHUD tu use simple
DESC
s.homepage = "https://github.com/qyfeng009/MBHUD"
s.license = { :type => "MIT", :file => "LICENSE" }
s.author = { "qyfeng" => "qyfeng009@163.com" }
s.ios.deployment_target = "8.0"
s.source = { :git => "https://github.com/qyfeng009/MBHUD.git", :tag => "#{s.version}"
s.source_files = "MBHUD/**/MBHUD.{h,m}"
s.resources = "MBHUD/MBHUD/MBHUD.bundle"
s.frameworks = "UIKit", "Foundation"
s.requires_arc = true
s.dependency 'MBProgressHUD', '~> 1.0.0'
end
接下來講解一下主要代碼的含義,其他的文檔中有詳解
s.name:名稱,pod search 搜索的關(guān)鍵詞,注意這里一定要和.podspec的名稱一樣,否則報錯
s.version:版本號
s.summary: 簡介
s.homepage:聲明庫的主頁
s.license:許可證
s.author:作者
s.ios.deployment_target:支持的pod最低版本
s.source:聲明原代碼的地址
s.source_files:聲明了我們庫的源代碼的位置,所以這個地方不能填錯了
s.resources: 資源文件
s.framework聲明了所依賴的核心庫,我這里只用到了UIKit
s.requires_arc: 是否支持ARC
s.dependency:依賴庫
s.license= { :type => "MIT", :file => "LICENSE" }
這里建議這樣寫。
需要在創(chuàng)建 LICENSE 文件

編輯完podspec文件后,需要驗證一下這個文件是否可用,如果有任何WARNING或者ERROR都是不可以的,它就不能被添加到Spec Repo中,不過xcode的WARNING是可以存在的,驗證需要執(zhí)行命令:
pod spec lint MBHUD.podspec 或者 pod lib lint MBHUD.podspec
這個過程會出現(xiàn)一些錯誤,這里不一一列舉,大家按照錯誤信息自行修改,不過一般不會出現(xiàn)錯誤,只要你按照樣子,基本上是沒有問題的
也會有這樣的

驗證時,也可能會出現(xiàn)警告如上,可以按照提示 執(zhí)行 pod lib lint --allow-warnings 就會通過,不過發(fā)布時也需要加上 --allow-warnings
當(dāng)看到HUPhotoBrowser passed validation.時,說明驗證通過了。

2、CocoaPods Trunk發(fā)布自己的Pods
注冊 Trunk
// 加上--verbose可以輸出詳細(xì)debug信息,方便出錯時查看。
pod trunk register qyfeng009@163.com "qyfeng" --verbose
大家在注冊時需要替換成自己的郵箱和用戶名,一切順利的話就會受到一份郵件,點(diǎn)擊郵件中的鏈接后驗證一下:
查看注冊信息
pod trunk me
Trunk push
pod trunk push 命令會首先驗證你本地的podspec文件(是否有錯誤),之后會上傳spec文件到trunk,最后會將你上傳的podspec文件轉(zhuǎn)換為需要的json文件。
如果你在手動驗證 Pod 時使用了 --use-libraries 或 --allow-warnings 等修飾符,那么發(fā)布的時候也應(yīng)該使用相同的字段修飾,否則出現(xiàn)相同的報錯。
在工程根目錄(包含有.podspec)下執(zhí)行命令:
--allow-warnings 忽略警告類的錯誤,
當(dāng)你的庫中用到了第三方的框架,上傳的時候得加上--use-libraries
我在上傳時執(zhí)行了下面命令
pod trunk push MBHUD.podspec --use-libraries --allow-warnings
當(dāng)出現(xiàn)如以下時即發(fā)布成功

此時,可以驗證以下
pod search MBHUD
如果搜不到,可以執(zhí)行更新
pod setup
出現(xiàn) 如 HEAD is now at 30e244742d3 [Add] MBHUD 0.0.3,對應(yīng)的tag就大公搞成了

哦了,大功搞成
3、總結(jié)下下參看文檔
如何發(fā)布自己的開源框架到CocoaPods http://www.cocoachina.com/ios/20160301/15459.html
[Cocoapods]項目添加Cocoapods支持遇到的坑 http://www.itdecent.cn/p/283584683b0b
3分鐘讓你的框架支持cocoapods,podspec文件講解 http://www.itdecent.cn/p/8a7b9232cbab
如何寫一個pod并發(fā)布到CocoaPods http://www.itdecent.cn/p/89605e02bf18
發(fā)布自己的開源框架到Cocoapods http://www.itdecent.cn/p/8e89b0fd7df8
cocoapods找不到第三方庫Unable to find a pod with name, author, summary, or descriptionmatching http://www.itdecent.cn/p/d2d81b58d716