Github代码添加Cocoapods支持

个人博客地址

需求

作为一名iOS应用开发者,在实际工作中会经常使用到第三方开源类库,比如JSONKit、AFNetWorking、SDWebimage等等。这些第三放开源类库添加Cocoapods支持,为我们实际开发工作中提供不少的便利。当慢慢开始习惯Cocoapods给我们带来的便利时,就开始想让自己的常用的工具类也添加Cocoapods支持,既然有了需求那么,就开始实现这个过程了,走过路过,千万不要错过,下面开始干货分享。

附上本文实现的demo:MD5(32位/64位)加密


解决需求

流程步骤

  • 注册trunk
  • 在Github上传相关的代码库
  • 创建podspec配置文件
  • 验证是否可用
  • trunk push 代码到 CocoaPods
  • 上传成功后检查是否可用

注册trunk

想让Cocoapods支持你自己的工具代码库,需要一个CocoaPods账号。

注册命令:

pod trunk register 邮箱地址 ‘用户名’ —description='描述信息'

执行以上注册命令后,到你注册邮箱检查一下,会有相关的邮件,点击验证链接打开网页。如果出现下面的提示,说明注册成功(如果打开网页太慢的话,建议开vpn)。

Snip20170308_6.png

查看注册信息命令:

pod trunk me

执行该命令会出现以下输出:

Snip20170308_7.png

至此,我们就注册完CocoaPods账号,可以trunk push我们的自己的代码库。


Github上传代码库

需要到github官网登录你的账户,执行Create a new repository操作。如下图所示:

Snip20170307_1.png

注意MIT License选项,这个会在添加Cocoapods支持的时候用到。创建完成后,可以通过GitHub Desktop软件clone到本地。目录结构如下图:

Snip20170307_3.png

可以看到这里的会有一个LICENSE的文件,就是刚刚选着MIT License所创建的。ZHWTools是示例工程,我们要开源的工具类代码库,在示例工程的子文件夹下。


创建podspec配置文件

打开终端,在cd到刚刚的文件夹目录下,执行创建podspec命令:

//ZHWtools是你要开源的库名
pod spec create ZHWtools

执行后文件夹里会出现相关的podspec文件,下面需要编辑这个文件,可以在终端执行vim ZHWtools.podspec进行编辑。也可以用其他的文本编辑器打开,进行编辑。如下图所示:

Snip20170307_4.png

简单介绍下相关代码行的意义:

s.name:名称,pod search 搜索的关键词,注意这里一定要和.podspec的名称一样,否则报错
s.version:版本号
s.ios.deployment_target:支持的pod最低版本
s.summary: 简介
s.homepage:项目主页地址
s.license:许可证
s.author:作者
s.social_media_url:社交网址,这里我写的微博默认是Twitter,如果你写Twitter的话,你的podspec发布成功后会@你
s.source:项目的地址
s.source_files:需要包含的源文件
s.resources: 资源文件
s.requires_arc: 是否支持ARC
s.dependency:依赖库,不能依赖未发布的库
s.dependency:依赖库,如有多个可以这样写

如果有什么不清楚可以去看一下那么比较知名的开源库(AFNetworking等),参考一下。

需要注意的source_files这个路径的填写,这里也简单说明一下。

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

s.source 常见写法

commit => "68defea" 表示将这个Pod版本与Git仓库中某个commit绑定
tag => 1.0.0 表示将这个Pod版本与Git仓库中某个版本的comit绑定
tag => s.version 表示将这个Pod版本与Git仓库中相同版本的comit绑定

验证是否可用

执行以下命令进行验证:

pod lib lint ZHWtools.podspec

如果有没有Erro输出,只是WARN输出,那么可以将这些警告直接忽略,忽略警告命令。

pod lib lint ZHWtools.podspec —allow-warnings
Snip20170308_5.png

当终端输出ZHWtools passed validation之后,就说明验证通过了。

在执行校验命令是会出现下面的类似错误情况,简单说明一下,供各位看官参考。

返回错误结果:

  - ERROR | xcodebuild: Returned an unsuccessful exit code. You can use `--verbose` for more information.
    - NOTE  | [OSX] xcodebuild:  /Users/wangguimin/UpTextField/UpTextField/UIView+Extension.h:8:9: fatal error: 'UIKit/UIKit.h' file not found
    - NOTE  | [OSX] xcodebuild:  /Users/wangguimin/UpTextField/UpTextField/UIColor+ColorWithHexStrig.h:9:9: fatal error: 'UIKit/UIKit.h' file not found

解决办法1:
在podspec配置文件里,修改 s.frameworks s.platform选项(s.platform这个指的是兼容iOS 8.0以后的版本)。

s.frameworks   = "Foundation"
s.platform     = :ios, "8.0"

解决办法2:
在你的示例工程里,创建一个pch文件,讲说有的要开源的代码库的.h头文件导入到pch文件里。
然后在执行pod lib lint ZHWtools.podspec —allow-warnings命令。

所有错误都解决后,我们需要这些修改都重新推到GitHub上(库文件 和 .spec文件),可以使用GitHub Desktop直接提交。也可使用以下命令来提交并打上标记:

git tag '1.0.0'git push --tags

trunk push 代码到 CocoaPods

所有的准备工作都已经完成了,下面就需要将我们编写的文件push到Cocoapods。

执行以下命令:

pod trunk push ZHWtools.podspec

如下图所示成功结果:

Snip20170308_10.png

如果出现下面的错误提示,可以试着在网络的DNS选项添加一个114.114.114.114的DNS服务器选项(建议开VPN):

Snip20170308_11.png

上传成功后检查是否可用

检验是否上传成功命令:

pod search ZHWtools

如果搜索不到,建议删除本地的CocoaPods的搜索目录,执行以下命令:

rm ~/Library/Caches/CocoaPods/search_index.json
Snip20170308_12.png

再重新执行pod search ZHWtools命令搜索就可以看到,我们的开源的工具代码库的相关信息,可以通过pod 命令安装到工程中使用。
ps:如果你发布成功后,在你自己的电脑上可以search到,在别的电脑上搜不到,建议执行rm ~/Library/Caches/CocoaPods/search_index.json命令,先删除旧的搜索目录。也可以尝试更新你的pod。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,482评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,377评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,762评论 0 342
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,273评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,289评论 5 373
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,046评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,351评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,988评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,476评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,948评论 2 324
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,064评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,712评论 4 323
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,261评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,264评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,486评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,511评论 2 354
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,802评论 2 345

推荐阅读更多精彩内容