pod install vs. pod update

来源于 https://guides.cocoapods.org
原文地址:https://guides.cocoapods.org/using/pod-install-vs-update.html
仅供学习,如有转摘,请注明出处.


介绍

很多开始使用CocoaPods的人认为pod install仅仅是首次对项目进行CocoaPods设置时使用,而后续使用pod update就行了,然后并非如此。

本指南的目的在于解释如何适时的使用pod installpod update

TL;DR:
  • 无论是对已存在Podfile文件的(项目)运行过pod install,还是仅仅对已经使用CocoaPods的项目进行添加或者移除pods操作。(都是)执行pod install在项目中去安装新的pods。

  • 只有在你想把pods更新到更新的版本时才需要执行pod update

pod install

首次对项目设置pods,或者每次对(项目中的)podfile进行添加、更新、移除pod等操作执行该命令

  • 每次运行pod install,(它)都会根据Podfile.lock中的每个pods进行下载和安装。Podfile.lock文件跟踪了每个已安装的pods版本并进行 锁定。
  • 运行pod install时,它只会解决Podfile.lock中尚未列出的pods 依赖。
    • 对于Podfile.lock中列出的pods,无需尝试检查是否存在新的版本,直接对指定的pods版本进行下载。

    • 对于Podfile.lock中尚未列出的pods,先搜索与Podfile中描述的相匹配的pods版本(例如 指定版本 1.2 的 ‘MyPod’)。

pod outdated

执行pod outdated,CocoaPods会列出所有比Podfile.lock中已存在pods的新版本。这意味着,如果对这些(存在新版本的)pods执行pod update PODNAME 命令,它们都会被更新 - 前提是这些新版本仍然与Podfile中的限制相匹配。
说明:如果Podfile中的版本设置方式为 ~> x.y 则会更新到 【x.最大版本号】,如果版本设置为 = x.y,则不会更新

pod update

当执行pod update PODNAME,CocoaPods会尝试寻找该pod的一个更新版本,不再考虑Podfile.lock中列出的版本。它会尽可能将pod更新到最新版本【前提是这些新版本仍然与Podfile中的限制相匹配】。

如果执行pod update时未指定pod name,CocoaPods将会Podfile中列出的每个pod更新到最新版本。

使用目的

使用pod update PODNAME,只会更新指定的pod【检查是否存在新版本并相应的更新】。与pod install不同,pod update 不会尝试更新已经安装的的pods 版本。

当在Podfile中增加一个pod时,应该执行pod install而非pod update - 安装此pod,而且避免在此过程中更新已存在的pod。

只有想更新指定pod版本(或者所有pods)时才需要使用pod update

提交你的 Podfile.lock

提醒一下,即使Pods文件夹不允许提交到共享仓库,也应该一直提交&推送Podfile.lock文件。

否则,它会打破上述pod install能够锁定已安装pods版本解释的所有逻辑。

场景举例

这有个场景来说明一个项目生命周期中各种可能的遇到的使用情况。

Stage1: user1 创建项目

user1创建一个项目,并且准备使用A,B,C(三个pods)。使用这些pods创建Podfile,并且执行pod install。此种情况(该项目)将会安装A,B,C(三个pods),版本号都定为1.0.0

Podfile.lock 将会保持追踪并且记录A,B,C所有安装的版本都是1.0.0

由于这是首次执行pod install,而且Pods.xcodeproj项目尚未存在,所以该命令会创建Pods.xcodeproj以及.xcworkspace,这是该命令附带的效果,而非主要结果。

Stage 2: User1 增加一个新的pod

过会,user1准备在项目中的Podfile 中增加Dpod 。

因此,需要执行pod install即使首次执行pod install 后,Bpod的维护又发布了1.1.0版本,项目仍然会保持使用1.0.0版本 — 因为user1仅仅是想增加Dpod,而不希望冒险去更新Bpod。

这就是某些人使用错误的地方,因为他们在这使用了pod update — 可能认为“我想用新的pods更新 project ”?— 所以使用了pod install 去安装项目中的新pods

Stage 3: User2 加入项目

从未参加该项目的user2加入了该小组,克隆好仓库并执行了pod install

Podfile.lock中的内容可以保证user2得到与user1正确且相同的pods。

即使是Cpod维护的最新版本是1.2.0user2仍将使用Cpod的1.0.0版本。因为那是在Podfile.lock被注册的版本。即,Cpod被Podfile.lock 锁定为1.0.0

Stage 4: 检查pod的新版本

稍过些时候,user1准备查看pods是否有更新可用。执行pod outdated后,提示pod B1.1.0新版本,pod C1.2.0新版本。

user1决定更新pod B,而pod C保持不变;于是,执行pod update B,将pod B1.0.0 更新至 1.1.0(也会同时相应的更新Podfile.lock),但是pod C仍保持为1.0.0 版本(不会更新至1.2.0

在Podfile中指定明确的版本仍不够

待续...


写于18年08月22号

你可能感兴趣的:(pod install vs. pod update)