CocoaPods 安装和使用记录

一、介绍

Cocoapods 是一个专门为 Cocoa 框架，提供项目依赖库的命令行工具。他可以通过网站 http://cocoapods.org/ 上整理好的各种 Cocoa 开发库，很优雅的扩展你的项目。使开发者不必在项目中放置非常多的 依赖库，而且能够对依赖库进行版本控制。

这些都可以通过文本编辑器编辑  Podfile 文件即可。

二、检查本机环境

本机需要安装 Cocoapods 命令行工具。由于该命令行工具是使用 Ruby 语言编写的。所以需要 Ruby 运行环境。Mac OS X 系统已经内置了 Ruby 环境。

检查更新。

三、安装 CocoaPods

注意，pod setup在执行时，会输出Setting up CocoaPods master repo，但是会等待比较久的时间。

四、安装后，测试一下(需要能够访问到 Cocoapods 官网，如果无法访问官网，建议FQ)

搜索命令参数

五、下载 Github 上面的工程，如果有 Podfile 文件。那么跳转到这个目录

运行 pod  install

六、新建 Podfile

使用时需要新建一个名为Podfile的文件，以如下格式，将依赖的库名字依次列在文件中即可

platform :ios
pod 'JSONKit',       '~> 1.4'
pod 'Reachability',  '~> 3.0.0'
pod 'ASIHTTPRequest'
pod 'RegexKitLite'

 

然后你将编辑好的Podfile文件放到你的项目根目录中，执行如下命令即可：

cd "your project home"
pod install

 

现在，你的所有第三方库都已经下载完成并且设置好了编译参数和依赖，你只需要记住如下2点即可：

1. 使用CocoaPods生成的 .xcworkspace 文件来打开工程，而不是以前的 .xcodeproj 文件。
2. 每次更改了Podfile文件，你需要重新执行一次pod update命令。

关于.gitignore

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

CocoaPods的这篇官方文档也在What is a Podfile.lock一节中介绍了Podfile.lock的作用，并且指出：

This file should always be kept under version control.

七、为自己的项目创建podspec文件

我们可以为自己的开源项目创建podspec文件，首先通过如下命令初始化一个podspec文件：

pod spec create your_pod_spec_name

该命令执行之后，CocoaPods会生成一个名为your_pod_spec_name.podspec的文件，然后我们修改其中的相关内容即可。

具体步骤可以参考这两篇博文中的相关内容：《如何编写一个CocoaPods的spec文件》 和《Cocoapods 入门》。

私有 podspec 目前不用。

参考 唐巧博客

http://blog.devtang.com/blog/2014/05/25/use-cocoapod-to-manage-ios-lib-dependency/

-------------------------------------------------------------------------------------

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

升级10.11后，运行pod命令出现：

解决办法：

sudo gem install -n /usr/local/bin cocoapods

之后pod命令可以使用了。

----------------------------------------------------

如果pod update / pod install 卡在：

Updating local specs repositories

使用

可以使用 “pod install --verbose --no-repo-update” 进行下载，原因可能x被墙。

pod install --verbose --no-repo-update
即可。