如何发布自己的开源框架到CocoaPods

前提你的cocopod已经安装好了,如果没有安装好,请参考这篇文章:macOS Sierra 10.12.1 (Xcode8.1) 安装CocoaPods -

1、在GitHub自己的主页新建一个仓库

如何发布自己的开源框架到CocoaPods_第1张图片
1.1


如何发布自己的开源框架到CocoaPods_第2张图片
1.2


如何发布自己的开源框架到CocoaPods_第3张图片
创建完成

2、将新建仓库clone到自己的电脑.尽量使用GitHub客户端来做,方便简单。https://desktop.github.com/  下载地址


如何发布自己的开源框架到CocoaPods_第4张图片
通过工具下载创建的仓库


如何发布自己的开源框架到CocoaPods_第5张图片
下载到本地

3、把要开源的代码,添加到这个目录下,最好带一个Demo工程,然后通过GitHub 客户端上传到github


如何发布自己的开源框架到CocoaPods_第6张图片
添加要开源的代码


如何发布自己的开源框架到CocoaPods_第7张图片
提交上传

4、项目发布到github后,需要打上tag。之后我们在工程根目录中初始化一个Podspec文件:

4.1、终端->切换到开源目录 

cd /Users/yueandy/Desktop/YqsPodSpec

4.2、创建Podspec文件

pod spec create YqsPodSpec


如何发布自己的开源框架到CocoaPods_第8张图片
创建Podspec文件

4.3、该命令将在本目录产生一个名为HUPhotoBrowser.podspec文件。用编辑器打开该文件,里面已经有非常丰富的说明文档。下面介绍如何声明第三方库的代码目录和资源目录,还有该第三方库所依赖ios核心框架和第三方库。这是我的podspec文件:

如何发布自己的开源框架到CocoaPods_第9张图片
生成的podspec文件

s.name是我们库的名称,s.version是库原代码版本号,s.summary是对我们库的一个简单的介绍,s.homepage声明库的主页,s.license是所采用的授权版本,s.author是库的作者。s.platform是我们库所支持的软件平台,这在我们最后提交进行编译 时有用。s.source声明原代码的地址。我这里是托管在github上,所以这里将地址copy过来就行了。

如何发布自己的开源框架到CocoaPods_第10张图片
主页和地址

我们开发的库中也可能还依赖第三方库,例如Alamofire,那么,就可以做如下声明:

s.dependency "Alamofire"

如果有多个需要填写多个s.dependency。

5、为你的项目添加版本号

开源许可LICENSE和podspec都做好之后,将项目push到你的远程代码仓库。

git  add .

git commit -m"添加开源许可和podspec"

git push origin master

发布开源项目到cocoapods上去需要添加版本号,用git tag添加版本号。

git tag -a 1.0.0 -m"version 1.0.0"

添加完版本号后,用'git tag'命令查看tag是否添加成功,按“Q”退出

git tag

将本地添加的tag同步到远程代码仓库:

git push --tag

6、验证podspec文的有效性:

验证podspec的有效性,检查修复语法或者逻辑错误:

pod spec lint xxx.podspec --verbose

xxx代表你的项目名字,要与上面的s.name一致。

需要注意的是:这种验证方式,存在警告也会验证不通过。

我们用可以忽略警告的验证方式(--allow-warnings),如:

pod spec lint xxxx.podspec --allow-warnings

验证车成功后会提示xxx.podspec passed validation.,如:


如何发布自己的开源框架到CocoaPods_第11张图片
验证成功

7、注册trunk账号

使用pod trunk register注册账号:

pod trunk register [email protected]"作者名"--verbose

上面的[email protected]表示邮箱

--verbose选项表示输出可见性.

注册好了之后,用pod trunk me验证注册信息.

发布代码到cocoapods

pod trunk push xxx.podspec --allow-warnings


如何发布自己的开源框架到CocoaPods_第12张图片
上传成功

之后就可以用 pod 'YqsPodSpec' 来下载自己的开源代码了

你可能感兴趣的:(如何发布自己的开源框架到CocoaPods)