OS X 10.11以上系统,CocoaPods的安装及使用

1.设置ruby的软件源

由于ruby的原始软件源rubygems.org被我大天朝屏蔽了,首先替换该软件源

gem sources --remove https://rubygems.org/

gem sources -a https://ruby.taobao.org/

验证软件源已经被替换

gem sources -l

如果成功替换,应显示如下内容

*** CURRENT SOURCES ***

https://ruby.taobao.org/

2.升级gem

sudo gem update --system

3.安装CocoaPods

sudo gem install cocoa pods

pod setup

在执行pod setup的时候,出现Setting up CocoaPods master repo,半天没有任何反应,还是因为我大天朝的那堵墙挡住了cocoapods.org。此时应当更换国内的服务器,gitcafe和oschina都是国内的服务器,可以用它们来作为CocoaPods索引库的镜像:

pod repo remove master

pod repo add master https://gitcafe.com/akuandev/Specs.git

pod repo update

如果想用oschina的镜像也可以把第二条命令换成http://git.oschina.net/akuandev/Specs.git 即可。

第二条命令执行的时候会比较耗时,因为这个时候要去把整个specs仓库clone到 ~/.cocoapods这里。可以cd到该目录里,用du -sh *命令查看文件大小来监视下载情况。

4.CocoaPods的使用

首先cd进入到你的工程根目录下,输入以下命令符

touch Podfile

该命令符用于创建一个名为Podfile的文件。(注意,不能写成其他名称)。

通过vim来编辑Podfile的内容(也可以通过文本编辑器)

vim Podfile

输入i进入编辑模式(终端下方会显示-- INSERT --字样),这里以添加AFNetworking为例

platform:ios,'7.0'

target "MyProject" do

pod 'AFNetworking', '~> 3.1.0'

use_frameworks! (swift项目需要加入该行)

end

其中MyProject是你的项目名称,platform的'7.0'要求当前第三方库最低支持IOS7.0版本。

~> 3.1.0的意思是AFNetworking的版本号要求在3.2.0以下(不含3.2.0),3.1.0以上(含3.1.0)。如果不写版本号,则默认为满足要求的最新版本。比如:

'~> 0.1.2' Version 0.1.2 and the versions up to 0.2, not including 0.2 and higher  0.2以下(不含0.2),0.1.2以上(含0.1.2)

'~> 0.1' Version 0.1 and the versions up to 1.0, not including 1.0 and higher      1.0以下(不含1.0),0.1以上(含0.1)

'~> 0' Version 0 and higher, this is basically the same as not having it.          0和以上,等于没有此约束

'3.1.0' 指定版本号为3.1.0

按下esc键,再输入:wq,保存并退出。

如果在输入vim Podfile敲完回车报错:Found a swap file by the name ".Podfile.swp"。Swap file ".Podfile.swp" already exists!

OS X 10.11以上系统,CocoaPods的安装及使用_第1张图片
此时输入D键,删除即可

该问题是由于在vim操作期间,被强行关闭的原因,系统生成了.Podfile.swp文件,输入D键删除即可。

这时候,你就可以利用CocoPods下载AFNetworking类库了。还是在终端中的当前项目目录下,运行以下命令:

pod install

运行上述命令之后,终端出现以下信息:

EricmatoMacBook-Pro:CocoaPodsDemo ericwang$ pod install

Analyzing dependencies

Downloading dependencies

Installing AFNetworking (3.1.0)

Generating Pods project

Integrating client project

[!] From now on use `omega.xcworkspace`.

注意最后一句话,意思是:以后打开项目就用 omega.xcworkspace 打开,而不是之前的.xcodeproj文件。

你也许会郁闷,为什么会出现.xcodeproj文件呢。这正是你刚刚运行pod install命令产生的新文件。除了这个文件,你会发现还多了另外一个文件“Podfile.lock”和一个文件夹“Pods”。

到此为止,AFNetworking库已经被成功的加入到你的项目之中。

用Xcode打开项目,会发现framework下的框架全部是红字,不用管它,直接运行。

5.指令扩展


5.1 使用pod search指令查询第三方库

在终端中输入pod search AFNetworking(此处名称可以是模糊搜索),回车,则可搜索相关的类库信息,如下:

OS X 10.11以上系统,CocoaPods的安装及使用_第2张图片
此处按Q键退出

5.2 使用pod outdated指令查询第三方库更新信息

cd到项目根目录,输入pod outdated指令,可以查询当前已安装的所有三方库中,有没有最新版本的信息

OS X 10.11以上系统,CocoaPods的安装及使用_第3张图片
可以看到,当前SDWebImage和YYKit都有更新的版本

5.3 pod install 和 pod update

假若你的Podfile中,关于AFNetworking是这么描述的:

pod 'AFNetworking', '~> 3.1.0'

而AFNetworking的最新版本已经升级至3.1.1。那么当你执行pod install的时候,CocoaPods并不会将AFNetworking升级至最新版本,而执行pod update语句操作时(pod update是对所有的第三方库进行检查并更新,你也可以通过pod update AFNetworking语句,单独更新AFNetworking。),CocoaPods将会把AFNetworking升级至3.1.1版本。

假若AFNetworking的描述变为:

pod 'AFNetworking', '3.1.0'

该语句指定了版本号为3.1.0,即使你执行了pod update操作,也并不会将AFNetworking升级至3.1.1,因为Podfile这段关于AFNetworking的描述,已经将版本号写死。

假如要用CocoaPods删除AFNetworking类库,只需删除Podfile中的pod 'AFNetworking', '~> 3.1.0'语句,然后执行pod install即可。

通常来说,除非要执行更新操作,否则类库的添加和删除,建议使用pod install。

有的时候使用CocoaPods来添加第三方类库,无论是执行pod install或是pod update会出现速度很慢的情况,原因在于当执行以上两个命令的时候会升级CocoaPods的spec仓库,加一个参数可以省略这一步,然后速度就会提升不少。加参数的命令如下:

pod install --verbose --no-repo-update

pod update --verbose --no-repo-update


6.关于CocoaPods上传服务器的相关问题

iOS开发中,使用CocosPods 框架管理工具会生成Podfile、Podfile.lock、Pods文件夹和.xcworkspace四个产物。

OS X 10.11以上系统,CocoaPods的安装及使用_第4张图片
CocoaPods文件说明

除了Podfile文件是必须要commit and push以外,其他都是可选的。Podfile.lock用于记录当前第三方库的版本号,可以不提交,不过提交这个的好处是,可以提醒团队里面的人,依赖库版本已经更新!

个人.gitignore的配置如下:

# 忽略Xcode本地用户配置信息

*.xcuserstate

*.xcuserdatad/

xcuserdata/

xcshareddata/

.metadata/

# 忽略`Pods/`和`Podfile.lock`

Pods/

Podfile.lock

如果想忽略*.xcworkspace添加即可。

7.下载别人源码打开报错的处理(项目使用了CocoaPods)

有的时候我们屁颠屁颠的从github上或者其他平台下载了一个源代码,正打算欣赏,打开却发现一堆报错,瞬间傻眼。不用着急,观察项目是否使用了CocoaPods,如果有,执行pod update命令符,再次build,你就会发现所有的报错都没了。

你可能感兴趣的:(OS X 10.11以上系统,CocoaPods的安装及使用)