CocoaPods是我們?cè)贗OS開發(fā)中必不可少的管理第三方框架的工具胳徽。CocoaPods的安裝時(shí)步驟比較簡(jiǎn)單,但是在安裝的過(guò)程中以及使用中總是遇到很多蛋疼的問(wèn)題魂角,這里紀(jì)錄我安裝過(guò)程中遇到的很多問(wèn)題以及處理方式辐怕。
現(xiàn)在的CocoaPods版本是1.0.1,需要Ruby的版本2.3澈蝙,Ruby是OSX自帶的吓坚。
1.查看Ruby的版本 ? ??
$ ruby -v
控制臺(tái)顯示信息
ruby 2.3.0p0 (2015-12-25 revision 53290) [x86_64-darwin15]
如果你的Ruby的版本在2.3版本以上,則跳過(guò)Ruby升級(jí)灯荧,直接安裝CocoaPods
2.升級(jí)Ruby
2.1安裝 RVM ? ------RVM:Ruby Version Manager,Ruby版本管理器礁击,包括Ruby的版本管理和Gem庫(kù)管理(gemset)
$ curl -L get.rvm.io | bash -s stable
等待一段時(shí)間后執(zhí)行
$ source ~/.bashrc
$ source ~/.bash_profile
檢查是否安裝成功
$ rvm -v
顯示一下結(jié)果,則安裝成功了
rvm 1.27.0 (latest) by Wayne E. Seguin, Michal Papis[https://rvm.io/]
2.2使用RVM升級(jí)Ruby
列出已知的Ruby版本
$ rvm list known
安裝Ruby2.3 ---[ruby-]2.3[.0]
$ rvm install 2.3
檢查是否安裝成功
$ ruby -v
3.安裝Cocoapods
3.1 remove現(xiàn)有的ruby默認(rèn)源逗载, 因?yàn)檫@個(gè)網(wǎng)址https://rubygems.org/國(guó)內(nèi)不能訪問(wèn)
$gem sources --remove https://rubygems.org/
3.2 使用taobao的源可以去訪問(wèn)
$gem sources -a https://ruby.taobao.org/
3.3 驗(yàn)證新源是否替換成功
$gem sources -l
出現(xiàn)下面的信息哆窿,則添加成功了
*** CURRENT SOURCES ***
https://ruby.taobao.org
如果沒(méi)有添加成功,則嘗試下面指令添加 (這個(gè)問(wèn)題遇到了厉斟,并且是這樣解決的)
$ sudo ?gem sources -a https://ruby.taobao.org/
3.4 安裝CocoaPods
$ sudo gem install cocoapods
如果出現(xiàn)下面錯(cuò)誤
ERROR:? While executing gem ... (Errno::EPERM)
? ? ? ?Operation not permitted - /usr/bin/xcodeproj
則使用下面的方式安裝
$ sudo gem install -n /usr/local/bin cocoapods
又是后gem指令版本低也會(huì)造成安裝的不成功
更新gem的指令
$ sudo gem update --system
3.5更新資源庫(kù)(等待的很長(zhǎng)的一段時(shí)間)
$ pod setup
在執(zhí)行這一步驟的時(shí)候挚躯,如果網(wǎng)路不太好的,可以直接拷貝其他人安裝好的資源庫(kù)擦秽÷肜螅拷貝路徑/Users/zyn/.cocoapods/repos下的master文件夾到你的這個(gè)路徑下的文件夾下面即可。
3.6 測(cè)試一下是否安裝成功了
$ pod search AFNetworking
4.使用cocoaPods集成第三方框架到項(xiàng)目中
4.1先創(chuàng)建一個(gè)項(xiàng)目CocoaPodsTest
然后在在控制臺(tái)cd到項(xiàng)目的文件夾下
$ cd /Users/zyn/Desktop/CocoaPodsTest
在控制臺(tái)輸入命令
$ pod init
這個(gè)時(shí)候會(huì)生成Profile文件感挥,如下截圖
使用xcode打開Profile文件,并且修改文件內(nèi)的信息如下
platform :ios, '8.0'
target 'CocoaPodsTest' do
pod 'AFNetworking'
end
保存目胡,然后在控制臺(tái)輸入命令
$pod install
等一點(diǎn)時(shí)間后,就可以了链快,會(huì)生成工作空間文件,打開工作空間.xcworkspace文件就好了眉尸。
5.遇到的問(wèn)題
5.1 安裝完成后會(huì)出現(xiàn)在搜索第三方庫(kù)的時(shí)候域蜗,搜索到的資源不全的問(wèn)題,卻少一些資源庫(kù)噪猾。遇到這種問(wèn)題的第一個(gè)解決方案就是升級(jí)資源庫(kù)
$ pod setup
如果還是不能解決問(wèn)題霉祸,則嘗試下面的方式(我的是這樣解決的)
rm ~/Library/Caches/CocoaPods/search_index.json
5.2 出現(xiàn)“cannot load such file – cocoapods-core (LoadError)”或者怎么安裝都顯示“-bash: pod: command not found”
解決辦法:卸載重裝
$ sudo gem uninstall cocoapods
6.0在swift項(xiàng)目中
6.1出現(xiàn)下列問(wèn)題,則需要在Profile文件中添加上use_frameworks!
[!] Pods written in Swift can only be integrated as frameworks; add `use_frameworks!` to your Podfile or target to opt into using it. The Swift Pods being used are: Alamofire, Kingfisher, and SnapKit