我 ：“ 2017年還有多久？”
我 ：“ ‘冬天來(lái)了，春天還會(huì)遠(yuǎn)嗎？’，馬上就要步入18年，您說(shuō)17年還有多久。您就看著吧，下個(gè)月到處都是17年年終總結(jié)！”
I'sorry,進(jìn)入正題
我個(gè)人寫(xiě)本文的目的只有一個(gè)：讓你輕松制作自己的
pod庫(kù)。可能是因?yàn)槲?笨？網(wǎng)上的教程，我看的有點(diǎn)??（暈），不過(guò)最終還是摸索出來(lái)了，并且明白了123，so,請(qǐng)?jiān)试S我以我“笨”的方式來(lái)讓你輕松。
第一步：在GitHub上新建一個(gè)倉(cāng)庫(kù)
說(shuō)明：由于自己創(chuàng)建PPKit時(shí)沒(méi)有截圖，這里為了說(shuō)明，新建了PPKit1來(lái)截圖說(shuō)明，諒解！
第二步：clone項(xiàng)目到本地，并創(chuàng)建PPKit1.podspec文件
具體clone與創(chuàng)建.podspec文件的命令如下：
//2.1（具體路徑，看你自己放置）
cd /Users/peijianbo/Documents/MTTest
//2.2
git clone https://github.com/chinesemanbobo/PPKit1.git
//2.3 (切換到開(kāi)源庫(kù)名相同的目錄)
cd /Users/peijianbo/Documents/MTTest/PPKit1
//2.4 （很重要的第一步，create后面必須是開(kāi)源庫(kù)名，此處是PPKit1）
pod spec create PPKit1
其中最關(guān)鍵的是(請(qǐng)自動(dòng)替換PPKit1為自己的庫(kù)名)，當(dāng)然cd對(duì)應(yīng)的文件目錄也不要弄錯(cuò)：
pod spec create PPKit1
等到終端看到如上圖綠色文字Specification created at PPKit1.podspec，這一步就成功了。
第三步：配置PPKit.podspec，尤其是里面的各種目錄的.source_files文件要注意
注意：此處開(kāi)始，我們?cè)倩氐絇PKit。（如果你自己的庫(kù)，請(qǐng)?zhí)鎿QPPKit為你的庫(kù)名來(lái)閱讀）。
3.1 打開(kāi)PPKit.podspec文件(推薦用Sublime Text打開(kāi))，先閱讀里面各種#后面的注釋說(shuō)明，尤其有必要讀讀開(kāi)頭的3行注釋
此處，為什么覺(jué)得很有必要讀讀開(kāi)頭的3行注釋，都是自己血與淚的教訓(xùn)！我自己當(dāng)時(shí)直接忽略這些注釋，一心急著想搞定，結(jié)果，折騰很久，后頭再看注釋，才明白好多，然后慢慢修改，才OK的。不過(guò)，你也可以不看，說(shuō)了讓你輕松。
下面的是開(kāi)頭的3行注釋，容我簡(jiǎn)單翻譯與介紹下：
//1.
Be sure to run `pod spec lint PPKit.podspec' to ensure this is a valid spec and to remove all comments including this before submitting the spec.
//2.
To learn more about Podspec attributes see http://docs.cocoapods.org/specification.html
//3.
To see working Podspecs in the CocoaPods repo see https://github.com/CocoaPods/Specs/
- 在你提交
PPKit.podspec文件到CocoaPods前，務(wù)必要在命令行運(yùn)行pod spec lint PPKit.podspec來(lái)確保.podspec有效，并且刪除所有的注釋，包括這句（Be sure ... submitting the spec.）。- 你可以在http://docs.cocoapods.org/specification.html看到更多關(guān)于
podspec的屬性的信息。- 你可以在https://github.com/CocoaPods/Specs/上查看當(dāng)前都有那些有效的、可以用的
Pods。
上面第3條，你也可以點(diǎn)開(kāi)看一看，保證你有收獲，如下：
點(diǎn)開(kāi)后，在
This repository里輸入AFNetworking,然后摁Enter鍵搜索，你會(huì)看到下圖，先別驚奇(至于我在下圖說(shuō)的，'本地也有'，就不上圖了)：
CocoaPods的秘密（原理）
看到這，如果你的項(xiàng)目用到了CocoaPods,有沒(méi)有一種“噢...，原來(lái)是這樣的”的柳暗花明又一村的感覺(jué)，如果你有，你NB；如果沒(méi)有，沒(méi)有就算了，你更要認(rèn)真看下去！反正我有。嘿嘿！
放大招的時(shí)候來(lái)了：CocoaPods說(shuō)白了，就是幫我們管理第三方or自己的庫(kù)；而它不過(guò)也是一個(gè).xcodeproj工程。只不過(guò)，它是專門(mén)管理第三方or自己的庫(kù)的工程，而它的工作原理就是：你把.podspec文件制作好，然后trunk push (后面后講到)給它，它再把.podspec文件保存為.podspec.json文件放到GitHub，你需要的話，它通過(guò)這個(gè).podspec.json把GitHub上對(duì)應(yīng)的開(kāi)源庫(kù)的文件下載下來(lái)，放到你的工程里。至此，OK。
說(shuō)了這么多，再來(lái)張圖，證實(shí)下，我們繼續(xù)講pod庫(kù)的制作，圖如下（不信也不行）：
3.2 修改PPKit.podspec文件，刪除里面所有的注釋，然后再修改。下面給出PPKit.podspec以便參考，注釋我已經(jīng)加進(jìn)去了（如果你發(fā)布的話，最好把注釋都去掉，此處只是為了說(shuō)明才保留注釋的），如下：
Pod::Spec.new do |s|
#開(kāi)源庫(kù)的名字
s.name = "PPKit"
#開(kāi)源庫(kù)當(dāng)期版本
s.version = "0.0.6"
#開(kāi)源庫(kù)概述（打開(kāi)GitHub能看到的描述）
s.summary = "開(kāi)發(fā)中常用的自定義控件、開(kāi)發(fā)經(jīng)驗(yàn)、開(kāi)發(fā)bug記錄，常用宏、categories等封裝，不再每個(gè)項(xiàng)目都手動(dòng)配置，用Pod統(tǒng)一管理。"
#開(kāi)源庫(kù)描述 （這個(gè)描述會(huì)被用來(lái)生成開(kāi)源庫(kù)的標(biāo)簽和提高被搜到，必需寫(xiě)在中間一行，只要在中間一行，不需要考慮縮進(jìn)）
s.description = <<-DESC
開(kāi)發(fā)中經(jīng)常從A項(xiàng)目copy一些代碼（比如常用的宏、category等）到B項(xiàng)目，A更改了一個(gè)category，B又要改動(dòng)；B更改了一個(gè)category，A也要改動(dòng)，不方便同步，就容易出差錯(cuò)，所以，考慮用Pod來(lái)管理。
DESC
#可以是開(kāi)源庫(kù)的GitHub地址，也可以是你自己的網(wǎng)址等
s.homepage = "https://github.com/chinesemanbobo/PPKit"
#我這里是參靠網(wǎng)上的一種寫(xiě)法，不會(huì)報(bào)警告，也可以直接 s.license = 'MIT'
s.license = { :type => 'MIT', :text => <<-LICENSE
Copyright PPAbner 2016-2017
LICENSE
}
#開(kāi)源庫(kù)作者
s.author = { "chinesemanbobo" => "chinesemanbobo@163.com" }
#開(kāi)源庫(kù)作者的社交鏈接（此處我放的是微博）
s.social_media_url = "https://weibo.com/5366568018/profile?rightmod=1&wvr=6&mod=personnumber&is_all=1"
#開(kāi)源庫(kù)支持的平臺(tái)（暫時(shí)沒(méi)考慮tvOS、OSX等）
s.platform = :ios
#開(kāi)源庫(kù)最低支持
s.ios.deployment_target = "8.0"
#VIP 開(kāi)源庫(kù)GitHub的路徑與tag值，GitHub路徑后必須有.git,tag實(shí)際就是上面的版本
s.source = { :git => "https://github.com/chinesemanbobo/PPKit.git", :tag => s.version }
#VIP 開(kāi)源庫(kù)資源文件 （我自己總結(jié)：每個(gè)文件都要有自己的路徑，尤其你想目錄分的比較詳細(xì)的話，更具體的說(shuō)明，看圖對(duì)比著再說(shuō)）
s.source_files = 'PPKit/PPKit.h','PPKit/PPMacros.h'
#子目錄PPHelpers（2級(jí)），PPKit(1級(jí))，ss子目錄可以隨便寫(xiě)，但下面要對(duì)應(yīng)
s.subspec 'PPHelpers' do |ss|
#子目錄PPRuntimeHelper.h和PPRuntimeHelper.m （3級(jí)）
ss.source_files = 'PPKit/PPHelpers/PPRuntimeHelper.{h,m}'
end
s.subspec 'PPCategories' do |ss|
ss.subspec 'UI' do |ssui|
ssui.subspec 'UIScreen' do |ssuiscreen|
ssuiscreen.source_files = 'PPKit/PPCategories/UI/UIScreen/UIScreen+EasilySize.{h,m}'
end
end
end
#開(kāi)源庫(kù)頭文件
s.public_header_files = 'PPKit/PPKit.h'
#開(kāi)源庫(kù)依賴庫(kù)
# s.dependency "JSONKit", "~> 1.4"
# 是否支持arc
s.requires_arc = true
end
3.3 .podspec里面的.source_files的簡(jiǎn)單介紹（主要是語(yǔ)法）
一個(gè)宗旨：庫(kù)里面每個(gè)文件、資源都要有路徑指向它。
部分語(yǔ)法：
'PPKit/*' 表示匹配所有PPKit目錄下文件，不包含子目錄的 'PPKit/PPHelpers/*.{h,m}' 表示匹配PPHelpers所有以.h和.m結(jié)尾的文件 'PPKit/**/*' 表示匹配所有文件(主目錄和子目錄，其中**相當(dāng)于省略中間層級(jí))具體的語(yǔ)法示例及截圖，見(jiàn)文章最后面（參考鏈接之前）。
第四步：更新PPKit.podspec到GitHub上
依次執(zhí)行下面命令：
$ git add -A && git commit -m "你的更新說(shuō)明"
//tag值要和.podspce里的version相同，并且必須設(shè)置
$ git tag '0.0.68'
$ git push --tags
$ git push origin master
第五步：驗(yàn)證PPKit.podspec是否有效
pod spec lint PPKit.podspec
如果驗(yàn)證不通過(guò)，可以執(zhí)行
pod spec lint PPKit.podspec --verbose查看詳細(xì)的ERROR和WARING提示，根據(jù)提示依次解決，然后回到第四步重新來(lái)一遍。
注意：在重新開(kāi)始之前，我們要?jiǎng)h除遠(yuǎn)程庫(kù)的tag和本地的tag，命令如下：$ git tag -d 0.0.68 //刪除本地tag $ git push origin :refs/tags/0.0.68 // 刪除遠(yuǎn)程庫(kù)tag
直到如下圖的驗(yàn)證成功：
第六步：提交PPKit.podspec到CocoaPods
pod trunk push PPKit.podspec
如果是第一次提交，需要先執(zhí)行下面的命令去CocoaPods注冊(cè)（填寫(xiě)郵箱，收取驗(yàn)證鏈接，點(diǎn)擊鏈接，就OK）：
$ pod trunk register 郵箱 '昵稱' --description=' 這里寫(xiě)描述'
然后再執(zhí)行：
pod trunk push PPKit.podspec
OLA，到此就結(jié)束了，趕緊去pod search一下，看有沒(méi)有！
遇到的問(wèn)題s:
1. pod search PPkit 搜不出
【方案一】cocoapods search 獲取不到最新庫(kù)的解決方法
我用的是第二種：執(zhí)行pod repo update更新本地倉(cāng)庫(kù)，再pod search PPkit，就能 搜到了。
【方案二】執(zhí)行pod search PPkit --simple
--simple
【方案三】打開(kāi)~/Library/Caches/CocoaPods,刪除search_index.json，該文件會(huì)在重新搜索時(shí)創(chuàng)建。
【方案四】執(zhí)行pod search PPkit --repo-update
附：從AFNetworking/PPKit/YYKit看podspec語(yǔ)法。
研究了自己常用的開(kāi)源庫(kù)的文件目錄，其中AFNetworking是最完美的，也是我最想要的，而其它的大多數(shù)都是，所有.h和.m文件都放在一個(gè)目錄下，比如：IQKeyboardManager。對(duì)比如下圖：
AFNetworking與IQKeyboardManager的pod庫(kù)目錄對(duì)比
參考AFNetworking來(lái)說(shuō)明{}里面的共用以及子目錄的設(shè)置。
1. 如下圖中間的線：
AFURLRequestSerialization.h、AFURLRequestSerialization.m以及AFURLResponseSerialization.h和AFURLResponseSerialization.m可以寫(xiě)為'AFNetworing/AFURL{Request,Response}Serialization.{h,m}'。所以：{}里面的用逗號(hào)（,）隔開(kāi)，相當(dāng)于數(shù)學(xué)中的組合.
2. Serialization文件不需要指定路徑，只需要subspec調(diào)用了就好，它處于第2級(jí)目錄，里面除了上面的4個(gè)文件別無(wú)其它。但是這4個(gè)文件必須指定目錄路徑，如上面1中所示。
AFNetworking的Serialization目錄解釋說(shuō)明
PPKit配置與截圖說(shuō)明，如下：記住那個(gè)原則：每個(gè)文件/路徑都要指定對(duì)應(yīng)的路徑。
由YYKit學(xué)會(huì)與理解.exclude_files
.exclude_files，忽略YYKit下的，重新建文件夾（目錄）來(lái)管理。
