cocoapods安装及应用

一、安装cocoapods

1、如果你mac上之前安装过cocoapods，现在想重新安装，首先要卸载之前的安装（以下命令都是在终端输入执行）

$ sudo gem uninstall cocoapods

2、查看默认镜像路径

$ gem sources -l

查询结果：

*** CURRENT SOURCES ***
https://rubygems.org/

这个路径在国内访问比较慢，所以我们换成国内工程师搭建的路径。
先删除之前的路径，在设置新的路径，要保证路径是唯一的。
设置好之后再检查一遍，防止出现错误

$gem sources --remove https://rubygems.org/
$gem sources -a https://ruby.taobao.org/
$ gem sources -l

• 提示：设置网络代理的mac访问路径的时候可能失败，把代理关掉重新连接网络试一下，我自己出现了这个问题。

3、安装cocoapods

$sudo gem install cocoapods 

//苹果系统升级OS X EI Capitan
$sudo gem install -n /usr/local/bin cocoapods 

终端命令行提示安装成功会显示一个 gem installed 字样。

4、更新gem

$sudo gem update --system

到这里安装就成功了，就下来我们为我们的项目配置第三方库。

5、设置本地库

pod setup

使用这个命令 Cocoapods 会将它的信息下载到 ~/.cocoapods目录下，如果你等太久，可以试着 cd 到那个目录，用du -sh *来查看下载进度

二、配置

2.1、首先新建一个xcode项目podDemo，让后在终端中进入到项目与podDemo.xcodeproj文件同级的目录下面

cd   podDemo路径

2.2、podDemo.xcodeproj文件同级的目录下面创建podfile文件

$touch podfile

2.3、查询第三方库

$pod search AFNetworking

查询结果可能会有很多不同名字的库，找到你需要的库，如果显示的是绿色的表示cocoapods支持这个库，如果是红色的表示不支持
copy库名称和版本号描述：pod ‘AFNetworking’, ‘~> 3.0.4’

• 自己手写的话不要忘记库名称和版本号之间有个逗号

-> AFNetworking (3.0.4)
   A delightful iOS and OS X networking framework.
   pod 'AFNetworking', '~> 3.0.4'
   - Homepage: https://github.com/AFNetworking/AFNetworking
   - Source:   https://github.com/AFNetworking/AFNetworking.git
   - Versions: 3.0.4, 3.0.3, 3.0.2, 3.0.1, 3.0.0, 3.0.0-beta.3, 
   ...

2.3编辑podfile文件
打开文件

$vim Podfile 

按i进入编辑模式，在文件中编写入一下内容（下面是我自己的一些常用库）

platform:ios, '7.0'
pod 'AFNetworking' , ’~>3.0.4'
pod 'SDWebImage', '~>3.7.5'
pod 'FMDB' ,'~>2.6'
pod 'MJRefresh', '~>3.1.0'
pod 'RDVTabBarController', '~>1.1.9'
pod 'CRToast', '~> 0.0.9'
pod 'TWTToast', '~> 0.17'
pod 'Toast', '~> 3.0'
pod 'TPKeyboardAvoiding', '~> 1.2.11' 
pod 'MMXXMPPFramework', '~> 3.6.13'
pod 'Base64', '~> 1.0.1'
pod 'MBProgressHUD', '~> 0.9.2'
pod 'SFHFKeychainUtils', '~> 0.0.1'
pod 'ZipArchive', '~> 1.4.0'

第一行描述支持的ios系统及最低版本，ios要小写。
后面每行 表示支持的库和版本号。
编辑完成后按”esc”键退出编辑模式，然后再按”:”,输入wq保存并退出文件
2.4、导入三方库

$pod install

导入完成后关闭终端，打开项目文件，发现文件夹里面多了一些内容，双击podDemo..xcworkspace打开项目，这时候项目里面已经可以使用你编辑的第三方库了。

三、import疑问

以上配置成功后再项目中就可以引用导入到pod中的库了，但是你会发现在引入头文件的时候系统不会自动提示你了，为什么呢？因为当前默认设置只会在你的项目中检索头文件，不会检索pod项目中的。
解决方案：

1、选择工程的 Target -> Build Settings 菜单，找到\”User Header             Search Paths\”设置项
2、新增一个值"$(PODS_ROOT)"，并且选择\”recursive\”

ok，现在你的项目import头文件的时候就会自动提示你了！

四、修复

如果在工程中不小心删除了pod的相关文件，导致文件缺失找不到，可以在终端输入一下命令修复

$sudo pod install

如果编译的时候出现权限问题，用以下命令授权

$sudo chmod 777 工程目录文件夹/*

---

以下内容来自简书博客CocoaPods安装及bug解决方案

---

以下是我在安装cocoaPods中出现的一些错误及解决方案,分享给大家

• 错误1：
  Error fetching http://ruby.taobao.org/:
  bad response Not Found 404 (http://ruby.taobao.org/specs.4.8.gz)
• 解决方案：
  把安装流程中 $gem sources -a http://ruby.taobao.org/
  改为$gem sources -a https://ruby.taobao.org/

---

• 错误2：
  ERROR: While executing gem … (Errno::EPERM)
  Operation not permitted - /usr/bin/pod
• 解决方案：苹果系统升级OS X EI Capitan后会出现的插件错误，将安装流程中
  (1)sudo gem install cocoa pods
  改为sudo gem install -n /usr/local/bin cocoapods

---

• 错误3：
  [!] Unable to satisfy the following requirements: - AFNetworking (~> 3.0.4) required by Podfile
  Specs satisfying the AFNetworking (~> 3.0.4) dependency were found, but they required a higher minimum deployment target.
• 解决方案：
  安装流程：Podfile文件 中 platform:ios, ‘3.0.4’ 后边的 3.0.4 是平台版本号 ，一定要加上

---

• 错误4:
  [!] CocoaPods was not able to update the master repo. If this is an unexpected issue and persists you can inspect it running pod repo update –verbose
  没有读写权限
  尝试解决：
• 尝试1、根据提示，跑一下pod repo update --verbose
• 尝试2、如果还是出现原来问题，升级 gem update cocoapods（如果CocoaPods还不是最新版本）
• 尝试3、如果升级还是出现原来的问题，那么重装CocoaPods 。
  首先查看本地装了关于cocoapods的哪些东西，在终端输入
  gem list --local grep cocoapods
  接着全部卸掉上面的，在终端输入
  sudo gem uninstall cocoapods
  再安装,在终端输入
  gem install cocoapods
  尝试4、如果问题依旧，那么请清除缓存再pod setup
  清除命令
  sudo rm -fr ~/.cocoapods/repos/master
  初始化
  pod setup
  结论:之前的版本没有权限,移除再安装就好了