组件化开发之01 cocoapods 本地私有库

阅读本文之前假定读者已经具有了能够使用 cocoapods 管理包依赖和能够通过编写 podspec 文件并上传过自己的 cocoapods 共公库到 GitHub.并能够通过 pod search 和 pod install 安装自己的 cocoapods 库.

私有库分为远程私有库和本地私有库,本地私有库顾名思义就是在自己电脑上搞个文件夹放自己库的代码,并通过pod install从本地引入你的库文件到工程中来.

1 如果创建一个本地私有库
在终点上通过pod lib create YVBase(你的库名称) 这个命令会从 cocoapods 在 github 上创建的模板工程 clone 到你本地 ,然后你根据提示创建一个模板工程,然后根据提示进行操作

01 What platform do you want to use?? [ iOS / macOS ]
//是创建一个 iOS 还是 macOS 的工程
02 What language do you want to use?? [ Swift / ObjC ]
//使用 ObjC 还是 Swift 开放语言
03 Would you like to include a demo application with your library? [ Yes / No ]
//是否导入一个实例程序就是俗称的 demo ,其实就是在这个 demo 上去安装你自己的私有库 然后测试你的私有库
04 Which testing frameworks will you use? [ Specta / Kiwi / None ]
//是否选择一个测试的框架 ,笔者一般选 None 我一般是将已经写好的功能抽取成组件,所以只需要管理组件 能够将代码抽离出来就行

05 Would you like to do view based testing? [ Yes / No ] 类似于 Xcode 自带的 UI Tests框架 笔者很少用,需要的可以输入 YES

06 What is your class prefix? 类前缀 我一般以 YV 开头,笔者待过好几家公司 BM BK SK CY 一般都是以公司项目名称为前缀 YV 代表一喂智能科技有限公司

[email protected]

最终会生成一个Xcode 工程 并且可以打开并运行

2 这个私有库由那几部分组成

[email protected]

我们一般将自己写的库文件放到 YVBase 这个文件夹里 ,并在 YVBase.podspec里指定 s.source_files 和 s.resources ,这样执行pod install时就会检查podspec里的描述信息,然后将 YVBase 里的代码和资源文件 引入到工程中

image.png

对于如何编写podspec 文件描述 不是本文所讲内容,具体可以cocoapods 官方文档 (https://guides.cocoapods.org/making/specs-and-specs-repo.html)

3 往本地私有库添加一些自己写的代码 并在测试工程中调试

01 将 SKToast 这个类放到 YVBase/Classes 文件夹下边 ,然后打开 demo 工程 并执行pod install命令 将添加的文件引入到 demo 工程中

image.png

02 打开测试工程 查看 Pods 下边文件 找到自己添加的 SKToast 这个类文件

image.png

03 如果文件路径在 podspec 中编写的没有错,是可以通过pod install引入到工程中的,这个时候可以再 YVBase-Example 测试工程里,去使用你本地私有库 YVBase 里的 SKToast 这个类

image.png

编写完测试代码后可以编译下代码并运行到模拟器中

image.png

4 注意细节 我们的demo 工程和 YVBase 是在同一个目录下边的,所以在工程里 podfile 文件已经设置好了 pod 'YVBase'的路径为 path ==> '../' , 当另一个工程需要引入YVBase 这个库时需要注意路径问题,本地私有库需要指定文件再电脑上的绝对路径, 不知道文件具体路径的可以 将 YVBase 代码仓库拖拽到终端上 可以查看

image.png

这样我在另一个工程里的 podfile 中 可以指定 pod 'YVBase' :path => '/Users/dzb/YVBase' ,然后执行 pod install 就可以将我放在 /Users/dzb/YVBase这个私有库代码引入到需要的工程中去.

以下是具体的使用参考

这是我放在本地的组件库 , 方便本地开发使用,也可以上传到 git 私有仓库作为远程私有库供其他开发人员使用(私有仓库需要其他开发人员具有查看 修改 提交的权限 可以使 https 和 ssh 等形式访问)

image.png

顺风车官网完全采用组件化开发 主工程只有一个 Appdelegate 写了一初始化的代码

image.png