组件化第一篇：CocoaPods的安装

前言

• 出于安全的考虑，苹果从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
  

• 查找、安装及卸载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文件---------------------

下一篇讲解CocoaPods的使用

参考链接

• brew,gem,rvm 和 bundler软件包的管理工具
• 解决CocoaPods慢的小技巧
• iOS CocoaPods 安装笔记（持续更新）
• 安装CocoaPods 2016 最新版教程
• CocoaPods安装使用总结(2016最新)
• 用CocoaPods做iOS程序的依赖管理