CocoaPods是一个用来管理第三方库的比较好用的管理工具。只需要我们做好少量的配置工作,CocoaPods会为我们做好一切,将三方库更新到最新的版本。
一、安装:
CocoaPods可以方便地通过Mac自带的RubyGems安装。
1、打开Terminal,然后输入以下命令:$ sudo gem install -n /usr/local/bin cocoapods
备注:苹果系统升级 OS X EL Capitan(版本10.11.3) 后安装改为: $ sudo gem install -n /usr/local/bin cocoapods ,10.11之前用$ sudo gem install cocoapods。
执行完这句如果报告以下错误:
ERROR: Could not find a valid gem 'cocoapods' (>= 0), here is why:
Unable to download data from https://rubygems.org/ - Errno::ETIMEDOUT: Operation timed out - connect(2)(https://rubygems.org /latest_specs.4.8.gz)
ERROR: Possible alternatives: cocoapods
这时需要需要更新一下ruby的源(原因:被墙了),将ruby的镜像rubygems.org指向淘宝,输入以下命令:
2.$ gem sources -l (查看当前ruby的源)
移除现有 Ruby 默认源
$ gem sources --remove https://rubygems.org/
将Ruby源指向淘宝镜像
$ gem sources -a https://ruby.taobao.org/
$ gem sources -l
3、如果gem版本太老,可以尝试用如下命令升级gem
$ sudo gem update --system
升级成功后会提示: RubyGems system software updated,如图:
4、检查pod 是否安装
$ pod --version 在这里能检测到版本就代表已经安装
如果出现pod: command not found,说明还没有安装pod
如果已安装想要重新安装,输入以下命令卸载pod:$ sudo gem uninstall cocoapods
5、然后执行安装下载命令
$ sudo gem install -n /usr/local/bin cocoapods
这里可能会报错,activesupport requires Ruby version >= 2.2.2.
更新Ruby环境,这里使用rvm对Ruby进行升级。
安装rvm,RVM:Ruby Version Manager,Ruby版本管理器,包括Ruby的版本管理和Gem库管理(gemset)
a、终端输入:$ curl -L get.rvm.io | bash -s stable
b、依次输入以下命令:
$ source ~/.bashrc
$ source ~/.bash_profile
$ source ~/.profile
$ rvm -v
如果出现下面的提示:
A RVM version 1.27.0 (latest) is installed yet 1.25.23 (stable) is loaded.
Please do one of the following:
* 'rvm reload'
* open a new shell
* 'echo rvm_auto_reload_flag=1 >> ~/.rvmrc' # for auto reload with msg.
* 'echo rvm_auto_reload_flag=2 >> ~/.rvmrc' # for silent auto reload.
输入以下命令,若没有上面的提示,则直接跳过本步骤
$ rvm reload
$ rvm -v
c、查看当前ruby版本 ,获取rvm 列表
$ ruby -v
$ rvm list known
d、安装Ruby
$ rvm install 2.3
出现Install of ruby-2.3.0 - #complete ,说明ruby2.3.0已经安装完成了。
e、再次使用:$ sudo gem install -n /usr/local/bin cocoapods ,这里会提示输入密码,出现如下界面:
6、接下来进行安装,执行:
$ pod setup
Terminal会停留在 Setting up CocoaPods master repo 这个状态一段时间,是因为要进行下载安装,而且目录比较大,需要耐心等待一下。(说明Cocoapods在将它的信息下载到 ~/.cocoapods里,$ cd ~/.cocoapods 到该目录里,用$ du -sh *命令来查看文件大小,每隔一段时间查看一次,我的这个目录最终大小是786M)
安装成功后会出现下面的界面,说明安装成功了。
二、使用:
1、新建一个项目,在终端cd到该项目的根目录下,使用$ vim Podfile ,新建一个名为Podfile的文件,在键盘上按 i 进入编辑模式,如图:
pod版本1.0.1以后,需要输入以下格式,并添加需要的库并保存,这里是MBProgressHUD:
platform :ios,'8.0'
target '项目名' do
pod 'MBProgressHUD', '~> 1.0.0'
end
按esc键退出编辑模式,然后按住shift键,并且输入“ :”号进入vim命令模式,然后在冒号后边输入wq,回车,退出编辑。
2、终端输入:$ pod install ,等几分钟后就会出现下面的界面:
到这里就说明项目里已经添加了pod,重新打开项目的目录会看到多出一个PodTest.xcworkspace文件,现在打开项目不是点击 PodTest.xodeproj了,而是点击 PodTest.xcworkspace。项目结构就会变为:
3、如果需要导入多个三方库只需在终端cd到项目根目录,再次使用 $ vim Podfile ,编辑之前的Podfile文件,修改完了Podfile文件,需要重新执行一次pod install命令。
4、补充:
使用:$ pod search <三方库名> 来查找最新的三方库,如:$ pod search AFNetWorking
拷贝圈中代码,按 q 退出,cd到项目目录,使用$ vim Podfile ,添加pod 'AFNetworking', '~> 3.1.0' ,重新执行一次pod install命令,就可以将最新的库添加到项目中。