原文链接http://blog.ltove.com/article/166.html
在ios
项目的实际开发中我们经常会使用cocoapods
来管理第三方框架,那么我们如何像大牛们一样将自己写的开源组件或者开源库发布到cocoapods
,方便同行小伙伴使用pod install
命令来集成自己的框架呢,接下来就讲一下如何发布自己的开源库,分为以下几个主要步骤。
关联git仓库
初始化本地git仓库
初始化本地仓库很简单,执行下边命令即可
git init
关联远程仓库
远程仓库的选择上推荐GitHub,(毕竟牛逼的开源代码都在这上边),本文采用的是自己搭建的gitlab,首先我们为本地仓库添加远程仓库地址
git remote add origin http://git.ltove.com/ltove/PodTestTGW.git
执行完上边的命令,如果没报错的话我们就建立了本地仓库与远程仓库的关键(当然如果报错请根据提示解决错误,在此不再累述git相关的错误),然后我们要做的是合并push
到远程仓库
git push -u origin master
执行这条命令会自动创建远程响应的分支,并推送本地代码到远程仓库
到此我们git仓库的准备工作已经完成(发布时需要打tag的,打tag的命令这里不再累述,实在不会的小伙伴可以使用GitHub管理UI页面点击操作)
创建自己项目的Podspec描述文件并根据项目实际需要编辑适合自己项目的Podspec文件
创建描述文件其实很简单,执行如下命令就会生成一个文件模板供我们使用,当然你可以去参考牛人的第三方来改写自己的描述文件,主要看你的喜好了,我们这里用的是生成的文件模板。
pod spec create podTestTgw
这条命令执行完毕将在当前目录产生一个名为podTestTgw.podspec的文件,我们可以使用我们喜欢的编辑器打开它,因为他的注释文档已经相当丰富,我们可以根据需要去修改项目依赖的核心框架和第三方库等,具体请看我的podspec详解,这里我的Podspec文件大致为:
Pod::Spec.new do |s|
s.name = "PodTestTGW"
s.version = "0.0.1"
s.summary = "A short description of PodTest."
s.homepage = "http://EXAMPLE/PodTest"
s.license = "MIT"
s.author = { "LTOVE" => "t@ltove.com" }
s.platform = :ios, "7.0"
s.source = { :git => "http://git.ltove.com/ltove/PodTestTGW.git", :tag => "#{s.version}" }
s.source_files = "PodTest", "podTest/**/*.{h,m}"
s.exclude_files = "Classes/Exclude"
end
测试Podspec文件(检测是否有语法错误)
我们可以执行命令来检测刚刚编写的描述文件是否有错,如果发现错误根据提示就该相应的描述文件即可
pod spec lint PodName.podspec
当你的终端出现类似PodTestTGW.podspec passed validation.
的时候,那么恭喜你检测通过来,离成功又进了一大步
如果只是供自己使用的话,我们把编辑好的描述文件拷贝到~/.cocoapods/repos/master/Specs
目录就好啦(如果自己用貌似没人会这么折腾)
发布到cocoapods
发布到cocoapods首先要确认一下自己是否注册
pod trunk me
如果你已经注册了你将看到下边的注册信息
- Name: ltove
- Email: t@ltove.com
- Since: January 21st, 21:23
- Pods: None
- Sessions:
- January 21st, 21:23 - May 29th, 21:38. IP: 58.132.214.66 Description:
ltove MackBook Pro
没注册的我们需要执行下边的命令注册
pod trunk register t@ltove.com 'ltobe' --description='device desc like MakeBook Pro' --verbose
其中--decriotion
是设备描述,你根据实际需要写
--verbose
表示啰嗦模式,执行过程中会打印相关信息,这个参数可以不写
还有就是邮箱一定要换成自己的
执行完检查邮箱,点击邮箱中收到的连接即可注册完成,找不到的话就去垃圾箱找
如果你的项目是由多个人维护的,你可以执行命令添加维护者可以执行
pod trunk add-owner name who@demoin.com
其他命令可以执行pod trunk ?
根据手册提示执行
以上工作完成之后,你就可以上传了,赶紧执行命令吧
pod trunk push
耐心等待之后如果没报错你将看到如下信息
For more information, see https://blog.cocoapods.org and the CHANGELOG for this version at https://github.com/CocoaPods/CocoaPods/releases/tag/1.6.0.beta.2
--------------------------------------------------------------------------------
🎉 Congrats
🚀 PodTestTGW (0.0.1) successfully published
📅 January 21st, 23:46
🌎 https://cocoapods.org/pods/PodTestTGW
👍 Tell your friends!
--------------------------------------------------------------------------------
那么到此恭喜你,你已经完成了自己开源库的cocoapods发布,赶紧去告诉小伙伴来集成吧