下面來看一篇關於 Swift 中 CocoaPods 安裝與使用的詳解(自動安裝管理第三方庫),希望文章能對各位有所幫助。
開發時,我們常常需要引入一些第三方庫(比如 Alamofire、SwiftyJSON 等等)。過去的做法是把這些庫下載下來,再引入到工程中;如果它們還依賴其他庫,就得手動把這些依賴庫也添加進來。更麻煩的是,一旦這些第三方庫後續有更新,我們還得先刪掉項目裡原來的庫,再重複前面的步驟,著實費事。
而用了 CocoaPods 之後,這些工作都不必再操心,只需做好配置,安裝、更新第三方庫,CocoaPods 都會自動幫我們搞定。
一、CocoaPods 介紹
(1)CocoaPods 是 iOS 開發中的第三方庫管理工具,目的是讓我們能自動化、集中、直觀地管理第三方開源庫。
(2)CocoaPods 能自動解決庫與庫之間的依賴關係、下載庫的源代碼,並創建一個 Xcode 的 workspace 把這些第三方庫和我們的工程連接起來,供開發使用。
二、安裝 CocoaPods
1,將 gem 升級為最新版本
sudo gem update --system
2,運行如下命令安裝 CocoaPods
sudo gem install -n /usr/local/bin cocoapods
接著執行如下命令,如果沒有報錯,就說明安裝成功了。(執行後需要等待一段時間,CocoaPods 會把它的信息下載到 ~/.cocoapods 裡,大約有一百多兆。)
pod setup
3,安裝後執行如下命令查看版本
pod --version
4,以後要更新升級 CocoaPods,執行如下命令
sudo gem update cocoapods
三、CocoaPods 安裝失敗的原因與解決辦法
1,執行 install 後一直沒反應,無法安裝
有時你會發現執行 install 命令後遲遲沒有響應。這是因為 Ruby 的默認源使用的是 rubygems.org,由於國內網絡原因,訪問上面的資源文件會間歇性連接失敗。
(1)我們可以執行如下命令,把源改成使用淘寶提供的 rubygems.org 鏡像:
gem sources --add https://ruby.taobao.org/ --remove https://rubygems.org/
(2)接著執行下面命令,確保只剩下 ruby.taobao.org:
gem sources -l
(3)最後再執行 install 就能成功安裝 CocoaPods 了。
2,Ruby 版本太低
如果本機 Ruby 版本過低,也可能導致安裝失敗。
(1)安裝 rvm(rvm 可以讓我們擁有多個版本的 Ruby,並在版本之間自由切換):
curl -L get.rvm.io | bash -s stable
source ~/.rvm/scripts/rvm
(2)完成後執行如下命令,若出現版本號則說明 rvm 安裝成功:
rvm -v
(3)執行 rvm list known 可以列出所有可安裝的 ruby 版本信息。
(4)我們安裝一個 ruby 版本:
rvm install 2.2.4
(5)並將其設為默認版本,這時應該就能正常安裝 CocoaPods 了:
rvm use 2.2.4 --default
(6)使用 rvm list 命令可以查看已安裝的 ruby。
(7)如果要卸載某個已安裝的 ruby 版本,執行如下命令:
rvm remove 2.1.4
四、CocoaPods 的使用
下面我們創建一個工程項目(假設工程名為 hangge_1358),演示如何用 CocoaPods 自動下載、導入、配置第三方庫。
1,創建 Podfile
首先進入工程的根目錄下,創建空白的 Podfile 文件:
cd /Users/hangge/Documents/Code/hangge_1358
touch Podfile
2,編輯 Podfile
我們在 Podfile 中寫上需要引入的第三方庫,這裡以 Alamofire、SwiftyJSON 這兩個庫為例:
platform :ios, '8.0'
use_frameworks!
target 'hangge_1358' do
pod 'Alamofire'
pod 'SwiftyJSON'
end
3,開始導入庫
(1)執行下面命令,開始導入前面配置的第三方庫:
cd /Users/hangge/Documents/Code/hangge_1358
pod install
(2)執行成功後,你會發現工程根目錄下多出三個新內容:hangge_1358.xcworkspace、Podfile.lock 文件,以及 Pods 目錄。
4,打開新生成的 hangge_1358.xcworkspace
(1)往後我們需要用這個新生成的 hangge_1358.xcworkspace 來開發。因為原來工程(hangge_1358.xcodeproj)的設置已被更改,如果直接打開原工程去編譯就會報錯。
(2)打開後可以看到,裡面除了我們的項目工程,還有一個 Pods 工程,整體結構一目了然。
5,測試代碼
開發時,我們只需在使用處 import 一下需要的庫即可:
import UIKit
import Alamofire
class ViewController: UIViewController {
override func viewDidLoad() {
super.viewDidLoad()
Alamofire.request(.GET, "")
.responseString { response in
print("Success: \(response.result.isSuccess)")
print("Response String: \(response.result.value)")
}
}
override func didReceiveMemoryWarning() {
super.didReceiveMemoryWarning()
}
}
6,新增或移除第三方庫
以後如果需要在工程中導入新庫,或移除原有的庫,仍是先編輯 Podfile,再執行 install 命令:
pod install
7,更新第三方庫
如果引用的庫沒有增減,只是想把它們更新到最新版本,則執行 update 命令:
pod update
五、導入 Objective-C 寫的第三方庫
上面的示例創建的是 Swift 工程,並導入 Swift 語言寫的第三方庫。如果想在 Swift 工程中引入 OC 寫的第三方庫,操作也一樣,而且項目裡不再需要像過去那樣創建橋接頭文件、手動把 Objective-C 頭文件引用進來。
這裡以 OC 寫的圖片緩存庫 SDWebImage 為例說明。1,編輯 Podfile:
platform :ios, '8.0'
use_frameworks!
target 'hangge_1358' do
pod 'Alamofire'
pod 'SwiftyJSON'
pod 'SDWebImage'
end
2,執行安裝命令
pod install
3,代碼中直接將 SDWebImage 庫 import 就能使用
import UIKit
import SDWebImage
class ViewController: UIViewController {
override func viewDidLoad() {
super.viewDidLoad()
let imageView = UIImageView()
imageView.frame=CGRectMake(10,10,130,27.5)
let url = NSURL(string: "/blog/images/logo.png")
imageView.sd_setImageWithURL(url)
self.view.addSubview(imageView)
}
override func didReceiveMemoryWarning() {
super.didReceiveMemoryWarning()
}
}