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

1、在GitHub上建立项目

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

2、在GitHub上建立Tag

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

一、查看

列出全部tag:
git tag 这样列出的tag是按字母排序的,和建立时间不要紧。
若是只是想查看某些tag的话,能够加限定:git tag -l v1.* 这样就只会列出1.几的版本。git

二、建立

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:github

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

三、删除

git tag -d v1.0
本地删除好像不会同步到GitHub上,能够在GitHub项目里直接删除。正则表达式

四、验证

若是你有GPG私钥的话就能够验证tag:git tag -v v1.0json

五、上传

咱们在执行git push的时候,tag是不会上传到服务器的,好比如今的github,建立tag后git push,在github网页上是看不到tag的,为了共享这些tag,你必须这样:上传全部tag:git push origin --tags 上传某个tag:git push origin v1.0swift

3、建立 .podspec 文件进行配置

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

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" => "zhugezhan32@sina.cn" }
  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的人也没法使用。框架

4、发布到 Cocoapods 进行管理

一、注册Trunk(第一次须要注册)
pod trunk register zhugezhan32@sina.cn 'ZhugeZhan' --description='macbook air'
你们在注册时须要替换成本身的邮箱和用户名,一切顺利的话就会收到一份邮件,点击邮件中的连接后验证一下。
邮件验证完成以后pod trunk me
固然,若是你的pod是由多人维护的,你也能够添加其余维护者:
pod trunk add-owner ARAnalytics kyle@cocoapods.org

二、Trunk push
pod trunk push 命令会首先验证你本地的podspec文件(是否有错误),以后会上传spec文件到trunk,最后会将你上传的podspec文件转换为须要的json文件。在包含有.podspec目录下执行命令:pod trunk push
图片描述
若是你能看的上面的结果说明上传成功了。

三、pod search 没有结果

先执行 pod setup
执行完以后,能够根据下面截图的步骤:打开地址,点击SeePodspec,而后在本地的~/.cocoapods/repos/master/Specs目录下 看到转换以后的json文件。
图片描述
而后执行 rm ~/Library/Caches/CocoaPods/search_index.json
这样再pod search 就会先更新search_index.json文件,就能找到结果了。
至此咱们整个制做本身的开源库的过程就完成了,之后有新版本须要在GitHub上建立新的tag,而后修改podspec文件(s.version必定要改)就好了,而后从新执行pod trunk push命令。

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

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

6、参考文章:

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

相关文章
相关标签/搜索