iOS-Cocoapods 的正确安装姿势

iOS-Cocoapods 的正确安装姿势

注：本文摘自网络，仅作为记录 [原文地址]:(https://www.jianshu.com/p/d80b06f6e4e7)

在安装过程中出现curl: (7) Failed to connect to raw.githubusercontent.com port 443: Connection refused 问题访问我的处理方式可能会对你有帮助.
文末附带rvm 无法在线安装的解决办法.
文末还提供了pod install或者serach 过程中[!]CDN: trunk URL couldn't be downloaded:的解决办法.

1. Mac环境下 Cocoapods 的安装

1.1 总体步骤

下载Xcode —>安装rvm —>安装ruby —>安装home-brew —>安装cocoapods

1.2 安装前，先检查是否有安装残留

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
1. 如果之前装过cocopods，最好先卸载掉，卸载命令：
$ sudo gem uninstall cocoapods

2. 先查看本地安装过的cocopods相关东西，命令如下：
$ gem list --local | grep cocoapods
会显示如下:
cocoapods (1.7.2)
cocoapods-core (1.7.2)
cocoapods-deintegrate (1.0.4)
cocoapods-downloader (1.2.2)
cocoapods-plugins (1.0.0)
cocoapods-search (1.0.0)
cocoapods-stats (1.1.0)
cocoapods-trunk (1.3.1)
cocoapods-try (1.1.0)

3. 使用删除命令, 逐个删除:
$  sudo gem uninstall cocoapods-core

1.3 Mac文件夹的显示隐藏命令行:

1
2
3
4
隐藏：defaults write com.apple.finder AppleShowAllFiles -bool true
显示：defaults write com.apple.finder AppleShowAllFiles -bool false

这里选择将隐藏文件显示出来; 退出终端，重启Finder. 如果不确定，可以把主目录下的隐藏文件都给删了.

1.4. RVM

  • Ruby Version Manager,Ruby版本管理器，包括Ruby的版本管理和Gem库管理(gemset)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
1. 安装RVM
$ curl -sSL https://get.rvm.io | bash -s stable
期间可能需要管理员密码, 以及自动通过homebrew安装依赖包，等待一段时间就安装好了.

2. 载入 RVM 环境
$ source ~/.rvm/scripts/rvm

3. 检查一下是否安装正确
$ rvm -v
会显示如下:
rvm 1.29.8 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io]
表示安装正确.

注意: 也可使用 ($ rvm -v) 来判断是否安装了rvm
// 结果类似如下代表没有安装rvm
zsh: command not found: rvm

1.5 用RVM安装Ruby环境

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
1. 列出已知的ruby版本
$ rvm list known

2. 选择最新版本进行安装(这里以2.6.0为例)
$ rvm install 2.6.0

同样继续等待漫长的下载，编译过程，完成以后，Ruby, Ruby Gems 就安装好了。

3. 查询已经安装的ruby
$ rvm list

卸载一个已安装版本的命令
$ rvm remove + 要卸载的版本号

4. RVM 装好以后，需要执行下面的命令将指定版本的 Ruby 设置为系统默认版本
$ rvm 2.6.0 --default

5. 测试操作是否正确(分 2 步)
$ ruby -v
会显示如下:
ruby 2.6.3p62 (2019-04-16 revision 67580) [x86_64-darwin18]

$ gem -v
会显示如下:
3.0.4

注: RubyGems（简称 gems）是一个用于对 Ruby组件进行打包的 Ruby 打包系统。 它提供一个分发 Ruby 程序和库的标准格式，还提供一个管理程序包安装的工具。

1.6 更换镜像源

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
1. 查看当前镜像源
$ gem sources -l
会显示如下:
*** CURRENT SOURCES *** 
http://rubygems.org/

2. 先删除, 再添加
$ gem sources --remove https://rubygems.org/
$ gem sources -a https://gems.ruby-china.com/

3. 再次查看, 测试是否成功
$ gem sources -l
会显示如下:
*** CURRENT SOURCES ***
https://gems.ruby-china.com/

到这里就已经把Ruby环境成功的安装到了Mac OS X上，接下来就可以进行相应的开发使用了。

1.7 安装home-brew

  • 也可选择跳过这步, 直接安装cocoapods, 引入库文件时, 会提示你自动安装home-brew
  • Homebrew: 是一个包管理器，用于在Mac上安装一些OS X没有的UNIX工具。
  • 官方网址: https://brew.sh/index_zh-cn
  • Homebrew是完全基于 Git 和 ruby.
1
2
3
4
5
6
7
8
9
1. 安装
$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)”
安装过程中需要按回车键确认

2. 检测是否存在冲突
$ brew doctor

3. 检查是否安装成功, 出现版本号就成功了.
$ brew --version

1.8 安装Cocoapods （步骤有点慢，不要急）

1
2
3
4
5
6
7
8
9
1. 坑点:
使用$  sudo gem install cocoapods安装cocoapods 极有可能报error: RPC failed / early EOF

2. 正确的使用方法:
A. 看到报这个错之后，需要在终端执行$  sudo xcode-select -switch  /Applications/Xcode.app/Contents/Developer 这句，具体如下: 先找到xcode，显示包内容，在Contents里找到Developer文件，然后在终端输入sudo xcode-select -switch ，把找到的Developer文件夹拖进终端，就得到后边的路径啦，然后执行。因为xcode位置和版本安装的不一样，可能路径会有所不同。我的最终是sudo xcode-select -switch  /Applications/Xcode.app/Contents/Developer 这个。
B. 执行$ sudo gem install -n /usr/local/bin cocoapods 
C. Git clone https://git.coding.net/CocoaPods/Specs.git ~/.cocoapods/repos/master

然后就等待吧,下载完就ok了.

2. 离线安装RVM方式

1
2
3
4
5
6
7
8
9
10
11
12
13
14
// 离线包
curl -sSL https://github.com/rvm/rvm/tarball/stable -o rvm-stable.tar.gz
// 创建文件夹
mkdir rvm && cd rvm
// 解包
tar --strip-components=1 -xzf ../rvm-stable.tar.gz
// 安装 
./install --auto-dotfiles
// 加载
source ~/.rvm/scripts/rvm
// if --path was specified when instaling rvm, use the specified path rather than '~/.rvm'

// 查询 ruby的版本
rvm list known

在查询 ruby的版本时可能会出现下面的错误：A RVM version () is installed yet 1.25.14 (master) is loaded.Please do one of the following:* ‘rvm reload’* open a new shell* ‘echo rvm_auto_reload_flag=1 >> ~/.rvmrc’ # for auto reload with msg.* ‘echo rvm_auto_reload_flag=2 >> ~/.rvmrc’ # for silent auto reload.

解决办法: sudo rm -rf /users/your_username/.rvmThen close and reopen the terminal.
然后重新打开终端即可.

3. [!] CDN: trunk URL couldn’t be downloaded:

CocoaPods 1.8 版本之后的一些说明!

我的解决方法

1
2
3
4
// 在podfile 文件中添加 (选一个就行)
source 'https://github.com/CocoaPods/Specs.git'
或
source 'https://cdn.cocoapods.org/'

.End