制作集成了一個(gè)認(rèn)證菇民,分享尽楔,支付的庫,也上載到了github第练,之前一直想做一個(gè)自己的pod庫阔馋,根據(jù)網(wǎng)上的教程,走了一些坑娇掏,總算折騰完了(寫這個(gè)文章的時(shí)候其實(shí)應(yīng)該還在部署呕寝,有點(diǎn)小激動(dòng))
1.Github?
? ? ?創(chuàng)建自己的Repository,我創(chuàng)建了QShare婴梧,然后從本地上傳到github上下梢, 這些步驟就不在這里贅述了,經(jīng)常跑github的同學(xué)應(yīng)該都會(huì)志秃。
2.建tag
? ? ?打開終端怔球,cd 到項(xiàng)目QShare目錄下,
git tag '1.0.0'//這個(gè)命令是本地創(chuàng)建tag浮还,1.0.0版本
git push --tags // 這個(gè)命令是把tag推送到遠(yuǎn)端竟坛。
3.創(chuàng)建項(xiàng)目的podspec文件
現(xiàn)在終端還是在項(xiàng)目QShare的目錄下,執(zhí)行以下命令
$ pod spec create QShare
在本地目錄下同時(shí)也生成了QShare.podspec文件
$ vim QShare.podspec
編輯podspec文件,會(huì)發(fā)現(xiàn)這個(gè)文件已經(jīng)生成了部分的字段
以下是編輯好的podspec 文件 做一些解釋
Pod::Spec.new do |s| ? ? ? ? ? ? ? ? ? ? ? #spec開始 ?s作為spec的別名
? ? s.name? ? ? ? = "QShare" ? ? ? ? ? ? ? #項(xiàng)目名稱
? ? s.version? ? ? = "1.0.0" ? ? ? ? ? ? ? ? #版本號(hào)担汤,
? ? s.summary? ? ? = "Gather Some Auth Share Pay." ? ? ? ?#簡介
? ? s.homepage? ? = "https://github.com/quankevin/QShare" ? ? ? ? ? #github涎跨,或者別的開源代碼地址
? ? s.license? ? ? = "MIT" ? ? ? ?#遵循的開源協(xié)議
? ? s.author? ? ? ? ? ? = { "quankevin" => "quankevin@163.com" } ? ? ? #作者
? ? s.social_media_url? = "http://weibo.com/quankevin" ? ? ? ? #作者聯(lián)系
? ? s.platform? ? = :ios, "7.0" ? ?#對(duì)應(yīng)的ios平臺(tái)
? ? s.source? ? ? = { :git => "https://github.com/quankevin/QShare.git", :tag => "#{s.version}" } ? ?#代碼的git源地址 ? ?這里的tag=>"#{s.version}" ? 引用了上面的s.version ?如果,在打tag的時(shí)候是用的 ?git tag 'v1.0.0' ? ? 那么這里需要使用 ? tag => "v#{s.version}"?
? ? s.frameworks? = "SystemConfiguration","UIKit","CoreTelephony" ? ? ? ? #項(xiàng)目需要用到的ios framework?
? ? s.libraries? ? = "stdc++", "sqlite3","z" ? ? ? ? ? ? ? ?#項(xiàng)目需要用到的庫
? ? s.requires_arc = true ? ? ? ? ? ? #arc
? ? s.public_header_files = "QShare/QShareHeader.h" ? ? ? ? ?#公用的一些頭文件
? ? s.subspec 'Core' do |core| ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?#定義一個(gè)Core
? ? ? ?core.source_files = "QShare/*.{h,m}" ? ?#指定Core的路徑
? ? end ? ? ? ?#結(jié)束定義Core
? ? s.subspec 'WeChat' do |wechat| ? ? ? #定義微信
? ? ? wechat.dependency 'QShare/Core' ? ? ? ? #需要上面的Core
? ? ? wechat.source_files = "QShare/Wechat/*.{h,m}" ? ?#微信的庫?
? ? ? wechat.vendored_libraries = "QShare/Wechat/*.a" ?#封裝了微信的.a
? ? end ? #結(jié)束
? ? s.subspec 'Weibo' do |weibo|
? ? ? ?weibo.dependency "WeiboSDK" ? #這里是直接引用了微博的cocoapod
? ? end
? ? s.subspec 'Tencent' do |qq|
? ? ? qq.dependency 'QShare/Core'
? ? ? qq.source_files = "QShare/Tencent/*.{h,m}"
? ? ? qq.vendored_frameworks = "QShare/Tencent/SDK/TencentOpenAPI.framework" ? #指定framework 的路徑
? ? end
? ? s.subspec 'Ali' do |ali|
? ? ? ali.dependency 'QShare/Core'
? ? ? ali.source_files = "QShare/Ali/*.{h,m}"
? ? ? ali.resources = "QShare/Ali/SDK*.bundle" ? #指定了ali 的非代碼資源
? ? ? ali.vendored_frameworks = "QShare/Ali/SDK/AlipaySDK.framework"
? ? end
end
編輯好podspec文件后崭歧,需要驗(yàn)證一下這個(gè)文件是否能通過編譯隅很。
$ pod spec lint QShare.podspec --verbose
然而并沒有通過
- ERROR | [iOS] Encountered an unknown error (The'Pods'target has transitive dependencies that include static binaries: (/private/var/folders/bw/c_n89d1n6xqffn525kp80000gn/T/CocoaPods/Lint/Pods/WeiboSDK/libWeiboSDK/libWeiboSDK.a)) during validation.
找了一些相關(guān)的,這個(gè)錯(cuò)誤是因?yàn)橐蕾噹欤╯.dependency)包含了.a靜態(tài)庫造成的率碾。雖然這并不影響Pod的使用叔营,但是驗(yàn)證是無法通過的∷祝可以通過 --use-libraries 來讓驗(yàn)證通過绒尊。使用以下的命令:
$ pod spec lint QShare.podspec --verbose --use-libraries
然而這種情況下使用 --use-libraries 雖然不會(huì)出現(xiàn)錯(cuò)誤(error),但是有時(shí)候會(huì)帶來一些警告(waring)仔粥,警告同樣是無法通過驗(yàn)證的婴谱。這時(shí)可以用 --allow-warnings 來允許警告。
$ pod spec lint QShare.podspec --verbose --use-libraries --allow-warnings
靜候佳音----終于通過了躯泰。
提交到pod
發(fā)布時(shí)也會(huì)驗(yàn)證 Pod 的有效性谭羔,如果你在手動(dòng)驗(yàn)證 Pod 時(shí)使用了 --use-libraries 或 --allow-warnings 等修飾符,那么發(fā)布的時(shí)候也應(yīng)該使用相同的字段修飾麦向,否則出現(xiàn)相同的報(bào)錯(cuò)瘟裸。
發(fā)布成功后,終于可以使用 pod search 搜索到自己的 Pod 了磕蛇。
?tieguan?pod search QShare
-> QShare (1.0.0)
Gather Some Auth Share Pay.
pod 'QShare', '~> 1.0.0'
- Homepage: https://github.com/quankevin/QShare
- Source:https://github.com/quankevin/QShare.git
- Versions: 1.0.0 [master repo]
- Subspecs:
- QShare/Core (1.0.0)
- QShare/WeChat (1.0.0)
- QShare/Weibo (1.0.0)
- QShare/Tencent (1.0.0)
- QShare/Ali (1.0.0)
版本升級(jí)
當(dāng)需要更新 Pod 版本的時(shí)候景描,修改 .podspec 中的 s.version 為更高的版本號(hào),并修改 s.source 中對(duì)應(yīng)的 Git 版本秀撇。提交到Git超棺,并打上對(duì)應(yīng)tag。然后再次執(zhí)行pod trunk push QShare.podspec將新的 .podspec 發(fā)布到 CocoaPods呵燕。更新完成棠绘!
為了更方便的修改版本號(hào),用了以下的語句:
s.source? ? ? = { :git => "https://github.com/quankevin/QShare.git", :tag => "v#{s.version}" }
這樣與 s.version進(jìn)行了綁定再扭,每次提交新的版本只需要修改s.version ?= "xxxx"氧苍。
如有不明白的或者錯(cuò)誤的地方,請(qǐng)大家指出泛范,我會(huì)將其修正让虐。
參考資料
http://www.tuicool.com/articles/6FF7fi
http://ishalou.com/blog/2012/10/16/how-to-create-a-cocoapods-spec-file/
https://guides.cocoapods.org/syntax/podspec.html#specification