〇、前言

在iOS开发中 [CocoaPods](https://github.com/CocoaPods/CocoaPods) 作为库依赖管理工具就是一把利器。

有了 CocoaPods 则无需再通过拖 第三方库 及第三方库所依赖的 framework 静态库到项目中等麻烦的操作，仅仅只需要通过终端（Terminal）输入一些指令即可完成这些操作；而且涉及到第三方库的更新升级也可以通过 CocoaPods 进行手动管理更新。

方便快捷！赶快行动起来吧！！！

一、Homebrew、Rvm、Ruby、CocoaPods 简介

1、官网及相关链接

Rvm 官网 ： https://www.rvm.io/ Ruby 官网 ：https://rubygems.org/ CocoaPods 官网 ：https://cocoapods.org/ Rvm 安装指南 ：https://rvm.io/rvm/install Homebrew 官网 ：http://brew.sh/index_zh-cn.html ruby 镜像 - taobao：https://ruby.taobao.org/ ruby 镜像 - china：https://gems.ruby-china.org/

2、Homebrew 介绍
- Homebrew 是一个软件包管理器，用于在mac上安装一些os x上没有的UNiX工具；类似于360软件管理器。
3、Rvm 介绍
- Rvm 全称 Ruby Version Manager ，是安装和管理 ruby 的一种工具。
- 摘录：RVM is a command-line tool which allows you to easily install, manage, and work with multiple ruby environments from interpreters to sets of gems.
4、Ruby 介绍
- Ruby 是一种面向对象的脚本语言，简单易用，功能强大。能跨平台和可移植性好等等。其实就是种脚本语言。
- Ruby 的软件源使用的是亚马逊的云服务，国内网络环境下载时可能会出现各种不稳定和超时，所以自带的需要翻墙，可以将 官方 ruby 源 替换成国内 淘宝 ruby 源（ruby.taobao.org/ ）或者是由 China ruby 源 （gems.ruby-china.org/ ）。据消息了解，2016.06 淘宝源 暂停维护了，建议使用 China ruby 源。
5、CocoaPods 介绍
- CocoaPods 是 iOS 最常用的第三方类库管理工具，绝大部分有名的开源类库都支持 CocoaPods。
- CocoaPods 是用 ruby 实现的，要想使用它首先需要有 ruby 的环境。幸运的是OS X系统默认已经可以运行 ruby 了。但是有时候 ruby 版本过低是无法正常支持 CocoaPods 的使用，所以需要先安装更新升级 rvm 和 ruby。

二、CocoaPods 安装使用

1、检查安装 rvm 环境（正常情况可直接略过此步骤）
- 检查当前 rvm 环境（此处检查是否存在 rvm 环境）：

$ rvm -v
复制代码

复制代码

输出结果：（存在 rvm 环境） muxuguixiandeMacBook-Pro:~ jijiucheng$ rvm -v rvm 1.27.0 (latest) by Wayne E. Seguin wayneeseguin@gmail.com, Michal Papis mpapis@gmail.com [https://rvm.io/]

复制代码

输出结果：（不存在 rvm 环境） muxuguixiandeMacBook-Pro:~ jijiucheng$ rvm -v -bash: rvm: command not found

- **情况一**：如果不存在 `rvm` 环境，先安装配置 `rvm` 环境；
复制代码

① 期间可能会问你 sudo管理员 密码，以及自动通过 homebrew 安装依赖包；等待一段时间后就可以成功安装好 rvm。

复制代码

$ curl -L https://get.rvm.io | bash -s stable

>```
输出结果：（下载安装）（显示的 `` 代表一行空格）
muxuguixiandeMacBook-Pro:~ jijiucheng$ curl -L https://get.rvm.io | bash -s stable% Total    % Received % Xferd  Average Speed   Time    Time     Time  Current Dload  Upload   Total   Spent    Left  Speed
100   184  100   184    0     0     93      0  0:00:01  0:00:01 --:--:--    93
100 22865  100 22865    0     0   8964      0  0:00:02  0:00:02 --:--:--  710k
Downloading https://github.com/rvm/rvm/archive/1.27.0.tar.gz
Downloading https://github.com/rvm/rvm/releases/download/1.27.0/1.27.0.tar.gz.asc
Found PGP signature at: 'https://github.com/rvm/rvm/releases/download/1.27.0/1.27.0.tar.gz.asc',
but no GPG software exists to validate it, skipping.
``
`Installing RVM to /Users/smalllufeinj/.rvm/`Adding rvm PATH line to /Users/smalllufeinj/.profile /Users/smalllufeinj/.mkshrc /Users/smalllufeinj/.bashrc /Users/smalllufeinj/.zshrc.Adding rvm loading line to /Users/smalllufeinj/.profile /Users/smalllufeinj/.bash_profile /Users/smalllufeinj/.zlogin.
`Installation of RVM in /Users/smalllufeinj/.rvm/ is almost complete:`
``.* To start using RVM you need to run `source /Users/smalllufeinj/.rvm/scripts/rvm`in all your open shell windows, in rare cases you need to reopen all shell windows.
``
# muxuguixian,
#
#   Thank you for using RVM!
#   We sincerely hope that RVM helps to make your life easier and more enjoyable!!!
#
# ~Wayne, Michal & team.
``
In case of problems: https://rvm.io/help and https://twitter.com/rvm_io
复制代码

```
复制代码
```

② 然后，载入 RVM 环境（新开 Termal 就不用这么做了，会自动重新载入的）。

复制代码

$ source ~/.rvm/scripts/rvm

>```
输出结果：（^_^）（什么都没有输出）
muxuguixiandeMacBook-Pro:~ jijiucheng$ source ~/.rvm/scripts/rvm
复制代码

```
复制代码
```

③ 再次检查 rvm 是否安装正确。

复制代码

$ rvm -v

>```
`输出结果：（ 存在 rvm 环境）`
muxuguixiandeMacBook-Pro:~ jijiucheng$ rvm -v
rvm 1.27.0 (latest) by Wayne E. Seguin <wayneeseguin@gmail.com>, Michal Papis <mpapis@gmail.com> [https://rvm.io/]
复制代码

情况二：如果存在 rvm 环境，用 rvm 安装 ruby 环境；
当 ruby 版本低于 2.2.2 时，安装 CocoaPods 会报错；为防止 ruby 版本过低，建议先升级 ruby 环境，建议升级到 2.3.0 版本以上。【可以通过 $ ruby -v 指令检查当前 ruby 版本】

  ① 查询已知的 ruby 环境。
复制代码

$ rvm list known
复制代码

复制代码

输出结果：（显示的 `` 代表一行空格） muxuguixiandeMacBook-Pro:~ jijiucheng$ rvm list known

MRI Rubies

[ruby-]1.8.6[-p420] [ruby-]1.8.7[-head] # security released on head [ruby-]1.9.1[-p431] [ruby-]1.9.2[-p330] [ruby-]1.9.3[-p551] [ruby-]2.0.0[-p648] [ruby-]2.1[.8] [ruby-]2.2[.4] [ruby-]2.3[.0] [ruby-]2.2-head ruby-head ``

for forks use: rvm install ruby-head- --url https://github.com/github/ruby.git --branch 2.2

JRuby

jruby-1.6[.8] jruby-1.7[.23] jruby[-9.0.5.0] jruby-head ``

Rubinius

rbx-1[.4.3] rbx-2.3[.0] rbx-2.4[.1] rbx[-2.5.8] rbx-head ``

Opal

opal ``

Minimalistic ruby implementation - ISO 30170:2012

mruby[-head] ``

Ruby Enterprise Edition

ree-1.8.6 ree[-1.8.7][-2012.02] ``

GoRuby

goruby ``

Topaz

topaz ``

MagLev

maglev[-head] maglev-1.0.0 ``

Mac OS X Snow Leopard Or Newer

macruby-0.10 macruby-0.11 macruby[-0.12] macruby-nightly macruby-head ``

IronRuby

ironruby[-1.1.3] ironruby-head

![查询已知的 ruby 环境 .png](http://upload-images.jianshu.io/upload_images/711060-1368757fe3502d2d.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)- ```
② 指定 ruby 版本进行更新（ 此处按照 ruby 2.3.0 版本进行更新 ）。
复制代码

$ rvm install 2.3.0
复制代码

复制代码

输出结果：（此处因为终端输出的字符过多，所以此处用截图方式）

![指定 ruby 版本进行更新 .png](http://upload-images.jianshu.io/upload_images/711060-7befae589754d80a.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)- ```
③ 第二步需要一段时间等待，完成后此时 rvm 环境就配置好了；Ruby Gems 就安装好了。
复制代码

④ 补充相关指令：
复制代码

查询已安装的 ruby：

$ rvm list
复制代码

卸载一个已安装版本：

$ rvm remove 1.9.2
复制代码

2、检查更新 ruby 版本环境（正常情况下从此步骤开始）
- CocoaPods 是用 gem ruby 实现的，要想使用它首先需要有 gem ruby 的环境。且 MAC 的 OS X系统默认已经可以运行 ruby 。
- 此处建议 gem ruby 包环境升级到 2.6.x 以上。
- 检查 gem ruby 版本号：

$ sudo gem -v
复制代码

复制代码

检查结果：（默认情况下版本应该较低，建议升级到） muxuguixiandeMacBook-Pro:local jijiucheng$ gem -v 2.5.1

- 更新 `gem ruby` 版本号：
复制代码

$ gem update --system

> ```
更新成功：（ 实际打印可能与此不同，但是成功了就会显示 Successfully ）
muxuguixiandeMacBook-Pro:local jijiucheng$ gem update --system
Updating rubygems-update
Fetching: rubygems-update-2.6.7.gem (100%)
Successfully installed rubygems-update-2.6.7
复制代码

此种提示：（ 表示已经是最新的 gem ruby 环境 ）
muxuguixiandeMacBook-Pro:~ jijiucheng$ gem update --system
Latest version currently installed. Aborting.
复制代码

检查 ruby 源

$ gem sources -l
复制代码

复制代码

检查结果：（如果电脑没安装过 CocoaPods，此时应该是默认 ruby 源） muxuguixiandeMacBook-Pro:~ jijiucheng$ gem sources -l *** CURRENT SOURCES *** https://rubygems.org/

- 移除 `ruby 源`
复制代码

$ gem sources --remove https://rubygems.org/

>```
移除结果：
muxuguixiandeMacBook-Pro:local jijiucheng$ gem sources --remove https://rubygems.org/
https://rubygems.org/ removed from sources
复制代码

替换添加国内镜像源 ruby-china 源，因为上面已经提到国内镜像源 taobao 源 已经停止维护了，所以此处替换的是 ruby-china 源，且尽量确保只有一个 ruby-china 源

$ gem sources --add https://gems.ruby-china.org
复制代码

复制代码

替换结果： muxuguixiandeMacBook-Pro:local jijiucheng$ gem sources --add https://gems.ruby-china.org https://gems.ruby-china.org added to sources

复制代码

再次检查此时的 ruby 源：（已经变成了 ruby-china 源） muxuguixiandeMacBook-Pro:local jijiucheng$ gem sources -l *** CURRENT SOURCES *** https://gems.ruby-china.org


- ### 3、安装 CocoaPods- 安装 CocoaPods（ `sudo 表示管理员执行指令` ）（ `此处需要输入一次密码` ）
复制代码

$ sudo gem install cocoapods

复制代码

注意点：<------------------------------> 此处有个注意点 由于 OS X 系统的不同，此处的指令也是有些变化: OS X 10.11之前系统的安装 CocoaPods 指令： $ sudo gem install cocoapods OS X 10.11以后系统的安装 CocoaPods 指令： $ sudo gem install -n /usr/local/bin cocoa pods

>```
安装结果：（正常情况打印没有这么多，此处是因为解决报错时，同时打印了这么多）
muxuguixiandeMacBook-Pro:local jijiucheng$ sudo gem install cocoa pods
Password:   <----------------------------------->  // 此处需要输入一次密码
Fetching: ffi-1.9.14.gem (100%)
Building native extensions.  This could take a while...
Successfully installed ffi-1.9.14
Fetching: thread_safe-0.3.5.gem (100%)
Successfully installed thread_safe-0.3.5
Fetching: tzinfo-1.2.2.gem (100%)
Successfully installed tzinfo-1.2.2
Fetching: i18n-0.7.0.gem (100%)
Successfully installed i18n-0.7.0
Fetching: concurrent-ruby-1.0.2.gem (100%)
Successfully installed concurrent-ruby-1.0.2
Fetching: activesupport-5.0.0.1.gem (100%)
Successfully installed activesupport-5.0.0.1
Fetching: cocoa-0.1.6.gem (100%)
Successfully installed cocoa-0.1.6
Parsing documentation for ffi-1.9.14
Installing ri documentation for ffi-1.9.14
Parsing documentation for thread_safe-0.3.5
Installing ri documentation for thread_safe-0.3.5
Parsing documentation for tzinfo-1.2.2
Installing ri documentation for tzinfo-1.2.2
Parsing documentation for i18n-0.7.0
Installing ri documentation for i18n-0.7.0
Parsing documentation for concurrent-ruby-1.0.2
Installing ri documentation for concurrent-ruby-1.0.2
Parsing documentation for activesupport-5.0.0.1
Installing ri documentation for activesupport-5.0.0.1
Parsing documentation for cocoa-0.1.6
Installing ri documentation for cocoa-0.1.6
Done installing documentation for ffi, thread_safe, tzinfo, i18n, concurrent-ruby, activesupport, cocoa after 34 seconds
Fetching: pods-0.0.1.gem (100%)
Successfully installed pods-0.0.1
Parsing documentation for pods-0.0.1
Installing ri documentation for pods-0.0.1
Done installing documentation for pods after 0 seconds
8 gems installed
<------------------ 此处有 gems installed 标志着安装 CocoaPods 成功 ------------------>
复制代码

正常情况下此处会出现很大的坑，经常会出现各种报错问题，大多数是为 ruby 环境过低没有更新升级，或者是牵扯到 rvm 管理器环境的问题，在后面各种报错问题的解决方案的中会有提到。
4、配置 CocoaPods 环境
- 说明：此处为了做测试，在 MAC 桌面 Desktop 创建了一个工程 CocoaPodsTestDemo。
- 第一步 ：cd 到目录文件夹，回车 enter（ 快速方式：直接将文件夹拖入到终端 Terminal ）。

$ cd /Users/jijiucheng/Desktop/CocoaPodsTestDemo
复制代码

复制代码

输入结果：（（^_^）此时没有任何结果） muxuguixiandeMacBook-Pro:~ jijiucheng$ cd /Users/jijiucheng/Desktop/CocoaPodsTestDemo

- **第二步（建议）**：如果不知道第三方库版本的情况下，建议先查找一下当前所需第三方库的最新版本，可以通过输入指令的方式完成。并且查询完成后输入 `wq` 返回之前终端 `Terminal`页面。
复制代码

$ pod search 'AFNetworking'

>```
查询结果：（因为会查询输出所有与 'AFNetworking' 相关的第三方库，此处只输出部分，其中下面的“横线”代替实际打印的一行空格）
muxuguixiandeMacBook-Pro:~ jijiucheng$ cd /Users/jijiucheng/Desktop/CocoaPodsTestDemo
muxuguixiandeMacBook-Pro:CocoaPodsTestDemo jijiucheng$ pod search 'AFNetworking'
--------------------------（此处是输出结果）--------------------------
-> AFNetworking (3.1.0)A delightful iOS and OS X networking framework.pod 'AFNetworking', '~> 3.1.0'- Homepage: https://github.com/AFNetworking/AFNetworking- Source:   https://github.com/AFNetworking/AFNetworking.git- Versions: 3.1.0, 3.0.4, 3.0.3, 3.0.2, 3.0.1, 3.0.0, 3.0.0-beta.3,3.0.0-beta.2, 3.0.0-beta.1, 2.6.3, 2.6.2, 2.6.1, 2.6.0, 2.5.4, 2.5.3, 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]- Subspecs:- AFNetworking/Serialization (3.1.0)- AFNetworking/Security (3.1.0)- AFNetworking/Reachability (3.1.0)- AFNetworking/NSURLSession (3.1.0)- AFNetworking/UIKit (3.1.0)
......（后面还有好多与 'AFNetworking' 相关的第三方库，此处不一一列举）
复制代码

第三步：创建 Podfile 配置文件

$ vim Podfile
复制代码

复制代码

回车跳转界面（如下）：

![指令 vim Podfile 后跳转界面 .png](http://upload-images.jianshu.io/upload_images/711060-a67f673c2e5bab9f.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)- ```
① 键盘输入 i ，进入 Podfile 配置文件的编辑模式，底部会变成 ：
-- INSERT --
复制代码

复制代码

Podfile 配置文件编辑模式（如下）：

![Podfile 配置文件编辑模式 .png](http://upload-images.jianshu.io/upload_images/711060-d812ea5319337128.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)- ```
② 通过固定语句编辑进行 Podfile 文件的配置：
复制代码

复制代码

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 'MBProgressHUD' pod 'FMDB' pod 'Masonry' pod 'MJExtension' pod 'MJRefresh'

use_frameworks!

pod 'ReactiveCocoa'

end

![Podfile 配置文件固定语句 .png](http://upload-images.jianshu.io/upload_images/711060-edb4e3eb4047a035.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)- ```
③ 当固定语句输入完毕之后，按一次 `Esc` 按键退出编辑模式，底部就没有 `-- INSERT --` 标识了；
再按一次 `shift + :` （ 英文输入法状态下 ）组合，底部就会出现一个 `冒号 :` ；
最后再输入 `wq` 回车，返回到配置 Podfile 文件之前的界面；
此时 Podfile 文件就配置好了；
此时可以在 `CocoaPodsTestDemo` 文件夹下发现多了一个 `Podfile` 文件。
复制代码

复制代码

Podfile 输入完毕之后（如下）：

![Podfile 输入完毕之后 .png](http://upload-images.jianshu.io/upload_images/711060-718d2be704c64c8f.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
![配置文件完成后新增 Podfile 文件 .png](http://upload-images.jianshu.io/upload_images/711060-3ba0fd1a2c88bc43.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)- **第四步**：下载第三方库文件到项目工程中
复制代码

$ pod install

>```
下载输出（如下）：
muxuguixiandeMacBook-Pro:CocoaPodsTestDemo jijiucheng$ pod install
Analyzing dependencies
Downloading dependencies
Installing AFNetworking (3.1.0)
Installing FMDB (2.6.2)
Installing MBProgressHUD (1.0.0)
Installing MJExtension (3.0.13)
Installing MJRefresh (3.1.12)
Installing Masonry (1.0.2)
Installing SDWebImage (3.8.2)
Generating Pods project
Integrating client project
[!] Please close any current Xcode sessions and use `CocoaPodsTestDemo.xcworkspace` for this project from now on.
Pod installation complete! There are 7 dependencies from the Podfile and 7 total pods
installed.
复制代码

** 第五步 **：此后打开项目工程只需要点击打开 CocoaPodsTestDemo.xcworkspace 文件即可

复制代码

打开工程文件目录变化（如下）：所有的第三方库文件都在 /CocoaPodsTestDemo/Pods/Pods 文件夹目录下

![打开工程文件目录变化 .png](http://upload-images.jianshu.io/upload_images/711060-b4042e8dde397cbd.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)# 三、CocoaPods 安装过程中报错问题解决
<p>
- ##### 说明：此部分所列举的问题均是在执行相关指令时出现的报错
<p>
- ### 1、Rvm 环境搭建- **报错一：**
**① Error running 'requirements_osx_brew_update_system ruby-2.3.0', showing last 15 lines of /Users/jijiucheng/.rvm/log/1475769205_ruby-2.3.0/update_system.log
② curl: (35) Server aborted the SSL handshake**
<p>
> *① 报错指令：*
复制代码

$ rvm install 2.3.0

*② 报错信息：*
复制代码

Error running 'requirements_osx_brew_update_system ruby-2.3.0', showing last 15 lines of /Users/jijiucheng/.rvm/log/1475769205_ruby-2.3.0/update_system.log ...... ...... Requirements installation failed with status: 1.

复制代码

curl: (35) Server aborted the SSL handshake

![报错信息 1.png](http://upload-images.jianshu.io/upload_images/711060-10e836d4fc9eecfa.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
![报错信息 2.png](http://upload-images.jianshu.io/upload_images/711060-53fd622f1b0feb16.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
*③ 报错原因：*
`网络问题，因为需要翻墙，所以网络不稳定；建议选择 VPN，保证线路的稳定性。`
<p>
*④ 解决方案（ 指令一行一行输入 ）：*
复制代码

$ cd /usr/local

复制代码

$ git remote set-url origin git://mirrors.ustc.edu.cn/brew.git

复制代码

$ echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.bashrc

![解决方案 .png](http://upload-images.jianshu.io/upload_images/711060-e53b3d21011be5fe.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
*⑤ 方案链接：*
[方案解决链接 -- https://segmentfault.com/q/1010000004276750](https://segmentfault.com/q/1010000004276750)- **报错二：**
**① Error running '__rvm_make -j 1',
showing last 15 lines of /Users/jijiucheng/.rvm/log/1475769349_ruby-2.3.0/make.log
**
> *① 报错指令：*
复制代码

$ rvm install 2.3.0

*② 报错信息：*
复制代码

Error running '__rvm_make -j 1', showing last 15 lines of /Users/jijiucheng/.rvm/log/1475769349_ruby-2.3.0/make.log ...... ...... There has been an error while running make. Halting the installation.

![报错信息 .png](http://upload-images.jianshu.io/upload_images/711060-2b536f8210eadeb9.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
*③ 报错原因：*
`缺少 Xcode 工具，xcode command line`
<p>
*④ 解决方案：*
复制代码

$ xcode-select --install

![解决方案 .png](http://upload-images.jianshu.io/upload_images/711060-5b7b4c3da30fd277.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
*⑤ 方案链接：*
[方案解决链接 1 - http://stackoverflow.com/questions/35228481/error-running-rvm-make-install](http://stackoverflow.com/questions/35228481/error-running-rvm-make-install)
[方案解决链接 2 - http://www.th7.cn/Program/Ruby/201609/966343.shtml](http://www.th7.cn/Program/Ruby/201609/966343.shtml)- **报错三：**
**① Gemset '' does not exist, 'rvm ruby-2.3.0 do rvm gemset create ' first, or append '--create'.
**
> *① 报错指令：*
复制代码

$ rvm install 2.3.0

*② 报错信息：*
复制代码

muxuguixiandeMacBook-Pro:local jijiucheng$ rvm install 2.3.0 Already installed ruby-2.3.0. To reinstall use: . rvm reinstall ruby-2.3.0 . Gemset '' does not exist, 'rvm ruby-2.3.0 do rvm gemset create ' first, or append '--create'.

![报错信息 .png](http://upload-images.jianshu.io/upload_images/711060-85ed75cf008139b9.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
*③ 报错原因：*
`指令不对，已经存在 ruby-2.3.0 的文件残留，需要重新安装；`
<p>
*④ 解决方案：*
复制代码

$ rvm reinstall ruby-2.3.0

![解决方案 .png](http://upload-images.jianshu.io/upload_images/711060-cf2af9da6f2bb499.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)- ### 2、Ruby 环境搭建- **报错一：**- ### 3、CocoaPods 安装
- ### 4、CocoaPods 配置使用- **报错一：**
**① Setting up CocoaPods master repo**
**② [!] Unable to add a source with url `https://github.com/CocoaPods/Specs.git` named `master`. You can try adding it manually in `~/.cocoapods/repos` or via `pod repo add`.**
> *① 报错指令：*
复制代码

$ pod install

*② 报错信息：*
复制代码

muxuguixiandeMacBook-Pro:NFCustomer jijiucheng$ pod install Setting up CocoaPods master repo [!] Unable to add a source with url https://github.com/CocoaPods/Specs.git named master. You can try adding it manually in ~/.cocoapods/repos or via pod repo add.

![报错信息 .png](http://upload-images.jianshu.io/upload_images/711060-9775d53e12cb8c56.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
*③ 报错原因：*
`由于安装了多个Xcode导致路径变了，需要变换路径：
sudo xcode-select -switch /Applications/Xcode.app
sudo xcode-select -switch /Applications/Xcode\ 2.app `
<p>
*④ 解决方案：*
复制代码

$ sudo xcode-select -switch /Applications/Xcode.app

![解决方案 .png](http://upload-images.jianshu.io/upload_images/711060-ed32f3dec2959b43.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
*⑤ 资料补充：*
`出现 Setting up CocoaPods master repo，说明 Cocoapods 在将它的信息下载到  ~/.cocoapods 里；
新创建终端窗口，输入 cd ~/.cocoapods ，回车，输入 du -sh *  命令来查看文件大小，
每隔几分钟查看一次，这个目录最终大小是100多M（ 本人这里大概 800M + ），就是完成了。`
<p>
*⑥ 方案链接：*
[方案解决链接 1 - ios开发怎样卸载已经安装的cocoapod](http://zhidao.baidu.com/link?url=WZj_AtGSTkdb0J3G09EdHxqNaD6eM6Uf5u-Qp6-SrFbDBUzA5Bhka9qQ_uHQe67Pn51nWw3wrulL2vy-nfal8KpLqMN_5-ahsYHY6G_8eOa)
[方案解决链接 2 - CocoaPods安装和使用及问题：Setting up CocoaPods master repo](http://blog.csdn.net/zhangjunjian127/article/details/47954981)# 四、资料补充
<p>
- #### 1、指令补全- **① Rvm 指令库**
<p>
复制代码

$ ruby -v # 查看ruby 版本 $ rvm list known # 列出已知的 ruby 版本 $ rvm install 2.3.0 # 选择指定 ruby 版本进行更新 $ rvm get stable # 更新 rvm $ rvm use 2.2.2 # 切换到指定 ruby 版本 $ rvm use 2.2.2 --default # 设置指定 ruby 版本为默认版本
$ rvm list # 查询已安装的 ruby 版本 $ rvm remove 1.9.2 # 卸载移除指定 ruby 版本

复制代码

$ curl -L https://get.rvm.io | bash -s stable # 安装 rvm 环境 $ curl -sSL https://get.rvm.io | bash -s stable --ruby # 默认安装 rvm 最新版本 $ curl -sSL https://get.rvm.io | bash -s stable --ruby=2.3.0 # 安装 rvm 指定版本 $ source ~/.rvm/scripts/rvm # 载入 rvm

 - **②  gem 指令库**
<p>
复制代码

$ gem -v # 查看 gem 版本 $ gem source # 查看 gem 配置源 $ gem source -l # 查看 gem 配置源目录 $ gem sources -a url # 添加 gem 配置源（url 需换成网址） $ gem sources --add url # 添加 gem 配置源（url 需换成网址） $ gem sources -r url # 删除 gem 配置源（url 需换成网址） $ gem sources --remove url # 删除 gem 配置源（url 需换成网址） $ gem update # 更新所有包 $ gem update --system # 更新 Ruby Gems 软件 $ $ gem install rake # 安装 rake，从本地或远程服务器 $ gem install rake --remote # 安装 rake，从远程服务器 $ gem install watir -v 1.6.2 # 安装指定版本的 watir $ gem install watir --version 1.6.2 # 安装指定版本的 watir $ gem uninstall rake # 卸载 rake 包 $ gem list d # 列出本地以 d 打头的包 $ gem query -n ''[0-9]'' --local # 查找本地含有数字的包 $ gem search log --both # 查找从本地和远程服务器上查找含有 log 字符串的包 $ gem search log --remoter # 查找只从远程服务器上查找含有 log 字符串的包 $ gem search -r log # 查找只从远程服务器上查找含有log字符串的包 $ $ gem help # 提醒式的帮助 $ gem help install # 列出 install 命令帮助 $ gem help examples # 列出 gem 命令使用一些例子 $ gem build rake.gemspec # 把 rake.gemspec 编译成 rake.gem $ gem check -v pkg/rake-0.4.0.gem # 检测 rake 是否有效 $ gem cleanup # 清除所有包旧版本，保留最新版本 $ gem contents rake # 显示 rake 包中所包含的文件 $ gem dependency rails -v 0.10.1 # 列出与 rails 相互依赖的包 $ gem environment # 查看 gem 的环境 $ $ sudo gem -v # 查看 gem 版本（以管理员权限） $ sudo gem install cocoa pods # 安装 CocoaPods（以管理员权限） $ sudo gem install cocoapods # 安装 CocoaPods（以管理员权限） $ sudo gem install cocoapods --pre # 安装 CocoaPods 至预览版（以管理员权限） $ sudo gem install cocoapods -v 0.39.0 # 安装 CocoaPods 指定版本（以管理员权限） $ sudo gem update cocoapods # 更新 CocoaPods 至最新版（以管理员权限） $ sudo gem update cocoapods --pre # 更新 CocoaPods 至预览版（以管理员权限） $ sudo gem uninstall cocoapods -v 0.39.0 # 移除 CocoaPods 指定版本（以管理员权限）

 - **③  pod 指令库**
<p>
复制代码

$ pod setup # CocoaPods 将信息下载到~/.cocoapods/repos 目录下。如果安装 CocoaPods 时不执行此命令，在初次执行 pod intall 命令时，系统也会自动执行该指令 $ pod --version # 检查 CocoaPods 是否安装成功及其版本号 $ pod install # 安装 CocoaPods 的配置文件 Podfile

# 五、引用资料
<p>
- ##### 说明：此处是列举了我安装CocoaPods 和写这篇文章时查询引用的文章，如有涉及到版权问题，请联系，我会删除的。
<p>
- **01** - [Rvm、Ruby及Cocoapods安装](http://www.jianshu.com/p/934849a5232a)
- **02** - [RVM 和 Ruby的安装](http://www.jianshu.com/p/7fedee946f40)
- **03** - [iOS的库依赖管理工具CocoaPods](http://www.jianshu.com/p/0cea9006c0cb)
- **04** - [CocoaPods的安装以及遇到的坑](http://www.cocoachina.com/ios/20160922/17622.html)
- **05** - [ios开发怎样卸载已经安装的cocoapod](http://zhidao.baidu.com/link?url=WZj_AtGSTkdb0J3G09EdHxqNaD6eM6Uf5u-Qp6-SrFbDBUzA5Bhka9qQ_uHQe67Pn51nWw3wrulL2vy-nfal8KpLqMN_5-ahsYHY6G_8eOa)
- **06** - [配置CocoaPods前 - 本地安装好Ruby环境](http://www.cnblogs.com/cwllong/p/5072882.html)
- **07** - [iOS 学习笔记二【cocopods安装使用和安装过程中遇到的问题及解决办法】【20160725更新】](http://www.cnblogs.com/boai/p/4977976.html)
- **08** - [ruby学习及编译ruby缺少openssl问题解决](http://www.cnblogs.com/netbuddy/p/3501147.html)
<p>
- **01** - [解决升级EI Capiton CocoaPods "pod: command not found"](http://www.jianshu.com/p/6ff1903c3f11)
- **02** - [curl: (35) Server aborted the SSL handshake](https://segmentfault.com/q/1010000004276750)
- **03** - [第一种 - Error running '__rvm_make -j 1'](http://stackoverflow.com/questions/35228481/error-running-rvm-make-install)
- **04** - [第二种 - Error running '__rvm_make -j 1'](http://www.th7.cn/Program/Ruby/201609/966343.shtml)
- **05** - [[!] Unable to add a source with url "xxxxxxxxxxxxx"](http://zhidao.baidu.com/link?url=WZj_AtGSTkdb0J3G09EdHxqNaD6eM6Uf5u-Qp6-SrFbDBUzA5Bhka9qQ_uHQe67Pn51nWw3wrulL2vy-nfal8KpLqMN_5-ahsYHY6G_8eOa)
- **06** - [Error running 'requirements_osx_brew_update_system ruby-2.0.0-p643'](http://blog.csdn.net/luohancc/article/details/46897247)
- **07** - [关于安装cocoapods遇到的一些坑（ERROR: Error installing cocoapods: activesupport requires Ruby version >= 2.2）](http://blog.csdn.net/fairytale_1/article/details/51850734)
- **08** - [Homebrew install: Failed during: git fetch origin master:refs/remotes/origin/master -n --depth=1](http://stackoverflow.com/questions/39836190/homebrew-install-failed-during-git-fetch-origin-masterrefs-remotes-origin-mas)
- **09** - [Pod /usr/bin/git clone https://github.com/CocoaPods/Specs.git master](http://www.jianshu.com/p/90ca71b3b94a)<p>
# 六、后续更新
<p>
- ### 2016.12.15  问题更新- **安装 CocoaPods 步骤指令问题**
>① 最初写的：
复制代码

由于 OS X 系统的不同，此处的指令也是有些变化: OS X 10.11之前系统的安装 CocoaPods 指令： $ sudo gem install cocoapods OS X 10.11以后系统的安装 CocoaPods 指令： $ sudo gem install -n /usr/local/bin cocoa pods

② 更改原因：*因为有朋友说在 `mac OS 10.11` 和 `mac OS 10.12` 环境中所用的指令不一样，当时写这篇文章的时候环境是 `mac OS 10.11` ，但是并没有做 `mac OS 10.12` 的环境，今天又做了一下测试，现在的环境是 `mac OS 10.12.1`。*
![测试环境 mac OS 10.12.1.png](http://upload-images.jianshu.io/upload_images/711060-2a771a61d55e2848.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
③ 测试结果：
`----> 指令：
----> $ sudo gem install cocoa pods
----> 不需要密码 `
![指令：$ sudo gem install cocoa pods 测试结果.png](http://upload-images.jianshu.io/upload_images/711060-77bee925cb289a85.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
`----> 指令：
----> $ sudo gem install cocoapods
----> 需要密码 `
![指令：$ sudo gem install cocoapods 测试结果.png](http://upload-images.jianshu.io/upload_images/711060-ba1476d9a9075c4c.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
`----> 指令：
----> $ sudo gem install -n /usr/local/bin cocoa pods
----> 需要密码 `
![指令：$ sudo gem install -n /usr/local/bin cocoa pods 测试结果.png](http://upload-images.jianshu.io/upload_images/711060-c9e35cae327c961e.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
④ 测试结论：
`三种结果都能安装 Cocoapods 成功，只不过安装更新的内容略有不同。
推荐使用：指令：$ sudo gem install cocoapods`----
<p>
### 报错信息板块尚未写完，后面有时间会继续完善！！！
<p>
### 如果有错误的信息，希望大家可以指出，进而及时修改，相互学习！！！
<p>
### 如有转载的，希望可以注明出处！！！
<p>----
复制代码

【iOS工具】rvm、Ruby环境和CocoaPods安装使用及相关报错问题解决（2016 12 15 更新）...相关推荐

checking for mysql_commit in -lmy_安装ruby环境，用mysql数据库，总是报错，调了一下午，网上方法都用了也不管事...
报错信息:windowsxp系统,ruby2.0Gem::Installer::ExtensionBuildError:ERROR:FailedtobuildgemnativeextensioC:/R ...
安装ideaIU-2022.1.4报错问题解决办法
原来版本是2020 现在因为要用到JDK17 而IDEA2020支持的JDK只能到14 所以我们现在在下载一个2022 .1.4 这时我们安装好后会发现如下错误原因分析: JetBrains 会 ...
云服务器(阿里云)安装kafka及相关报错处理（WARN Connection request from old client /58.247.201.56:31365； will be dropp）
linux下载:wget http://mirrors.hust.edu.cn/apache/kafka/2.0.0/kafka_2.12-2.0.0.tgz 云服务器安装kafka,部署zookee ...
Mac 下安装 ruby 环境解决 brew 安装 yarn 问题
Mac 下安装 ruby 环境解决 brew 安装 yarn 问题参考文章: (1)Mac 下安装 ruby 环境解决 brew 安装 yarn 问题 (2)https://www.cnblogs. ...
Python在指定环境下安装第三方库的报错解决办法
Python在指定环境下安装第三方库的报错解决办法在python安装第三方库时,如果直接打开cmd命令提示符,并输入下列安装命令,则会默认安装在base环境下但base环境下的包新建的虚拟环境是无 ...
解决安装visual studio installer 报错，无法下载安装文件的问题
文章目录解决安装visual studio installer 报错,无法下载安装文件的问题 Visual Studio 2019下载官网一.VS2019安装问题问题解决方法1 解决方法2 解 ...
使用cocopods安装Alamofire后各种报错
使用cocopods安装Alamofire后各种报错,大概有一百多个吧,好像是因为swift版本问题我看到gitHub上面Alamofire是支持swift3的,我的xcode版本也不低,就放弃了更 ...
Yum编译安装Error Downloading Packages报错
Yum编译安装Error Downloading Packages报错在编译安装FS环境的时候发现如何报错: yum编译执行命令如下: yum install ntpdate wget autoco ...
笔记：windows 2012 安装SQL 2008 群集报错
http://blog.sina.com.cn/s/blog_3fa319f70101hc3z.html 现象: 在已安装群集服务并已群集MSDTC资源后,运行SQL2008R2群集添加向导时,在安装 ...

【iOS工具】rvm、Ruby环境和CocoaPods安装使用及相关报错问题解决（2016 12 15 更新）...

〇、前言

一、Homebrew、Rvm、Ruby、CocoaPods 简介

1、官网及相关链接

2、Homebrew 介绍

3、Rvm 介绍

4、Ruby 介绍

5、CocoaPods 介绍

二、CocoaPods 安装使用

1、检查安装 rvm 环境（正常情况可直接略过此步骤）

MRI Rubies

for forks use: rvm install ruby-head- --url https://github.com/github/ruby.git --branch 2.2

JRuby

Rubinius

Opal

Minimalistic ruby implementation - ISO 30170:2012

Ruby Enterprise Edition

GoRuby

Topaz

MagLev

Mac OS X Snow Leopard Or Newer

IronRuby

2、检查更新 ruby 版本环境（正常情况下从此步骤开始）

4、配置 CocoaPods 环境

Uncomment this line to define a global platform for your project

use_frameworks!

pod 'ReactiveCocoa'

【iOS工具】rvm、Ruby环境和CocoaPods安装使用及相关报错问题解决（2016 12 15 更新）...相关推荐

最新文章

热门文章

【iOS工具】rvm、Ruby环境和CocoaPods安装使用及相关报错问题解决（2016 12 15 更新）...

〇、前言

一、Homebrew、Rvm、Ruby、CocoaPods 简介

1、官网及相关链接

2、Homebrew 介绍

3、Rvm 介绍

4、Ruby 介绍

5、CocoaPods 介绍

二、CocoaPods 安装使用

1、检查安装 rvm 环境（ 正常情况可直接略过此步骤 ）

MRI Rubies

for forks use: rvm install ruby-head- --url https://github.com/github/ruby.git --branch 2.2

JRuby

Rubinius

Opal

Minimalistic ruby implementation - ISO 30170:2012

Ruby Enterprise Edition

GoRuby

Topaz

MagLev

Mac OS X Snow Leopard Or Newer

IronRuby

2、检查更新 ruby 版本环境（正常情况下从此步骤开始）

4、配置 CocoaPods 环境

Uncomment this line to define a global platform for your project

use_frameworks!

pod 'ReactiveCocoa'

【iOS工具】rvm、Ruby环境和CocoaPods安装使用及相关报错问题解决（2016 12 15 更新）...相关推荐

最新文章

热门文章

1、检查安装 rvm 环境（正常情况可直接略过此步骤）