Cocoapods的安装以及使用

0、CocoaPods是什么?

CocoaPods是开发OS X和iOS应用程序的一个第三方库的依赖管理工具。利用CocoaPods,可以定义自己的依赖关系(称作pods),并且随着时间的变化,以及在整个开发环境中对第三方库的版本管理非常方便。

CocoaPods背后的理念主要体现在两个方面。

首先,在工程中引入第三方代码会涉及到许多内容。针对Objective-C初级开发者来说,工程文件的配置会让人很沮丧。在配置buildphases和linker flags过程中,会引起许多人为因素的错误。CocoaPods简化了这一切,它能够自动配置编译选项。

其次,通过CocoaPods,可以很方便的查找到新的第三方库。当然,这并不是说你可以简单的将别人提供的库拿来拼凑成一个应用程序。它的真正作用是让你能够找到真正好用的库,以此来缩短我们的开发周期和提升软件的质量。

CocoaPods的原理:  它是将所有的依赖库都放到另一个名为Pods项目中,然后让主项目依赖Pods项目,这样,源码管理工作都从主项目移到了Pods项目中:

1、Pods项目最终会编译成一个名为libPods.a的文件,主项目只需要依赖这个.a文件即可。

2、对于资源文件,CocoaPods提供了一个名为Pods-resources.sh的bash脚本,该脚本在每次项目编译的时候都会执行,将第三方库的各种资源文件复制到目标目录中。

3、CocoaPods通过一个名为Pods.xcconfig的文件来在编译时设置所有的依赖和参数。

---

1、Cocoapods的安装

1.先升级  Gem:

sudo gem update --system

2.切换   cocoapods的数据源 【先删除，再添加，查看】

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

  gem sources -a https://ruby.taobao.org/

  gem sources -l

3.安装  cocoapods sudo gem install cocoapods

4.将Podspec文件托管地址从github切换到国内的oschina 【先删除，再添加，再更新】（以下不同颜色是用来区分不同的命令）

pod repo remove master

pod repo add master http://git.oschina.net/akuandev/Specs.git

pod repo add master https://gitcafe.com/akuandev/Specs.git pod repo update

5.设置pod仓库    pod setup

6.测试 【如果有版本号，则说明已经安装成功】    pod --version

7.利用 cocoapods来安装第三方框架

    7-1 进入要安装框架的项目的.xcodeproj同级文件夹

    7-2 在该文件夹中新建一个文件podfile

    7-3 在文件中告诉cocoapods需要安装的框架信息 a.该框架支持的平台 b.适用的iOS版本 c.框架的名称 d.框架的版本

8.安装    pod install --no-repo-update      pod update --no-repo-update

---

2、终端如何使用cocopods：

步骤：

0. cd 项目路径 （切换到项目的.xcodeproj同级文件夹）

1. touch podfile/pod init生成podfile文件  （创建podfile,用来保存框架的名称,会去加载指定框架）（补充区别：touch podfile生成空文件，pod init生成了模板，建议使用pod init）

2. pod search 框架名称 (搜索框架)

3. open podfile  （打开 podfile 文件/也可以找到文件直接双击打开）

4. 把框架名称以及版本号导入podfile文件 （记得保存Ctrl + S）

5. pod update/install --no-repo-update （安装）

注意:

1.利用CocoPods管理类库后,以后打开项目就用xxxx.xcworkspace打开,而不是之前的.xcodeproj文件

2.每次更改了Podfile文件,你需要重新执行一次pod update命令。

3.关于.gitignore 当你执行pod install之后,除了Podfile外,CocoaPods还会生成一个名为Podfile.lock的文件,你不应该把这个文件加入到.gitignore中。因为Podfile.lock会锁定当前各依赖库的版本,之后如果多次执行pod install不会更改版本,要pod update才会改Podfile.lock了。这样多人协作的时候,可以防止第三方库升级时造成大家各自的第三方库版本不一致。

4. CocoaPods在执行pod install和pod update时,会默认先更新一次CocoPods的spec仓库索引。使用--no-repo-update参数可以禁止其做索引更新操作

pod install --no-repo-update h

pod update --no-repo-update

---

3、终端命令使用cocoPods演示：

终端命令演示图

tip(提示):   open podfile之后 写入podfile文件的内容之后如下（记得保存Ctrl + S）

podfile文件图

---

4、Xcode可以直接使用cocoPods：

1.借助别人写的第三方框架cocoapods-xcode-plugin-master，首先去github下载这个框架（网址在后面）

github图

2.下载好之后解压，用Xcode打开CocoaPods.xcworkspace

打开cocoPods项目

3.运行CocoaPods.xcworkspace   之后，关闭Xcode（Ctrl + Q）注意是退出Xcode，不只是关闭当前CocoaPods.xcworkspace的项目，然后再重新打开Xcode（有提示: load Bundle），安装成功按照操作就会有如下界面：

Xcode成功安装CocoPods图

---

四:参考文献

1、用CocoaPods做iOS程序的依赖管理:（这个可能无法访问界面）：www.devtang.com

2、CocoaPods最佳实践:  Sina Visitor System

3、极速化：CocoaPods:http://www.cocoachina.com/ios/20150123/11002.html

4、深入理解：CocoaPods:http://objccn.io/issue-6-4/

---

五、安装cocoapods时出现错误

ERROR:  While executing gem ... (Errno::EPERM)

Operation not permitted - /usr/bin/pod

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

参考资料：

http://segmentfault.com/q/1010000002926243

治标不治本，下一次还会再出现，永久解决办法：

下载命令行工具：

http://brew.sh

下载过后，运行命令行：brew install ruby

http://stackoverflow.com/questions/33015875/operation-not-permitted-usr-bin-update-rubygems

附：CocoaPods.xcworkspace的github下载地址：GitHub - heyuan110/PodsRepertory: cocopods repertory