注:本项目采用Davis-Category的名称来举例, 具体需要根据你自己的项目名更换
第一步: github新建一个repository,配置信息如下:
第二步: 克隆到本地
新建本地项目文件,cd到文件目录下执行:
$ git clone https://github.com/cuirhong/Davis-Category.git
第三步: 配置编辑文件
3.1 使用xcode新建一个项目到你的本地文件下
3.2 新建一个Source的文件,这个文件也就是你的cocopods库文件
如下:
第四步:注册Cocoapods
4.1 已经注册过的不需要注册,怎么看自己有没有注册
$ pod trunk me (如果出现Name Email等信息就代表已经注册过了)
4.2 trunk需要CocoaPods 0.33版本以上,用pod --version命令查看版本,如果版本低,需要升级
$ pod --version(如果低于0.33则使用下面的命令升级)
$ sudo gen install cocoapods
$ pod setup
4.3 若未注册,执行以下命令,邮箱以及用户名请对号入座。用户名我使用的是Github上的用户名。
// 加上--verbose可以输出详细错误信息,方便出错时查看。
// [email protected]是邮箱 davis:是用户名(这些根据自己定义)
$ pod trunk register [email protected] 'davis' --verbose
4.4 注册完成之后使用pod trunk me查看是否有name和email等信息
第五步: 创建.podspec
cd到你项目的目录,执行命令
$ pod spec create Davis-Category
第六步: 编辑.podspec
创建好后,打开.podspec,删除注释, 前面有#的为注释,也可以用以下代码替换,然后编辑自己的库信息(复制下面的直接全部替换掉,按照图片的标注填写)
Pod::Spec.new do |s|
s.name = 'DDLoadHud'
s.version = '0.1.3'
s.authors = { 'davis' => '[email protected]' }
s.homepage = 'https://github.com/cuirhong/DDLoadHud'
s.summary = 'a load hud for wechat video.'
s.source = { :git => 'https://github.com/cuirhong/DDLoadHud.git',
:tag => s.version.to_s }
s.license = { :type => "MIT", :file => "LICENSE" }
s.platform = :ios, '9.0'
s.requires_arc = true
s.source_files = 'Source/**/*.swift'
s.ios.deployment_target = '8.0'
s.swift_version = '5.0'
end
s.name:名称,pod search搜索的关键词,注意这里一定要和.podspec的名称一样,否则报错
s.version:版本号,to_s:返回一个字符串
s.author:作者
s.homepage:项目主页地址
s.summary:项目简介
s.source:项目源码所在地址
s.license:许可证
s.platform:项目支持平台
s.requires_arc:是否支持ARC
s.source_files:需要包含的源文件
s.public_header_files:需要包含的头文件
s.ios.deployment_target:支持的pod最低版本
s.source常见写法
s.source = { :git => "https://github.com/liugangios/IFMMenu.git", :commit => "68defea" }
s.source = { :git => "https://github.com/liugangios/IFMMenu.git", :tag => 1.0.0 }
s.source = { :git => "https://github.com/liugangios/IFMMenu.git", :tag => s.version }
第七步:上传项目(Source里面的类需要使用open修饰)
7.1 将本地项目文件上传到远程私有库中:
$ git add .
$ git commit -m '备注做了哪些修改'
$ git push
7.2 将自己的项目打成tag(这里的 tag也就是上一步的s.version)
因为cocoapods是依赖tag版本的,所以必须打tag,以后再次更新只需要把你的项目打一个tag,然后修改.podspec文件中的版本接着提交到cocoapods官方就可以了,提交命令请看下面
$ git tag "0.0.1"
$ git push --tags
第八步: 验证.podspec
使用以下命令测试本地.podspec文件是否存在语法错误。
$ pod spec lint Davis-Category.podspec --verbose
注意: 如果出现一些错误,可以尝试从新提交代码到git,并且添加一个新的tag,并且s.version也需要修改为对应的tag
第九步: 创建spec repo
9.1 指定管理 lib repo 的 specs repo 的 url
下面的地址是自己git仓库的地址,Davis-Category是Name
$ pod repo add Davis-Category https://github.com/cuirhong/Davis-Category.git
9.2 推送 podspec 到 specs repo
一下除了名称了地址外,格式必须这样写
pod repo push Davis-Category Davis-Category.podspec --sources=https://github.com/cuirhong/Davis-Category.git
成功之后会看到如下:
第十步:到这里我们就算大功高成啦
新建一个项目,到里面加入Pod Davis-Category
执行pod install试试
如果失败的话,修改profile文件里面为 Pod Davis-Category, :git => 'https://github.com/cuirhong/Davis-Category.git'
再pod install应该就成功啦