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

介绍

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

本指南的目的在于解释如何适时的使用pod install与pod 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.0，user2仍将使用Cpod的1.0.0版本。因为那是在Podfile.lock被注册的版本。即，Cpod被Podfile.lock 锁定为1.0.0

Stage 4: 检查pod的新版本

稍过些时候，user1准备查看pods是否有更新可用。执行pod outdated后，提示pod B 有1.1.0新版本，pod C有1.2.0新版本。

user1决定更新pod B，而pod C保持不变；于是，执行pod update B，将pod B 从 1.0.0 更新至 1.1.0（也会同时相应的更新Podfile.lock），但是pod C仍保持为1.0.0 版本（不会更新至1.2.0）

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

待续...

写于18年08月22号