以下要实现的效果就是,将自己的封装的代码发布到git公开仓库里面,以后自己用或者其他的开发者使用的时候直接用cocoaPods进行集成就可以了。类似于MJRefresh一样。
首先先了解一下,当我们使用MJRefresh的时候,使用CocoaPods是怎么把MJRefresh下载到我们的项目中的?
相关详细的说明和流程可以参考
使用CocoaPods是怎么把三方库下载到本地的?</a>
那么我们需要做的工作包括以下几点
1>、创建一个本地的仓库,将自己想要公开的代码搞进去。
2>、将自己的代码上传到远程公开仓库中去
3>、创建一个pods 的描述文件 .podSpec
4>、修改.podSpec描述文件中的相关的描述信息
5>、将当前本地的.podSpec文件传到CocoaPods官方的索引库中
6>、测试一下,有没有上传到CocoaPods的索引库中
7>、后期的升级维护
具体详细的步骤如下
1、创建一个本地的仓库,将自己想要公开的代码搞进去。
1.1、准备要公开的代码完成之后,git init 创建一个本地的仓库
1.2、cd 到准备公开的代码目录
1.3、git add .
1.4、git commit -m "create"
创建一个OC项目,将自己的要公开的代码放在其中,便于测试,MyViewExtenion就是准备公开的代码。
2、将自己的代码上传到个人远程公开仓库中去
2.1、git上面创建一个远程仓库
2.2、将自己的本地仓库和远程仓库进行绑定
2.3、将自己的本地代码更新到远程仓库中去
3、创建一个pods 的描述文件 .podSpec
3.1、pod spec create MyViewExtension<这个名称一般和创建的项目名称一样就可以>
4、修改.podspec描述文件中的相关的描述信息
详情可参考CocoaPods的官网的PodSpec语法
.podspec可以选择使用Xcode进行打开修改
4.1、这里面主要注意这么几个地方就可以了
Pod::Spec.new do |s|
# 项目的名称
s.name = "MyViewExtension"
# 项目的版本号,通过项目git的tag标签进行对应,这里的标签代表的版本
s.version = "0.0.1"
# 项目简单的描述信息
s.summary = "Just Testing."
# 项目的详细描述信息,注意,这里的文字的长度,一定要比上面的s.summary长,不然会认为格式不合格
s.description = "MyViewExtension ****"
# 项目的网页主页信息,这里可以直接写自己的远程仓库的主页的地址
s.homepage = "https://github.com/RunOfTheSnail/MyViewExtension" #主页,这里要填写可以访问到的地址,不然验证不通过
#截图
# s.screenshots = "www.example.com/screenshots_1", "www.example.com/screenshots_2"
# 开源协议
s.license = 'MIT'
# 作者信息
s.author = { "zhangyan" => "zy_iOS@163.com" }
# 这个比较重要,指的就是git的对应的远程仓库的地址以及版本号,版本号直接获取的是上面的s.version
# 项目地址,这里不支持ssh的地址,验证不通过,只支持HTTP和HTTPS,最好使用HTTPS
s.source = { :git => "https://github.com/RunOfTheSnail/MyViewExtension.git", :tag => s.version }
# 多媒体介绍地址
# s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'
# 支持的平台及版本
s.platform = :ios, '7.0'
# 代码源文件地址,**/*表示Classes目录及其子目录下所有文件,如果有多个目录下则用逗号分开,如果需要在项目中分组显示,这里也要做相应的设置
s.source_files = "MyViewExtension", "MyViewExtension/**/*"
# 资源文件地址
# s.exclude_files = "Classes/Exclude"
# 公开头文件地址
# s.public_header_files = 'Pod/Classes/**/*.h'
# 所需的framework,多个用逗号隔开
s.frameworks = 'UIKit'
# 依赖关系,该项目所依赖的其他,当在加载的时候也会一块把相关的依赖的库加载下来,如果有多个需要填写多个
# s.dependency 'AFNetworking', '~> 2.3'
# 是否使用ARC,如果指定具体文件,则具体的问题使用ARC
s.requires_arc = true
end
4.2、用git添加一个tag来和.podspec中的 s.version = "0.0.1"相对应
4.3、修改完毕之后进行检验一下.podspec的格式有木有问题
pod lib lint
可以看到没有通过,有一个警告。换一种检验的方式,忽略所有的警告进行格式的检验,当然了不建议忽略。
pod lib lint --allow-warnings
5、将当前本地的podspec文件传到CocoaPods官方的索引库中
5.1、
pod trunk register zy_iOS2163.com 'zy' --description='macbook air' --verbose
你注册的时候需要替换邮箱和名字,加上 --verbose 可以看到详细信息。
然后顺利的话你会收到一份邮件,收到的邮件有可能在邮件垃圾箱中,需要点击验证。
验证完毕之后
5.3、执行命令,将 .podspec push到cocopods的trunk中
pod trunk push MyViewExtension.podspec
然后等着,得需要等些时间。
Updating spec repo master
结果失败了
原因就是 之前验证的那个警告
上面可以忽略,下面就也可以忽略,当然了不建议忽略。
pod trunk push MyViewExtension.podspec --allow-warnings
6、测试一下,有没有上传到CocoaPods的索引库中
6.1、直接 pod search MyViewExtension检查一下
发现没找到?是我们没有更新到CocoaPods的spec索引远程库中吗?
原因是因为,我们去pod search MyViewExtension的时候是去我们本地的CocoaPods的spec列表仓库中查找的。
解决的办法就是,干掉这个本地的CocoaPods的spec列表仓库,重新下载一下
6.2、干掉本地的CocoaPods的spec列表仓库,重新下载一下
cd ~/.cocoapods/repos
open .
删掉 master那个文件夹,然后
git clone https://github.com/CocoaPods/Specs.git master
漫长的等待.......
安装完毕之后,迫不及待的
pod search MyViewExtension
还是不行。
原因,清除一下podSearch的查询缓存列表。干掉这个文件
再次
pod search MyViewExtension
完成!!
7、后期的升级维护
7.1、更新远程公开库中的代码
7.2、修改.podspec中的配置,最起码你的version得升级一个版本,就像iOS的app上线一样。如果你添加了其他的内容,比如封装了一下AFN的请求,那么就会依赖AFNetworking这个库,那么就要添加相关的依赖库了
such as:**s.dependency 'AFNetworking', '~> 3.0' **
7.3、给当前的远程仓库的代码,重新打个tag,标签和.podspec的version一样
7.4、远程仓库的代码更新完毕了,tag也打了,.podspec也重新配置完了,接下来执行上面的 第五条、将当前本地的spec文件传到CocoaPods官方的索引库中
7.5、需要检查使用的话还是上面的 第六条、测试一下,有没有上传到CocoaPods的索引库中
下一篇:2、教你一步步用CocoaPods创建远程私有库
扩展篇:实现CocoaPods的subspec分支功能
扩展篇:使用CocoaPods集成的远程私有公有库如何使用图片资源
如有失误请各位路过大神即时指点,或有更好的做法,也请指点一二。在下不甚感激