第一次制作 CocoaPods 開源庫

第一次制作 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 文件
LICENSE.gif

編輯完podspec文件后,需要驗證一下這個文件是否可用,如果有任何WARNING或者ERROR都是不可以的,它就不能被添加到Spec Repo中,不過xcode的WARNING是可以存在的,驗證需要執(zhí)行命令:

pod spec lint MBHUD.podspec 或者  pod lib lint MBHUD.podspec
這個過程會出現(xiàn)一些錯誤,這里不一一列舉,大家按照錯誤信息自行修改,不過一般不會出現(xiàn)錯誤,只要你按照樣子,基本上是沒有問題的

也會有這樣的

WARNING.png
驗證時,也可能會出現(xiàn)警告如上,可以按照提示 執(zhí)行 pod lib lint --allow-warnings 就會通過,不過發(fā)布時也需要加上 --allow-warnings

當(dāng)看到HUPhotoBrowser passed validation.時,說明驗證通過了。


pass.png

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ā)布成功


success.png
此時,可以驗證以下
pod search MBHUD

如果搜不到,可以執(zhí)行更新

pod setup

出現(xiàn) 如  HEAD is now at 30e244742d3 [Add] MBHUD 0.0.3,對應(yīng)的tag就大公搞成了

屏幕快照 2017-10-12 下午6.21.43.png

哦了,大功搞成

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

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容