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点即可:
- 使用CocoaPods生成的 .xcworkspace 文件来打开工程,而不是以前的 .xcodeproj 文件。
- 每次更改了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
即可。