一、概要
iOS開(kāi)發(fā)時(shí)誉裆，項(xiàng)目中會(huì)引用許多第三方庫(kù)足丢，CocoaPods（https://github.com/CocoaPods/CocoaPods） 可以用來(lái)方便的統(tǒng)一管理這些第三方庫(kù)（從一個(gè)坑出來(lái)斩跌，又進(jìn)了另一個(gè)坑而已……）捞慌。
二啸澡、安裝
由于網(wǎng)上的教程基本都大同小異嗅虏，但細(xì)節(jié)之處還不是很完善，所以借機(jī)會(huì)在這里補(bǔ)充下：
注：要使用CocoaPods楞艾，那就要下載安裝它产徊，而下載安裝CocoaPods需要Ruby環(huán)境
1舟铜、Ruby環(huán)境搭建
當(dāng)前安裝環(huán)境為Mac mini 10.8.5谆刨。Mac OS本身自帶Ruby，但還是更新一下保險(xiǎn)刁岸，因?yàn)槲业谝淮伟惭b在沒(méi)有更新Ruby的情況下就失敗了虹曙。
a 查看下當(dāng)前ruby版本：打開(kāi)終端輸入 ruby -v（確實(shí)安裝了酝碳，不過(guò)用這個(gè)版本接下來(lái)工作失敗了，所以更新下ruby）
vincentdeMacBook-Air:PodTest lucky$ ruby -v
ruby 1.8.7 (2012-02-08 patchlevel 358) [universal-darwin12.0]
b 更新ruby
終端輸入如下命令（把Ruby鏡像指向taobao疏哗，避免被墻返奉，你懂得）
gem sources --remove https://rubygems.org/
gem sources -a http://ruby.taobao.org/
gem sources -l （用來(lái)檢查使用替換鏡像位置成功）
vincentdeMacBook-Air:~ lucky$ gem sources --remove https://rubygems.org/
https://rubygems.org/ removed from sources
vincentdeMacBook-Air:~ lucky$ gem sources -a http://ruby.taobao.org/
http://ruby.taobao.org/ added to sources
vincentdeMacBook-Air:~ lucky$ gem sources -l
*** CURRENT SOURCES ***
ps: 淘寶已經(jīng)關(guān)閉HTTP協(xié)議的景象服務(wù)芽偏，改為HTTPS協(xié)議哮针。
淘寶ruby地址：
https://ruby.taobao.org/
2十厢、下載安裝CocoaPods
終端輸入：
sudo gem install cocoapods
vincentdeMacBook-Air:~ lucky$ sudo gem install cocoapods
CHANGELOG:
## 0.32.1
##### Bug Fixes
* Fixed the Podfile `default_subspec` attribute in nested subspecs.
[Fabio Pelosin][irrationalfab]
\ [#2050](https://github.com/CocoaPods/CocoaPods/issues/2050)
Successfully installed cocoapods-0.32.1
Installing ri documentation for cocoapods-0.32.1
/System/Library/Frameworks/Ruby.framework/Versions/1.8/usr/lib/ruby/1.8/rdoc/rdoc.rb:280: warning: conflicting chdir during another chdir block
/System/Library/Frameworks/Ruby.framework/Versions/1.8/usr/lib/ruby/1.8/rdoc/rdoc.rb:287: warning: conflicting chdir during another chdir block
Done installing documentation for cocoapods after 10 seconds
1 gem installed
這樣就下載安裝好了CocoaPods
3蛮放、使用CocoaPods
a 新建一個(gè)項(xiàng)目包颁，名字PodTest
b 終端中娩嚼，cd到項(xiàng)目總目錄（注意：包含PodTest文件夾岳悟、PodTest.xcodeproj贵少、PodTestTest的那個(gè)總目錄）
cd /Users/lucky/Desktop/PodTest
c 建立Podfile（配置文件）
接著上一步滔灶，終端輸入 vim Podfile
鍵盤輸入 i录平，進(jìn)入編輯模式斗这，輸入
platform :ios, '7.0'
pod 'MBProgressHUD', '~> 0.8'
然后按Esc，并且輸入“ ：”號(hào)進(jìn)入vim命令模式，然后在冒號(hào)后邊輸入wq或者x
注意：鍵盤輸入 ：后燃逻，才能輸入wq臂痕∥胀回車后發(fā)現(xiàn)PodTest項(xiàng)目總目錄中多一個(gè)Podfile文件
激動(dòng)人心的時(shí)刻到了：確定終端cd到項(xiàng)目總目錄，然后輸入 pod install稽揭，等待一會(huì)溪掀。
查看項(xiàng)目根目錄：
注意：現(xiàn)在打開(kāi)項(xiàng)目不是點(diǎn)擊 PodTest.xodeproj了揪胃，而是點(diǎn)擊 PodTest.xcworkspace
對(duì)于工程發(fā)生的變化喊递，有幾點(diǎn)需要說(shuō)明：
a骚勘、第三方庫(kù)會(huì)以成靜態(tài)庫(kù)方式引入工程使用
CocoaPods會(huì)將所有的第三方庫(kù)以target的方式組成一個(gè)名為Pods的工程调鲸，該工程就放在剛才新生成的Pods目錄下。整個(gè)第三方庫(kù)工程會(huì)生成一個(gè)名稱為libPods.a的靜態(tài)庫(kù)提供給工程使用藐石。
b于微、xcworkspace（PodTest.xcworkspace）的作用是管理工程和第三方庫(kù)
PodTest工程和Pods工程被以workspace的形式組織和管理株依。
打開(kāi)項(xiàng)目后看到項(xiàng)目結(jié)構(gòu)并且測(cè)試一下：
運(yùn)行結(jié)果：
補(bǔ)充：
1恋腕、CocoaPods的基本安裝及使用都詳細(xì)的說(shuō)明了荠藤，但還有一些補(bǔ)充哈肖，當(dāng)需要同時(shí)導(dǎo)入多個(gè)第三方時(shí)候怎么辦 ？
這就需要修改Podfile了布疼，就是用vim編輯的那個(gè)保存在項(xiàng)目根目錄中的文件游两，修改完了Podfile文件器罐，需要重新執(zhí)行一次pod install命令渐行。
例如：
platform :ios
pod 'JSONKit', '~> 1.4'
pod 'AFNetworking', '~> 2.0'
2祟印、CocoaPods可以查找你想要的第三方庫(kù)
終端輸入命令：pod search UI
你會(huì)發(fā)現(xiàn)好多庫(kù)帶有關(guān)鍵字UI do not case-sensitive
然后重新編輯Podfile文件蕴忆，按照之前的步驟，把更多的庫(kù)都導(dǎo)入項(xiàng)目站蝠！
3菱魔、上文中“建立Podfile（配置文件）接著上一步，終端輸入 vim Podfile”步驟澜倦，如果不習(xí)慣使用vim編輯器藻治，也可以使用Linux命令touch，生成一個(gè)空的Podfile文件验靡，然后使用其他的文本編輯器都可以胜嗓，例如：
vincentdeMacBook-Air:~ vincent$ cd /Users/lizhongfu/Desktop/TestProject
vincentdeMacBook-Air:TestProject vincent Podfile
編輯好Podfile文件后，就可以執(zhí)行pod install第三方導(dǎo)入了（詳見(jiàn)：補(bǔ)充第1條）初厚，CocoaPods就開(kāi)始為我們做下載源碼排作、配置依賴關(guān)系妄痪、引入需要的framework等一些列工作楞件。
4土浸、如果已經(jīng)生成了CocoaPods管理的工程黄伊，則可以在Xcode中編輯Podfile，編輯保存后墓阀，別忘記cd到根目錄斯撮，調(diào)用pod install命令
5橱乱、項(xiàng)目存在多個(gè)Target的時(shí)候粱甫，需要配置Podfile文件來(lái)支持新增加的Target茶宵，否則只支持項(xiàng)目默認(rèn)建立時(shí)生成的Target：
a乌庶、如果新建一個(gè)Target瞒大，命名為Second螃征，并且Second與Test兩個(gè)Target所需要的第三方支持相同，也就是使用相同的Pods依賴庫(kù)透敌，則可以使用
link_with關(guān)鍵字：
link_with 'Test', 'Second'
platform :ios
platform :ios, ‘9.0’
pod 'AFNetworking', '~> 2.0'
b盯滚、如果不同的Target需要不同的依賴庫(kù)，則可以
platform :ios
target :'Test' do
pod 'Reachability'
pod 'SBJson'
pod 'AFNetworking'
end
target :'Second' do
pod 'OpenUDID'
end
6酗电、出現(xiàn) > /Library/Ruby/Gems/2.0.0/gems/claide-0.8.1/lib/claide/command.rb:417:in `help!': [!] You cannot run CocoaPods as root. (CLAide::Help)
重新打開(kāi)一個(gè)終端魄藕，然后> pod install，不要> sudo pod install撵术。
7背率、如果$ pod install時(shí)候遇到：
Analyzing dependencies
Fetching podspec for `UAAppReviewManager` from `..`
[!] Unable to satisfy the following requirements:
- `UAAppReviewManager (from `..`)` required by `Podfile`
8、如果要移除Cocoapods寝姿，則可以：
a. 刪除工程文件夾下的Podfile、Podfile.lock及Pods文件夾
b. 刪除xcworkspace文件
c. 使用xcodeproj文件打開(kāi)工程翻翩，刪除Frameworks組下的Pods.xcconfig及l(fā)ibPods.a引用
d. 在工程設(shè)置中的Build Phases下刪除Check Pods Manifest.lock及Copy Pods Resources
ps:如果將cocoapods集成到工程中后不小心修改或刪除了其相關(guān)文件導(dǎo)致無(wú)法便以通過(guò)例如：不小心把
Pods.xcconfig給刪除了然后出現(xiàn)> diff: /../Podfile.lock: No such file or directory，用上面的方法刪除cocoapods后睛低，
再重新$sudo pod install一下就好了。
如果編譯的時(shí)候出現(xiàn)權(quán)限問(wèn)題，對(duì)工程文件夾
$sudo chmod 777 path-to-project-folder/*
$sudo chown 777 path-to-project-folder/*
9套蒂、當(dāng)庫(kù)正常導(dǎo)入，但還是找不到相關(guān)頭文件骨坑，則可以：
在TARGETS -> Search Paths -> User Header Search Paths 中 寫入 ${SRCROOT}再將后面參數(shù)改為recursive：
10警没、Xcode - ld: library not found for -lPods
當(dāng)新增加一個(gè)Target杀迹，并且pod install后大州，由于創(chuàng)建項(xiàng)目是默認(rèn)創(chuàng)建的Target的Build Phases中引用了舊的.a疮茄，例如libPods.a徙邻，當(dāng)新增加Targget后，libPods.a已經(jīng)變成了libPods-Test.a帅容，而新增加的Target名字為Second，依賴的.a為libPods-Second.a饮亏。所以libPods.a此時(shí)已經(jīng)不再被引用，并且不會(huì)被生成简肴，如果任何地方引用了就會(huì)報(bào)錯(cuò)，解決辦法是出現(xiàn)問(wèn)題的Target的Build Phases中刪除無(wú)用的.a引用辫狼，例如libPods.a
11真椿、pod update
若果Podfile中指定的依賴庫(kù)版本不是寫死的，當(dāng)對(duì)應(yīng)的依賴庫(kù)有了更新锋八，無(wú)論有沒(méi)有Podfile.lock文件都會(huì)去獲取Podfile文件描述的允許獲取到的最新依賴庫(kù)版本。
12樊销、在引用第三方撤师，如果想明確第三方版本號(hào)的時(shí)候腺占，還有一些小細(xì)節(jié)：
pod 'AFNetworking' //不顯式指定依賴庫(kù)版本，表示每次都獲取最新版本 （11、pod update） pod 'AFNetworking', '2.0' //只使用2.0版本 pod 'AFNetworking', '> 2.0' //使用高于2.0的版本 pod 'AFNetworking', '>= 2.0' //使用大于或等于2.0的版本 pod 'AFNetworking', '< 2.0' //使用小于2.0的版本 pod 'AFNetworking', '<= 2.0' //使用小于或等于2.0的版本 pod 'AFNetworking', '~> 0.1.2' //使用大于等于0.1.2但小于0.2的版本 pod 'AFNetworking', '~>0.1' //使用大于等于0.1但小于1.0的版本 pod 'AFNetworking', '~>0' //使用最新版本怎顾，與不顯示指定依賴庫(kù)版本相同
巧大神這里有更多內(nèi)容，其中介紹了pod制作及Podfile.lock的相關(guān)內(nèi)容《用CocoaPods做iOS程序的依賴管理》
13、如果pod install之后彪笼，一直停留在Updating local specs repositories杏死，可以試一試 pod install --verbose --no-repo-update品追，原因是pod install被墻了
14、（2016年6月11日）> The dependency 'xxx' is not used in any concrete target
在Podfile文件中需要明確指出使用第三方庫(kù)的target，例如：
platform:ios,'7.0'
pod 'MJRefresh', '~> 3.1.0'
pod 'SDWebImage', '~> 3.7.6'
pod 'SVProgressHUD', '~> 2.0.3'
pod 'AFNetworking', '~> 3.1.0'
改為：
platform:ios,'7.0'
target "MyTarget" do
pod 'MJRefresh', '~> 3.1.0'
pod 'SDWebImage', '~> 3.7.6'
pod 'SVProgressHUD', '~> 2.0.3'
pod 'AFNetworking', '~> 3.1.0'
end
pod update 試了還可以用
pod install 被墻了，請(qǐng)大家換成pod install --verbose --no-repo-update
升級(jí)10.11后使用CocoaPod出現(xiàn)-bash: pod: command not found 解決辦法
1.升級(jí)10.11后，運(yùn)行pod命令出現(xiàn)：-bash: pod: command not found
解決辦法：sudo gem install -n /usr/local/bin cocoapods
2'如果還不能解決，可以使用以下方法再試試：
sudo gem install -n /usr/local/bin cocoapods /
sudo chmod +rx /usr/local/bin
3.遇到如下錯(cuò)誤可能是因?yàn)檠b了多個(gè)Xcode導(dǎo)致路徑變了
[!] Unable to add a source with url `https://github.com/CocoaPods/Specs.Git` named `master-1`. You can try adding it manually in `~/.cocoapods/repos` or via `pod repo add`.
解決辦法：sudo xcode-select -switch /Applications/Xcode.app
/Applications/Xcode.app：此部分未Xcode所在路徑理郑，找到Xcode的安裝路徑柒爵，拖進(jìn)來(lái)即可
4.pod》error:The dependency `` is not used in any concrete target
內(nèi)容提要：
podfile升級(jí)之后到最新版本冀膝，pod里的內(nèi)容必須明確指出所用第三方庫(kù)的target，否則會(huì)出現(xiàn)''The dependency '' is not used in any concrete target這樣的錯(cuò)誤熬北。
以下從三個(gè)步驟陳述：
- Podfile升級(jí)
查看pod版本：
pod --version
pod 升級(jí)（此時(shí)是升級(jí)到1.0.0.beta.2版本）：
sudo gem install cocoapods --pre
- 錯(cuò)誤內(nèi)容：
我的Podfile的內(nèi)容是：
platform :ios, '7.0'
pod 'ReactiveCocoa', '2.1.8'
pod 'objectiveflickr', '2.0.4'
pod 'LinqToObjectiveC', '2.0.0'
pod 'SDWebImage', '3.6'
pod install后出現(xiàn)錯(cuò)誤The dependency `` is not used in any concrete target
pod install
/System/Library/Frameworks/Ruby.framework/Versions/2.0/usr/lib/ruby/2.0.0/universal-darwin14/rbconfig.rb:213: warning: Insecure world writable dir /Applications/Cocos/tools/ant/bin in PATH, mode 040777
Re-creating CocoaPods due to major version update.
Updating local specs repositories
Analyzing dependencies
[!] The dependency `ReactiveCocoa (= 2.1.8)` is not used in any concrete target.
The dependency `objectiveflickr (= 2.0.4)` is not used in any concrete target.
The dependency `LinqToObjectiveC (= 2.0.0)` is not used in any concrete target.
The dependency `SDWebImage (= 3.6)` is not used in any concrete target.
- 修改方法：
Podfile內(nèi)容更改：
platform :ios, '7.0'
target "RWTFlickrSearch" do
pod 'ReactiveCocoa', '2.1.8'
pod 'objectiveflickr', '2.0.4'
pod 'LinqToObjectiveC', '2.0.0'
pod 'SDWebImage', '3.6'
end
