使用CocoaPods创建自己的公开库

一、简介

CocoaPods是 iOS 的依赖管理工具,很优雅的将一些常用的三方库或私有库与主工程分隔开,pod是使用 git 进行项目管理的,所以能好的控制版本,使用 pod 可以集成 git 上的开源项目,也可以集成本地的项目,也是组件化中必不可少的一项重要的工具。同时通过创建一个Xcode的workspace来将这些三方库和我们的工程连接起来,供我们开发使用。使用CocoaPods的目的是让我们能自动化的、集中的、直观的管理第三方开源库。

二、Cocoapods的安装和使用

1、安装

使用 Terminal,输入指令:

sudo gem install cocoapods

如果报错:(没有权限)

ERROR:  While executing gem ... (Errno::EPERM)
    Operation not permitted - /usr/bin/xcodeproj

使用以下指令安装:

sudo gem install -n /usr/local/bin cocoapods

执行完以上指令,pod应该已经正常安装你的电脑上了,如果依然失败,请留言给我。

2、使用

pod 是通过Podfile文件进行安装管理的,在工程的目录下,使用终端执行指令vi Podfile创建Podfile文件,文件内容如下:

#Uncomment this line to define a global platform for your project
# 支持的最低版本
platform :ios, "8.0" 
# 是否使用framework的形式集成
#use_frameworks!
#下载三方库的地址,下面的地址就是公开pod库的默认地址,如果还有私有库,还需要将私有库的地址也写上。
source 'https://github.com/CocoaPods/Specs.git'

# Demo为工程的名字
target "Demo" do
    pod 'SDWebImage', '~> 3.0'
end

配置好Podfile文件之后,执行指令pod install,pod就会自动安装了,安装之后打开工程,需要打开.xcworkspace文件了。

三、发布自己的pod到CocoaPods

平常我们都是使用pod去安装别人封装好的库,那么自己怎么发布自己的 pod 库到 CocoaPods 呢?主要分为如果几个步骤:

  • 注册 trunk
  • 创建 podspec 文件
  • 验证 podspec 文件
  • 提交自己的代码到 git,添加 tag
  • 通过 trunk 推送 podspec文件

1、注册trunk

pod trunk register <email> <name>

pod trunk register cui.keyi@outlook.com 'cuikeyi'

注册成功之后会收到一份确认邮件,去邮箱确认一下邮件,然后执行指令

pod trunk me

成功之后如下图:
image

2、创建 podspec 文件

本文以上一篇文章 图片浏览器 PhotoBrowser 为例,比如我这次的名字叫做CCPhotoBrowser,那么执行指令创建 spec 文件:

pod spec create CCPhotoBrowser

会生成一个 CCPhotoBrowser.podspec 文件,这个文件需要我们简单的修改,修改完的信息如下。

Pod::Spec.new do |s|
  s.name         = "CCPhotoBrowser"
  s.version      = "0.0.1"
  s.summary      = "CCPhotoBrowser."
  s.description  = <<-DESC
                    发布pod到CocoaPods的演示例子,demo。
                   DESC

  s.homepage     = "https://github.com/cky113999742/CCPhotoBrowser"
  s.license      = "MIT"
  s.author       = { "Cuikeyi" => "cuidawangvip@163.com" }
  s.platform     = :ios, '8.0'
  s.source       = { :git => "https://github.com/cky113999742/CCPhotoBrowser.git", :tag => "#{s.version}" }
  s.header_dir    = 'CCPhotoBrowser'
  s.source_files  = 'KYPhotoBrowser/PhotoBrowser/**/*.{h,m}'
  s.framework  = 'UIKit'
  s.requires_arc = true
  s.dependency 'YYWebImage'

end

文件的目录如下:
image

3、验证 podspec 文件

运行指令:

pod lib lint

这个指令是验证 podspec 文件的格式是否正确,如果有报错,就按照报错的提示去修改这个文件,如果有不知道怎么解决的问题,可以留言。

pod lib lint --verbose

上边这个指令可以打出详细的信息,方便更直接的定位文件的问题所在。如果验证没有错误,就算验证成功了,警告什么的可以忽略,无伤大雅,可以使用如下指令忽略警告:

pod lib lint --allow-warnings

如果验证通过了,就进行下一步骤。

4、提交代码,添加tag

提交代码:

git  add .
git commit -m "first commit"
git pull origin master
git push origin master

提交tag

git  tag -m "release 0.0.1" 0.0.1
git  push --tags

5、推送 podspec文件

执行指令:

pod trunk push CCPhotoBrowser.podspec --allow-warnings

上传成功显示如下图:
image

看见这个是不是很兴奋,此刻是不是很激动,想立刻去看看自己的库到底能不能找到吧。
执行指令:

pod search CCPhotoBrowser

你会发现,纳尼,怎么找不到???

▶ pod search CCPhotoBrowser
[!] Unable to find a pod with name, author, summary, or description matching `CCPhotoBrowser`

此时别慌,你需要执行以下几个指令试一试,如果你的朋友也搜不到你提交的pod,执行下面的指令就能解决问题了。
1、更新本地的 repo 空间

pod repo update

2、如果执行完这个还是找不到,删除本地缓存,执行:

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

此时就能找到自己刚刚发布的pod库啦,如果还是没有找到,请留言吧。到此发布自己的 pod 到 cocoaPods 就算是告一段落了,但是还没有结束,如果有一天,你不想发布这个 pod 了,你突然想删掉上传到cocoaPods了,你只需要执行以下的指令就可以了:
pod trunk delete <podName> <tag>

pod trunk delete CCPhotoBrowser 0.0.1

0.0.1为你发布到 cocoaPods 上的版本,这个版本号和自己的 tag 有关系。
好了,亲爱的读者们,欢乐的时光总是这么短暂,又到了和大家说再见的时间了,文章到这里就彻底结束了,如果有什么问题的话,可以留言告知。

使用Cocoapods创建私有podspec
图片浏览器 PhotoBrowser

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

推荐阅读更多精彩内容