1、git服务器创建一个项目。
2、Clone项目到本地,到本地后是一个空目录,还没有工程。
image.png3、创建一个工程。
1.打开终端,切换到该目录
cd /Users/lmy/Desktop/XesAppMultimedia
2、创建工程模板
pod lib create XesAppMultimedia
3、配置相关选择。
选择平台
What platform do you want to use?? [ iOS / macOS ]
iOS
选择语言
What language do you want to use?? [ Swift / ObjC ]
ObjC
是否自动生成demo,选择Yes,方便以后测试
Would you like to include a demo application with your library? [ Yes / No ]
Yes
是否集成测试框架
Which testing frameworks will you use? [ Specta / Kiwi / None ]
None
UI 测试
Would you like to do view based testing? [ Yes / No ]
No
指定类前缀
image.pngWhat is your class prefix?
XesApp
4、执行完之后,自动打开项目。
image.png
4、编写podspec文件。
1、 目录下文件介绍
-
podspec这个文件主要是用来描述项目名称、pod的版本号、介绍、首页(homepage)、作者信息、git源等,具体的可以参看官方Podspec Syntax Reference
-
README使用过GitHub的都会知道README文件的重要性,这个文件可以使用Markdown语法,主要展示在GitHub工程上的首页。README文件对于使用这个pod库的人来说,有和没有这个文件,区别是很明显的,此外这还有助于创建一个高质量的 CocoaPods Quality Index ;
-
LICENSE要想是Spec仓库接收,就必须包含一个license。命令
pod lib create
自动创建使用的是 MIT license;
2、如果用第3步的命令创建工程模板,那么工程的目录下已经自动生成了.podspec(XesAppMultimedia.podspec)。如果是已有的工程或者库文件目录,也可以利用Pod命令自己制作.podspec文件,命令如下:
pod spec cretae <组件库名>
PS注意:自动生成的podspec文件只是模板,需要结合工程的库文件、资源目录、远程代码仓库(第1步创建的远程代码仓库)修改补充podspec文件。
image.png5、验证.podspec文件的格式是否正确
1、cd 到 *.podspec 文件所在的目录下,用到的一些命令
pod lib lint
解说:本地验证pod能否通过验证,如果失败使用下面命令:pod lib lint --verbose查看失败原因, 或使用pod lib lint --allow-warnings忽略警告错误
pod spec lint
解说:本地和远程验证pod能否通过验证,需要更新提交podspec到远程specs仓库,参考第7步,一般本地验证通过即可提交到远程specs仓库
pod lib lint --verbose
解说:加--verbose可以显示详细的检测过程,出错时会显示详细的错误信息
pod lib lint --verbose --allow-warnings
解说: 允许警告,用来解决由于代码中存在警告导致不能通过校验的问题
有时候会提示一个错误:
image.png
没有写简介,把简介填写一下,就可以验证通过。
有时候会提示一个错误:
992921-20170419163104056-63847022.png
到这个提示错误信息的时候,使用如下指令:
pod lib lint 文件名称.podspec --use-libraries --allow-warnings
相应的执行上传指令的时候,也需要加上参数:
pod repo push GofSpecs GofKit.podspec --use-libraries --allow-warnings
pod lib lint --sources=[https://git.xxx.com/XesAppMediator...]
解说: 私有库依赖需要添加specs源来验证
引用当前私有库的podFile中指定source为私有库地址
source http://[privateLibName]/cocoaspecs.git'
source 'https://github.com/CocoaPods/Specs.git'
pod lib lint --help
解说:查看所有可选参数,可选参数可以加多个
6.提交工程代码
提交工程代码到远程代码仓库,可以利用git或者svn进行代码版本管理,提交代码到GitHub等, 初始化提交命令如下:
//初始化git版本管理仓库,模板代码已经初始化过此步骤可以忽略(有.git文件夹)
git init
Sourcetree可视化//添加到暂存区
git add .
//提交到本地仓库
git commit -a -m '提交信息'
示例:git commit -a -m '添加pod组件库'
//打标签,注意此标签可能在podspec中用到,用于区分版本
git tag 1.0.0
//本地仓库与远程仓库关联(已关联过的,可以忽略)
git remote add origin <url>
//拉取和合并本地与远程仓库
git pull origin master --allow-unrelated-histories
//本地仓库代码推送到远程
git push --set-upstream origin master
此时如果你报错,查看报错信息中如果有:“pre-receive hook declined”
说明存在权限问题,没有master分支的代码提交权限。分配权限后,就可以push成功。
//推送标签
git push --tags
7.提交podspec文件
1. 开源库提交
podspec文件到Cocopods官方仓库,首先在cocopods官方仓库中注册账号,命令如下:
pod trunk me
//(检查是否注册trunk)
pod trunk register 邮箱 注册名字 --verbose
//(注册命令)
注册完成之后会给你的邮箱发个邮件,进入邮箱邮件里面有个链接,需要点击确认一下.之后开始提交,切换到有.podspec文件的组件工程根目录执行命令
pod trunk push 组件库名.podspec
pod trunk push 组件库名.podspec --allow-warnings
2. 私有库提交
私有仓库需要先添加到本地仓库,再push到远程仓库。
电脑查看目录:~/.cocoapods/repos/
-
添加到本地仓库, git@git.xxxx/.git为远程specs库的地址,成功之后目录(~/.cocoapods/repos)除了master之外,新增了一个文件夹(组件库名)
pod repo add specs仓库名 specs远程仓库地址
//示例:pod repo add XesAppMultimedia https://####.com/ /XesAppMultimedia_ spec.git -
查看是否添加成功
pod repo list
-
push到远程specs仓库
pod repo push 本地spec库名 本地.podsepc文件
//示例:pod repo push XesAppMultimedia XesAppMultimedia.podspec -
如果.podspec文件存在警告时不能成功push。
解决:Pod repo push 本地spec库名 本地.podsepc文件 --allow-warnings
示例:pod repo push XesAppMultimedia XesAppMultimedia.podspec --allow-warnings
- 如果已经添加过得,可以不用再添加。
-
如果添加报错:
image.png
删除文件夹, 重新pod repo add, 重新pod repo push
pod repo add XesAppMultimedia https://####.com/ /XesAppMultimedia_ spec.git
pod repo push specs远程仓库地址 组件库名.podspec
//示例:pod repo push https://##.com/#/XesAppMultimedia_ specs.git XesAppMultimedia.podspec
8、 检查仓库是否发布成功
pod搜索验证:
pod search 组件库名
如果报错,搜索不到,建议更新下pod:
pod update
之后仍然搜索不到,那么进入CocoaPods缓存目录,删除缓存索引文件search_index.json:
cd ~/Library/Caches/CocoaPods
ls
rm -f search_index.json
9、 pod库文件引入
如果是开源库(公有的),修改podfile文件:
如果是私有仓库,建议在podfile文件开头添加source源:
最后执行命令进行安装:
pod install
网友评论