欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  移动技术

IOS CocoaPods详解之进阶篇

程序员文章站 2023-12-18 08:06:10
一、podfile.lock文件 上文讲过,在开始使用cocoapods,执行完pod install之后,会生成一个podfile.lock文件。这个文件看起来跟我们关...

一、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文件都放在工程根目录,如下图所示:

IOS CocoaPods详解之进阶篇

事实上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所在目录下面,如下图:

IOS CocoaPods详解之进阶篇

和之前一样,我们仍然需要使用这里生成的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有:

IOS CocoaPods详解之进阶篇

①多个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命令是搜不出来的。

四、参考文档

上一篇:

下一篇: