CocoaPods是 iOS 最常用的第三方类库管理工具,绝大部分有名的开源类库都支持CocoaPods。
CocoaPods
是用ruby
实现的,要想使用它首先需要有ruby
的环境。幸运的是OS X系统默认已经可以运行ruby
了。但是有时候ruby版本过低是无法正常支持CocoaPods的使用,所以需要先安装更新升级rvm和ruby。
CocoaPods的安装
- 检查安装 rvm 环境
-
$rvm -v
如果存在着显示对应的版本
如果不存在,则显示
不存在则安装rvm
-
$curl -L https://get.rvm.io | bash -s stable
如果安装成功这显示下面
- 载入Rvm
$source ~/.rvm/scripts/rvm
- 再次检查 rvm 是否安装正确
$rvm -v
- 安装好Rvm,然后利用Rvm安装ruby环境
当ruby版本低于2.2.2时,安装CocoaPods会报错;为防止ruby版本过低,建议先升级ruby环境,建议升级到2.3.0版本以上
- 查看ruby版本列表
$ rvm list known
- 查看当前ruby版本
$ rvm -v
- 如果当前ruby版本过低, 可以更新到指定版本
$ rvm install 2.3.0
- 查询已安装的 ruby
$ rvm list
- 卸载一个已安装版本
$ rvm remove 1.9.2
-
检查更新 ruby 版本环境
CocoaPods是用gem ruby
实现的,要想使用它首先需要有gem ruby的环境。且 MAC 的 OS X系统默认已经可以运行rubyTip:
建议gem ruby包环境升级到2.6.x以上。
- 查看
gem ruby
版本号
$sudo gem -v
- 查看
- 如果版本较低(默认),建议更新版本
```
$gem update --system
```
Ruby的软件源使用的是亚马逊的云服务,国内网络环境下载时可能会出现各种不稳定和超时,可以将官方 ruby 源替换成国内由China ruby 源
- 查看ruby源
$ gem sources -l
- 移除ruby 源
gem sources --remove https://rubygems.org/
- 替换源
$ gem sources --add https://gems.ruby-china.org
-
安装coocoapods
- OS X10.11之前系统的安装 CocoaPods 指令
$ sudo gem install cocoapods
- OS X10.11之后系统的安装 CocoaPods 指令
$ sudo gem install -n /usr/local/bin cocoa pods
pod setup
执行pod setup时,CocoaPods 会将第三方的podspec索引文件更新到本地的~/.cocoapods/repos目录下
这里下载时间比较长,通常会失败,通常解决方法:
如果执行 pod setup,并且命令没有执行成功,那么会创建~/.cocoapods/repos
目录,只不过目录是空的。
直接到~/.cocoapods/repos目录下执行 git clone https://github.com/CocoaPods/Specs.git 到改目录下,并修改Specs文 件夹名为master
- 执行pod setup
通常这样,cocoapods就安装成功了!!!
CocoaPods的安装
1.创建一个项目,名字为testcocoapodsdemo
2.加入我们想通过cocoapods安装AFNetworking框架.
2.1.在项目文件下创建一个名为podfile的文件
2.2.执行pod search AFNetworking
2.3.编辑podfile 文件,最简单的方式
platform :ios, '7.0'
target 'testcocoapodsdemo' do
pod 'AFNetworking', '~> 3.1.0'
end
2.4 执行命令 pod install
CocoaPods 在执行pod install和pod update时,会默认先更新一次podspec索引。使用--no-repo-update
参数可以禁止其做索引更新操作,通常我们是会用一下命令
$pod install --no-repo-update
$pod update --no-repo-update
执行 pod install --no-repo-update
如果profile书写有误,会报错
如果没有问题,这显示如下信息,接下来就是等待安装
安装成功:
这时候打开我们项目目录:
Pofile
Podfile是cocoapods安装第三方库的依赖文件,其中定义cocoapod需要集成的第三库已经对应的系统要求等信息。
podfile写法
platform :ios, '7.0'
依赖库写法
pod 'AFNetworking', '~> 3.1.0' //高于3.1.0的版本,表示使用最新版本
pod 'AFNetworking' //不指定依赖库版本,每次都获取最新版本
pod 'AFNetworking', '3.1.0' //只使用3.1.0的版本
pod 'AFNetworking', '>3.1.0' //使用高于3.1.0的版本
pod 'AFNetworking', '>=3.1.0' //使用大于等于
use_frameworks!
a. 使用frameworks动态库替换静态库链接
b. swift项目cocoapods默认是 use_frameworks
c. OC项目cocoapods默认是 #use_frameworks <#是注释的意思>
Pofile.lock
- Podfile.lock会锁定当前各依赖库的版本,之后如果多次执行pod install不会更改版本,要pod update才会改Podfile.lock了。这样多人协作的时候,可以防止第三方库升级时造成大家各自的第三方库版本不一致
注意:
1.podfile.lock 应该加入到版本控制里面,不应该把这个文件加入到.gitignore中