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
即可。

 

 

posted on 2015-02-05 13:37  奋进的闹钟  阅读(230)  评论(0编辑  收藏  举报

导航