前言
- 出于
安全的考虑，苹果从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.org/ --remove https://rubygems.org/- 方式二
// 先删除原有镜像源 gem sources --remove https://rubygems.org/ // 添加Ruby China为镜像源 gem sources -a https://gems.ruby-china.org/ -
以下命令建议添加
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]
- 通过repo镜像源来更新repo
- 由于码市官方限制，详见
- 推荐镜像源(每2小时更新一次)：https://gitclub.cn/CocoaPods/Specs.git
- 最初我的尝试，提示：
[!] To setup the master specs repo, please run pod setup.
pod repo remove master
pod repo add master https://gitclub.cn/CocoaPods/Specs.git
- 解决方案
// 如果clone前提示.cocoapods不为空，则先移除原master仓库
pod repo remove master
// 把仓库克隆下来
git clone https://gitclub.cn/CocoaPods/Specs.git ~/.cocoapods/repos/master
// 切记【不要执行】这句，不然master仓库地址会指向github的地址
###pod setup###
- 之后再次更新CocoaPods仓库源使用下面的命令
pod repo update
- 遇到的问题
-
问题描述
问题.png
- 解决办法：
关闭Xcode
-
// 在终端中执行下面的命令，按照提示一步一步做完
// 执行完毕后，再次尝试下载，我通过此办法解决我的问题
sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
- 如果没有安装成功，可以尝试删除
.cocoapods目录，然后重新安装
sudo rm -rf ~/.cocoapods/
-
注意：如果使用了
repo的替代源，记得在Podfile文件的顶部加入下面这行描述，如果不加这一句话，它默认还是从github镜像源地址去下载repo
source 'https://gitclub.cn/CocoaPods/Specs.git'
Cocoapods重要路径
-
~/Library/Caches/CocoaPods- 使用到的第三方框架的缓存路径
- 第三方框架索引文件所在路径
- 如果发现框架信息本地已经缓存，但是就是无法搜索到框架, 可以删除这个索引文件, 重新生成
- 如果文件不存在，只要通过
pod search xxx命令搜索框架时就会自动生成
-
~/.cocoapods/repos- 三方框架索引信息缓存路径，一般指
masterrepo - 你新建的私有repo也会处于这个位置
- 三方框架索引信息缓存路径，一般指
-
/usr/local/bin- pod命令安装路径
常用命令总结
--------------------安装RVM--------------------
# 三条命令一起copy
\curl -sSL https://get.rvm.io | bash -s stable
source ~/.bashrc
source ~/.bash_profile
# 查看rvm版本，同时验证是否安装成功
rvm -v
--------------------安装RVM--------------------
--------------------安装Ruby--------------------
# 查看当前默认的Ruby版本
ruby -v
# 查询所有【已安装】的Ruby版本
rvm list
# 获取所有可用于安装的 Ruby 版本
rvm list known
# 安装指定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--------------------
--------------------升级gem---------------------
# 检查当前【已安装】的gem的版本
gem -v
# 查看当前镜像源
gem sources -l
# 替换镜像源
gem sources --add https://gems.ruby-china.org/ --remove https://rubygems.org/
# 升级gem
sudo gem update -n /usr/local/bin --system
--------------------升级gem---------------------
--------------------安装CocoaPods---------------------
# 搜索CocoaPods
gem search cocoapods
# 安装CocoaPods
sudo gem install -n /usr/local/bin cocoapods
# 检查pod版本
pod --version
--------------------安装CocoaPods---------------------
--------------------初始化CocoaPods---------------------
# 查看本地三方框架仓库(repo)源，list可以省略
pod repo [list]
# 如果clone前提示.cocoapods不为空，则先移除原master仓库
pod repo remove master
# 把仓库克隆下来
git clone https://gitclub.cn/CocoaPods/Specs.git ~/.cocoapods/repos/master
# 之后再次更新CocoaPods仓库源使用下面的命令
pod repo update
--------------------初始化CocoaPods---------------------
--------------------Podfile文件---------------------
# 在文件内容的顶部添加这行代码，指定repo源
source 'https://gitclub.cn/CocoaPods/Specs.git'
--------------------Podfile文件---------------------
网友评论
我栽倒这里了。。。谢谢你啊