上一篇介绍了:CocoaPods简介及基本运用,本篇将介绍一下CocoaPods公有库的创建和运用。
一、什么是公有库?
在咱们开发中,经常会用到一些第三方库(比如
AFNetworking
、SDWebImage
等等),咱们经过pod install
指令,把第三方库导入自己的项目中(具体操作见:上一篇)。而这些第三方库便是公有库。
二、为什么用公有库?
假如咱们也想把自己创作的 组件 / 结构 开源出去,给更多的开发者运用,那咱们就要把自己的
pods
发布到CocoaPods
里。这样,当别人在用pod search xxx
时,就会search到你开源的 组件 / 结构 了。
而一个开源组件/结构,一般需要包含以下几个文件:
- 组件/结构 源码;
-
LICENSE
:开源许可证(一般挑选MIT
); -
README.md
:库房阐明(Markdown格局); -
cocoaPodsName.podspec
:CocoaPods的描绘文件(很重要)。
三、公有库的创建及运用
1. 首要,在GitHub上创建好库房。
留意点: 1> 库房名(
Repository name
)不行重名。 2> 开源许可证(LICENSE
)一般默认挑选MIT
。
2. 经过终端、sourceTree
、GitHub Desktop
等工具,将项目clone
到本地。
3. cd
进入项目工程目录,创建podsName.podspec
文件。
运用指令:pod spec create xxx
4. 编辑podsName.podspec
文件。
运用指令 vi xxx.podspec
备注:
属性 | 意义 |
---|---|
s.name | 公有库 – 称号 |
s.version | 公有库 – 版本号 |
s.summary | 公有库 – 简介 |
s.description | 公有库 – 详细介绍 |
s.homepage | 公有库 – 主页(一般是GitHub地址) |
s.author | 公有库 – 作者 |
s.license | 公有库 – 开源协议 |
s.source | 公有库 – GitHub地址及版本号 |
s.source_files | 公有库 – 对外共享的.h和.m文件 |
s.requires_arc | 公有库 – 是否支持ARC |
更多字段解说:可看官方文档。
5. 编辑完结后,验证podsName.podspec
文件。
运用指令:pod lib lint [xxx.podspec] [--allow-warnings] [--verbose]
PS:
-
--allow-warnings
:忽略工程中的正告⚠️。 -
--verbose
:查看控制台详细信息。
成功后如图:
完结后,把文件push到GitHub上。
6. 创建Release版本信息:
7. 注册Trunk
打开终端,运用指令:pod trunk register EMAIL [YOUR_NAME]
。
如图:
这时你的邮箱会收到一封邮件: 点击后呈现:
这时,回终端运用指令pod trunk me
会呈现:
8. 再次校验
运用指令:pod spec lint "your podspec name" --allow-warnings
9. 发布公有库
运用指令:pod trunk push "xxx.podspec" --allow-warnings
10. 完结,可用pod search podsName
查找运用。
运用指令:pod search QiCocoaPods
,成果如图:假如没搜到,更新一下本地的索引库即可。(删掉 ~/资源库/Caches/CocoaPods/search_index.json,再从头运用search指令)
预告:下一篇:CocoaPods私有库