1、教你一步步用CocoaPods创建远程公有库

以下要实现的效果就是,将自己的封装的代码发布到git公开仓库里面,以后自己用或者其他的开发者使用的时候直接用cocoaPods进行集成就可以了。类似于MJRefresh一样。

首先先了解一下,当我们使用MJRefresh的时候,使用CocoaPods是怎么把MJRefresh下载到我们的项目中的?

Paste_Image.png

相关详细的说明和流程可以参考
使用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就是准备公开的代码。

Paste_Image.png

2、将自己的代码上传到个人远程公开仓库中去
2.1、git上面创建一个远程仓库
2.2、将自己的本地仓库和远程仓库进行绑定
2.3、将自己的本地代码更新到远程仓库中去

Paste_Image.png

3、创建一个pods 的描述文件 .podSpec
3.1、pod spec create MyViewExtension<这个名称一般和创建的项目名称一样就可以>

Paste_Image.png

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"相对应

Paste_Image.png

4.3、修改完毕之后进行检验一下.podspec的格式有木有问题

pod lib lint
Paste_Image.png

可以看到没有通过,有一个警告。换一种检验的方式,忽略所有的警告进行格式的检验,当然了不建议忽略。

pod lib lint --allow-warnings
Paste_Image.png

5、将当前本地的podspec文件传到CocoaPods官方的索引库中
5.1、

pod trunk register zy_iOS2163.com 'zy' --description='macbook air' --verbose

你注册的时候需要替换邮箱和名字,加上 --verbose 可以看到详细信息。
然后顺利的话你会收到一份邮件,收到的邮件有可能在邮件垃圾箱中,需要点击验证。
验证完毕之后


Paste_Image.png

5.3、执行命令,将 .podspec push到cocopods的trunk中

pod trunk push MyViewExtension.podspec 

然后等着,得需要等些时间。
Updating spec repo master
结果失败了

Paste_Image.png

原因就是 之前验证的那个警告
上面可以忽略,下面就也可以忽略,当然了不建议忽略。

pod trunk push MyViewExtension.podspec  --allow-warnings 
成功.png

6、测试一下,有没有上传到CocoaPods的索引库中
6.1、直接 pod search MyViewExtension检查一下
发现没找到?是我们没有更新到CocoaPods的spec索引远程库中吗?

Paste_Image.png

原因是因为,我们去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

还是不行。


image.png

原因,清除一下podSearch的查询缓存列表。干掉这个文件


image.png

再次
pod search MyViewExtension
image.png

image.png

完成!!

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集成的远程私有公有库如何使用图片资源
如有失误请各位路过大神即时指点,或有更好的做法,也请指点一二。在下不甚感激

推荐阅读更多精彩内容