cocoapods

cocoapods.png

CocoaPods是 iOS 最常用的第三方类库管理工具，绝大部分有名的开源类库都支持CocoaPods。

CocoaPods是用ruby实现的，要想使用它首先需要有ruby的环境。幸运的是OS X系统默认已经可以运行ruby了。但是有时候ruby版本过低是无法正常支持CocoaPods的使用，所以需要先安装更新升级rvm和ruby。

CocoaPods的安装

---

• 检查安装 rvm 环境

  • $rvm -v
    如果存在着显示对应的版本
    

    Snip20170313_118.png
    如果不存在,则显示
    Snip20170313_119.png

  • 不存在则安装rvm

$curl -L https://get.rvm.io | bash -s stable

如果安装成功这显示下面

Snip20170313_120.png

• 载入Rvm

$source ~/.rvm/scripts/rvm

• 再次检查 rvm 是否安装正确

$rvm -v

Snip20170313_118.png

• 安装好Rvm,然后利用Rvm安装ruby环境

当ruby版本低于2.2.2时，安装CocoaPods会报错；为防止ruby版本过低，建议先升级ruby环境，建议升级到2.3.0版本以上

• 查看ruby版本列表

$ rvm list known

Snip20170313_121.png

• 查看当前ruby版本

$ rvm -v

Snip20170313_122.png

• 如果当前ruby版本过低, 可以更新到指定版本

$ rvm install 2.3.0

Snip20170313_125.png

• 查询已安装的 ruby

$ rvm list

Snip20170313_129.png

• 卸载一个已安装版本

$ rvm remove 1.9.2

• 检查更新 ruby 版本环境
  CocoaPods是用gem ruby实现的，要想使用它首先需要有gem ruby的环境。且 MAC 的 OS X系统默认已经可以运行ruby

  Tip:

  建议gem ruby包环境升级到2.6.x以上。
  

  • 查看gem ruby版本号

  $sudo gem -v
  

Snip20170313_130.png

- 如果版本较低(默认),建议更新版本
 ```
$gem update --system
```

Ruby的软件源使用的是亚马逊的云服务，国内网络环境下载时可能会出现各种不稳定和超时,可以将官方 ruby 源替换成国内由China ruby 源

• 查看ruby源

$ gem sources -l

• 移除ruby 源

gem sources --remove https://rubygems.org/

• 替换源

$ gem sources --add https://gems.ruby-china.org

• 安装coocoapods

  • OS X10.11之前系统的安装 CocoaPods 指令

  $ sudo gem install cocoapods
  

  • OS X10.11之后系统的安装 CocoaPods 指令

  $ sudo gem install -n /usr/local/bin cocoa pods
  

• pod setup

执行pod setup时，CocoaPods 会将第三方的podspec索引文件更新到本地的~/.cocoapods/repos目录下

这里下载时间比较长,通常会失败,通常解决方法:
如果执行 pod setup，并且命令没有执行成功，那么会创建~/.cocoapods/repos目录，只不过目录是空的。

直接到~/.cocoapods/repos目录下执行 git clone  https://github.com/CocoaPods/Specs.git 到改目录下,并修改Specs文  件夹名为master          

Snip20170313_132.png

• 执行pod setup

通常这样,cocoapods就安装成功了!!!

CocoaPods的安装

---

1.创建一个项目,名字为testcocoapodsdemo
2.加入我们想通过cocoapods安装AFNetworking框架.
2.1.在项目文件下创建一个名为podfile的文件

Snip20170313_133.png

2.2.执行pod search AFNetworking

Snip20170313_134.png

2.3.编辑podfile 文件,最简单的方式

platform :ios, '7.0'

target 'testcocoapodsdemo' do

pod 'AFNetworking', '~> 3.1.0'

end

Snip20170313_136.png

2.4 执行命令 pod install
CocoaPods 在执行pod install和pod update时，会默认先更新一次podspec索引。使用--no-repo-update
参数可以禁止其做索引更新操作,通常我们是会用一下命令

 $pod install --no-repo-update
 $pod update --no-repo-update

执行 pod install --no-repo-update

如果profile书写有误,会报错

Snip20170313_137.png

如果没有问题,这显示如下信息,接下来就是等待安装

Snip20170313_138.png

安装成功:

Snip20170313_139.png

这时候打开我们项目目录:

Pofile

Podfile是cocoapods安装第三方库的依赖文件，其中定义cocoapod需要集成的第三库已经对应的系统要求等信息。

podfile写法

platform :ios, '7.0'

依赖库写法

pod 'AFNetworking', '~> 3.1.0' //高于3.1.0的版本，表示使用最新版本
pod 'AFNetworking' //不指定依赖库版本，每次都获取最新版本
pod 'AFNetworking', '3.1.0' //只使用3.1.0的版本
pod 'AFNetworking', '>3.1.0' //使用高于3.1.0的版本
pod 'AFNetworking', '>=3.1.0' //使用大于等于

use_frameworks!

a. 使用frameworks动态库替换静态库链接
b. swift项目cocoapods默认是 use_frameworks
c. OC项目cocoapods默认是 #use_frameworks <#是注释的意思>

Pofile.lock

1. Podfile.lock会锁定当前各依赖库的版本,之后如果多次执行pod install不会更改版本,要pod update才会改Podfile.lock了。这样多人协作的时候，可以防止第三方库升级时造成大家各自的第三方库版本不一致

注意:
1.podfile.lock 应该加入到版本控制里面，不应该把这个文件加入到.gitignore中