CocoaPods安裝、卸載、使用說明(Mac ox 10.11+)

1、全新安裝前，先檢查是否有安裝殘留

 

因爲Mac 10.11更改了安全機制，因此cocoapods得安裝和卸載命令也有所改變，

一、若是以前裝過cocopods，最好先卸載掉，卸載命令：

$ sudo gem uninstall cocoapods【Mac 10.10以前】

$ sudo gem uninstall -n /usr/local/bin cocoapods【Mac 10.11以後】

二、先查看本地安裝過的cocopods相關東西【本步驟沒有必要】，命令以下：

$ gem list --local | grep cocoapods

會顯示以下：

cocoapods-core (0.39.0)

cocoapods-downloader (0.9.3)

cocoapods-plugins (0.4.2)

cocoapods-search (0.1.0)

cocoapods-stats (0.6.2)

cocoapods-trunk (0.6.4)

cocoapods-try (0.5.1)

而後逐個刪除吧：

$ sudo gem uninstall cocoapods-core【Mac 10.10以前】

$ sudo gem uninstall -n /usr/local/bin cocoapods-core【Mac 10.11以後】

。。。

 

2、安裝

因爲網上的教程基本都大同小異，但細節之處還不是很完善，因此藉機會在這裏補充下：

注：要使用CocoaPods，那就要下載安裝它，而下載安裝CocoaPods須要Ruby環境

一、準備工做

當前安裝環境爲Mac os 10.11.6。Mac  OS自己自帶Ruby，但仍是更新一下保險，由於我第一次安裝在沒有更新Ruby的狀況下就失敗了。

a） 查看下當前ruby版本：打開終端輸入 ruby -v（確實安裝了，不過用這個版本接下來工做失敗了，因此更新下ruby）（更新方法本身百度。。。）

chendeMacBook-Air:~ chen$ ruby -v
ruby 2.3.0p0 (2015-12-25 revision 53290) [x86_64-darwin15]
chendeMacBook-Air:~ chen$

chendeMacBook-Air:~ chen$ ruby -v
ruby 2.3.0p0 (2015-12-25 revision 53290) [x86_64-darwin15]
chendeMacBook-Air:~ chen$

 

b）cocoapods鏡像：https://gems.ruby-china.org/   好像如今不支持淘寶了

終端輸入以下命令（把Ruby鏡像指向Ruby China，避免被牆，你懂得）

$gem sources --remove https://rubygems.org/ 
$gem sources --add https://gems.ruby-china.org/
$gem sources -l  （用來檢查使用替換鏡像位置成功）

 

chendeMacBook-Air:~ chen$ gem sources -l
*** CURRENT SOURCES ***

https://gems.ruby-china.org/

chendeMacBook-Air:~ chen$ gem sources -l
*** CURRENT SOURCES ***

https://gems.ruby-china.org/

二、下載安裝CocoaPods

 

終端輸入：sudo gem install -n /usr/local/bin cocoapods

......
Installing ri documentation for cocoapods-0.39.0
Done installing documentation for cocoapods-try, cocoapods-trunk, cocoapods-stats, cocoapods-search, cocoapods-plugins, cocoapods-downloader, cocoapods-core, cocoapods after 5 seconds
8 gems installed

......
Installing ri documentation for cocoapods-0.39.0
Done installing documentation for cocoapods-try, cocoapods-trunk, cocoapods-stats, cocoapods-search, cocoapods-plugins, cocoapods-downloader, cocoapods-core, cocoapods after 5 seconds
8 gems installed

 

接下來進行安裝，執行：


$ pod setup

Terminal會停留在 Setting up CocoaPods master repo 這個狀態一段時間,是由於要進行下載安裝,並且目錄比較大,須要耐心等待一下.安裝成功後,你會看到:  setup completed

這樣就下載安裝好了CocoaPods

/************************************************************************************************************************************/

安裝過程遇到的問題：

一、Ruby版本太低（更新就好了）

二、

$ pod setup
Setting up CocoaPods master repo
[!] /usr/bin/git clone https://github.com/CocoaPods/Specs.git master
Cloning into ‘master’…
error: RPC failed; curl 56 SSLRead() return error -36
fatal: The remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed

$ pod setup
Setting up CocoaPods master repo
[!] /usr/bin/git clone https://github.com/CocoaPods/Specs.git master
Cloning into ‘master’…
error: RPC failed; curl 56 SSLRead() return error -36
fatal: The remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed

 

三、

$ pod setup
Setting up CocoaPods master repo
[!] /usr/bin/git clone https://github.com/CocoaPods/Specs.git master
Cloning into ‘master’…
error: RPC failed; curl 56 SSLRead() return error -9806
fatal: The remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed

$ pod setup
Setting up CocoaPods master repo
[!] /usr/bin/git clone https://github.com/CocoaPods/Specs.git master
Cloning into ‘master’…
error: RPC failed; curl 56 SSLRead() return error -9806
fatal: The remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed

 

四、

$ pod setup
Setting up CocoaPods master repo
[!] /usr/bin/git clone https://github.com/CocoaPods/Specs.git master
Cloning into ‘master’…
error: RPC failed; curl 18 transfer closed with outstanding read data remaining
fatal: The remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed

$ pod setup
Setting up CocoaPods master repo
[!] /usr/bin/git clone https://github.com/CocoaPods/Specs.git master
Cloning into ‘master’…
error: RPC failed; curl 18 transfer closed with outstanding read data remaining
fatal: The remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed

解決方法：上面錯誤主要是os10.11+和cocoapods1.0+版本升級的安全機制更改形成的。主要出如今pod setup過程當中。且該過程等待時間很是長，因此，你能夠在$sudo gem install -n /usr/local/bin cocoapods命令後直接執行$Git clone https://git.coding.net/CocoaPods/Specs.git ~/.cocoapods/repos/master 該過程做用與 pod setup做用相同，做者親測。效果極佳！！！！

 

若是還不成功！！！！能夠一樣的方法安裝正式版v0.39 而後在升級到v1.0版本  

gem update --system

sudo gem install -n /usr/local/bin cocoapods --pre

 

 

 

 

/************************************************************************************************************************************/

3、使用CocoaPods

a  新建一個項目，名字PodTest

b  終端中，cd到項目總目錄（注意：包含PodTest文件夾、PodTest.xcodeproj、PodTestTest的那個總目錄）

$cd /Users/chen/Desktop/projects/PodTest

c  創建Podfile（配置文件）

接着上一步，終端輸入$vim Podfile

鍵盤輸入 i，進入編輯模式，輸入

platform :iOS, '8.0'
target "PodTest" do
pod 'MBProgressHUD', '~> 1.0.0'
end

而後按Esc，而且輸入「 ：」號進入vim命令模式，而後在冒號後邊輸入wq

 

注意：鍵盤輸入 ：後，才能輸入wq。回車後發現PodTest項目總目錄中多一個Podfile文件

激動人心的時刻到了：肯定終端cd到項目總目錄，而後輸入 $pod install，等待一會。

查看項目根目錄：

注意：如今打開項目不是點擊 PodTest.xodeproj了，而是點擊 PodTest.xcworkspace

 

 

 

 

 

 

對於工程發生的變化，有幾點須要說明：

a、第三方庫會以成靜態庫方式引入工程使用

CocoaPods會將全部的第三方庫以target的方式組成一個名爲Pods的工程，該工程就放在剛纔新生成的Pods目錄下。整個第三方庫工程會生成一個名稱爲libPods.a的靜態庫提供給工程使用。

b、xcworkspace（PodTest.xcworkspace）的做用是管理工程和第三方庫

PodTest工程和Pods工程被以workspace的形式組織和管理。

補充：

一、CocoaPods的基本安裝及使用都詳細的說明了，但還有一些補充，當須要同時導入多個第三方時候怎麼辦 ？

這就須要修改Podfile了，就是用vim編輯的那個保存在項目根目錄中的文件，修改完了Podfile文件，須要從新執行一次pod install命令。

例如：

 

platform :ios

pod 'JSONKit',       '~> 1.4'

pod 'AFNetworking',  '~> 2.0'

 

二、CocoaPods能夠查找你想要的第三方庫

終端輸入命令：pod search JSONKit

瘋了了，我怎麼查找這麼大衆的關鍵字，好多庫～～

而後從新編輯Podfile文件，按照以前的步驟，把更多的庫都導入項目！

三、上文中「創建Podfile（配置文件）接着上一步，終端輸入 vim Podfile」步驟，若是不習慣使用vim編輯器，也可使用linux命令touch，生成一個空的Podfile文件，而後使用其餘的文本編輯器均可以，例如：

lizhongfudeMacBook-Pro:~ lizhongfu$ cd /Users/lizhongfu/Desktop/TestProject
lizhongfudeMacBook-Pro:TestProject lizhongfu$ touch Podfile

編輯好Podfile文件後，就能夠執行pod install第三方導入了（詳見：補充第1條），CocoaPods就開始爲咱們作下載源碼、配置依賴關係、引入須要的framework等一些列工做。

四、若是已經生成了CocoaPods管理的工程，則能夠在Xcode中編輯Podfile，編輯保存後，別忘記cd到根目錄，調用pod install命令

五、項目存在多個Target的時候，須要配置Podfile文件來支持新增長的Target，不然只支持項目默認創建時生成的Target：

a、若是新建一個Target，命名爲Second，而且Second與Test兩個Target所須要的第三方支持相同，也就是使用相同的Pods依賴庫，則可使用

link_with關鍵字：

link_with 'Test', 'Second'
platform :ios
platform :ios, ‘9.0’
pod 'AFNetworking', '~> 2.0'

b、若是不一樣的Target須要不一樣的依賴庫，則能夠

platform :ios
target :'Test' do
pod 'Reachability'
pod 'SBJson'
pod 'AFNetworking'
end

target :'Second' do
pod 'OpenUDID'
end

六、出現/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)

從新打開一個終端，而後pod install，不要sudo pod install。

七、若是$ pod install時候遇到：

Analyzing dependencies  
Fetching podspec for `UAAppReviewManager` from `..`  
[!] Unable to satisfy the following requirements:  
- `UAAppReviewManager (from `..`)` required by `Podfile`  

八、若是要移除Cocoapods，則能夠：

 

a. 刪除工程文件夾下的Podfile、Podfile.lock及Pods文件夾

b. 刪除xcworkspace文件

c. 使用xcodeproj文件打開工程，刪除Frameworks組下的Pods.xcconfig及libPods.a引用

d. 在工程設置中的Build Phases下刪除Check Pods Manifest.lock及Copy Pods Resources

 

 

ps:若是將cocoapods集成到工程中後不當心修改或刪除了其相關文件致使沒法便以經過例如：不當心把

Pods.xcconfig給刪除了而後出現diff: /../Podfile.lock: No such file or directory，用上面的方法刪除cocoapods後，

再從新$sudo pod install一下就行了。

若是編譯的時候出現權限問題，對工程文件夾$sudo chmod 777 path-to-project-folder/*

$sudo chown 777 path-to-project-folder/*

九、當庫正常導入，但仍是找不到相關頭文件，則能夠：

在TARGETS -> Search Paths -> User Header Search Paths 中 寫入 ${SRCROOT}再將後面參數改成recursive：

 

十、Xcode - ld: library not found for -lPods

當新增長一個Target，而且pod install後，因爲建立項目是默認建立的Target的Build Phases中引用了舊的.a，例如libPods.a，當新增長Targget後，libPods.a已經變成了libPods-Test.a，而新增長的Target名字爲Second，依賴的.a爲libPods-Second.a。因此libPods.a此時已經再也不被引用，而且不會被生成，若是任何地方引用了就會報錯，解決辦法是出現問題的Target的Build Phases中刪除無用的.a引用，例如libPods.a

十一、pod update
若果Podfile中指定的依賴庫版本不是寫死的，當對應的依賴庫有了更新，不管有沒有Podfile.lock文件都會去獲取Podfile文件描述的容許獲取到的最新依賴庫版本。

十二、在引用第三方，若是想明確第三方版本號的時候，還有一些小細節：

pod 'AFNetworking'      //不顯式指定依賴庫版本，表示每次都獲取最新版本  （<span style="color: rgb(50, 62, 50); font-family: Arial; font-size: 14px; line-height: 26px;">十一、</span><span style="color: rgb(50, 62, 50); font-family: Arial; font-size: 14px; line-height: 26px;">pod update</span>）
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'     //使用最新版本，與不顯示指定依賴庫版本相同

1三、若是pod install以後，一直停留在Updating local specs repositories，能夠試一試 pod install --verbose --no-repo-update，緣由是pod install被牆了

 

可能出現的錯誤：

1、pod install時報錯：

一、終端報錯：The dependency MBProgressHUD (~> 0.9.2) is not used in any concrete target.
二、緣由：CocoaPods升級到最新版本（包括一些高版本），Podfile文件的內容必須明確指出所用第三方庫的targetName.
三、報錯分析：低版本和高版本寫法不同.

低版本：
platform :ios, '8.0'
pod 'MBProgressHUD', '~> 0.9.2'

高版本：
platform :ios, '8.0'
target "targetName" do
pod 'MBProgressHUD', '~> 0.9.2'
end

注意：這裏的 targetName 填寫工程的名字。

 

2、刪除某個框架

 

方法：

1.打開Podfile文件，刪除JSONKit該行，即：

platform:ios, '7.0'  
pod 'AFNetworking', '~> 2.1.0'
pod 'JSONKit', '~> 1.5pre'（刪除該行）
pod 'MBProgressHUD', '~> 0.8'

（若是想換成1.1版本，將被刪除的行改爲pod 'JSONKit-NoWarning', '~> 1.1'便可）