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

移动开发 iOS
发布自己的cocoapods开源库按照以下步骤,良心制作,包教包会!!下面我会通过一个名为IFMMenu的项目来讲解一下整个过程。

发布自己的cocoapods开源库按照以下步骤,良心制作,包教包会!!

下面我会通过一个名为IFMMenu的项目来讲解一下整个过程。

1.写好代码,上传到github

github上创建项目仓库的时候记得创建LICENSE(许可证/授权)文件,此文件必须要有。

 

github上创建项目仓库

2.将自己的项目打成tag

因为cocoapods是依赖tag版本的,所以必须打tag,以后再次更新只需要把你的项目打一个tag,然后修改.podspec文件中的版本接着提交到cocoapods官方就可以了,提交命令请看下面

  1. //为git打tag, ***次需要在前面加一个v 
  2.  
  3. git tag "v1.0.0" 
  4.  
  5. git push --tags  

3.注册CocoaPods

trunk需要CocoaPods 0.33版本以上,用pod --version命令查看版本,如果版本低,需要升级。

  1. pod --version 
  2.  
  3. //版本低于0.33 
  4.  
  5. sudo gen install cocoapods 
  6.  
  7. pod setup  

已经注册过的不需要注册,怎么看自己有没有注册

  1. pod trunk me 

 

pod trunk me信息

若未注册,执行以下命令,邮箱以及用户名请对号入座。用户名我使用的是Github上的用户名。

  1. // 加上--verbose可以输出详细错误信息,方便出错时查看。 
  2.  
  3. pod trunk register example@example.com 'liugangios' --verbose  

注册完成之后会给你的邮箱发个邮件,进入邮箱邮件里面有个链接,需要点击确认一下。

注册完成后使用pod trunk me检验注册是否成功。

4.创建.podspec

cd到你项目的目录,执行命令

  1. pod spec create IFMMenu 

5.编辑.podspec

创建好后,打开.podspec,删除注释, 前面有#的为注释,也可以用以下代码替换,然后编辑自己的库信息。

  1. Pod::Spec.new do |s| 
  2.  
  3. s.name = 'IFMMenu' 
  4.  
  5. s.version = '1.0.2' 
  6.  
  7. s.authors = { 'liugangios' => 'example@example.com' } 
  8.  
  9. s.homepage = 'https://github.com/liugangios/IFMMenu' 
  10.  
  11. s.summary = 'a dropdown menu for ios like wechat homepage.' 
  12.  
  13. s.source = { :git => 'https://github.com/liugangios/IFMMenu.git'
  14.  
  15. :tag => s.version.to_s } 
  16.  
  17. s.license = { :type => "MIT", :file => "LICENSE" } 
  18.  
  19. s.platform = :ios, '7.0' 
  20.  
  21. s.requires_arc = true 
  22.  
  23. s.source_files = 'IFMMenu' 
  24.  
  25. s.public_header_files = 'IFMMenu/*.h' 
  26.  
  27. s.ios.deployment_target = '7.0' 
  28.  
  29. end  
  • s.name:名称,pod search搜索的关键词,注意这里一定要和.podspec的名称一样,否则报错
  • s.version:版本号,to_s:返回一个字符串
  • s.author:作者
  • s.homepage:项目主页地址
  • s.summary: 项目简介
  • s.source:项目源码所在地址
  • s.license:许可证
  • s.platform:项目支持平台
  • s.requires_arc: 是否支持ARC
  • s.source_files:需要包含的源文件
  • s.public_header_files:需要包含的头文件
  • s.ios.deployment_target:支持的pod***版本

其他一些非必要字段

  • s.social_media_url:社交网址
  • s.resources:资源文件
  • s.dependency:依赖库,不能依赖未发布的库
  1. s.license= { :type => “MIT”, :file => “LICENSE” } 

这里建议这样写,如果写别的会报警告,导致后面一直提交失败。

source_files写法及含义

  1. "IFMMenu/* 
  2.  
  3. "IFMMenu/IFMMenu/*.{h,m}" 
  4.  
  5. "IFMMenu/**/*.h"  

*表示匹配所有文件

*.{h,m}表示匹配所有以.h和.m结尾的文件

**表示匹配所有子目录

s.source常见写法

  1. s.source = { :git => "https://github.com/liugangios/IFMMenu.git", :commit => "68defea" } 
  2.  
  3. s.source = { :git => "https://github.com/liugangios/IFMMenu.git", :tag => 1.0.0 } 
  4.  
  5. s.source = { :git => "https://github.com/liugangios/IFMMenu.git", :tag => s.version }  
  • commit => "68defea" 表示将这个Pod版本与Git仓库中某个commit绑定
  • tag => 1.0.0表示将这个Pod版本与Git仓库中某个版本的comit绑定
  • tag => s.version表示将这个Pod版本与Git仓库中相同版本的comit绑定

6.验证.podspec

到此检查一下你工程中有以下文件:

  • 你的项目,
  • .podspec文件,
  • LICENSE文件

 

项目内文件

使用以下命令测试本地.podspec文件是否存在语法错误。

  1. pod spec lint IFMMenu.podspec --verbose 

7.发布

  1. pod trunk push IFMMenu.podspec 

时间较长,耐性等待,大概5-10分钟,发布成功后会有以下提示

 

 

发布成功截图

8.测试自己的cocoapods

这个时候使用pod search搜索的话会提示搜索不到,可以执行以下命令更新本地search_index.json文件

  1. rm ~/Library/Caches/CocoaPods/search_index.json 

然后

  1. pod search IFMMenu 

该命令会重新创建search_index.json文件,5-10分钟,耐性等待

 

搜索结果

完整命令

  1. git tag "v1.0.0" 
  2.  
  3. git push --tags 
  4.  
  5. pod trunk register example@example.com 'liugangios' --verbose 
  6.  
  7. pod trunk me 
  8.  
  9. pod spec create IFMMenu 
  10.  
  11. //编辑 IFMMenu.podspec 
  12.  
  13. pod spec lint IFMMenu.podspec 
  14.  
  15. pod trunk push IFMMenu.podspec 
  16.  
  17. rm ~/Library/Caches/CocoaPods/search_index.json 
  18.  
  19. pod search IFMMenu  

报错处理

  1. [!] Unable to accept duplicate entry for: XXXXX (1.0.0) 

意思是:不能接受同一版本的提交

解决方案:

1、执行如下命令

  1. git tag 1.0.1 
  2.  
  3. git push --tags  

2、修改XXXX.podspec文件中的内容

  1. s.version = "1.0.1" 
  2.  
  3. s.source = { :Git => "https://github.com/xxx/xxx.git", :tag => "1.0.1" }  

3、执行命令pod spec lint、pod trunk push 库名.podspec验证并提交到CocoPods

***

IFMMenu是一个仿微信首页添加菜单的多功能、多种属性可自定义的下拉菜单,欢迎download下载提意见,star,感谢阅读。 

责任编辑:庞桂玉 来源: iOS大全
相关推荐

2021-05-27 11:10:42

Python开源包代码

2021-09-26 16:08:23

CC++clang_forma

2022-01-04 08:52:14

博客网站Linux 系统开源

2022-02-15 09:03:07

Pythonmofish库代码

2024-03-18 18:07:38

VSCode插件文件

2024-01-26 08:16:48

Exporter开源cprobe

2011-05-03 15:59:00

黑盒打印机

2011-01-10 14:41:26

2021-07-14 09:00:00

JavaFX开发应用

2020-11-27 07:38:43

MongoDB

2011-02-22 13:46:27

微软SQL.NET

2021-02-26 11:54:38

MyBatis 插件接口

2021-12-28 08:38:26

Linux 中断唤醒系统Linux 系统

2022-03-14 14:47:21

HarmonyOS操作系统鸿蒙

2023-04-26 12:46:43

DockerSpringKubernetes

2022-01-08 20:04:20

拦截系统调用

2022-12-07 08:42:35

2022-07-27 08:16:22

搜索引擎Lucene

2009-06-15 16:58:57

Java安装Linux

2018-03-23 20:45:23

机器学习NLP文本数据
点赞
收藏

51CTO技术栈公众号