CocoaPods之公有仓库的创建

目录

Cocoapods之安装及使用
CocoaPods之公有仓库的创建

一、创建GitHub仓库
二、注册CocoaPods账号
三、创建 .podspec文件
四、 配置编辑.podspec文件
五、提交框架库索引到CocoaPods

一、注册GIthub账号,提交代码到GitHub仓库,就以我封装的原生二维码扫描工具类WSLNativeScanTool为例,文件目录如下图,让它支持CocoaPods:

CocoaPods之公有仓库的创建_第1张图片
GitHub仓库目录

二、注册CocoaPods账号:

  • 用终端命令行注册CocoaPods账号,有账号的话也跳不过这一步,因为他的账号没有类似登陆的机制,所以在你切换设备后,需要再次使用如下的注册命令进行“登陆”操作;如果还没安装CocoaPods,先看一下我的另一篇文章Cocoapods的安装及使用。
//注册cocoapods维护者信息,邮箱[email protected] 和 用户名WSL,注册之后邮箱会收到一封确认邮件,打开邮件点击确认链接,完成注册。
pod trunk register [email protected]  'WSL'    或 
pod trunk register [email protected]  'WSL'  --description='设备信息' 
//查看自己的注册信息 
pod trunk me  
//如果多人维护pod 可以添加其他维护者
pod trunk add-owner name [email protected]
CocoaPods之公有仓库的创建_第2张图片
注册CocoaPods账号终端命令行.png

三、创建 .podspec文件

关于Podsepc文件:在所有支持Cocoapods导入的库的开源目录(如Github)下,我们都能看到一个*.podspec文件。当然我们不管是做公有库或者是私有库都是必须配置这个文件的。这个文件是告诉Cocoapods你这个库的一些基本信息,包括你的版本号、获取的地址、那些文件是希望被包含进来的等一些信息。
这个文件是在你新建或者需要新提交一个版本的时候回进行改动的文件。
.podspec要放在clone到本地的git仓库的根目录下面,并提交到Github的。

第一种方式:适用于那些已经创建好项目的情况,只需要在你的管理目录下生成一个podspec文件。
  • cd 到管理目录下, 在管理目录下运行如下命令,创建生成WSLNativeScanTool.podspec文件 , WSLNativeScanTool为工程名,
pod spec create WSLNativeScanTool    //创建生成WSLNativeScanTool.podspec文件
CocoaPods之公有仓库的创建_第3张图片
创建 .podspec文件

第二种方式:适用于连项目都没有创建的情况,Cocoapods还提供了如下命令:
pod lib create WSLSDK  //WSLSDK项目名称

通过这条命令会创建好一个项目,在执行这个项目的过程中,根据命令行的引导,你会创建好一个Cocoapdos定义好的一个项目模板。如果对于刚开始创建项目的小伙伴们来说,或许这个是一个不错的选择。通过这个命令Cocoapods会给你创建好,Podspec文件,travis文件,MIT Lisence文件以及README.md文件等。这些项目文件也是要提交到Github上的。

CocoaPods之公有仓库的创建_第4张图片
屏幕快照 2018-03-16 下午3.47.35.png
CocoaPods之公有仓库的创建_第5张图片
屏幕快照 2018-03-16 下午3.51.15.png

四、 配置编辑.podspec文件

这里介绍两种编辑.podspec文件的方式:

  • 第一种方式:终端命令行
vim WSLNativeScanTool.podspec

首先cd 到WSLNativeScanTool.podspec 所在目录下,执行vim WSLNativeScanTool.podspec 编辑命令,然后点击键盘上的" i "进入编辑模式,编辑完毕之后首先点击"esc",然后按Esc,并且输入“ : ”号进入vim命令模式,然后输入wq,回车后编辑结束。

CocoaPods之公有仓库的创建_第6张图片
编辑结束之后的命令行.png
CocoaPods之公有仓库的创建_第7张图片
编辑过程中 — 输入" i "后进入的编辑界面.png

  • 第二种方式:文本编辑工具

直接用文本编辑工具打开WSLNativeScanTool.podspec进行编辑

CocoaPods之公有仓库的创建_第8张图片
文本编辑WSLNativeScanTool.podspec

  • 编辑内容之前,你需要在Github上创建release版本的代码:
CocoaPods之公有仓库的创建_第9张图片
在Github上创建release版本

点进去之后步骤很简单,填上版本号,标题和简单的描述即可,需要注意的是版本号需要与你的podspec文件中的s.version 相同。

编辑的内容,配置参数信息如下:

Pod::Spec.new do |spec|
   spec.name         = "WSLNativeScanTool"
   spec.version      = "1.0"
   spec.summary      = "iOS 封装原生二维码扫描和生成."
   spec.homepage     = "https://github.com/wsl2ls/ScanQRcode"
   spec.license      = { :type => "MIT", :file => 'README.md' }
   spec.author       = { "PlutoY" => "[email protected]" }
   spec.platform     = :ios, "8.0"
   spec.source       = { :git => "https://github.com/wsl2ls/ScanQRcode.git", :tag => "v#{spec.version}" }
   spec.frameworks   = 'UIKit'
   spec.source_files  = "WSLNativeScanTool", "WSLNativeScanTool/**/*.{h,m}"
   spec.requires_arc = true
end
//参数意义依次是 :Cocoapods上的名字、版本号,简介、主页、License、作者信息、最低平台信息、从哪个Git上下载、需要引入的framework、那些文件需要被引入,那些文件是资源文件以及是否需要ARC的模式。

s.name pods名称
s.version 版本号 此版本号需要与github中tag的内容一致
s.summary 简短说明
s.homepage github工程的链接地址
s.source github工程的地址追加.git
“ * ” 表示匹配所有文件
“ * .{h,m}” 表示匹配所有以.h和.m结尾的文件
“**” 表示匹配所有子目录
查看完整参数 http://guides.cocoapods.org/syntax/podspec.html

  • 编辑配置完成后,不要着急,我们先验证自己的GOVAVPlayer.podspec文件格式的有效性,如果这里不通过,就没必要上传了。
//在上传CocoaPods之前,验证WSLNativeScanTool.podspec文件格式的有效性, --allow-warnings 为忽略警告的意思
pod spec lint  --allow-warnings  //本地和远程库同时检索) 
或
pod lib lint WSLNativeScanTool.podspec --allow-warnings  //检索本地索引文件
CocoaPods之公有仓库的创建_第10张图片
验证WSLNativeScanTool.podspec文件格式的有效性

五、提交框架库索引到CocoaPods

验证WSLNativeScanTool.podspec文件格式的有效性成功时,执行如下命令上传代码到CocoaPods:

//上传代码到CocoaPods  需要等待一段时间
pod trunk push WSLNativeScanTool.podspec --allow-warnings

这里 "--allow-warnings",也是忽略警告的意思,如果不加该关键字的话,如果在执行"pod spec lint"时候报出了警告,那么在这里上传代码到CocoaPods时就会报错。

CocoaPods之公有仓库的创建_第11张图片
提交框架代码到CocoaPods

说明发布成功,你就可以通过上面的URL: https://cocoapods.org/pods/WSLNativeScanTool 进入的Pods查看自己的仓库信息了. 也可以执行 $ pod search WSLNativeScanTool 命令查询库信息。

CocoaPods之公有仓库的创建_第12张图片

注意:发布到Cocoapods后,需要在终端更新本地pods仓库信息:$ pod setup


参考文献:
http://blog.csdn.net/youtk21ai/article/details/50750300
http://qiubaiying.top/2017/03/08/CocoaPods公有仓库的创建/
https://blog.csdn.net/zhaojinqiang12/article/details/80211057#t0
https://blog.csdn.net/sdefzhpk/article/details/69389584

你可能感兴趣的:(CocoaPods之公有仓库的创建)