創(chuàng)建自己的 Pod 十分簡(jiǎn)單。只需要?jiǎng)?chuàng)建 .podspec，編輯好 .podspec 的必要信息儿礼，提交到 Git，然后就可以在其他項(xiàng)目中使用了宫静。
如果想了解其中的原理，可以查看這篇文章扔字。
如果是 Swift 囊嘉，可以在此基礎(chǔ)上參考這篇文章。
創(chuàng)建.podspec
首先在你的項(xiàng)目中使用如下命令創(chuàng)建名為 LPPushService 的 LPPushService.podspec（當(dāng)然你也可以使用vim創(chuàng)建革为，只是沒有默認(rèn)文本而已）
$ pod spec create LPPushService
編輯.podspec
創(chuàng)建好的 .podspec 包含大量的注釋說明了每個(gè)參數(shù)的含義及用法扭粱。如果想詳細(xì)了解可以仔細(xì)閱讀。這里只介紹幾個(gè)常用的震檩。
Pod::Spec.new do |s|
s.name = "LPPushService"
s.version = "1.0.0"
s.summary = "integrate APNs rapidly"
s.homepage = "https://github.com/xiaofei86/LPPushService"
s.license = { :type => "MIT", :file => "LICENSE" }
s.author = { "XuYafei" => "xuyafei86@163.com" }
s.social_media_url = "http://xuyafei.cn"
s.platform = :ios, "7.0"
s.source = { :git => "https://github.com/xiaofei86/LPPushService.git", :tag => s.version }
s.source_files = "LPPushService/**/*.{h,m}"
s.resources = "LPPushService/Images/*.png"
s.dependency "BPushSDK", "1.4.1"
s.requires_arc = true
end
s.name：名稱琢蛤，pod search 搜索的關(guān)鍵詞
s.version：版本
s.summary：簡(jiǎn)介蜓堕，pod search 搜索的關(guān)鍵詞
s.homepage：主頁地址，例如Github地址
s.license：許可證
s.author：作者
s.social_media_url：社交網(wǎng)址
s.platform：平臺(tái)
s.source：Git倉庫地址博其，例如在Github地址后邊加上 .git 就是Git倉庫地址套才，常見寫法如下
s.source_files：需要包含的源文件，常見的寫法如下
s.resources：需要包含的圖片等資源文件
s.dependency：依賴庫慕淡，不能依賴未發(fā)布的庫
s.dependency：依賴庫背伴，如有多個(gè)可以這樣寫
s.requires_arc：是否要求ARC
s.source_files 常見寫法
"Directory1/*"
"Directory1/Directory2/*.{h,m}"
"Directory1/**/*.h"
- “*” 表示匹配所有文件
- “*.{h,m}” 表示匹配所有以.h和.m結(jié)尾的文件
- “**” 表示匹配所有子目錄
s.source 常見寫法
s.source = { :git => "https://github.com/xiaofei86/LPPushService.git", :commit => "68defea" }
s.source = { :git => "https://github.com/xiaofei86/LPPushService.git", :tag => 1.0.0 }
s.source = { :git => "https://github.com/xiaofei86/LPPushService.git", :tag => s.version }
- commit => "68defea" 表示將這個(gè)Pod版本與Git倉庫中某個(gè)commit綁定
- tag => 1.0.0 表示將這個(gè)Pod版本與Git倉庫中某個(gè)版本的comit綁定
- tag => s.version 表示將這個(gè)Pod版本與Git倉庫中相同版本的comit綁定
按照上述規(guī)則編輯完成就制作好了 .podspec（最好使用vim進(jìn)行編輯）。
上傳到Git
將包含配置好的 .podspec 的項(xiàng)目提交 Git峰髓，并給這次提交打上 tag傻寂，這時(shí)就可以在其他項(xiàng)目中使用 CocoaPods 引入你配置好的 Pod 了。
pod 'LPPushService', :git => 'https://github.com/xiaofei86/LPPushService.git', :tag => '1.0.0'
當(dāng)然携兵，在給其他項(xiàng)目使用前最好先<a href="##驗(yàn)證.podspec">驗(yàn)證.podspec</a>的有效性疾掰。
*驗(yàn)證.podspec
編輯好后最好先驗(yàn)證 .podspec 是否有有效
$ pod spec lint LPPushService.podspec
驗(yàn)證過程中：
-> LPPushService
驗(yàn)證成功后：
LPPushService.podspec passed validation.
驗(yàn)證失敗后：
[!] The spec did not pass validation, due to 1 error.
驗(yàn)證 .podspec 會(huì)先測(cè)試本地 .podspec 文件是否存在語法錯(cuò)誤。測(cè)試成功再根據(jù) .podspec 文件找到遠(yuǎn)端倉庫對(duì)應(yīng)的版本克隆到本地并進(jìn)行配置徐紧。最后測(cè)試文件是否能夠編譯成功静檬。
*.podspec驗(yàn)證失敗錯(cuò)誤排查
語法錯(cuò)誤
如果是因?yàn)檎Z法錯(cuò)誤，驗(yàn)證失敗后會(huì)給出錯(cuò)誤的準(zhǔn)確定位
[!] Invalid `LPPushService.podspec` file: no .<digit> floating literal anymore; put 0 before dot
s.version = “1.0.0”
^
LPPushService.podspec:5: syntax error, unexpected tFLOAT, expecting '('
s.version = “1.0.0”
^
標(biāo)記“^”的地方即為有語法錯(cuò)誤的地方并级。
上述錯(cuò)誤是因?yàn)槭褂谩拔谋揪庉嫛边M(jìn)行編輯造成的拂檩。使用文本編輯有時(shí)候英文""引號(hào)會(huì)自動(dòng)變成中文“”引號(hào)。
[!] Your Podfile has had smart quotes sanitised. To avoid issues in the future, you should not use TextEdit for editing it. If you are not using TextEdit, you should turn off smart quotes in your editor of choice.
使用 vim 將其改為英文的""引號(hào)即可嘲碧。
依賴錯(cuò)誤
但是广恢，有些非語法錯(cuò)誤是不會(huì)給出錯(cuò)誤原因的。這個(gè)時(shí)候可以使用“--verbose”來查看詳細(xì)的驗(yàn)證過程來幫助定位錯(cuò)誤呀潭。
pod spec lint LPPushService.podspec --verbose
如下錯(cuò)誤通過 --verbose 就可以找到原因。
-> LPPushService (1.0.0)
- ERROR | [iOS] Encountered an unknown error (The 'Pods' target has transitive dependencies that include static binaries: (/private/var/folders/jz/b_m3k7ln47524cm__h3__mk00000gn/T/CocoaPods/Lint/Pods/BPushSDK/LibBPush/libBPush.a)) during validation.
這個(gè)錯(cuò)誤是因?yàn)橐蕾噹欤╯.dependency）包含了.a靜態(tài)庫造成的至非。雖然這并不影響Pod的使用钠署，但是驗(yàn)證是無法通過的』耐郑可以通過 --use-libraries 來讓驗(yàn)證通過谐鼎。
pod spec lint LPPushService.podspec --verbose --use-libraries
這種情況下使用 --use-libraries 雖然不會(huì)出現(xiàn)錯(cuò)誤（error），但是有時(shí)候會(huì)帶來一些警告（waring）趣惠，警告同樣是無法通過驗(yàn)證的狸棍。這時(shí)可以用 --allow-warnings 來允許警告。
pod spec lint LPPushService.podspec --verbose --use-libraries --allow-warnings
安裝錯(cuò)誤
如果在其他項(xiàng)目 pod install 的過程中味悄，出現(xiàn)包含“undefined method `end_with?' for nil”字樣的報(bào)錯(cuò)草戈。進(jìn)入“~/.cocoapods/repos”目錄，刪除“master”侍瑟，并將 master-1 改為 master 即可唐片。
如果出現(xiàn)如下錯(cuò)誤丙猬，而你的驗(yàn)證可以通過，那么一般更新下版本號(hào)就可以解決费韭。
[!] Unable to find a specification for 'LPPushService'.
再次驗(yàn)證
如果錯(cuò)誤發(fā)生在 .podspec 中茧球。當(dāng)修改完時(shí)，不需要再次提交就可以直接驗(yàn)證星持。如果錯(cuò)誤發(fā)生在代碼中抢埋，則需要再次提交才能驗(yàn)證。
發(fā)布到CocoaPods
你可以用 .podspec 文件來方便的管理內(nèi)部代碼督暂，當(dāng)然揪垄，也可以發(fā)布自己的 Pod 供其他開發(fā)者使用。
CocoaPods 0.33中加入了 Trunk 服務(wù)损痰，使用 Trunk 服務(wù)可以方便的發(fā)布自己的Pod福侈。雖然一開始使用 GitHub Pull Requests 來整理所有公共 pods 效果很好。但是卢未，隨著 Pod 數(shù)量的增加肪凛，這個(gè)工作對(duì)于 spec 維護(hù)人員 Keith Smiley 來說變得十分繁雜。甚至一些沒有通過 $ pod lint 的 spec 也被提交上來辽社，造成 repo 無法 build伟墙。CocoaPods Trunk 服務(wù)的引入，解決了很多類似的問題滴铅。每次使用 Trunk 服務(wù)發(fā)布 Pod 時(shí)都會(huì)通過 $ pod lint 驗(yàn)證 .podspec 是否有效戳葵。要想使用 Trunk 服務(wù)，首先需要使用如下命令注冊(cè)自己的電腦汉匙。這很簡(jiǎn)單拱烁，只要你指明你的郵箱地址（spec文件中的）和名稱即可。CocoaPods 會(huì)給你填寫的郵箱發(fā)送驗(yàn)證郵件噩翠，點(diǎn)擊郵件中的鏈接就可通過驗(yàn)證戏自。
pod trunk register xuyafei86@163.com "XuYafei"
然后就可以發(fā)布你的 Pod 了。
pod trunk push LPPushService.podspec
發(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ò)屯援。
pod trunk push LPPushService.podspec --use-libraries --allow-warnings
發(fā)布成功后猛们，就可以使用 pod search 搜索到你的 Pod 了！
-> LPPushService (1.0.0)
integrate APNs rapidly
pod 'LPPushService', '~> 1.0.0'
- Homepage: https://github.com/xiaofei86/LPPushService
- Source: https://github.com/xiaofei86/LPPushService.git
- Versions: 1.0.0 [master repo]
由于 pod search 是搜索的本地“~/.cocoapods”狞洋，所以在其他設(shè)備上可能無法搜到弯淘。這時(shí)只需要執(zhí)行 pod install 更新下 pod 倉庫即可（不要加 --no-repo-update）。
版本升級(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 LPPushService.podspec將新的 .podspec 發(fā)布到 CocoaPods废登。更新完成！
為了更新更加方便郁惜，版本控制更加清晰堡距，s.source 建議采用如下寫法：
s.source = { :git => "https://github.com/xiaofei86/LPPushService.git", :tag => s.version }
這樣寫將 Git 的版本與 CocoaPods 的版本進(jìn)行了綁定。每次提交后再給本次提交打上 tag 就完成了更新兆蕉。而且在 Git 中就可以清晰的看到哪次提交對(duì)應(yīng)的哪個(gè) CocoaPods 版本羽戒。如果與 commit 綁定，則要通過兩次提交才能完成更新虎韵，第一次先提交修改代碼易稠，第二次將上一次 commit id 更新到 s.source 然后再次提交。如果直接與固定 tag 綁定包蓝，則每次還都要修改 s.source驶社。如果你的 Pod 是私有庫，那么 s.source 其實(shí)是無用的测萎。因?yàn)樵?Podfile 中已經(jīng)指明了地址和版本（如下）亡电。這時(shí) s.source 可以隨便填寫，但最好還是按照上述規(guī)則以便以后發(fā)布硅瞧。
pod 'LPPushService', :git => 'https://github.com/xiaofei86/LPPushService.git', :tag => 1.0.0
博客：xuyafei.cn
簡(jiǎn)書：jianshu.com/users/2555924d8c6e
微博：weibo.com/xuyafei86
Github：github.com/xiaofei86
