在GitHub上分享自己的第三方框架以供pod使用

一、在GitHub上创建项目

1.在GitHub上创建一个项目,包括开源协议。
2.先clone到本地,放入第三方框架,然后push。

二、在GitHub上创建Tag

我们可以创建一个tag来指向软件开发中的一个关键时期,比如版本号更新的时候可以建一个“v2.0”、“v3.1”之类的标签,这样在以后回顾的时候会比较方便。tag的使用很简单,主要操作有:查看、创建、删除、验证、上传。

1、查看

列出所有tag:
git tag 这样列出的tag是按字母排序的,和创建时间没关系。
如果只是想查看某些tag的话,可以加限定:git tag -l v1.* 这样就只会列出1.几的版本。

2、创建

git tag -a v1.0 -m 'first version' -m后面带的就是注释信息,这样在日后查看的时候会很有用,这种是普通tag。
还有一种有签名的tag:git tag -s v1.0 -m 'first version' 前提是你有GPG私钥,把上面的a换成s就行了。
除了可以为当前的进度添加tag,我们还可以为以前的commit添加tag:

  1. 首先查看以前的commit: git log --oneline
  2. 假如有这样一个commit:8a5cbc2 updated readme
  3. 这样为他添加tag: git tag -a v1.18a5cbc2

3、删除

git tag -d v1.0
本地删除好像不会同步到GitHub上,可以在GitHub项目里直接删除。

4、验证

如果你有GPG私钥的话就可以验证tag:git tag -v v1.0

5、上传

我们在执行git push的时候,tag是不会上传到服务器的,比如现在的github,创建tag后git push,在github网页上是看不到tag的,为了共享这些tag,你必须这样:上传所有tag:git push origin --tags 上传某个tag:git push origin v1.0

三、创建 .podspec 文件进行配置

在工程根目录中初始化一个Podspec文件:pod spec create UMessage_1.5.0a.podspec
Podspec文件内容:

Pod::Spec.new do |s| 
  s.name         = "UMessage_1.5.0a"
  s.version      = "1.5.0a"
  s.summary      = "无IDFA版本"
  s.description  = <<-DESC
                   U-Push 友盟官方 SDK
                   DESC
  s.homepage     = "https://github.com/ZhugeZhan/UMessage_1.5.0a"
  s.license      = { :type => "MIT", :file => "LICENSE" }
  s.author       = { "ZhugeZhan" => "[email protected]" }
  s.platform     = :ios, "8.0"
  s.source       = { :git => "https://github.com/ZhugeZhan/UMessage_1.5.0a.git", :tag => "#{s.version}" }
  s.source_files = "UMessage_Sdk_1.5.0a", "UMessage_Sdk_1.5.0a/**/*.{h,m}"
  s.vendored_libraries = 'UMessage_Sdk_1.5.0a/**/*.a'
  s.framework   = "UserNotifications"
  s.library     = "z"
end

说明:
s.name是我们库的名称(和Podspec文件名一致)
s.version是库原代码版本号
s.summary是对我们库的一个简单的介绍
s.homepage声明库的主页
s.license是所采用的授权版本
s.author是库的作者
s.platform是我们库所支持的软件平台,这在我们最后提交进行编译时有用
s.source声明原代码的地址
s.source_files声明了我们库的源代码的位置(从项目根目录文件夹下开始)
目录的层级关系一定要跟代码库的保持一致。这里前一部分可以不用的,因为我这里后一部分的HUPhotoBrowser/*与前面是一致的,这个指定的目录下的文件都会进行编译。.{h,m}是一个类似正则表达式的字符串,表示匹配所有以.h和.m为扩展名的文件。
s.source声明原代码的地址
s.source_files声明了我们库的源代码的位置(从项目根目录文件夹下开始)
目录的层级关系一定要跟代码库的保持一致。这里前一部分可以不用的,因为我这里后一部分的HUPhotoBrowser/*与前面是一致的,这个指定的目录下的文件都会进行编译。.{h,m}是一个类似正则表达式的字符串,表示匹配所有以.h和.m为扩展名的文件。
s.resourcs声明如果该目录下还有一些资源文件(如图片等),这些文件并不需要进行编译。
s.vendored_libraries声明了所需要的静态库文件(框架里面自带的)
s.library声明了所依赖的系统静态库文件(多个s.libraries = "A", "B")
s.framework 声明了所依赖的核心库 (多个s.frameworks = "A", "B")
s.dependency 我们开发的库中也可能还依赖第三方库,例如JSONKit,那么,就可以做如下声明: s.dependency "JSONKit", "~> 1.4"
如果有多个需要填写多个 s.dependency

编辑完podspec文件后,需要验证一下这个文件是否可用,如果有任何WARNING或者ERROR都是不可以的,它就不能被添加到Spec Repo中,不过xcode的WARNING是可以存在的,验证需要执行命令:pod spec lint UMessage_1.5.0a.podspec
注:不建议尝试。如果框架只使用静态库需要加上--use-libraries,但是这会导致 use_frameworks! 不能把框架用pod导入项目,使用swift的人也无法使用。

四、发布到 Cocoapods 进行管理

1、注册Trunk(第一次需要注册)
pod trunk register [email protected] 'ZhugeZhan' --description='macbook air'
大家在注册时需要替换成自己的邮箱和用户名,一切顺利的话就会收到一份邮件,点击邮件中的链接后验证一下。
邮件验证完成之后pod trunk me
当然,如果你的pod是由多人维护的,你也可以添加其他维护者:
pod trunk add-owner ARAnalytics [email protected]

2、Trunk push
pod trunk push 命令会首先验证你本地的podspec文件(是否有错误),之后会上传spec文件到trunk,最后会将你上传的podspec文件转换为需要的json文件。在包含有.podspec目录下执行命令:pod trunk push
在GitHub上分享自己的第三方框架以供pod使用_第1张图片
如果你能看的上面的结果说明上传成功了。

3、pod search 没有结果

先执行 pod setup
执行完之后,可以根据下面截图的步骤:打开地址,点击SeePodspec,然后在本地的~/.cocoapods/repos/master/Specs目录下 看到转换之后的json文件。
在GitHub上分享自己的第三方框架以供pod使用_第2张图片
然后执行 rm ~/Library/Caches/CocoaPods/search_index.json
这样再pod search 就会先更新search_index.json文件,就能找到结果了。
至此我们整个制作自己的开源库的过程就完成了,以后有新版本需要在GitHub上创建新的tag,然后修改podspec文件(s.version一定要改)就行了,然后重新执行pod trunk push命令。

五、怎么删除提交到cocoapods上的框架?

pod trunk delete AFNetwroing 3.0.1 来删除指定版本的pods (未验证)

六、参考文章:

《如何发布自己的开源框架到CocoaPods》http://www.cocoachina.com/ios...
《如何使用Cocoapods管理自己github上的项目,并让其支持pod》http://www.jianshu.com/p/f146...
《GitHub创建Tag》 http://caibaojian.com/github-...

你可能感兴趣的:(github,cocoapods)