CocoaPods爲我們的項目管理依賴庫,依賴庫可以很容易的通過一個叫做Podfile的文件來管理,通過簡單的幾句命令行代碼來同步更新你的依賴庫。CocoaPods簡化了我們添加第三方依賴庫的複雜度,使得代碼的可讀性更強,管理第三方庫更容易。
安裝
CocoaPods的運行需要有Ruby環境,因此在我們安裝CocoaPods之前,首先需要爲我們的MacOS安裝Ruby環境。
Ruby環境搭建
由於國內強大的防火牆,直接安裝Ruby可能導致不成功,因此這裏我們使用Ruby鏡像指向taobao的地址https:ruby.taobao.org/(貌似原來的http地址已經無法使用了)。
$ gem sources --remove https://rubygems.org/
$ gem sources -a https://ruby.taobao.org/
gem sources -l
安裝完成後,我們可以使用代碼來檢查Ruby安裝的版本,使用 ruby -v
Taylorwen-MacBook-Pro: wenzhan$ ruby -v
ruby 2.0.0p648 (2015-12-16 revision 53162) [universal.x86_64-darwin15]
更新Ruby版本
$ sudo gem update --system
Updating rubygems-update
Fetching: rubygems-update-2.6.6.gem (100%)
Successfully installed rubygems-update-2.6.6
Parsing documentation for rubygems-update-2.6.6
Installing ri documentation for rubygems-update-2.6.6
Installing darkfish documentation for rubygems-update-2.6.6
Installing RubyGems 2.6.6
RubyGems 2.6.6 installed
Parsing documentation for rubygems-2.6.6
Installing ri documentation for rubygems-2.6.6
=== 2.6.6 / 2016-06-22
RubyGems system software updated
通過sudo來安裝gems
通過默認的Ruby來安裝CocoaPods的gems,需要使用sudo命令。
$ sudo gem install cocoapods
安裝過程可能會持續半分鐘,成功後會顯示你安裝的gems的名稱和數量;
Fetching: cocoapods-core-1.0.1.gem (100%)
Successfully installed cocoapods-core-1.0.1
Fetching: claide-1.0.0.gem (100%)
Successfully installed claide-1.0.0
Fetching: cocoapods-deintegrate-1.0.0.gem (100%)
Successfully installed cocoapods-deintegrate-1.0.0
Fetching: cocoapods-downloader-1.1.0.gem (100%)
Successfully installed cocoapods-downloader-1.1.0
Fetching: cocoapods-plugins-1.0.0.gem (100%)
Successfully installed cocoapods-plugins-1.0.0
.........
14 gems installed
驗證一下你安裝的CocoaPod版本號
Taylorwen-MacBook-Pro: wenzhan$ pod --version
1.0.1
如果需要升級你的CocoaPods,你只需要重新安裝CocoaPods的gems
$ sudo gem install cocoapods
如果想要安裝上一個版本的CocoaPods,使用如下命令
$ sudo gem install cocoapods --pre
使用CocoaPods安裝依賴庫
CocoaPods通過一個.Podfile來管理你的依賴庫,那麼爲你的項目添加CocoaPods支持後,並沒有這個Podfile,因此我們需要創建一個Podfile,這裏我使用的是通過命令行創建Podfile方式,當然也可以使用文本編輯工具創建這個文件然後拖放到項目裏的/pods文件夾目錄中。
$ pod init
這時你的項目文件中就會出現一個Podfile文件。
搜索並安裝最新版AFNetworking
$ pod search AFNetworking
-> AFNetworking (3.1.0)
A delightful iOS and OS X networking framework.
pod 'AFNetworking', '~> 3.1.0'
- Homepage: https://github.com/AFNetworking/AFNetworking
- Source: https://github.com/AFNetworking/AFNetworking.git
- Versions: 3.1.0, 3.0.4, 3.0.3, 3.0.2, 3.0.1, 3.0.0, 3.0.0-beta.3
- AFNetworking/Serialization (3.1.0)
- AFNetworking/Security (3.1.0)
- AFNetworking/Reachability (3.1.0)
- AFNetworking/NSURLSession (3.1.0)
- AFNetworking/UIKit (3.1.0)
在Podfile中添加AFNetworking, 最新版CocoaPods對Podfile做了嚴格的格式要求,一定要按照下面的格式寫Podfile
platform :ios, ‘7.0’
use_frameworks!
target 'YourProjectName' do (這裏寫項目名)
pod 'AFNetworking', '~> 3.1.0'
end
然後使用命令行執行安裝
pod install
pod install命令會對未安裝的依賴庫進行安裝,同時會檢查已經安裝了的依賴庫的版本,如果有新的版本存在,則會對其進行update. 如果我們希望快速安裝依賴庫而不進行更新的話,使用如下命令行:
pod install --verbose --no-repo-update (不執行update)
————————————- 分割線 ——————————————-
2016-07-14更新
淘寶已經關閉HTTP協議的鏡像服務,改爲HTTPS協議。
淘寶ruby地址:https://ruby.taobao.org/