每次嘗試接觸一個(gè)新東西祟昭,總不免出些七七八八,亂七八糟的問題怖侦。明明之后很多操作好像似乎也一樣,但是一開始總要報(bào)各種錯(cuò)匾寝。好在查了資料,終歸是成功了的艳悔,記錄一下筆記,方便下回使用猜年。
大致流程
1.準(zhǔn)備好要發(fā)布到cocoapods的代碼抡锈。
2.創(chuàng)建.podspec,并根據(jù)自己的項(xiàng)目情況企孩,編輯.podspec文件。
3.將包含.podspec的項(xiàng)目上傳到GitHub袁稽,并且保證上傳后GitHub上包含.podspec及一份LICENSE證書。
4.講項(xiàng)目打成tag
5.注冊(cè)并驗(yàn)證cocoapods
6.發(fā)布
第1步省略,從第2部說(shuō)起歧沪。
2.創(chuàng)建.podspec,并根據(jù)自己的項(xiàng)目情況莲组,編輯.podspec文件
①創(chuàng)建.podspec:終端cd到要上傳的項(xiàng)目目錄,使用:
//YourPodName 改成你自己pod框架的名字
pod spec create YourPodName
創(chuàng)建完成之后锹杈,就會(huì)在自己項(xiàng)目的文件夾里看到一個(gè)YourPodName.podspec的文件。對(duì)這個(gè)文件進(jìn)行編輯竭望。
②.podspec文件編輯
文件里以#開頭的是注釋邪码,都可以刪掉咬清,剩下有用的信息看得更清晰。先放一份方便復(fù)制修改的旧烧,底下再放一份加注釋說(shuō)明的影钉。
Pod::Spec.new do |s|
s.name = "YourPodName"
s.version = "1.0.0"
s.summary = "這是簡(jiǎn)介"
s.description = <<-DESC
這是描述掘剪,描述需要比簡(jiǎn)介長(zhǎng)。
DESC
s.homepage = "https://github.com/gulingxuan/YourPodName"
s.license = "MIT"
s.license = { :type => "MIT", :file => "LICENSE" }
s.platform = :ios, "8.0"
s.author = { "gulingxuan" => "249166831@qq.com" }
s.social_media_url = "https://weibo.com/xuanxuan7520"
s.source = { :git => "https://github.com/gulingxuan/YourPodName.git", :tag => "v#{s.version}" }
s.source_files = "YourPodName/**/*.{h,m}"
s.requires_arc = true
end
Pod::Spec.new do |s|
#項(xiàng)目名字
s.name = "YourPodName"
#版本號(hào)杖小,需要和github上打的tag標(biāo)簽號(hào)保持一致愚墓,否則上傳的時(shí)候會(huì)報(bào)錯(cuò)
s.version = "1.0.0"
#項(xiàng)目簡(jiǎn)介
s.summary = "這是簡(jiǎn)介"
#項(xiàng)目描述
s.description = <<-DESC
這是描述予权,描述需要比簡(jiǎn)介長(zhǎng)浪册。
DESC
#項(xiàng)目的主頁(yè)
s.homepage = "https://github.com/gulingxuan/YourPodName"
# 開源證書
s.license = "MIT"
#證書相關(guān)的吧,不知道具體什么鬼
s.license = { :type => "MIT", :file => "LICENSE" }
#平臺(tái)及支持的最低版本
s.platform = :ios, "8.0"
# 作者信息
s.author = { "gulingxuan" => "249166831@qq.com" }
# 個(gè)人主頁(yè)
s.social_media_url = "https://weibo.com/xuanxuan7520"
#你的倉(cāng)庫(kù)地址村象,不能用SSH地址
s.source = { :git => "https://github.com/gulingxuan/YourPodName.git", :tag => "v#{s.version}" }
# 代碼的位置, YourPodName/*.{h,m} 表示 YourPodName 文件夾下所有的.h和.m文件
s.source_files = "YourPodName/*.{h,m}"
# 是否啟用ARC
s.requires_arc = true
#支持的框架
s.frameworks = "UIKit", "Foundation"
# 依賴庫(kù)
# s.dependency = "AFNetworking"
end
③驗(yàn)證.podspec 文件的格式是否正確,這一步十分重要厚者,必須要驗(yàn)證通過才行躁劣。
終端繼續(xù)使用命令:
// 也可以使用 pod lib lint YourPodName.podspec
$ pod lib lint
驗(yàn)證如果有error库菲,則必須要解決,WARN能解決也盡量解決。如果出現(xiàn)以下警告
- WARN | url: There was a problem validating the URL http:xxxxx
也可以用以下命令驗(yàn)證
$ pod lib lint --allow-warnings
這個(gè)解決方法在別人的文章里看到鳖擒,的確可以驗(yàn)證通過,但是后面上傳的時(shí)候還是報(bào)錯(cuò)了蒋荚。最后是升級(jí)了一堆亂七八糟的環(huán)境之后,重新走了一遍所有流程期升,發(fā)現(xiàn)沒有這個(gè)警告了惊奇,再上傳就成功了播赁。所以這個(gè)驗(yàn)證方式會(huì)是否管用,我沒有成功驗(yàn)證過行拢。僅供參考。
3.所有編輯完成之后舟奠,將項(xiàng)目及包含.podpesc文件及 LICENSE證書的文件上傳到Github竭缝。LICENSE文件可以在創(chuàng)建GitHub項(xiàng)目的時(shí)候一起生成沼瘫。具體上傳就不細(xì)說(shuō)了。
4.給項(xiàng)目Git打tag耿戚,第一次需要在前面加個(gè)v。我第一回沒有加膜蛔,果然是報(bào)錯(cuò)了坛猪。打tag并推送到遠(yuǎn)程倉(cāng)庫(kù):
//這里的tag版本號(hào)皂股,必須和podspec中的版本號(hào)保持一致,大寫加粗描黑的必須呜呐。
$ git tag "v1.0.0"
$ git push --tags
- 如果注冊(cè)了cocoapods,就不必再注冊(cè)了蘑辑,如果沒有注冊(cè)洋机,則先注冊(cè)洋魂。所以建議先驗(yàn)證啄踊,再注冊(cè),最后再驗(yàn)證颠通,沒問題再推。
//驗(yàn)證你的信息
pod trunk me
//沒有則注冊(cè)膀懈,you-email@qq.com 和YourName換成自己的郵箱及名字
pod trunk register you-email@qq.com "YourName"
//再次驗(yàn)證
pod trunk me
- 驗(yàn)證沒有問題則開始發(fā)布到倉(cāng)庫(kù)
pod trunk push YourPodName.podspec
如果整套流程都沒有問題,并且發(fā)布成功了启搂,就可以查詢倉(cāng)庫(kù)看一下了。
pod search YourPodName
處查到基本就完成了整個(gè)上傳發(fā)布胳赌,大功告成牢撼。
============= 報(bào)錯(cuò)分割線 =============
如果出現(xiàn)報(bào)錯(cuò):
1.- ERROR | [iOS] unknown: Encountered an unknown error (/usr/bin/xcrun simctl list -j devices
xcrun: error: unable to find utility "simctl", not a developer tool or in PATH
) during validation.
[!] The spec did not pass validation, due to 1 error.
設(shè)置一下Xcode