iOS开发——在CocoaPods发布个人第三方库

在进行日常的 iOS 开发的时候,我们肯定会用到各种第三方库,每次使用一个库的时候,各种依赖配置总是让人很头痛。幸好我们有了 CocoaPods,CocoaPods 为我们节省了大量集成第三方库的时间。在我们便捷地使用他人制作的 Pod 的时候,一定也希望能够将自己的代码制作成 Pod 供别人使用,来为开源社区做一点贡献。接下来,我们就来尝试制作一个属于自己的 Pod 库,并发布供他人使用。

备注:假设你已经拥有了一个完善的用于制作 Pod 的 iOS 工程。

创建 Pod 库依赖的文件

1. podspec 文件

podspec 文件是 Pod 库的描述文件,每个 Pod 库必须有且仅有一个这样的文件。文件名需要与我们将要创建的 Pod 库的名称一致,如我将创建的 Pod 库名称为 LixFoundation, 那么我的 podspec 文件就是 LixFoundation.podspec。

创建 podspec 文件

在工程目录下,执行(注意把名称换成你自己的名称)

pod spec create LixFoundation

创建完成后,在你的工程目录下就会出现对应的文件。以下是我创建出来的文件(为了方便阅读,我把所有注释和不需要的选项都删去了):

Pod::Spec.new do |s|

  s.name         = "LixFoundation"
  s.version      = "0.0.1"
  s.summary      = "Objective-C编程基础工具类"

  s.homepage     = "https://github.com/originalix/LixFoundation"

  #s.license      = "MIT"
  s.license      = { :type => "MIT", :file => "LICENSE" }


  s.author             = { "Lix" => "xiao.liunit@gmail.com" }

  s.platform     = :ios
  s.platform     = :ios, "7.0"

  s.source       = { :git => "https://github.com/originalix/LixFoundation.git", :tag => "#{s.version}" }

  s.source_files  = "Lix_Foundation", "Lix_Foundation/**/*.{h,m}"
  s.frameworks = "Foundation", "UIKit"
  s.dependency 'LixMacro', '~> 0.0.3'

end

该文件虽然是 Ruby 文件,但是里面的条目的意思都明显,就算没有学过 Ruby 也不影响。
几个需要说明的参数:

  1. s.homepage: 一般就是 Github 仓库的主页)。
  2. s.license: 指的是 Pods 依赖库使用的 license 类型。
  3. s.source: 表示 git 仓库的地址,注意是指向 tag 的,所以需要给你的 git 仓库打上 tag。
  4. s.source_files : 表示源文件的路径,是相对于创建的 podspec 文件而言的。

其他应该具备的文件

1. license 文件

CocoaPods 强制要求所有的 Pod 依赖库都必须有 license 文件,否则验证不会通过。license 的类型很多,你可以在创建 Github仓库的时候一并创建,也可以在后来添加进去。具体的 license 类型和适合你的 license 请自行 google。我在 Github 创建项目的时候,选择了 MIT license 一并创建

2. 主文件

Pod 的根本目的就是将自己创建的类供他人使用,比如我的 Pod 的作用就是将 LixFoundation 类分享给别人使用,方便他们快捷的使用常用扩展和宏定义。所以我将 LixFoundation 放入到 LixFoundation 文件夹中。

3. Demo 工程

Demo 工程是为了方便向其他使用者展示该 Pod 的使用。我将 Demo工程放在了 LixFoundationDemo 文件夹中。

4. README 文件

该文件一般使用 Markdown 语言标记,是对仓库的详细说明。作为一个共享给他人使用的 Pod 库,README 文件是必不可少的,这样对方才能很快的了解你的 Pod 具体是干嘛用的。

提交修改的文件`

1. 提交修改到 Github

依次执行以下命令:

  • 将新添加的文件加入到 git 管理,并提交一个 commit
  • 打上 tag0.0.1(为了 Pod 指向)
  • 提交 tag
  • 提交到 Github 仓库
git add -A && git commit -m "Release 0.0.1"
git tag '0.0.1'
git push --tags
git push origin master

如果一切正常,就可以在 Github 上看到刚才的改动

2. pod 验证

执行以下命令,为 Pod 添加版本号,并打上 tag

set the new version to 0.0.1
set the new tag to 0.0.1

接下来是验证

pod lib lint

如果一切正常,终端中会输出:

 -> LixFoundation (0.0.1)

LixFoundation passed validation.

到此,pod 验证就成功。

Trunk 你的 Pod

以上工作都就绪后,就可以将我们的 Pod 提交给 CocoaPods 了,CocoaPods 使用 trun 服务让我们来提交 Pod
`

1. 注册 Trunk

使用以下命令进行 trunk 注册:

pod trunk register  youremail@gmail.com 'ihomway' --description='macbook pro @ home' --verbose

上面的命令是我注册时使用的,你需要把邮箱和名字以及描述替换成你的,加上 --verbose 可以输出详细 debug 信息,方便出错时查看。

注册后 CocoaPods 会给你的邮箱发送验证链接,点击后就注册成功了,可以用 pod trunk me 命令查看自己的注册信息,如我的注册信息是:

  - Name:     **********
  - Email:    **********
  - Since:    **********
  - Pods:
    - Lix_ModelSqliteKit
    - LixMacro
    - LixFoundation
  - Sessions:
    - January 99th, 99:99 - May 25th, 03:02. IP: ********
    Description: macbook pro @ home

2. 部署你的Pod

使用以下命令,通过 trunk 部署你的 Pod:

pod trunk push LixFoundation.podspec

podspec 的文件名换成自己的文件名。

如果你出现报错,请根据提示寻找错误的原因。

之后你可以运行 pod setup 来更新你的 Pod 依赖库后,再使用 pod search LixFoundation 命令来查找刚刚加入的名字叫 LixFoundationPod

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

推荐阅读更多精彩内容