CocoaPods详解之----进阶篇

原创 2014年02月19日 16:19:16
CocoaPods详解之----进阶篇
作者:wangzz
原文地址:http://blog.csdn.net/wzzvictory/article/details/19178709
转载请注明出处
如果觉得文章对你有所帮助,请通过留言或关注微信公众帐号wangzzstrive来支持我,谢谢!

一、Podfile.lock文件

上文讲过,在开始使用CocoaPods,执行完pod install之后,会生成一个Podfile.lock文件。这个文件看起来跟我们关系不大,实际上绝对不应该忽略它。
该文件用于保存已经安装的Pods依赖库的版本,通过CocoaPods安装了SBJson、AFNetworking、Reachability三个POds依赖库以后对应的Podfile.lock文件内容为:
PODS:
  - AFNetworking (2.1.0):
    - AFNetworking/NSURLConnection
    - AFNetworking/NSURLSession
    - AFNetworking/Reachability
    - AFNetworking/Security
    - AFNetworking/Serialization
    - AFNetworking/UIKit
  - AFNetworking/NSURLConnection (2.1.0):
    - AFNetworking/Reachability
    - AFNetworking/Security
    - AFNetworking/Serialization
  - AFNetworking/NSURLSession (2.1.0):
    - AFNetworking/NSURLConnection
  - AFNetworking/Reachability (2.1.0)
  - AFNetworking/Security (2.1.0)
  - AFNetworking/Serialization (2.1.0)
  - AFNetworking/UIKit (2.1.0):
    - AFNetworking/NSURLConnection
  - Reachability (3.0.0)
  - SBJson (4.0.0)

DEPENDENCIES:
  - AFNetworking (~> 2.0)
  - Reachability (~> 3.0.0)
  - SBJson (~> 4.0.0)

SPEC CHECKSUMS:
  AFNetworking: c7d7901a83f631414c7eda1737261f696101a5cd
  Reachability: 500bd76bf6cd8ff2c6fb715fc5f44ef6e4c024f2
  SBJson: f3c686806e8e36ab89e020189ac582ba26ec4220

COCOAPODS: 0.29.0
Podfile.lock文件最大得用处在于多人开发。对于没有在Podfile中指定Pods依赖库版本的写法,如下:
pod 'SBJson'
该句话用于获取当前SBJson这个Pods依赖库的最新版本。
当团队中的某个人执行完pod install命令后,生成的Podfile.lock文件就记录下了当时最新Pods依赖库的版本,这时团队中的其它人check下来这份包含Podfile.lock文件的工程以后,再去执行pod install命令时,获取下来的Pods依赖库的版本就和最开始用户获取到的版本一致。如果没有Podfile.lock文件,后续所有用户执行pod install命令都会获取最新版本的SBJson,这就有可能造成同一个团队使用的依赖库版本不一致,这对团队协作来说绝对是个灾难!
在这种情况下,如果团队想使用当前最新版本的SBJson依赖库,有两种方案:
  • 更改Podfile,使其指向最新版本的SBJson依赖库;
  • 执行pod update命令;
鉴于Podfile.lock文件对团队协作如此重要,我们需要将它添加到版本管理中。

二、Podfile文件

对于普通用户来说,使用CocoaPods我们打交道最多的就是Podfile文件。CocoaPods是用ruby实现的,因此Podfile文件的语法就是ruby的语法。接着从以下几个方面来介绍Podfile:

1、Podfile文件存放位置

这是在上篇文章中,遗留的一个问题。通常情况下我们都推荐Podfile文件都放在工程根目录,如下图所示:

事实上Podfile文件可以放在任意一个目录下,需要做的是在Podfile中指定工程的路径,和原来相比,Podfile文件就在最开始的位置增加了一行,具体内容如下:
xcodeproj "/Users/wangzz/Desktop/CocoaPodsTest/CocoaPodsTest.xcodeproj"

platform :ios  
pod 'Reachability',  '~> 3.0.0'  
pod 'SBJson', '~> 4.0.0'  
  
platform :ios, '7.0'  
pod 'AFNetworking', '~> 2.0' 
指定路径使用的是xcodeproj关键字。
此后,进入Podfile文件所在路径,执行pod install命令就会和之前一样下载这些Pods依赖库,而且生成的相关文件都放在了Podfile所在目录下面,如下图:
和之前一样,我们仍然需要使用这里生成的workspace文件打开工程。

2、Podfile和target

Podfile本质上是用来描述Xcode工程中的targets用的。如果我们不显式指定Podfile对应的target,CocoaPods会创建一个名称为default的隐式target,会和我们工程中的第一个target相对应。换句话说,如果在Podfile中没有指定target,那么只有工程里的第一个target能够使用Podfile中描述的Pods依赖库。
如果想在一个Podfile中同时描述project中的多个target,根据需求的不同,可以有不同的实现方式。为了说明问题,在原来的工程中再创建一个名称为Second的target,现在的project中包含的target有:
①多个target中使用相同的Pods依赖库
比如,名称为CocoaPodsTest的target和Second的target都需要使用Reachability、SBJson、AFNetworking三个Pods依赖库,可以使用link_with关键字来实现,将Podfile写成如下方式:
link_with 'CocoaPodsTest', 'Second'
platform :ios  
pod 'Reachability',  '~> 3.0.0'  
pod 'SBJson', '~> 4.0.0'  
  
platform :ios, '7.0'  
pod 'AFNetworking', '~> 2.0' 
这种写法就实现了CocoaPodsTest和Second两个target共用相同的Pods依赖库。
②不同的target使用完全不同的Pods依赖库
CocoaPodsTest这个target使用的是Reachability、SBJson、AFNetworking三个依赖库,但Second这个target只需要使用OpenUDID这一个依赖库,这时可以使用target关键字,Podfile的描述方式如下:
target :'CocoaPodsTest' do
platform :ios  
pod 'Reachability',  '~> 3.0.0'  
pod 'SBJson', '~> 4.0.0'  
  
platform :ios, '7.0'  
pod 'AFNetworking', '~> 2.0'
end

target :'Second' do
pod 'OpenUDID', '~> 1.0.0'
end
其中,do/end作为开始和结束标识符。

3、使用Podfile管理Pods依赖库版本

再引入依赖库时,需要显示或隐式注明引用的依赖库版本,具体写法和表示含义如下:
pod 'AFNetworking'      //不显式指定依赖库版本,表示每次都获取最新版本
pod 'AFNetworking', '2.0'     //只使用2.0版本
pod 'AFNetworking', '> 2.0'     //使用高于2.0的版本
pod 'AFNetworking', '>= 2.0'     //使用大于或等于2.0的版本
pod 'AFNetworking', '< 2.0'     //使用小于2.0的版本
pod 'AFNetworking', '<= 2.0'     //使用小于或等于2.0的版本
pod 'AFNetworking', '~> 0.1.2'     //使用大于等于0.1.2但小于0.2的版本
pod 'AFNetworking', '~>0.1'     //使用大于等于0.1但小于1.0的版本
pod 'AFNetworking', '~>0'     //高于0的版本,写这个限制和什么都不写是一个效果,都表示使用最新版本

三、CocoaPods常用命令

1、pod install

根据Podfile文件指定的内容,安装依赖库,如果有Podfile.lock文件而且对应的Podfile文件未被修改,则会根据Podfile.lock文件指定的版本安装。
每次更新了Podfile文件时,都需要重新执行该命令,以便重新安装Pods依赖库。

2、pod update

若果Podfile中指定的依赖库版本不是写死的,当对应的依赖库有了更新,无论有没有Podfile.lock文件都会去获取Podfile文件描述的允许获取到的最新依赖库版本。

3、pod search

命令格式为:
$ pod search OpenUDID
后面的OpenUDID为参数。
从命令的名称不难看出,该命令是用来按名称搜索可用的Pods依赖库,执行结果如下:
-> OpenUDID (1.0.0)
   Open source initiative for a universal and persistent UDID solution for iOS.
   pod 'OpenUDID', '~> 1.0.0'
   - Homepage: http://OpenUDID.org
   - Source:   https://github.com/ylechelle/OpenUDID.git
   - Versions: 1.0.0 [master repo]
这里我们搜到了一条可用数据,里面描述了OpenUDID库的简要信息。其实我们真正需要的是上述结果中的第三行:
pod 'OpenUDID', '~> 1.0.0'
不难看出,这是我们需要添加到Podfile文件中的。
有了这条命令,就可以方便、迅速地找到需要的Pods依赖库。

4、pod setup

命令格式为:
$ pod setup
执行完了以后会打印:
Setting up CocoaPods master repo
Updating 7cd4668..f3d3ced

Fast-forward
接下来还会打印很多更新信息。
这条命令用于跟新本地电脑上的保存的Pods依赖库tree。由于每天有很多人会创建或者更新Pods依赖库,这条命令执行的时候会相当慢,还请耐心等待。我们需要经常执行这条命令,否则有新的Pods依赖库的时候执行pod search命令是搜不出来的。

四、参考文档

http://guides.cocoapods.org/using/index.html

相关文章推荐

在工程中创建Podfile 文件

1.新建xcode文件 2.打开命令行,切换到你工程的目录下 3.新建Podfile文件:touch Podfile 4.使用vim文本编辑器打开Podfile文件,在文件中填写版本信息和需要p...

coacoapods中的podfile介绍;如何指定版本号(内容来自官方英文blog)

一个简单的podfile: pod 'AFNetworking', '~> 1.0' 版本号可以是1.0,可以是1.1,1.9,但必须小于2 -个更简单的podfile: pod 'A...

创建podfile 文件

一、概要 iOS开发时,项目中会引用许多第三方库,CocoaPods(https://github.com/CocoaPods/CocoaPods)可以用来方便的统一管理这些第三方库。 ...
  • zhaoyya
  • zhaoyya
  • 2016年03月04日 15:53
  • 12175

CocoaPods中Podfile详解

1、Podfile简介 Podfile的官方说明为:The Podfile is a specification that describes the dependencies of the t...

Podfile 常见语法

source  'URL' : 指定镜像仓库的源 platform : ios,  '6.0'  : 指定所支持系统和最低版本 inhibit_all_warnings! :屏蔽所有warnin...

(实验)Podfile的target与link_with

参考: http://guides.cocoapods.org/syntax/podfile.html#target http://guides.cocoapods.org/syntax/pod...

CocoaPods为工程的所有target增加依赖支持

在使用CocoaPods时,pod install默认只能为xcode工程的第一个target添加依赖库支持。如果要为所有的target增加可按照如下步骤进行 1. 编辑Podfile文件 sourc...

xcode 添加新target (支持cocoapods)

前几天,老大说能不能把工程里的调试第三方工具在上线的时候去掉,立马就想到了新建一个targetDev来开发,以前没用cocoapods的时候很简单,前几天加的时候因为要让cocoapods支持几个ta...

CocoaPods详解之----使用篇

一、什么是CocoaPods 1、为什么需要CocoaPods 在进行iOS开发的时候,总免不了使用第三方的开源库,比如SBJson、AFNetworking、Reachability等等。使用这...

多个Target的podfile文件配置

多个Target的podfile文件配置遇到The dependency * is not used in any concrete target这种错误,是因为没有在podfile文件中设置targ...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:CocoaPods详解之----进阶篇
举报原因:
原因补充:

(最多只允许输入30个字)