CocoaPods 是为iOS程序提供依赖管理的工具,项目源码在 Github 上。
CocoaPods 可以方便的使用、设置和更新第三方开源库项目。
CocoaPods 将需要的类库都放在一个Pods 的项目中,生成libPods.a 文件,主项目依赖这个.a文件。
一、安装
1. 修改 ruby 软件源
Mac上自带 ruby,默认软件源为 https://rubygems.org/ ,这个源被墙了,需要换成淘宝的源 https://ruby.taobao.org/,如果你还没换的话。
2017.02.27 update
RubyGems 镜像的管理工作现由
Ruby China 负责,使用新的地址 https://gems.ruby-china.org/
请在终端输入以下命令,注意:都是 https 。
gem sources --remove https://rubygems.org/
gem sources --add https://gems.ruby-china.org/
// 查看源
gem sources -l
2. 安装 CocoaPods
sudo gem install cocoapods
pod setup
根据网速下载需要一些时间,请耐心等待,完成后会提示 Setup Completed。
注意:更新 CocoaPods 也是使用这个命令。
等待时间问题
输入 "pod setup" 之后出现 Setting up CocoaPods master repo
然后下载进度是没有反馈回来的,可以新建终端窗口
输入:
cd ~/.cocoapods
du -sh *
间隔几分钟查询下载的总大小
pod 1.1.1 版本大概900多MB
pod 1.3.1 版本大概1.2G
update 2017.03.22
新版本有进度反馈
3. 问题
3.1 如果 gem 版本太低导致安装失败,可尝试升级 gem,这里可能需要翻墙
sudo gem update --system
比如出现错误
ERROR: While executing gem ... (Gem::DependencyError)
Unable to resolve dependencies: cocoapods requires cocoapods-core (= 1.2.0)......
解决:更新gem
3.2 安装cocoapods报错
ERROR: While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/xcodeproj
解决:使用下面命令安装
sudo gem install -n /usr/local/bin cocoapods
二、CocoaPods 使用
1. 创建编辑 Podfile 文件
在项目根目录下创建名字为 Podfile 的文件,在文件中添加需要的第三方开源库名称。
cd '项目根目录'
touch Podfile
格式如下:
platform :ios, '7.0'
pod "AFNetworking", "~> 2.0"
这里以导入 AFNetworking 为例,上面两句话来源于 AFNetworking 的 github 页面,其它库基本上格式都差不多。
可以使用 vi 命令写入
cd 'Podfile所在的目录'
pod install
正常情况下会下载导入 podfile 中记录的第三方库。
生成三个东西:
.xcworkspace 文件,以后打开项目需要用 CocoaPods 生成的 .xcworkspace 文件,不能使用原来的 .xcodeproj 文件。
Podfile.lock 文件,锁定当前依赖库的版本
Pods 文件夹,Pods 项目
3. 搜索第三方库
如果你想查找某个库,可以使用这个命令
可以查看库的介绍、版本和 podfile 命令等。
pod search AFNetworking
4. 更新第三方库
pod update
pod install 按 Podfile 文件中的要求来请求类库,如果类库版本号发生变化,会获取失败,
pod update 获取所有类库,更新到最新版本
参看
http://blog.devtang.com/blog/2014/05/25/use-cocoapod-to-manage-ios-lib-dependency/
http://www.superqq.com/blog/2014/10/16/cocoapodsan-zhuang-he-shi-yong-jiao-cheng/
http://blog.csdn.net/wzzvictory/article/details/18737437