CocoaPods简介
CocoaPods是一个管理Swift和Objective-C的Cocoa项目的依赖工具。它现在有超过一万八千多个库,可以优雅地帮助你扩展你的项目。简单的说,就是替你管理Swift和Objective-C的Cocoa项目的第三方库引入。
官网地址: https://cocoapods.org/
1、安装
Mac上面本来就自带了ruby,所有就不用自己安装了(除非你卸载了)。
打开Terminal(终端),输入以下命令(第二个命令可能会需要稍等一会儿)
gem sources --remove https://rubygems.org/
gem source -a https://gems.ruby-china.org
第 一个命令是移除官方源,因为在不翻墙的情况下,使用起来比较慢;第二个命令是添加ruby-china的RubyGems镜像(很多旧教程都是说使用 taobao的gem源,但是taobao的gem源已经停止维护了)。
接下来运行一个命令查看是否成功添加了ruby-china的gem源:
gem source
出现下面所示,则代表成功添加~
localhost:~ glw-ios$ gem source
*** CURRENT SOURCES ***
https://gems.ruby-china.org
然后就可以开始真正安装CocoaPods了,输入一下命令:
sudo gem install -n /usr/local/bin cocoapods --pre
等一会儿就能安装完成~
出现下面代表安装成功(由于太多删除了一部分):
Successfully installed xcodeproj-1.5.0
Fetching: ruby-macho-1.1.0.gem (100%)
Successfully installed ruby-macho-1.1.0
Fetching: nap-1.1.0.gem (100%)
Successfully installed nap-1.1.0
Fetching: molinillo-0.5.7.gem (100%)
Successfully installed molinillo-0.5.7
Fetching: gh_inspector-1.0.3.gem (100%)
Successfully installed gh_inspector-1.0.3
Fetching: fourflusher-2.0.1.gem (100%)
Successfully installed fourflusher-2.0.1
Fetching: escape-0.0.4.gem (100%)
Successfully installed escape-0.0.4
Fetching: cocoapods-try-1.1.0.gem (100%)
Successfully installed cocoapods-try-1.1.0
Fetching: netrc-0.7.8.gem (100%)
Successfully installed netrc-0.7.8
...
...
unable to convert "\x84" from ASCII-8BIT to UTF-8 for lib/active_support/values/unicode_tables.dat, skipping
Installing ri documentation for activesupport-4.2.9
Parsing documentation for cocoapods-core-1.3.0.beta.2
Installing ri documentation for cocoapods-core-1.3.0.beta.2
Parsing documentation for cocoapods-1.3.0.beta.2
Installing ri documentation for cocoapods-1.3.0.beta.2
23 gems installed
localhost:~ glw-ios$
安装结束后,需要运行一下命令初始化CocoaPods:
pod setup
没有什么错误的话,就算了安装结束了。
2、基本使用
打开Terminal(终端),cd到你的Project目录,输入一下命令:
pod init
运行结束后,该目录下,会生成了一个Podfile文件
使用文本编辑器(vim、Sublime Text2、等等…)打开它(Podfile),大概会看到以下的东西
platform :ios, 'xxx' # 目标平台及其版本use_frameworks! # swift项目需要这句话,是Objective-C项目的话,请在前面加个`#`注释掉target 'xxxx' do # 在这里添加你的依赖库说明,如pod xxx
pod 'Alamofire', '~> 3.1’ # 例如这是引入Alamofire这个第三方库
end
编辑完Podfile后,使用Terminal(终端)输入其中一个命令(需要cd到项目的根目录,即Podfile所在目录):
pod install --no-repo-updateorpod install
第一个命令是不更新本地库信息进行安装,速度会快一点,毕竟不需要更新。但是会有一点点问题,当有一个新的库发布的时候,就会无法安装成功。如果不嫌麻烦,可以定时执行以下命令更新CocoaPods的库,然后就可以在一段时间使用以上的第一个命令进行安装:
pod repo update
安装完成之后,打开项目就需要打开xxx.xcworkspace,而不是xxx.xcodeproj了
如果在安装之后,修改了Podfile文件,可以执行以下的其中一个命令进行库的更新(两个命令的区别和上面说的一样):
pod update --no-repo-updateorpod update
3、安装CocoaPods的可能失败原因
gem过旧,使用以下命令更新一下,再进行安装:
sudo gem update --system