我们平时会开源一些库到github上,供自己和大家使用,为了使用更方便,大家可以把比较常用的或者比较不错的库支持下pod,下面以一个例子来说一下制作过程。
创建远程项目
在github上创建一个新仓库
image.png创建完成后:
1.cd到本地的某一个目录,将远程项目clone下来;
2.cd到项目目录下创建工程;
生成.podspec文件
在项目目录下执行下面代码
pod spec create SSLFoundation
这时候本地会生成一个SSLFoundation.podspec文件。
打开.podspec文件,以#开头的是注释,为了观看方便我把注释都删掉了,编辑文件:
Pod::Spec.new do |s|
s.name = "SSLFoundation"
s.version = "0.0.1"
s.summary = "iOS 基础库"
s.description = <<-DESC
iOS 基础库,持续更新
DESC
s.homepage =
s.license = "MIT"
s.author = { "SpringSunLcy" => }
s.platform = :ios, "8.0"
s.ios.deployment_target = "8.0"
s.source = { :git => :tag => "#{s.version}" }
s.source_files = "Classes/SSLFoundationHeader.h"
s.subspec 'UI' do |ss|
ss.source_files = 'Classes/UI/*.{h,m}'
end
s.subspec 'Category' do |ss|
ss.source_files = 'Classes/Category/*.{h,m}'
end
s.frameworks = "Foundation","UIKit"
end
字段说明:
- s.name 创建的pod私有库的名称
- s.version 版本
- s.summary 库的简单描述
- s.description 库的详细描述
- s.homepage 库的地址 填写私有库在GitHub上的地址即可
- s.license 专利声明,一般填写MIT 即可
- s.author 作者信息 填写方式 { "SpringSunLcy" => "" } 前面名称后面邮箱 这个用户名邮箱最好是你注册trunk cocoapods 过的。
- s.platform 支持的平台和版本
- s.source 源码地址
- s.source_files 一级文件路径,这里很容易出问题,路径一定要写对,这里的路径是指从.podspec同级目录开始算的
- s.subspec 二级文件路径,可以对照下面的实体目录:
- s.frameworks 依赖的系统frameworks
本地验证
pod lib lint SSLFoundation.podspec --verbose --use-libraries --allow-warnings
验证的时候可能会出现一些问题,不过别慌,错误都会有提示的,像下面这样,这个的错误的原因就是description是空的,按照提示修改就好。
lcy:SSLFoundation lcy$ pod lib lint SSLFoundation.podspec
-> SSLFoundation (0.0.1)
- ERROR | description: The description is empty.
- ERROR | [iOS] unknown: Encountered an unknown error (The `SSLFoundation` pod failed to validate due to 1 error:
- ERROR | description: The description is empty.
) during validation.
[!] SSLFoundation did not pass validation, due to 2 errors.
You can use the `--no-clean` option to inspect any issue.
验证通过以后有下面这样的提示:
lcy:SSLFoundation lcy$ pod lib lint SSLFoundation.podspec
-> SSLFoundation (0.0.1)
SSLFoundation passed validation.
提交代码
git add . && git commit -m "version 0.0.1"
git tag '1.0.0' //和上面.podspec一致
git push --tags
git push origin master
这里的tag一定不要忘记打,不然就会报错。
远程验证
pod spec lint SSLFoundation.podspec --verbose --use-libraries --allow-warnings
push本地的podspec文件到cocoaPods主分支上
pod trunk register "SpringSunLcy"
pod trunk push SSLFoundation.podspec --use-libraries --allow-warnings
如果trunk注册过了可以跳过注册直接推。
推送成功提示:
--------------------------------------------------------------------------------
🎉 Congrats
🚀 SSLFoundation (0.0.1) successfully published
📅 May 30th, 02:03
🌎 https://cocoapods.org/pods/SSLFoundation
👍 Tell your friends!
--------------------------------------------------------------------------------
成功后就可以pod下来了,每次修改都要升版本,改一次升一次版本。
常见问题
1. [!] Unable to find a pod with name, author, summary, or description matching 'SSLFoundation '
podspec已经推送到远程,但是使用pod search命令不能搜到上传的库可以使用 rm ~/Library/Caches/CocoaPods/search_index.json删除索引,然后再使用pod search,等一会儿就能出现了。