CocoaPod安装牛程
一, CocoaPods 介绍
CocoaPods 是 iOS 最常用的第三方类库管理工具,绝大部分有名的开源类库都支持 CocoaPods。
CocoaPods 是用 ruby 实现的,要想使用它首先需要有 ruby 的环境。
在OS X系统默认已经可以运行 ruby。但 ruby 版本过低是无法正常支持 CocoaPods 的使用,所以需要先安装更新升级 rvm 和 ruby。
二, 安装流程
第1步.
检查是否存在rvm环境, 打开终端输入
$ rvm -v ```
如果存在rvm环境 返回信息:
rvm 1.27.0 (latest) by Wayne E. Seguin wayneeseguin@gmail.com, Michal Papis mpapis@gmail.com [https://rvm.io/]
不存在则出现:
-bash: rvm: command not found
如果不存在rvm,先安装配置rvm,输入:
$ curl -L https://get.rvm.io | bash -s stable
安装完成后载入rvm:
$ source ~/.rvm/scripts/rvm
####第2步.
确定已安装rvm并载入rvm环境后,下一步检查ruby 版本环境:
OS X系统默认存在ruby,但版本低于2.2.2,安装会出错,所以先检查其版本
$ sudo gem -v
低于2.6.x的建议更新到最新:
$ gem update --system
返回更新成功信息:
Updating rubygems-update
Fetching: rubygems-update-2.6.7.gem (100%)
Successfully installed rubygems-update-2.6.7
######补充指令
*查询已安装的 ruby:*
$ rvm list
*卸载一个已安装版本:*
$ rvm remove 1.9.2
*修改默认使用的ruby版本*
$ rvm use 2.3.0 --default
---
####第3步.
由于淘宝的镜像 (https://ruby.taobao.org/ )已经不可用了。
所以接下来我们用最新支持的ruby镜像 (https://gems.ruby-china.org/)
首先检查电脑目前的镜像:
$ gem sources -l
如果电脑没安装过CocoaPods,默认的应该是https://rubygems.org/
*** CURRENT SOURCES ***
https://rubygems.org/
输入移除命令:
$ gem sources --remove https://rubygems.org/
返回移除成功:
https://rubygems.org/ removed from sources
添加国内镜像 https://gems.ruby-china.org 输入:
$ gem sources --add https://gems.ruby-china.org
成功后返回信息:``https://gems.ruby-china.org added to sources``
确认当前ruby源:
$ gem sources -l
返回信息:
*** CURRENT SOURCES ***
https://gems.ruby-china.org //已经添加
##三,安装CocoaPods
####第1步.
如果系统版本是10.11.x 输入这行命令:
$ sudo gem install -n /usr/local/bin cocoapods
否则输入:
$ sudo gem install cocoapods
注意:当系统升级10.11 后,输入pod命令会出现
``-bash: pod: command not found``
解决方法就是输入下面这一行命令就可以了:
$ sudo gem install -n /usr/local/bin cocoapods
接着$pod setup:
$ pod setup
提示:如果终端一直停留在``Settng up CocoaPods master repo``这个状态,是因为要进行下载安装,文件比较大,此时你可通过新开一个终端窗口,输入``cd ~/.cocoapods/``命令行跳到cocoapods文件夹内,执行``du -sh *``查看正在下载的文件夹的大小。
下载完成最后返回显示 ``Setup completed``
当出现如下:
[!] An error occurred while performing [Git](http://lib.csdn.net/base/git) pull
on repo master
.
[!] /usr/bin/git pull --ff-only
原因: Cocoapods的分支不支持当前最新的Xcode版本
解决办法: 删除master分支 重新建立新的分支
``sudo rm -fr ~/.cocoapods/repos/master``
然后再: pod setup
####第2步.
用xcode新建一个project(例如:CocoaPodsTestDemo),并在终端用cd到工程文件夹目录(具体操作:终端输入cd+空格+工程文件夹直接拖拽到终端+回车)
查找所需第三方库的最新版本例如:AFNetworking,输入指令:
$ pod search 'AFNetworking' //(退出搜索按 :wq )
####第3步.
vim Podfile 配置文件
$ vim Podfile
写入以下内容并保存 ( 提示:终端vim文件 按 i 进入编辑模式 ,esc 退出编辑模式(如果esc没反应,control+c也可以退出编辑状态),退出编辑模式以后按 :wq 可保存并退出Podfile)
Uncomment this line to define a global platform for your project
platform :ios, '8.0'
target 'CocoaPodsTestDemo' do
Uncomment this line if you're using Swift or would like to use dynamic frameworks
Pods for CocoaPodsTestDemo
pod 'AFNetworking', '~>3.1.0'
pod 'SDWebImage'
pod 'FMDB'
pod 'Masonry'
pod 'MJRefresh'
use_frameworks!
pod 'ReactiveCocoa'
end
备注:platform那一行,ios三个字母都要小写,而且与前面的冒号之间不能有间隔,后面的版本号也可以不写,但是有些开源库对版本是有要求的,比如要在6.0以上才能运行,遇到这样的开源库就需要写上版本号
####第4步.
保存退出Pofile后
下载第三方库文件到项目工程中:
$ pod install
####第5步.
打开CocoaPodsTestDemo.xcworkspace
打开Pod文件里面就是下载的库
![](https://img.haomeiwen.com/i3252527/cb529ba321ef0903.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/300)
Done。
>使用说明:
>1.从此以后需要使用Cocoapods生成的 .xcworkspace文件来打开工程,而不是使用以前的.xcodeproj文件。
>2.每次更改了Podfile文件,都需要重新执行一次pod update命令。
>备注:当执行pod install之后,除了Podfile,还会生成一个名为Podfile.lock的文件,它会锁定当前各依赖库的版本,之后即使多次执行pod install也不会更改版本,只有执行pod update才会改变。Podfile.lock.在多人协作的时候,这样可以防止第三方库升级时候造成大家各自的第三方库版本不一致。所以在提交版本的时候不能把它落下,也不要添加到.gitignore中。