雖然網上關于cocoapods安裝教程多不勝數,但是我在安裝的過程中還是出現了很多錯誤,所以大家可以照下來步驟裝一下,我相信會很好用.
前言
在ios項目中使用第三方類庫可以說是非常常見的事,但是要正確地配置他們有時候是非常繁瑣的事情,幸運的是cocoapods是一個很好的解決方案。
什么是cocoapods
cocoapods是os x和ios下的一個第三類庫管理工具,通過cocoapods工具我們可以為項目添加被稱為“pods”的依賴庫(這些類庫必須是cocoapods本身所支持的),并且可以輕松管理其版本。
cocoapods意義體現在兩個方面。第一,在引入第三方庫時它可以自動為我們完成各種各樣的配置,包括配置編譯階段、連接器選項、甚至是arc環境下的-fno-objc-arc配置等。第二,使用cocoapods可以很方便地查找新的第三方庫,這些類庫是比較“標準的”,而不是網上隨便找到的,這樣可以讓我們找到真正好用的類庫。
接下來我們將介紹cocoapods的使用。
cocoapods的核心組件
cocoapods是用ruby寫的,并劃分成了若干個gem包。
cocoapods在解析執行過程中最重要的幾個包的路徑分別是:cocoapods/cocoapods、 cocoapods/core和 cocoapods/xcodeproj。
cocoapods / cocoapod:這是面向用戶的組件,每當執行一個pod命令時,這個組件將被激活。它包括了所有實用cocoapods的功能,并且還能調用其他gem包來執行任務。
cocoapods / core:core gem提供了與cocoapods相關的文件(主要是podfile和podspecs)的處理。
podfile:該文件用于配置項目所需要的第三方庫,它可以被高度定制。本文中我們主要在這里做動作。
podspec:該文件描述了一個庫將怎樣被添加進工程中。.podspec文件可以標識該第三方庫所需要的源碼文件、依賴庫、編譯選項,以及其他第三方庫需要的配置。
cocoapods / xcodeproj:這個包負責處理工程文件,它能創建以及修改.xcodeproj文件和.xcworkspace文件。它也可以作為一個獨立的包使用,當你要編寫修改項目文件的腳本時,可以考慮使用cocoapods/xcodeproj。
cocoapods安裝步驟
1、升級ruby環境
終端輸入:$gem update --system
此時會出現
error: while executing gem ... (gem::filepermissionerror)
you don‘t have write permissions for the /library/ruby/gems/2.0.0 directory.
zijingmacbook-pro:~ shiyunlei$ sudo gem update —system
這個是因為你沒有權限去更新ruby
這個時候你可以在終端使用:$sudo gem update —system來進行升級
這個時候表示ruby升級完成。
2、安裝cocoapods時我們要訪問cocoapods.org,該網站可能被我們大天朝墻了,這樣下載安裝可能會是龜速,幸好我們可以用淘寶的ruby鏡像來訪問該網站,方法如下:
gem sources --remove https://rubygems.org/
gem sources -a http://ruby.taobao.org/
可以使用下面的命令(紅色部分)查看是否更換鏡像成功(如下圖所示):
$ gem sources -l
3、安裝cocoapods,在終端輸入命令
$sudo gem install cocoapods
這個時候會提示你輸入密碼,注:在終端輸入密碼不會有提示,光標也不會移動,一定要注意
開始安裝,如下圖:ps:這個過程可能花費時間比較長
安裝成功如下:
4、使用search命令搜索類庫名:
$pod search afnetworking
如果cocoapods支持,將會輸出搜索到的所有類庫版本和信息,以及在podfile中配置的寫法,終端返回信息如下:
-> afnetworking (2.3.1)
a delightful ios and os x networking framework.
pod ‘afnetworking‘, ‘~> 2.3.1'(這個語句是需要在編輯podfile的時候輸入的命令,即是如何安裝下載相關類庫的指令)
- homepage: https://github.com/afnetworking/afnetworking
- source: https://github.com/afnetworking/afnetworking.git
- versions: 2.3.1, 2.3.0, 2.2.4, 2.2.3, 2.2.2, 2.2.1, 2.2.0, 2.1.0,
2.0.3, 2.0.2, 2.0.1, 2.0.0, 2.0.0-rc3, 2.0.0-rc2, 2.0.0-rc1, 1.3.4, 1.3.3,
1.3.2, 1.3.1, 1.3.0, 1.2.1, 1.2.0, 1.1.0, 1.0.1, 1.0, 1.0rc3, 1.0rc2, 1.0rc1,
0.10.1, 0.10.0, 0.9.2, 0.9.1, 0.9.0, 0.7.0, 0.5.1 [master repo]
- sub specs: - afnetworking/serialization (2.3.1) -
afnetworking/security (2.3.1) - afnetworking/reachability (2.3.1) -
afnetworking/nsurlconnection (2.3.1) - afnetworking/nsurlsession (2.3.1)
- afnetworking/uikit (2.3.1)
-> afnetworking+autoretry (0.0.5)
auto retries for afnetworking requests
pod ‘afnetworking+autoretry‘, ‘~> 0.0.5‘
- homepage: https://github.com/shaioz/afnetworking-autoretry
- source: https://github.com/shaioz/afnetworking-autoretry.git
- versions: 0.0.5, 0.0.4, 0.0.3, 0.0.2, 0.0.1 [master repo]
5、需要在工程中創建一個podfile文件,
使用命令:
$cd /users/shiyunlei/desktop/cocoapodssample
(進入工程目錄,cd后面的是工程的路徑)
$ touch podfile
(創建podfile文件)
然后使用vim編輯podfile文件,使用命令:
$ vim podfile
進入如下界面
然后緊接著按鍵盤上的“i”鍵,變成如下狀態,這個時候可以對podfile文件進行編輯:
$platform:ios, ‘7.0‘
$ pod ‘afnetworking‘, ‘~> 2.3.1‘
在編輯完成后按“esc”,
在按“:”,這個時候輸入wq,點擊回車,保存并退出。
這個時候打開podfile文件就會看到里面添加了剛才在終端輸入的一行語句,如下圖
然后在終端輸入命令安裝相應的第三方類庫
$pod install
因為這個過程需要下載相應的類庫,所以時間和網速有關。
安裝成功之后截圖如下:
這個時候會看到之后打開工程都需要從類型為工程名.xcworkspace文件打開。
史上最詳細的cocoapods安裝教程就此結束了,如果還有什么疑問可以查看下面的相關文章。