常用命令总结写在前面,具体分析往下看
--------------------安装RVM--------------------
# 安装rvm命令
curl -sSL https://get.rvm.io | bash -s stable
# 如果安装失败先执行下面的命令,再次执行上面的命令
sudo gem install redis
# 安装完毕后重启终端
# 查看rvm版本,同时验证是否安装成功
rvm -v
--------------------安装RVM--------------------
--------------------安装Ruby--------------------
# 查看当前默认的Ruby版本
ruby -v
# 查询所有【已安装】的Ruby版本
rvm list
# 获取所有可用于安装的 Ruby 版本
rvm list known
# 安装指定Ruby版本
rvm install ruby-2.6.6
# 切换Ruby版本
rvm use 2.6.6
# 设置默认Ruby版本
rvm use 2.6.6 --default
# 卸载已安装的Ruby版本
rvm remove 2.6.3
--------------------安装Ruby--------------------
--------------------升级gem---------------------
# 检查当前【已安装】的gem的版本
gem -v
# 查看当前镜像源
gem sources -l
# 如果是https://rubygems.org/则需要替换镜像源
gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
# 升级gem
sudo gem update -n /usr/local/bin --system
# 如果上面的命令不行就执行下面的
sudo gem update --system
--------------------升级gem---------------------
--------------------安装CocoaPods---------------------
# 检查pod版本
pod --version
# 搜索远程的CocoaPods库
gem search cocoapods
# 搜索本地的CocoaPods库
gem list
# 先删除cocoapods,再安装
# 备注:有时会报这个错误Gem 'cocoapods' is not installed,移除sudo再执行就好了
[sudo] gem uninstall cocoapods [-v 移除的版本号]
# 安装CocoaPods
[sudo] gem install cocoapods
# 如果使用这个报错,请使用
[sudo] gem install -n /usr/local/bin cocoapods [-v 要安装的版本号]
# 当多个pod版本存在时,使用指定版本
pod _1.5.3_ install
--------------------安装CocoaPods---------------------
--------------------初始化CocoaPods---------------------
# 查看本地三方框架仓库(repo)源,list可以省略
pod repo [list]
# 如果clone前提示.cocoapods不为空,则先移除原master仓库
pod repo remove master
# 把仓库克隆下来
git clone https://github.com/CocoaPods/Specs.git ~/.cocoapods/repos/master
# 之后再次更新CocoaPods仓库源使用下面的命令
pod repo update
--------------------初始化CocoaPods---------------------
--------------------Podfile文件---------------------
# 在文件内容的顶部添加这行代码,指定repo源
source 'https://github.com/CocoaPods/Specs.git'
--------------------Podfile文件---------------------
前言
- 出于
安全
的考虑,苹果从Xcode 8开始禁用
插件,原来那么多好用的插件都不能用了,其中也包括CocoaPods插件,无奈之下只得通过终端使用了 - CocoaPods能让开发者非常方便的使用第三方类库,并且自动设置好相应的系统依赖和编译参数,所以学会使用CocoaPods是很有必要的
相关概念介绍
- rvm、ruby、gem(
对应RubyGems
)、brew(对应Homebrew
)的安装顺序- 首先安装rvm
- 再安装一个Ruby版本,就可以提供一个完整的ruby运行环境
- 安装完Ruby版本之后可以安装
Homebrew
和RubyGems
- 安装完
RubyGems
就可以使用gem安装CocoaPods
了
- RVM
- 全称:
Ruby Version Manager
,即Ruby版本管理工具 - 是一个
命令行工具
,可以方便的管理和切换
多个版本的Ruby环境 - RVM有一个非常灵活的gem管理系统,称为
gem sets
,gem sets
管理横跨多个Ruby版本的gems包 - RVM的安装见下文
- 使用RVM安装Ruby见下文
- 全称:
-
RubyGems
- 用于
管理ruby应用
,不同于Homebrew(用于操作系统层面
上软件包的安装) -
gem
是一个管理
Ruby库和程序的标准包
(即:一个gem包对应一个Ruby应用程序的安装单元); -
RubyGems
是强大的Ruby程序包管理工具
,可以通过RubyGems源来查找、安装、升级和卸载
gem包; - 在最新的Ruby版本中已经包含RubyGems,无需单独安装
- RubyGems的安装见下文
- 用于
-
Homebrew
- 用于
操作系统层面
上软件包的安装 - 将软件包安装到单独的目录,然后将符号链接到
/usr/local
中,完全基于git和ruby - Homebrew的安装
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
- 用于
安装RVM
- 以下命令都是在
用户权限
下操作的,不要用sudo
- 安装完记得
重启终端
# -sSL严格区分大小写 \curl -sSL https://get.rvm.io | bash -s stable source ~/.bashrc source ~/.bash_profile // 查看rvm版本,同时验证是否安装成功 rvm -v
采用RVM管理Ruby环境
Mac OS X系统
自带
Ruby环境-
修改
RVM
的Ruby安装源
到Ruby China
的Ruby镜像服务器,这样能提高安装速度echo "ruby_url=https://cache.ruby-china.org/pub/ruby" > ~/.rvm/user/db
-
Ruby的安装与切换相关命令
// 获取所有可用于安装的 Ruby 版本 rvm list known // 查询所有【已安装】的Ruby版本 rvm list // 安装指定Ruby版本 rvm install 2.4.0 --disable-binary // 切换Ruby版本 rvm use 2.4.0 // 设置默认Ruby版本 rvm use 2.4.0 --default // 卸载已安装的Ruby版本 rvm remove 2.4.0 // 查看当前默认的Ruby版本 ruby -v
参考文档:RVM安装 及 Ruby的安装与切换
安装RubyGems
如果
gem
版本过低也可能导致CocoaPods安装失败,所以这里首先需要先检查gem版本,看是否需要升级-
查看gem版本
# 下面两个命令都可以检查当前【已安装】的gem的版本 gem -v gem --version
-
替换
RubyGems镜像源
- 查看当前镜像源
gem sources -l
- 如果是
https://rubygems.org/
则需要替换为Ruby China镜像源,由于天朝网络受到管制; - 原淘宝镜像源已交由Ruby China镜像源来维护
- 方式一(推荐)
// 替换镜像源为Ruby China gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
- 方式二
// 先删除原有镜像源 gem sources --remove https://rubygems.org/ // 添加Ruby China为镜像源 gem sources -a https://gems.ruby-china.com/
以下命令建议添加
sudo
,表示以管理员
的身份操作,因为可能在安装软件包的过程中,需要操作文件,这些操作必须有管理员
权限才能进行-
升级gem
- macOS X EI Capitan
之前
sudo gem update --system
- macOS X EI Capitan
之后
sudo gem update -n /usr/local/bin --system
- macOS X EI Capitan
-
查找、安装及卸载gem包
// 搜索软件包 gem search 软件包关键字 // 安装软件包 sudo gem install 软件包名称 // 安装上一个版本的软件包 sudo gem install 软件包名称 --pre // 卸载安装包 sudo gem uninstall 软件包名称
安装CocoaPods
- macOS X EI Capitan
之前
sudo gem install cocoapods
- macOS X EI Capitan
之后
sudo gem install -n /usr/local/bin cocoapods
- 检查版本
pod --version
- 至此CocoaPods的
壳
已经安装完毕,下面需要初始化CocoaPods,下载使用CocoaPods进行管理的应用程序对应的描述文件
列表,大概有四百多兆;
初始化CocoaPods,【不使用】镜像源(不推荐)
- 安装完CocoaPods后如果直接在终端输入
pod setup
,接着出现Setting up CocoaPods master repo
,之后就是一个很漫长的等待... - 会将数据下载到
~/.cocoapods/repo/master
目录中,可以cd ~/.cocoapods
到此目录,用du -sh *
命令每隔一段时间查看已下载下来的文件大小 - 初始化数据总共有几百兆,要是不使用镜像的话,一天也未必能下载下来,所以
不要采取这种方式
初始化CocoaPods,【使用】镜像源
- 说明:
更换repo源只是加快了repo的下载速度,并不会加快第三方库源码的下载速度
,下载第三方库源码还是要到指定的源码存放地址(podspec
中有指定)去下载,两者是没有任何关系的; - 首先查看本地三方框架仓库(
repo
)源,如果没有,不要
直接使用pod setup
,为什么上面已经解释了
# list可以省略
pod repo [list]
-
CocoaPods 镜像使用帮助
- 进入自己的工程,在自己工程的
podFile第一行加上
source 'https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git'
- 进入自己的工程,在自己工程的
- 之后再次更新CocoaPods仓库源使用下面的命令
pod repo update
- 遇到的问题
-
问题描述
- 解决办法:
关闭Xcode
-
// 在终端中执行下面的命令,按照提示一步一步做完
// 执行完毕后,再次尝试下载,我通过此办法解决我的问题
sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
- 如果没有安装成功,可以尝试删除
.cocoapods
目录,然后重新安装cocoapods
sudo rm -rf ~/.cocoapods/
Cocoapods重要路径
-
~/Library/Caches/CocoaPods
- 使用到的第三方框架的缓存路径
- 第三方框架索引文件所在路径
- 如果发现框架信息本地已经缓存,但是就是无法搜索到框架, 可以删除这个索引文件, 重新生成
- 如果文件不存在,只要通过
pod search xxx
命令搜索框架时就会自动生成
-
~/.cocoapods/repos
- 三方框架索引信息缓存路径,一般指
master
repo - 你新建的私有repo也会处于这个位置
- 三方框架索引信息缓存路径,一般指
-
/usr/local/bin
- pod命令安装路径