看懂 Podfile.lock 文件

发布于 2024-09-28 01:00:04 字数 5476 浏览 8 评论 0

当前环境： Xcode10.0 Swift4.2 iOS SDK 12.1

其实本来已经不想介绍这个文件了，其实有些经验的同学肯定对这个都非常理解，毕竟在多人开发中，它尤为有用，比如我们公司项目要有 30 多个人来维护，每几个人分成一个业务组，每个迭代，每个业务组派出一个人向主分支提交代码，如果我们没有很强的版本意识和 Git 使用技巧，很容易出现事故。

打开 Podfile.lock 文件你会发现如下的几个 Key，我来解释下分别是什么意思。

一，PODS

例如：下面是一部分内容意思是：你的 AFNetworking 引用的是 3.1.0 的版本，这个是你应用实际应用的版本，这里要注意的是，Podfile 里面的版本区间，执行 pod install 和 pod update 区别，install 不会更新区间版本，update 则会更新到可升区间的最大版本。尤其在多人开发的大项目有之中，如果 Podfile 里面没有锁死版本，很容易造成版本被动升级。

// AFNetworking 是被安装的是 3.1.0 版本，这是在你的源下面搜到的 podspec 文件下的版本号，并且包括依赖 AFNetworking 的依赖。
PODS:
      - AFNetworking (3.1.0):
        - AFNetworking/NSURLSession (= 3.1.0)
        - AFNetworking/Reachability (= 3.1.0)
        - AFNetworking/Security (= 3.1.0)
        - AFNetworking/Serialization (= 3.1.0)
        - AFNetworking/UIKit (= 3.1.0)

二，DEPENDENCIES

这个 Key 下面的其实就是你 Podfile 里面引用的版本，你可以清楚的看到他们的版本区间，因为后面会有 = < > 比较符号标记，这是因为它和 Podfile 里面引用版本的方式有关，具体可以看 Podfile 引用版本的细节，可以设置一个版本区间，可以定死版本。

三，SPEC REPOS

这个 Key 是表示你这个项目有用到源有哪些，有些私有源，有些公有源，例如默认的 GitHub cocoapods 的源，私有源就是这个源实在私人服务器上并且不对外开放，公有源就是你这个源可以对任何人开发，对不对外开放这个取决于你的源放在哪里，例如我下面的私有源是在公司内部的 GitLab 中搭建的，对于外面的人来说肯定就是私有源，因为他们不能访问到我公司的 Git 源。

yaml SPEC REPOS: "git@git.nevint.com:DOMOBILE-FeiDian/DOMOBILE-FeiDian-FDSpec.git": //私有源 - Alita "git@git.nevint.com:ios/nio-lib-repo.git": //私有源 - CCUtil https://github.com/cocoapods/specs.git: // 公有源 - AFNetworking - Aspects - Bugly - CocoaSecurity - DBPrivacyHelper

四，EXTERNAL SOURCES

在 Podfile 引用的版本使用的 Git 的引用，没有上传到源的这种引用，会被放在 external sources 。例如： pod 'RNShop', :git => 'git@git.nevint.com:DOMOBILE-FeiDian/do-otd-mer-nioapp-ios.git', :tag => '0.4.1' 像这种引用，它明确了使用哪个 Git 但是，这个 pod 并没有上传到私有源版本，所以他会在外部源里面。如何发布到私有源或者公有源可以去 Cocoapods 文档自行查找。

    ```yaml
    EXTERNAL SOURCES:
        AutopartsStoreLib:
            :git: "git@git.nevint.com:DOMOBILE-FeiDian/DOIOS-Nioapp-AutopartsStore-Maintenance.git"
            :tag: 0.6.29
        CodePush:
            :path: "../../do-otd-mer-nioapp-rn/node_modules/react-native-code-push"
        Debug:
            :git: "git@git.nevint.com:DOMOBILE-FeiDian/DOIOS-Nioapp-Debug.git"
            :tag: 1.11.8
        DeepLinkKit:
            :git: "git@git.nevint.com:ios/DeepLinkKit.git"
            :tag: 1.2.2.1
        libwebp:
            :git: "git@git.nevint.com:ios-libs/libwebp.git"
            :tag: v0.6.0
    ```

五，CHECKOUT OPTIONS

这个字段，其实是对应当有些 pod 库没有在源（公有源/私有源) 当中 PS: 比如你在 Podfile 里面引入版本用的是 tag 或者 commit，下面的内容是是真正装在你 app 当中的三方库代码，从哪个 Git，哪个 tag，哪个 commit。比如你现在要确定你的 AutopartsStoreLib ， Debug 具体版本代码从哪里来，那么你就应该看下面的信息来找到具体下载你本地的库的版本它是从哪里来的。


    CHECKOUT OPTIONS:
        AutopartsStoreLib:
            :git: "git@git.nevint.com:DOMOBILE-FeiDian/DOIOS-Nioapp-AutopartsStore-Maintenance.git"
            :tag: 0.6.29
        Debug:
            :git: "git@git.nevint.com:DOMOBILE-FeiDian/DOIOS-Nioapp-Debug.git"
            :tag: 1.11.8
        DeepLinkKit:
            :git: "git@git.nevint.com:ios/DeepLinkKit.git"
            :tag: 1.2.2.1
        libwebp:
            :git: "git@git.nevint.com:ios-libs/libwebp.git"
            :tag: v0.6.0

六，SPEC CHECKSUMS

这个 hash 值怎么来的呢，我来解释一下，例如： Alita: 577f02fd587c7722d9c063c70a278a0ef6f35ef9 ，那么这个 hash 值是对我们本地 /Users/yongpeng.zhu/.cocoapods/repos/nevint-domobile-feidian-fdspec/Alita/0.2.1/Alita.podspec 这个文件的 SHA1 的值来保证，你的 podspec 文件是一致的。如果这个地方发生了改变，那么只可能是你的 podspec 文件发生了改变。

yaml SPEC CHECKSUMS: AFNetworking: 5e0e199f73d8626b11e79750991f5d173d1f8b67 Alita: 577f02fd587c7722d9c063c70a278a0ef6f35ef9 Aspects: 7595ba96a6727a58ebcbfc954497fc5d2fdde546 AutopartsStoreLib: 4663847a6d03364760affc5b4cefda84e1d6d214 Bugly: 3ca9f255c01025582df26f9222893b383c7e4b4e CCUtil: 5c83684e2e5e514fe20a16de0c95a250faf2cf75

七，PODFILE CHECKSUM

这个字段就是对 Podfile 文件的 SHA1 的值。用来对比 Podfile 是否有过改变。

最后

上面我对 Podfile.lock 文件每个字段都介绍了一下，其实它最主要的功能就是告诉你，你当前的 app 使用的三方库的版本，来源，和他们生成的 hash 值，用在多人协作中，来确定版本是否被更改等等。因为这份文件才是你真正在 app 当中的三方库版本，而不是 Podfile 文件里面写的。 Podfile 更像是一个版本约束，而 Podfile.lock 才是你真正使用的版本。如果让你去确定你 app 使用某一个三方库的版本，你不应该找 Podfile，而是应该找 Podfile.lock 文件。即使你 Podfile 使用的定死版本的方式。

补充

本地源版本管理地址： 例如：/Users/yongpeng.zhu/.cocoapods/repos/

存放着各个源的版本，对应的 Podspec 文件

本地源缓存地址： 例如：/Users/yongpeng.zhu/Library/Caches/CocoaPods/Pods

External 文件夹：存放外部源的代码，例如，你引用的 Pod 模块是直接用 Commit/Tag 去引用的，它并没有上传到源上， pod 'ABCKit', :git => 'git@git.nevint.com:ios-libs/ABCKit.git', :commit => '76a7c550c98030e606477f4506d1060846253b3b' 或者 pod 'libwebp', :git => 'git@git.nevint.com:ios-libs/libwebp.git', :tag => 'v0.6.0' 像这种引用方式其实这个 Pod 并没有上传到源上，而是直接从 Git 上拉的，所以算作外部源上面，你可以参考上面 Podfile.lock 文件里面的 External 字段就知道了。

1. Release 文件夹：上传到源上面版本的 Pod 源代码
2. Specs 文件夹：存放这些 外部的 或者 发布在源伤的 的 Podspec 文件的 JSON 文件，这个 JSON 文件其实就是把 Podspec 文件解析然后组成的。
3. VERSION 文件：存放着当前的 cocoapods 版本

上面两个地址，第一个是记录发布到源上面的版本，和 Podspec 文件，第二个是记录缓存，内容包括源代码和 Podspec 配置文件和 Cocoapods 版本。

分享到QQ

分享到微博