一.CocoaPods 的安装
目前CocoaPods 的最新版本为1.0,于2016年5月10号发布的
1.替换ruby源 (简单来说就是更换ruby的镜像环境,翻墙到我们指定的环境中才能安装CocoaPods)
ruby -v 查看ruby 版本
$ ruby -v
ruby 2.0.0p648 (2015-04-13 revision 50295) [x86_64-darwin14]
gem sources -l 查看ruby源
$ gem sources -l
*** CURRENT SOURCES ***
https://rubygems.org/
https://rubygems.org/ 这个源在墙内无法访问到,所以更换到 https://gems.ruby-china.com
中
移除原有的源:
gem sources --remove https://rubygems.org/
添加新的源:
gem source -a https://gems.ruby-china.com
验证更换是否成功:
gem sources -l 成功则显示:
*** CURRENT SOURCES ***
https://gems.ruby-china.com
2.更新gem版本:(gem是管理Ruby的标准包,他的版本低的话,也无法安装CocoaPods)
gem -v : 查看gem的版本
2.4.8
sudo gem update --system // 更新gem版本,国内的需要切换ruby源
3.开始安装CocoaPods
安装命令为:
如果是OS X 10.11 以前安装命令为:(这个没使用过)
sudo gem install cocoapods
如果是Mac系统为OS X EL Capitan 用下面的命令(就用这个,其他测试不可行)
sudo gem install -n /usr/local/bin cocoa pods
执行以上命令有时候会报:
Error installing cocoapods: activesupport requires Ruby version >= 2.2.2,
详见第三点:三.CocoaPods 的常见坑(错误)
4.卸载CocoaPods 方法(没有用过)
sudo gem uninstall cocoa pods
终于成功了,别着急,输入:
pod --version 查看CocoaPods有没有安装成功
1.1.1
执行以下命令把cocoa pods 的所有第三方库索引引到本地
pod setup(慢慢的等待吧,目前是365M的大小,切记不要关闭终端)
打开新的终端:
cd ~/.cocoapods/repos (进入这个目录)
du -sh (查看下载进度)等待完成吧!
不要偷懒要什么镜像会加快速度,亲测不可以的!
二.CocoaPods 的使用
1.新建一个Xcode项目工程
如以我建的TestCocopods为例进行讲解:
2.新建Podfile文件
cd /Users/XXXuser/Documents/Example/TestCocopods(进入到对应的文件目录中)
touch Podfile (新建Podfile文件必须用Podfile命名,不要问我为什么)
3.编辑Podfile文件
用Xcode打开Podfile 文件夹,键入以下的代码
注意以下我写的“//”注释不要复制到里面去
platform :ios, '8.0'// 引用1解释
inhibit_all_warnings!
project 'TestCocopods'// 引用2解释
workspace 'TestCocopods'// 引用3解释
use_frameworks!
target 'TestCocopods' do// 引用4解释
pod 'AFNetworking', '~> 3.1.0'// 引用5解释
end
引用1解释:8.0代表引用的平台的最低版本,不写默认为iOS版本为4.3,所以必须写的
引用2解释:
引用3解释:
引用4解释:
2和3和4解释都是我当前引用的工程文件的名称
引用5解释:引用的第三方库名和版本(Cocopods 版本1.0之后必须写上所引用第三方库的版本)
可以用 pod search 库名 可以查看该库是否存在以及最新的版本等
注意点:Podfile的编辑,第一次最好用Xcode打开,后续修改可以直接用文本编辑器或者vi命令修改
4.进入项目根目录中,执行 pod install 命令
cd /Users/XXXuser/Documents/Example/TestCocopods(进入到对应的文件目录中)
pod install (如此CocoaPods 的第三方库的集成基本完毕)
关闭终端,关闭工程,打开下面图片所示的图片:
愉快的引用第三方库吧!
三.CocoaPods 的常见坑(错误)
神坑一:安装CocoaPods 的时候 执行
sudo gem install -n /usr/local/bin cocoa pods
报如下的错误:Error installing cocoapods: activesupport requires Ruby version >= 2.2.2.
错误原因:ruby 的版本比较低造成安装失败,应该这样执行用RVM升级ruby
$curl -L get.rvm.io | bash -s stable
//等待安装成功后,出现下面的提示
In case of problems: https://rvm.io/helpandhttps://twitter.com/rvm_io
依次执行以下命令
$source ~/.bashrc
$source ~/.bash_profile
rvm -v
//出现
rvm 1.28.0 (latest) by Wayne E. Seguin <wayneeseguin@gmail.com>, Michal Papis <mpapis@gmail.com> [https://rvm.io/]
如此RVM升级ruby版本完毕
$ruby -v // 查看ruby版本
$rvm list known
//出现好长的提醒,执行以下命令:
rvm install 2.2.2 // 安装ruby 2.2.2 版本的命令
如此继续执行:
sudo gem install -n /usr/local/bin cocoa pods
安装CocoaPods
其他神坑暂未碰到,没有发言权!
四.CocoaPods 的常用快捷键
以下来源大牛的总结:
pod setup
将所有第三方的Podspec索引文件更新到本地的~/.cocoapods/repos目录下,更新本地仓库。pod repo update
执行 pod repo update更新本地仓库,本地仓库完成后,即可搜索到指定的第三方库,作用类似pod setup。不过这个命令经常不单独调用。比如执行pod setup、pod search、pod install、pod update会默认执行pod repo updatepod search xxx
查找某一个开源库。查找开源库之前,默认会执行pod repo update指令pod list
列出所有可用的第三方库.现在已经2.4W+了.还在不断地增长pod install
会根据Podfile.lock文件中列举的版本号来安装第三方框架
如果一开始Podfile.lock文件不存在, 就会按照Podfile文件列举的版本号来安装第三方框架
安装开源库之前, 默认会执行pod repo update指令
- pod update
将所有第三方框架更新到最新版本, 并且创建一个新的Podfile.lock文件
安装开源库之前, 默认会执行pod repo update指令
- pod install –no-repo-update
- pod update –no-repo-update
安装开源库之前, 不会执行pod repo update指令
参考资料:
CocoaPods的使用教程比较牛:http://ios.jobbole.com/90957/?utm_source=blog.jobbole.com&utm_medium=relatedPosts
CocoaPods的常见神坑与错误:http://www.jianshu.com/p/ad98a3364803