CocoaPods官方使用說(shuō)明文檔
安裝
ruby 的軟件源https://rubygems.org/
因?yàn)槭褂玫氖莵嗰R遜的云服務(wù),需要更新 ruby 的源:
$ gem source -- remove https://rubygems.org/
$ gem source -a https://ruby.taobao.org/(已經(jīng)停用注意移除)
$ gem source -a https://gems.ruby-china.org/
$ gem source -l(列出目前所有的源)
安裝方式異常簡(jiǎn)單,Mac 下自帶ruby,使用 ruby 的 gem 命令即可下載安裝:
$ sudo gem install cocoapods
$ pod setup
如果出現(xiàn)下面
問(wèn)題一:
ERROR: While executing gem ... (Gem::DependencyError)
Unable to resolve dependencies: cocoapods requires cocoapods-core (= 1.2.0), cocoapods-downloader (< 2.0, >= 1.1.3), cocoapods-trunk (< 2.0, >= 1.1.2), molinillo (~> 0.5.5), xcodeproj (< 2.0, >= 1.4.1)
是因?yàn)間em版本太老可以嘗試命令更新:
$ sudo gem update --system
注意:
更新gem需要admin權(quán)限赠橙。如果需要修改密碼空民,注意新密碼和驗(yàn)證保持一致。
問(wèn)題二:
ERROR: While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/xcodeproj
解決途徑:
輸入終端命令
sudo gem install -n /usr/local/bin cocoapods
還有一點(diǎn)需要注意挑胸,pod setup
在執(zhí)行時(shí)猴凹,會(huì)輸出Setting up CocoaPods master repo
夷狰,但是會(huì)等待比較久的時(shí)間。這步其實(shí)是 Cocoapods 在將它的信息下載到 ~/.cocoapods
目錄下郊霎,如果你等太久沼头,可以試著 cd
到那個(gè)目錄,用du -sh *
來(lái)查看下載進(jìn)度。你也可以參考本文接下來(lái)的使用 cocoapods 的鏡像索引
一節(jié)的內(nèi)容來(lái)提高下載速度进倍。
使用 Cocoapods 的鏡像索引
所有的項(xiàng)目的 Podspec 文件都托管在https://github.com/CocoaPods/Specs
土至。第一次執(zhí)行pod setup
時(shí),CocoaPods 會(huì)將這些podspec
索引文件更新到本地的 ~/.cocoapods/
目錄下猾昆,這個(gè)索引文件比較大陶因,有 80M 左右。所以第一次更新時(shí)非常慢垂蜗,筆者就更新了將近 1 個(gè)小時(shí)才完成楷扬。
一個(gè)叫 akinliu
的朋友在 gitcafe
和 oschina
上建立了 CocoaPods 索引庫(kù)的鏡像,因?yàn)?gitcafe 和 oschina 都是國(guó)內(nèi)的服務(wù)器么抗,所以在執(zhí)行索引更新操作時(shí)毅否,會(huì)快很多。如下操作可以將 CocoaPods 設(shè)置成使用 gitcafe 鏡像:
$ pod repo remove master
$ pod repo add master https://gitcafe.com/akuandev/Specs.git
$ pod repo update
將上面的
https://gitcafe.com/akuandev/Specs.git
替換為
https://git.oschina.net/akuandev/Specs.git
就可以使用oschina的鏡像
使用CocoaPods
1.在項(xiàng)目文件xxx.xcodeproj
同一目錄下創(chuàng)建Podfile
文件
$ cd 項(xiàng)目xxx.xcodeproj文件目錄
$ touch Podfile
2.使用vim命令編輯Podfile文件
$ sudo vim Podfile
3.按下i
插入要繼承的第三方框架
platform :ios
pod 'JSONKit', '~> 1.4'
pod 'Reachability', '~> 3.0.0'
pod 'ASIHTTPRequest'
pod 'RegexKitLite'
4.按下 ESC
退出編輯狀態(tài)
5.輸入wq
退出文件
6.執(zhí)行命令pod install
或者 pod upodate
7.成功后的命令圖片
現(xiàn)在蝇刀,你的所有第三方庫(kù)都已經(jīng)下載完成并且設(shè)置好了編譯參數(shù)和依賴螟加,你只需要記住如下 2 點(diǎn)即可:
使用 CocoaPods 生成的
.xcworkspace
文件來(lái)打開(kāi)工程,而不是以前的 .xcodeproj
文件吞琐。每次更改了
Podfile
文件捆探,你需要重新執(zhí)行一次pod update
命令。
pod 查找第三方庫(kù)
如果不知道 cocoaPods 管理的庫(kù)中站粟,是否有你想要的庫(kù)黍图,那么你可以通過(guò) pod search 命令進(jìn)行查找:
$ pod search AFNetworking