手把手教你发布自己的开源框架到CocoaPods

Posted W_C__L

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了手把手教你发布自己的开源框架到CocoaPods相关的知识,希望对你有一定的参考价值。

移动端显示不佳,请访问我的个人博客

偶尔会发布自己的开源框架到CocoaPods上,但是每次都忘记命令行,写这篇博客的目的是为了记录下来步骤,方便以后翻阅使用

一、先将代码传到github上

这步比较简单,大致说一下:

// 创建本地仓库
git init
// 添加名称为origin的远程连接
git remote add origin '你的github项目地址'
// 将本地代码加入本地仓库里
git add .
// 提交修改到本地仓库
git commit -m '你的修改记录'
// 推送master分支的代码到名称为origin的远程仓库
git push origin master

二、给你git打上tag

打tag的目的就相当于给你的开源框架制定版本号,每个版本一个tag,下面是打tag的流程:

// 查看本地tag
git tag
// 添加本地tag 1.0.0
git tag -a 1.0.0 -m 'release 1.0.0'
// 将tag传到远程
git push origin --tags

tag的其他操作

// 删除本地tag
git tag -d 1.0.0
// 删除远程tag
git push origin -d tag 1.0.0

三、注册Trunk

pod trunk register 你的邮箱 '你的用户名' --description='你的描述'

成功的话就会受到一份邮件,点击邮件中的链接后验证一下:

pod trunk me

成功的话会返回以下类似字段:

  - Name:     WCL
  - Email:    wangchonglei93@icloud.com
  - Since:    January 10th, 21:32
  - Pods:
    - WCLImagePickerController
    - WCLShineButton
    - CRRefresh
  - Sessions:
    - January 10th, 21:32 - July 22nd, 07:38. IP: 58.132.205.59

如果你的pod是由多人维护的,你也可以添加其他维护者:

pod trunk add-owner ARAnalytics kyle@cocoapods.org

四、创建自己项目的Podspec描述文件

上传到cocoapods时主要就依赖着.podspec的描述文件来进行配置的,所以我们要先建立一个.podspec的描述文件:

// 初始化.podspec文件
pod spec create 你的项目名

初步了解.podspec文件:

Pod::Spec.new do |s|
  s.name         = "你的项目名"
  s.version      = "项目的版本"
  s.summary      = "项目的描述"
  s.homepage     = "项目的主页,一般为github地址就行"
  s.license      = "许可证:一般为 MIT"
  s.author             =  "作者名" => "你的邮箱" 
  // 支持的最低版本,比如ios 8.0
  s.platform     = :ios, "8.0"
  // 源代码地址,也就是你github上的地址
  s.source       =  :git => "你的github地址", :tag => "项目的tag" 
  // 源代码的文件路径
  s.source_files  = "WCL", "WCL/**/*.h,m" , "WCL/*.swift"
  // 资源文件路径
  s.resources     = "WCL.png", "WCL/**/*.bundle" , "WCL/*.bundle"
  // 用到的框架
  s.framework  = "UIKit"
  // 依赖的第三方库
  s.dependency "JSONKit", "~> 1.4"

编辑完podspec文件后,需要验证一下这个文件是否可用,如果有任何WARNING或者ERROR都是不可以的,它就不能被添加到Spec Repo中,不过xcode的WARNING是可以存在的,验证需要执行命令:

pod spec lint 你的podspec文件名.podspec

通过的话就验证成功,失败会告诉你错误的位置,一般很详细

五、传到CocoaPods上

pod trunk push 命令会首先验证你本地的podspec文件(是否有错误),之后会上传spec文件到trunk,最后会将你上传的podspec文件转换为需要的json文件。在工程根目录(包含有.podspec)下执行命令:

pod trunk push

没有错误的话,会提示你成功,并返回一下类似代码:

--------------------------------------------------------------------------------
 ��  Congrats

 ��  CRRefresh (1.0.0) successfully published
 ��  March 16th, 07:14
 ��  https://cocoapods.org/pods/CRRefresh
 ��  Tell your friends!
--------------------------------------------------------------------------------

以上是基本流程,如果有什么问题欢迎交流,最后谢谢大家的阅读

以上是关于手把手教你发布自己的开源框架到CocoaPods的主要内容,如果未能解决你的问题,请参考以下文章

手把手教你发布自己的 cocoapods 开源库

手把手教你构建自己的CocoaPods仓库

手把手教你构建自己的CocoaPods仓库

手把手教你如何构建 WPF 官方开源框架源代码

手把手教你如何构建 WPF 官方开源框架源代码

手把手教你如何构建 WPF 官方开源框架源代码