1 介绍
许多刚开始使用CocoaPods的人似乎认为pod install只用于第一次建立使用CocoaPods的工程,而在这之后要用pod update。但这并不完全正确。
这篇引导的目的就是解释什么该使用pod install什么时候该使用pod update。
如果觉得文章太长,简单的说就是:
使用pod install在你的工程里安装新的pods。尽管你已经有了一个Podfile并且之前运行过pod install;尽管你只是在已经使用了CocoaPods的工程中添加/移除了pod,你都要使用pod install。
只有在你想要更新pods到新的版本时才使用pod update [PODNAME]。
2 这两个命令的详细表达式
2.1 pod install
注意:install和update这两个词实际上并不是CocoaPods独有的。它们也被许多其他依赖的管理器推荐使用,如bundler,RubyGems或者composer,它们都有类似的命令,并且有与本文描述完全相同的行为和意图。
该命令是在你第一次在项目中获取库的时候使用,并且在每次你对 Podfile文件编辑的时候(添加、更新、删除)使用。
每一次运行pod install命令后,都会去下载安装新的库,并且会修改Podfile.lock文件中记录的库的版本。Podfile.lock文件是用来追踪和锁定这些库的版本的。
当你运行pod install时,它只会处理没有被记录在Podfile.lock文件中的pods的依赖。
对于已经记录在Podfile.lock中的pods,会下载记录在Podfile.lock文件中的准确版本,而不去检查是否有新版本可用。
对于没有记录在Podfile.lock文件中的pods,会查找匹配Podfile中描述的版本(如pod ‘MyPod’, ‘~>1.2’)。
2.2 pod outdated
当你运行pod outdated命令,CocoaPods会列出所有有新版本的pods,新版本是指比记录在Podfile.lock文件中的版本(即当前每个pod安装的版本)更新的版本。这意味着如果你对这些pod运行pod update PODNAME,它们将会更新——只要这些版本仍然满足如pod ‘MyPod’, ‘~>x.y’这样设置在Podfile中的约束。
2.3 pod update
当你运行pod update PODNAME命令,CocoaPods将会尝试找到PODNAME指定pod的更新版本,而不会顾及Podfile.lock文件中记录的版本。它将会更新pod的最新可用版本(只要满足Podfile中的版本约束)。
如果你运行pod update而不带pod名称,CocoaPods将会更新Podfile文件中记录的每一个pod到最新可用版本。
3 推荐用法
使用pod update PODNAME,你可以只更新指定的pod(检查是否存在新版本并相应的更新这个pod)。相反pod install不会尝试更新已经安装的pod的版本。
当你添加一个pod到你的Podfile,你应该运行pod install,而不是pod update——才能安装这个新的pod,同时不会带来在同一个处理过程中更新已存在的pod的风险。
当你想要更新指定pod(或所有pod)的版本时,应该只使用pod update。
4 提交Podfile.lock文件
提交你的Podfile.lock文件:
提醒一下,即使你一向不commit你的库文件到你的共享仓库,你也应该总是commit & push到你的Podfile.lcok文件中。
否则,就会破坏掉pod install 的整个设计逻辑,造成Podfile.lock文件无法锁定你已经安装的库。
总结:
- pod update will NOT respect the podfile.lock. It will override it.
-
pod install will respect the podfile.lock
The major problem comes from the
~>
aka optimistic operator.
To install a single pod without updating existing ones-> Add that pod to your Podfile and use:
pod install --no-repo-update
https://guides.cocoapods.org/using/pod-install-vs-update.html
https://stackoverflow.com/questions/26351086/how-to-update-a-single-pod-without-touching-other-dependencies