一、Podfile.lock 文件的作用
Podfile.lock 用于记录最后一次更新Pods时,记录所有的第三方框架的版本号。
Podfile.lock 文件主要包括:
PODS: 记录所有Pod库的具体安装的版本号
DEPENDENCIES: 记录各Pod库之间的相互依赖关系
SPEC REPOS: 仓库信息,即安装了哪些三方库,他们来自哪个仓库
EXTERNAL SOURCES: 在Podfile引用的版本使用的git的引用,没有上传到源的这种引用
SPEC CHECKSUMS: 记录当前各Pod库的Podspc文件Hash值,其实就是文件的md5
POPODFILE CHECKSUM: 记录Podfile文件的hash值,同样是md5,确认是否有变更
COCOAPODS: 记录上次所用的CocoaPods版本
Podfile.lock文件最大的用处在于多人开发。当团队中的某个人执行完pod install命令后,生成的Podfile.lock文件就记录下了当时最新Pods依赖库的版本,这时团队中的其它人check下来这份包含Podfile.lock文件的工程以后,再去执行pod install命令时,获取下来的Pods依赖库的版本就和最开始用户获取到的版本一致。如果没有Podfile.lock文件,后续所有用户执行pod install命令都会获取最新版本的依赖库,这就有可能造成同一个团队使用的依赖库版本不一致,这对团队协作来说绝对是个灾难!
团队开发时,一定要保证Podfile.lock的一致
二、Podfile常用指令的区别
当执行pod install 命令时,首先会根据Podfile文件指定的内容,安装依赖库,如果有Podfile.lock文件而且对应的Podfile文件未被修改,则会根据Podfile.lock文件指定的版本安装
当执行pod update命令时,如果Podfile中指定的依赖库版本不是写死的,当对应的依赖库有了更新,无论有没有Podfile.lock文件,都会去获取Podfile文件描述的允许获取到的最新依赖库版本,并且创建一个Podfile.lock文件覆盖掉原来的Podfile.lock文件
pod install/ pod update 过程:
1、在通过pod install或pod update指令安装框架前,都会先执行pod repo update指令,将服务器最新的框架下载到本地,项目中是否安装最新版本的框架,取决于安装方式:pod install(指定版本)和pod update(最新版本);
2、在第一次执行pod install指令时,podfile.lock还不存在,会根据podfile中的说明来集成框架。如果指定了框架版本号,则安装指定版本,如果未指定,则安装最新的,并自动生成podfile.lock文件;
3、当以后再次执行pod install指令时,会根据podfile.lock中记录的框架版本号来安装框架;
4、即便服务器中有最新的版本,通过pod install指令也不会安装最新的第三方框架,只会根据podfile.lock中记录的版本来安装。
备注:
--no-repo-update 常用命令
安装前不会执行pod repo update,意味着不去检查服务器版本,直接使用本地cache的框架版本
三、.podspec 文件
podspec 文件是 CocoaPods 中用于描述和配置一个库(或者称为 Pod)的文件。当创建并封装一个基于CocoaPods的属于自己的三方库时,会伴随创建一个podspec 文件来定义这个库的元数据,其包括但不限于以下内容:
https://guides.cocoapods.org/syntax/podspec.html#specification
在项目中使用 CocoaPods 时,podspec 文件是在项目的根目录下的描述文件。通过 pod install 命令,CocoaPods 将会读取这个文件并下载、安装相应的依赖库
使用细节:
目录分层:
使用:
目录分层的好处:
1、目录分层,结构清晰;
2、使用pod引入一个三方库时,可以只引入一个subspec而不用将整个三方库引入
Podspec的校验:
pod lib lint (从本地验证pod能否通过验证)
pod spec lint (从本地和远程验证pod能否通过验证)
pod lib lint --verbose (加--verbose可以显示详细的检测过程,出错时会显示详细的错误信息)
pod lib lint --allow-warnings (允许警告,用来解决由于代码中存在警告导致不能通过校验的问题)
pod lib lint --help (查看所有可选参数,可选参数可以加多个)
pod验证相关参数说明:
--allow-warnings : 忽略警告,即可以允许有警告也可以通过验证
--use-libraries: 使用静态库安装规范,当包含依赖的第三方或自定义的静态库需要添加此规范
--use-modular-headers:如果是OC和swift 的混编需要加上
--sources=https://cdn.cocoapods.org/:指定索引库的源,多个源必须用逗号分隔
--local-only:不执行将回购推到其远程服务器的步骤
--no-private:包括仅适用于公共回购的检查
--skip-import-validation:跳过验证pod是否可以导入
--skip-tests:在验证期间跳过构建和运行测试
--commit-message="Fix bug in pod":添加自定义提交消息。如果没有指定提交消息,则打开默认编辑器
--use-json:在将其推送到repo之前,将podspec转换为JSON
--swift-version=VERSION:在标记规范时应该使用的SWIFT_VERSION。这优先于规范中指定的Swift版本或.Swift版本文件
--no-overwrite:不允许将覆盖现有规范的推送