先来个 Demo, 点击即可下载
一: 建立自己的GitHub仓库
1. 第一个红长方形的是一个README的说明文档,一般第三方库都需要
2. 第二个是license文件,正规的仓库都应该有一个，Pods依赖库对这个文件的要求更严，是必须要有的。因此最好在这里让github创建一个，也可以自己后续再创建。我使用的license类型是MIT。
3. 其他的按照需求自行填写
二: clone仓库到本地
1. 可以使用git将将仓库clone到本地
$ git clone https://github.com/KangSky123/WKCategory.git
2. 用SourceTree下载进行管理
3. 下载之后将工程拖进去进行管理
三: 导入所需文件
说明:工程中所需的文件一共需要五种文件,1.后缀为.podspec的文件,2.LICENSE文件,3.主类文件,4.README.md,5.demo工程
1. 后缀为.podspec的文件(这一步最重要,也是最容易出错)
pod spec create WKCategory
(1).首先创建一个.podspec文件(使用命令行进行创建)
(2).生成之后打开会有很多内容,个人是将全部删除,然后找GitHub上边的第三方的.podspec文件进行复制和修改,具体的各个参数以及内容,请参照http://www.jianshu.com/p/7a82e977281c,下面只列出本例子的.podspec文件内容
Pod::Spec.new do |s|
s.name = "WKCategory"
s.version = "0.0.1"
s.summary = "all kinds of categories for iOS develop"
s.description = <<-DESC
this project provide all kinds of categories for iOS developer
DESC
s.homepage = "https://github.com/KangSky123/WKCategory"
s.license = "MIT"
s.license = { :type => "MIT", :file => "LICENSE" }
s.author = { "HuangWenKang" => "[email protected]" }
s.platform = :ios
s.source = { :git => "https://github.com/KangSky123/WKCategory.git", :tag => "0.0.1" }
s.source_files = "Classes", "WKCategory/Classes/**/*.{h,m}"
s.exclude_files = "Classes/Exclude"
s.requires_arc = true
end
注意: 在填写s.source_files的时候请确定清楚路径是否准确,此路径是主类文件的路径,是相对.podspec文件路径,如果需要引入头文件,则需要s.public_header_files
(3).编写完成之后,使用 pod lib lint 进行验证,如果有错误,按照提示修改文件内容
git tag -m 'first release' '0.0.1'
git push --tag #推送tag到远端仓库
四: 打tag, 发布一个release版本
五: 将工程上传到GitHub
使用git上传或者SourceTree上传(上述的所需文件都要放到该工程中一起上传)
六: 发布自己的库描述文件podspec给cocoapods
(1). 出现下面的样式之后,说明已经创建成功
七: 查找和使用新库
在成功之后使用 pod search WKCategory 无法找到自己的库时候,需要进行下面操作,运行之后会有几分钟的等待时间
pod setup
rm ~/Library/Caches/CocoaPods/search_index.json
pod search WKCategory
八:更新维护podspec
如果有错误或者需要迭代版本,修改工程文件后推送到远端仓库后, 需要修改podspec中的版本号, 并重新打tag上传, 再进行新一轮的验证和发布, 当然, 创建一个演示demo工程供其他开发者下载查看并不会影响我们的pod库.
总结:走完整个流程中,只有在第三步设置.podspec文件中遇到了瓶颈,source_file的路径需要准确,是因为本地工程的路径有错,上传后也出现问题
拓展:
source_file文件路径写法和含义:
"yooweitest/*
"yooweitest/yoowei/*.{h,m}"
"yooweitest/**/*.h"
“*” 表示匹配所有文件
“*.{h,m}” 表示匹配所有以.h和.m结尾的文件
“**” 表示匹配所有子目录