步骤流程
-
1.在git上创建新的repository,填写name(你的库名称),勾选readme选项,选择license;
-
2.将创建的repository clone下来,cd进入该目录下,将自己的库文件和demo放在这个目录下;
-
3.使用如下命令,在这个目录中创建.podspec文件;
pod spec create xxx
xxx是你的库名称整个目录结构如下:
- 4.填写.podspec
新创建的. podspec里加#的都是注释掉的字段信息,按需填写,有些可以不填;
Pod::Spec.new do |s|
s.name = "UIImageKit"
s.version = "1.0.0"
s.summary = "UIImageKit is a library of UIImage class."
s.description = <<-DESC
UIImageKit is a library of UIImage class, a simple kit.
DESC
s.homepage = "https://github.com/Kangqj/UIImageKit"
s.license = "MIT"
s.author = { "Kangqj" => "kang_qj@sina.cn" }
s.source = { :git => "https://github.com/Kangqj/UIImageKit.git", :tag => "#{s.version}" }
s.source_files = "UIImageKit/**/*"
s.platform = :ios
s.framework = "UIKit"
end
主要解释两个字段:
source_files:资源文件,当前路径就是库路径,后面再拼接库文件所在的文件夹,
“*” 表示匹配所有文件
“*.{h,m}” 表示匹配所有以.h和.m结尾的文件
“**” 表示匹配所有子目录
s.description:这个描述字段可以不用填写,如果要填写的话,需要将描述写在
<<-DESC
xxx
DESC
之间。
- 5.将项目打tag,push到git上
git tag ‘1.0.0’
git push --tags
-
6.验证你的.podspec是否有效
pod spec lint
验证成功会显示:
xxx.podspec passed validation.
-
7.注册CocoaPods
pod trunk register xxx.podspec youremail.com ‘your name’ —verbose
完成之后的结果:
[!] Please verify the session by clicking the link in the verification email that has been sent to youremail.com
打开你的邮箱,会收到一封[CocoaPods] Confirm your session
的邮件,点击里面的链接,就完成了注册过程。
使用命令:pod trunk me
可以检查是否注册成功,如果返回你注册的信息,说明注册成功了。
-
8.发布pod
pod trunk push xxx.podspec
等待。。。
Creating search index for spec repo 'master'..` Done!
成功。
- 9.验证是否真的成功
`pod search xxx`
能搜索出来自己的库就说明大功告成了^_^
……Y(^_^)Y
- 10.版本更新
第一个版本上传好了之后,如果后期需要更新,不管是只更新.podspec文件,还是更新工程资源文件,此时如果进行`pod trunk push xxx.podspec `发布的话,会提示错误:
[!] Unable to accept duplicate entry for: xxx
**应该这样做:**
1.先更新.podspec文件中的 s.version版本号;
2.然后 git tag 打和.podspec中一样的tag,再将改动push到git上;
3.最后再pod trunk push
就可以了。
更新结束,然后就可以更新你本地工程的`Podfile`文件中的版本号,再执行`pod update xxx`,就可以将刚刚上传的版本拉下来,检查一下更新的版本是否有问题。
***
##遇到的问题及解决方法
- 问题1 .
NOTE | [OSX] xcodebuild: UIImageKit/UIImageKit/UIImage+Generate.h:9:9: fatal error: 'UIKit/UIKit.h' file not found
> 解决:.podspec文件没有添加下面两个字段,加上就好了
s.platform = :ios
s.framework = "UIKit"
- 问题2.
- ERROR | file patterns: The `source_files` pattern did not match any file.
> 解决:.podspec文件中的`source_files`格式填写的不对,找不到资源文件
source_files:资源文件,当前路径就是库路径,后面再拼接库文件所在的文件夹,
“” 表示匹配所有文件
“.{h,m}” 表示匹配所有以.h和.m结尾的文件
“**” 表示匹配所有子目录
- 问题3.
- WARN | description: The description is equal to the summary.
> 解决:这是一个警告,原因是.podspec中的description字段和summary字段内容填写的一样,改成不一样的就没有了。
- 问题4.
在执行
`pod trunk push UIImageKit.podspec`
命令后一只卡在
`Updating spec repo master ` 这一步,
需要等待一段时间后,会出现
[!] Unable to accept duplicate entry for: UIImageKit (1.0.0)
库其实没有传上去,搜索不到。
> 解决:
使用命令:
pod setup
再进行一次`pod trunk push`,如果还不行的话,可以使用命令:
pod repo update --verbose
- 问题5.
[!] Unable to find a pod with name, author, summary, or descriptionmatching `xxx`
> 解决:搜索不到你的库,使用下面的命令,一处搜索目录的缓存文件,然后再search
rm ~/Library/Caches/CocoaPods/search_index.json
[UIImageKit](https://github.com/Kangqj/UIImageKit/tree/master/UIImageKit)
网友评论