Cocoapods安装步骤:
1、升级Ruby环境
终端输入:$ gem update --system (注意 $号不用打)
此时会出现
ERROR: While executing gem ... (Gem::FilePermissionError)
You don't have write permissions for the /Library/Ruby/Gems/2.0.0 directory.
zijingMacBook-Pro:~ shiyunlei$ sudo gem update —system
这个是因为你没有权限去更新Ruby
这个时候你需要在终端使用如下命令:$ sudo gem update —system来进行升级
这个时候表示Ruby升级完成。(2016.11.2更新)可以通过ruby --version (当前最高2.2)来查看当前ruby版本 如果不是最新.最好下载一个RVM(表纠结是什么)他可以管理多个ruby(如果用不到的话.可以升级到最新的ruby)
$ curl -L https://get.rvm.io | bash -s stable 执行后各种敲回车...(有可能问你sudo权限.输入自己电脑密码即可)
然后加载$ source ~/.rvm/scripts/rvm
然后查看当前所有ruby版本$ rvm list known 可以查看所有的ruby版本.(当前最高是2.2)
升级ruby:$ rvm install 2.2
安装好之后.我们需要默认使用此版本:$ rvm 2.2 --default
记得打开另一个窗口查看一下当前的rvm版本 $rvm list 是否是2.2 有时候可能没默认上
2、安装CocoaPods时我们要访问cocoapods.org,该网站被我们天朝墙了,这样下载安装速度会特别慢,我们可以用(淘宝已经废弃)国内专门维护cocoapods的Ruby镜像来访问该网站(2016.11.2更新),方法如下:
1、gem sources --remove https://rubygems.org/ (如果以前安装过的.镜像不是这个.用gem sources查看一下在删除)
2、gem sources -a https://gems.ruby-china.org/
可以使用下面的命令(红色部分)查看是否更换镜像成功(如下图所示):
$ gem sources
3、安装Cocoapods,在终端输入命令
$ sudo gem install cocoapods
这个时候会提示你输入密码,注:在终端输入密码不会有提示,光标也不会移动,切记切记!!!!!!!!!
开始安装,如下图:PS:这个过程可能花费时间比较长
安装成功如下:
4、使用search命令搜索类库名:
$ pod search AFNetworking (此处举例为搜索AFNetworking)
如果CocoaPods支持,将会输出搜索到的所有类库版本和信息,以及在Podfile中配置的写法,终端返回信息如下:
-> AFNetworking (2.5.2)
A delightful iOS and OS X networking framework.
pod 'AFNetworking', '~> 2.5.2’(这个格式的文字是需要在下面编辑Podfile里面填写的,不同的类库搜索出来的是不一样的,建议复制一下)
- Homepage: https://github.com/AFNetworking/AFNetworking
- Source: https://github.com/AFNetworking/AFNetworking.git
- Versions: 2.5.2, 2.5.1, 2.5.0, 2.4.1, 2.4.0, 2.3.1, 2.3.0, 2.2.4,
2.2.3, 2.2.2, 2.2.1, 2.2.0, 2.1.0, 2.0.3, 2.0.2, 2.0.1, 2.0.0, 2.0.0-RC3,
2.0.0-RC2, 2.0.0-RC1, 1.3.4, 1.3.3, 1.3.2, 1.3.1, 1.3.0, 1.2.1, 1.2.0, 1.1.0,
1.0.1, 1.0, 1.0RC3, 1.0RC2, 1.0RC1, 0.10.1, 0.10.0, 0.9.2, 0.9.1, 0.9.0,
0.7.0, 0.5.1 [master repo]
- Sub specs: - AFNetworking/Serialization (2.5.2) -
AFNetworking/Security (2.5.2) - AFNetworking/Reachability (2.5.2) -
AFNetworking/NSURLConnection (2.5.2) - AFNetworking/NSURLSession (2.5.2)
- AFNetworking/UIKit (2.5.2)
-> AFNetworking+AutoRetry (0.0.5)
Auto Retries for AFNetworking requests
pod 'AFNetworking+AutoRetry', '~> 0.0.5'
- Homepage: https://github.com/shaioz/AFNetworking-AutoRetry
- Source: https://github.com/shaioz/AFNetworking-AutoRetry.git
- Versions: 0.0.5, 0.0.4, 0.0.3, 0.0.2, 0.0.1 [master repo]
5、需要在工程中创建一个Podfile文件
使用命令:
$ cd /Users/shiyunlei/Desktop/CocoapodsSample (进入工程目录,cd后面的是工程的路径,可直接将文件拖拽到终端)
$ touch Podfile (创建Podfile文件)
然后使用vim编辑Podfile文件,使用命令:
$ vim Podfile (也可以在工程中直接双击Podfile文件来打开,然后把上面搜索的类似于pod 'AFNetworking', '~> 2.5.2’的文字直接粘贴进去,然后直接跳到下面安装对应类库那一步)
进入如下界面
然后紧接着按键盘上的“i”键,变成如下状态(尾部为 INSERT),此时才是可编辑的,这个时候可以对Podfile文件进行编辑:
$ pod 'AFNetworking', '~> 2.3.1' (赋值刚才搜索到库的信息)
如果因为版本问题,可以最上面加上,表示使用此库必须在iOS7.0以上才行(即要求的有效最低版本)
platform :iOS ,'7.0'
在编辑完成后按“esc”,
这个时候直接按“:”,就会去底部,输入wq,点击回车,保存并退出。
这个时候我们打开工程里的Podfile文件就会看到里面添加了刚才在终端输入的一行语句,如下图
安装对应类库:然后在终端输入命令安装相应的第三方类库
$ pod install(貌似第一个命令被墙了,如果出现updating local specs repositories 长时间没有反应就用下面这个)
$ pod install --verbose --no-pepo-update(打不对的话就复制粘贴好了,-_-!)
因为这个过程需要下载相应的类库,所以时间和网速有关。
安装成功之后截图如下:
这个时候会看到之后打开工程都需要从类型为工程名.xcworkspace文件打开。
(2016.11.2更新)如果没成功.可能cocoapods的版本过低了.pod setup试一下.如果版本低会有这种显示
CocoaPods 1.2.0.beta.1 is available.
To update use: `sudo gem install cocoapods --pre`
[!] This is a test version we'd love you to try.
那就输入 sudo gem install cocoapods --pre来进行升级 就可以了
我们可以通过gem list --local | grep cocoapods来查看当前的cocoapods版本
如果出现(举例):
The dependency `FMDB (~>2.3)` is not used in any concrete target.
这个错误说明我们这个库没用指定工程的target(我看好多人查了半天也不知道.就是你项目的名字.英文注意大小写)
如果你的target填写错了...就会提示你:
Unable to find a target named 'XXX'
此时,我们CocosPods的首次安装就成功了.为什么说是首次呢?我们难道每次都要写辣么多辣么麻烦的指令吗?很显然:不用!!!
为了怕童鞋不懂,下面说一次第一次安装后调用的步骤:(煞费苦心中~~)
第一次安装后我们已经在工程里有了Podfile 文件了,所以我们只需要在其中添加库就可以了
核心:1.vim Podfile 编辑 2.pod install 执行 (候补:3.pod search 搜索库名)
1.每次添加库都需要先用vim Podfile 编辑(最好先用3.pod search 搜索库名,然后复制一下)
2.填好后就pod install 执行 我们就会发现在工程的Podfile文件中有了新加进去的库了.
只需反复两步,简单吧!
那么问题又来了,添加后如何删除呢?
删除某一个库:(有时候因为更新,造成不能使用,或者这个库不需要了.我们需要将它移除掉)
首先先看我们的.xcworkspace工程时存在刚成功导入的库的
两种方法:
一:
1.在Podfile文件里直接删除,或者版本更新高了.可以改成低版
2.在终端输入 cd到工程的地址,然后pod install执行
我们会发现已经没有了,说明删除成功
二:
1.在终端输入vim Podfile编辑,将pod 'AFNetworking', '~> 2.6.0' 变成#pod 'AFNetworking', '~> 2.6.0'
2.在终端输入 cd到工程的地址,然后pod install执行
我们会发现已经没有了,说明删除成功
在项目中移除CocoaPods
如果你觉得CocoaPods让你的项目出现了问题,不好用甚⾄是恶心,想将其从项目中
彻底移除,也有方法:
1.删除工程文件夹下的Podfile、Podfile.lock和Pods文件夹
2.删除xcworkspace文件。
3.打开xcodeproj文件,删除项目中的libpods.a和Pods.xcconfig引用:
4.打开Build Phases选项,删除Check Pods Manifest.lock和Copy Pods Resources:
好了.就到这里吧