一、在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:
- 首先查看以前的commit: git log --oneline
- 假如有这样一个commit:8a5cbc2 updated readme
- 这样为他添加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
如果你能看的上面的结果说明上传成功了。
3、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命令。
五、怎么删除提交到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-...