CocoaPods Guides : pod install vs pod update

翻译原文地址 https://guides.cocoapods.org/using/pod-install-vs-update.html

简介

许多人开始使用CocoaPods时候都认为:pod install 仅在首次用CocoaPods建立工程的时候使用,之后更新使用pod update,但事实并非如此。

本文目的是解释什么时候使用pod install 和 pod update

简而言之

  • 使用pod install来安装新的库,即使你的工程中已经有了 Podfile文件 并且已经执行过pod install命令,但只要当你添加或删除库,都应该使用pod install
  • 使用pod update [PODNAME] 只有当你想更新一个库到一个新的版本时候用

详细介绍

install 和 update 命令并不是CocoaPods独有的,受到了bundler, RubyGems or composer这些依赖库的启发,它们具有类似的命令,具有与本文描述的命令完全相同的行为和意图。

pod install

第一次在工程中使用pods时会使用到,后续,你每次编辑Podfile(添加 、 更新、移除)的时候也会使用。

  • pod install命令运行时候,在下载和安装新的库同时,会把你安装的每个库的版本都编写到Podfile.lock 文件中,这个文件会跟踪记录你每个安装库的版本号,并锁定这些版本号

  • pod install命令运行时候,当你新添加的库不在Podfile.lock文件中

    • 对于在Podfile.lock里面所列出的那些库,会下载在Podfile.lock里面明确的版本,并不会去检查是否该库有新的版本
    • 对于还不在Podfile.lock里面的库,会找到Podfile里面描述对应版本(例如:pod “MyPod”, “~>1.2”)

pod outdated

运行pod outdated命令,CocoaPods会列出那些比Podfile.lock里面记录的版本(那些当前被安装着的库的版本)更新的库以及库的新版本。这个意思就是,如果你运行pod update PODNAME,如果这个库有新的版本,并且新版本符合Podfile里的限制,它就会被更新。


pod update

运行 pod update PODNAME 命令时CocoaPods会帮你更新到这个库的新版本,而忽略Podfile.lock里面的版本限制,它会更新到这个库的新版本(只要符合Podfile里面的版本限制)

如果你运行pod update,后面没有跟库的名字,CocoaPods就会更新每一个Podfile里面的库到尽可能的最新版本


正确用法

你应该使用pod update PODNAME 去只更新某个特定的库(检查是否有新版本,并尽可能更新到新的版本)。相反,你也可以使用pod install命令,不会更新那些已经安装了的库。

当你在你的Podfile里面添加了一个库的时候,你应该使用pod install,而不是pod update,这样既安装了这个库,也不需要去更新其它的已安装库。

你应该使用pod update去更新某个特定的库,或者所有的库(在Podfile的限制中)。


提交你的Podfile.lock文件

在此提醒,如果你以前重来不commit你的Pods文件夹到远程仓库,你现在应该commit并push到远程仓库中。

要不然,就会破坏整个逻辑,Podfile.lock文件讲无法限制你的Pods中的库的版本。


典型举例

下面是一个场景示例,以说明在项目生命周期中可能遇到的各种用例。


场景1:User1创建了一个工程

User1创建了一个工程,并且想使用A、B、C这三个库,所以他就创建了一个含有这个三个库的Podfile,并且运行了pod intall。

这样就会安装了A、B、C三个库到这个工程里面,假设我们的版本都为1.0.0。

因此Podfile.lock跟踪并记录A、B、C这三个库以及版本号1.0.0。

顺便说一下:由于这个工程是第一次运行pod install,并且Pods.xcodeproj工程文件还不存在,所以这个命令也会同时创建Pods.xcodeproj以及.xcworkspace工程文件,这只是这个命令的一个副作用,并不是主要目的。


场景2:User1添加了一个库

之后,User1添加了一个库D到Podfile文件中。

然后他就应该运行pod install命令了。所以即使库B的开发者发布了B的一个新版本1.1.0。但只要是在第一次执行pod install之后发布的,那么B的版本仍然是1.0.0。因为User1只是希望添加一个新库D,不希望更新库B。

这就是很多人容易出错的地方,因为他们在这里使用了pod update,因为想着“更新我的工程一个新的库而已”。这里要注意!


场景3:User2加入到这个工程中

然后,User2,一个之前没有参与到这个工程的人,加入了。他clone了一份仓库,然后使用pod install命令。

Podfile.lock的内容就会保证User1和User2会得到完全一样的pods,前提是Podfile.lock被提交到git仓库中。

即使库C的版本已经更新到了1.2.0,User2仍然会使用C的1.0.0版本,因为C已经在Podfile.lock里面注册过了,C的1.0.0版本已经被Podfile.lock锁住了。


场景4:检查某个库的新版本

之后,User1想检查pods里面是否有可用的更新时,他执行了pod outdated,这个命令执行后,会列出来:B有了1.1.0版本,C有了1.2.0版本。

这时候,User1打算更新库B,但不更新库C,所以执行pod update B,这样就把B从1.0.0更新到1.1.0(同时更新Podfile.lock里面对B的版本记录),此时,C仍然是1.0.0版本,不会更新。


在Podfile中使用明确版本还不够

有些人认为在Podfile中明确某个库的版本,例如:pod ‘A’, ‘1.0.0’ ,足以保证所有项目里面的人都会使用完全一样的版本。

这个时候,他们可能会觉得,此时如果添加一个新库的时候,我使用pod update并不会去更新其它的库,因为其它的库已经被限定了固定的版本号。

但事实上,这不足以保证User1和User2的pods中库的版本会完全一样。

一个典型的例子是,如果库A有一个对库A2的依赖(声明在A.podspec中:dependency ‘A2’, ‘~> 3.0’),如果这样的话,使用 pod ‘A’, ‘1.0.0’ 在你的Podfile中,的确会让User1和User2都使用同样版本的库A(1.0.0),然而:

最后User1可能使用A的依赖库A2的版本为3.4(因为3.4是当时User1使用的最新版本),但User2使用的库A2版本是3.5(假设A2的开发者刚刚发布了A2的新版本3.5)。

所以只有一个方法来保证项目的每个开发者都使用相同版本的库,就是每个人电脑中都使用同样的Podfile.lock,并且合理使用pod install 和 pod update。

猜你喜欢

转载自blog.csdn.net/u014641631/article/details/82425520