iOS学习46之第三方CocoaPods的安装和使用（通用方法）

本文主要说明CocoaPods的安装步骤、使用说明和常见的报错即解决方法。

1. CocoaPods

　1>  CocoaPods简介

• CocoaPods是一个用来帮助我们管理第三方依赖库的工具。

• 在开发iOS应用时，会经常使用第三方类库，比如SDWebImage、AFNetworking等等，手动的下载与添加类库非常麻烦，通过CocoaPods可以便捷的下载与管理第三方类库。

• 使用CocoaPods的目的是让我们能自动化的、集中的、直观的管理第三方开源库。

• 官方链接：https://cocoapods.org
  

• CocoaPods是用Ruby实现的，要想使用它首先需要有Ruby的环境，OS X系统默认支持Ruby运行，但是Ruby的默认源使用的是rubygems.org，国内访问这个网址时，如果无法FQ，则不能下载，解决方案是将其替换成可用的Ruby,比如淘宝，具体操作详见安装。

　2>  CocoaPods安装

• 第一步：查看自己电脑的Ruby环境，终端命令：gem sources -l

　　① 如果环境已经是taobao镜像了，此时不需要再进行环境修改

　　② 如果环境不是taobao镜像，将当前的镜像移除，终端命令：gem sources —remove https://rubygems.org/（当前的Ruby环境），接着下载taobao的镜像，终端命令：gem sources -a https://ruby.taobao.org/

• 第二步：安装CocoaPods

　　① 下载CocoaPods，终端命令：sudo gem install cocoapods （中间可能要输入管理员密码，不是明文，在你输入密码的时候不会提示）

　　安装过程需要稍作等待,成功后会有成功安装的提示，如图所示：

　　② 设置CocoaPods，终端命令：pod setup

　　　因为文件较大，需要等待，我们可以通过终端命令来查看进度，具体操作如下：

　　　　<1> 重新打开一个终端，进入CocoaPods，终端命令：cd ~/.cocoapods

　　　　<2> 查看下载进度，终端命令：du -sh *，这个命令只能关注当下一个时间点的进度，需要不断执行这个命令，才能随时关注下载进度

　　设置成功后终端图片：

　3> CocoaPods使用

• 先找到要查找的第三方库，终端命令：pod search + 第三方库名称

• 在列表页面，选择三方库最新版本的命令，例如：pod 'MBProgressHUD','~>0.9.2'

• 创建工程，使用 cd + 工程路径 命令进入工程（直接拖着文件到终端就可得到工程路径）

• 编辑工程的 Podfile 文件，终端命令：vim Podfile

　　vim 是一个强大的编辑工具，我从网上找到一篇还可以的Vim编辑器使用基础教程，有兴趣的朋友可以看看

• 键盘输入 " i " 使 Podfile 处于编辑状态，然后将以下内容写入（高版本）：

platform :ios, '8.0'
use_frameworks!
target 'MyApp（你现在项目文件夹名）' do
  pod 'MBProgressHUD', '~> 0.9.2' // 最新版本的第三方命令
end

　　在编辑完成后，按下esc键，再按下 " : "，此时，输入 "wq" 再按回车，保存并退出。

• 进行更新下载三方库，终端命令：pod update

• 回到你的工程所在的目录,会发现现在多了很多文件,此时我们应该使用 .xcworkspace文件打开项目，而不在用.xcodeproj文件打开。

 4> CococaPods可能报错及解决方式

• pod setup -bash: pod: command not found　　

　　升级10.11后使用CocoaPod出现-bash: pod: command not found

　　解决办法：sudo gem install -n /usr/local/bin cocoapods

• The dependency `MBProgressHUD (~> 1.0.1)` is not used in any concrete target.

　　原因：CocoaPods升级到最新版本（包括一些高版本），Podfile文件的内容必须明确指出所用第三方库的targetName.

　　报错分析：低版本和高版本写法不一样.

　　　低版本：
　　　　platform :ios, '8.0'
　　　　pod 'MBProgressHUD', '~> 0.9.2'

　　　高版本：
　　　　platform :ios, '8.0'
　　　　target "targetName" do
　　　　　pod 'MBProgressHUD', '~> 0.9.2'
　　　　end

　　还会有其他的一些小的容易的错误，比如：在Podfile文件中将使用中文输入法的标点符号，ios写为iOS等等，大家可以根据报错自行处理