一、全新安装前,先检查是否有安装残留
由于Mac 10.11更改了安全机制,所以cocoapods得安装和卸载命令也有所改变,
1、如果之前装过cocopods,最好先卸载掉,卸载命令:
$ sudo gem uninstall cocoapods【Mac 10.10之前】
$ sudo gem uninstall -n /usr/local/bin cocoapods【Mac 10.11之后】
2、先查看本地安装过的cocopods相关东西
命令如下:
$ gem list --local | grep cocoa pods
会显示如下:
cocoapods-core (0.39.0)
cocoapods-downloader (0.9.3)
cocoapods-plugins (0.4.2)
cocoapods-search (0.1.0)
cocoapods-stats (0.6.2)
cocoapods-trunk (0.6.4)
cocoapods-try (0.5.1)
然后逐个删除吧:
$ sudo gem uninstall cocoapods-core【Mac 10.10之前】
$ sudo gem uninstall -n /usr/local/bin cocoapods-core【Mac 10.11之后】
3、先把Mac隐藏文件夹显示出来,Mac隐藏和显示的命令如下:
$ defaults write com.apple.finder AppleShowAllFiles -bool true
$ defaults write com.apple.finder AppleShowAllFiles -bool false
4、退出终端,重启Finder
5、如果不确定,可以把主目录下的隐藏文件都给删了,重新安装Ruby和cocopods。(前往路径:/usr/local/bin)
备注:ruby最好不要轻易卸载!本人遇到的坑就是因为ruby升级到2.3之后和cocoapods不兼容的。
二、接下来安装总体步骤:Xcode—>home-brew—>rvm—>ruby—>cocopods
在安装CocoaPods之前要先配置好RUBY环境,本文就怎么安装RUBY的环境进行一总结。安装Ruby环境首先需要安装Xcode然后需要安装Homebrew,接下来需要安装RVM最后安装Ruby环境。安装XCode就不用说了,大家都会。
(Homebrew是一个包管理器,用于在mac上安装一些os x上没有的UNiX工具。Homebrew将这些工具统统安装到了 /usr/local/Cellar 目录中,并在 /usr/local/bin 中创建符号链接)
1.安装Homebrew
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
2.安装rvm
(RVM是一个命令行工具,可以提供一个便捷的多版本ruby环境的管理和切换)
$ curl -sSL https://get.rvm.io | bash -s stable
$ source ~/.rvm/scripts/rvm
检查一下是否安装正确
$ rvm -v
rvm 1.27.0 (latest) by Wayne E. Seguin, Michal Papis[https://rvm.io/]
3、用RVM安装Ruby环境
列出已知的ruby版本
$ rvm list known
可以选择现有的rvm版本来进行安装(以下就是2.3.0安装步骤)
$ rvm install 2.3.0
同样继续等待漫长的下载,编译过程,完成以后,Ruby, Ruby Gems 就安装好了。
另附:
查询已经安装的ruby以及默认的版本
$ rvm list
卸载一个已安装版本
$ rvm remove 2.2.0
1.设置Ruby版本。RVM 装好以后,需要执行下面的命令将指定版本的 Ruby 设置为系统默认版本
$ rvm use 2.3.0 --default
这个时候你可以测试是否正确
$ ruby -v
ruby 2.3.0p0 (2015-12-25 revision 53290) [x86_64-darwin15]
$ gem -v
2.6.3
2、准备工作
首先要切换到淘宝镜像服务器,不然下面各个步骤会很慢甚至没有进展,这有可能是因为Ruby的默认源使用的是cocoapods.org,国内访问这个网址有时候会有问题,网上的一种解决方案是将远替换成淘宝的。
查询:
$ gem source
可以查看当前是什么连接,然后替换方式如下:
$ gem source -r https://rubygems.org/
$ gem source -a https://ruby.taobao.org/
要想验证是否替换成功了,可以执行:
$ gem source
正常的输出结果:
CURRENT SOURCES
http://ruby.taobao.org/
到这里就已经把Ruby环境成功的安装到了Mac OS X上
安装cocopods
这里由于pod稳定版最新版是0.39,beta版是1.0.0beta.6,而ruby版本为2.3.0的时候安装cocoapods0.39之前的版本有问题,所以这里先安装beta版本来解决
(1)Mac 10.11之前版本命令:
$ gem install cocoapods(步骤有点慢,不要急)
$ pod setup(步骤有点慢,不要急)
(2)Mac 10.11之后版本命令【苹果系统升级 OS X EL Capitan 后】:
$ sudo gem install -n /usr/local/bin cocoapods --pre
$ pod setup
Terminal会停留在 Setting up CocoaPods master repo 这个状态一段时间,是因为要进行下载安装,而且目录比较大,需要耐心等待一下.如果想加快速度,可使用cocoapods的镜像索引.
Cocoapods的使用
进入工程所在的目录(工程根目录)
执行命令 touch Podfile
这句是说新建一个名为Podfile的文件(不能写成别的名字,也可以自己在工程根目录里面直接新建)
然后对改文件进行编辑,执行命令 open -e Podfile
第一次执行这个命令,会有一个空白文件打开,可以先放在一边,
Podfile文件的格式应该如下:
platform :ios, '7.0'
pod 'AMap2DMap', '~> 2.5.0'
pod 'AFNetworking', '~> 2.5.3'
pod 'SDWebImage', '~> 3.7.2'
需要注意的几点:platform那一行,ios三个字母都要小写,而且与前面的冒号之间不能有间隔,后面的版本号也可以不写,但是有些开源库对版本是有要求的,比如要在6.0以上才能运行,遇到这样的开源库就需要写上版本号。
platform下面就是Cocoapods需要集成的开源库,根据你的需要确定集成那些库。
举个例子:
我要集成AFNetworking这个库类,需要在Cocoapods里面先搜索是否有需要的库,可以在Terminal中输入:
pod search AFNetworking