来源于 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号