2016最新cocoapods安装流程,安装过程中遇到的问题及解决方法
现在的cocoapods与之前比较。有很多不一样的地方。自己试了一试,终于搞定。现在大概纪录一下。
1.首先查看ruby是否是最新版的。
ruby是通过rvm安装的所以需要先安装rvm后查看ruby是否是最新的(通过查看ruby版本列表来判断),在终端需要中输入以下命令:
(1)安装RVM.RVM:Ruby Version Manager,即Ruby版本管理器,包括Ruby的版本管理和Gem库管理(gemset)
$ curl -L get.rvm.io | bash -s stable
等待一段时间后就可以成功安装好 RVM
$ source ~/.bashrc
$ source ~/.bash_profile
$ source ~/.profile
输出安装的版本号,测试是否安装正常
$ rvm -v
(2)用RVM升级Ruby
首先查看当前ruby版本
$ rvm reload
$ ruby -v
例如:ruby 2.2
列出已知的ruby版本 --找到最新的版本安装
$ rvm list known
已知最新版是2.3, 安装ruby 2. 3 ,注意版本号, 这里2.3.0是错误的
$ rvm install 2.3
2.CocoaPods的安装
(1)先检查ruby源,gem sources -l
正确情况下返回以下信息:
*** CURRENT SOURCES ***
https://gems.ruby-china.org
这个是ruby的官方源码,还有以下ruby源:
https://ruby.taobao.org/ 淘宝源
http://rubygems-china.oss.aliyuncs.com 阿里云源
淘宝的那个镜像(https://ruby.taobao.org/ )已经不可用了。官方的需要FQ。所以我们现在用最新支持的ruby镜像 (https://gems.ruby-china.org/)
确认ruby源镜像后就可以修改ruby源了,先执行删除原来的ruby源:
gem sources --remove https://ruby.taobao.org/
之后添加可用的ruby镜像源(推荐使用官方的)
gem sources -a https://gems.ruby-china.com/
这个时候执行gem sources -l命令,就能看到当前镜像源里只有官方ruby源这一个了
(2)更新升级gem,如果它的版本过低也可能导致安装失败,在终端输入以下命令:
$ sudo gem update --system
(3)安装CocoaPods:
OS X 10.11以前,在终端输入以下命令:
$ sudo gem install cocoapods
OS X 10.11以后,在终端输入以下命令:
$ sudo gem install -n /usr/local/bin cocoapods
更新cocoapods
$ sudo gem update cocoapods
$ sudo gem install -n /usr/local/bin cocoapods --pre //最新版本
更新CocoaPods到固定的某一个版本
$ sudo gem install -n /usr/local/bin cocoapods -v (版本号)//指定安装cocoaPods版本
3.初始化
在终端输入以下命令:
$ pod setup
问题最多的就是这一步,第一次安装完成可能要一个小时左右,所以要耐心等待.无需担心,这里可以查看下载的进度,通过新开一个终端窗口,输入"cd ~/.cocoapods/"命令行跳到cocoapods文件夹内,执行"du -sh *"查看文件夹的大小。
如果这一步完成了,那么恭喜你已经成功安装了CocoaPods。想知道自己有没有安装完成,可以在终端输入以下命令:
"pod --version",显示出版本就说明成功了。或者说在终端输入以下命令:“pod repo list”,结果为0 repos时说明安装不成功。
试过以上所有解决办法,还是没有安装成功。安装过程出错,则删除并重新(更新)所有的需要的环境:(ruby、gem、cocoapods、其中包括cocoapods的节点),替换新的ruby镜像即可
4.使用
通过CocoaPods来下载使用第三方类库,首先要检查CocoaPods是否支持目标类库,虽然大多数都是支持的,而且可以查看当前类库的最新版本信息,顺便检查是否成功安装CocoaPods。比如检查是否支持AFNetworking,执行命令“pod search AFNetworking”,即可看到相关信息。
首先定位到项目文件目录
$ cd 项目位置
然后添加podfile文件
$ vim podfile
进入后按i进入插入模式,进行编辑,安装官方最新的文档格式(直接复制粘贴,改项目名称):
platform :ios, '8.0'
target '你的项目名称' do
pod 'AFNetworking', '~> 3.0'
//可以连续pod多个第三方
// pod 'B','版本'...
end
编辑完成后,按ESC退出编辑模式,最后输入:wq保存并退出文件,此时可以发现在项目目录下多了一个Podfile的文件,请注意这个文件必须与.xcodeproj在同一目录下,
最后注意还需要:pod install / pod update进行安装即可。
参考来自:http://www.cnblogs.com/guanshenbao/p/5534578.html
上述过程遇见的问题
在安装的时候,若是出现:
1.You don't have write permissions for the /Library/Ruby/Gems/2.0.0 directory.
就在命令前加一个sudo获得管理员权限,eg: sudo gem install bundler
2.Error installing rails:activesupport requires Ruby version >= 2.2.2.
macOS 自身已经安装了 Ruby 了,版本应该比较低的,直接按照上面命令安装,会提示 Ruby 版本不够的错误信息,可以参考上面的方法进行更新,还有需要注意输入版本号的正确性,eg:rvm install 2.3是正确的,而rvm install 2.3.0是错误的。
附增常见错误的解决方法:http://blog.csdn.net/wangyanchang21/article/details/51437934
http://www.jianshu.com/p/0e3421961db4
http://www.cnblogs.com/yujidewu/p/6125218.html
降低cocoapods版本的方法:http://www.jianshu.com/p/d2ac601f8b3b