CocoaPods私有库制作+上传到公有库(小白教程)



一、背景

首先了解下使用需求。公司有多个项目同时进行,期望可以共用一个工具库。而该工具库代码可能涉及到公司内部信息,不便公开,需要部署在内部服务器上。也就是私有库的管理。

大家都知道CocoaPods管理第三方库十分方便,所以我们希望私有库的使用也可以借助CocoaPods管理。

二、准备私有库平台

首先,我们需要一个管理私有库代码的平台,我们公司暂时使用的是GitLab,先了解下概念。

Git:版本控制系统。

Github:在线的基于 Git 的代码托管服务,同时提供付费账户和免费账户。这两种账户都可以创建公开的代码仓库,只有付费账户可以创建私有的代码仓库。

Gitlab解决了这个问题, 可以在上面创建免费的私人repo

如何搭建本地服务器Gitlab仓库管理,大家自己去看吧。

三、创建一个Git远程仓库

我们私有库包含多个工具类的代码库,每个工具库代码使用CocoaPods打包后会生成一个.podspec文件,来描述该工具库的具体信息,包括代码地址。而所有的库的.podspec文件要有一个Spec Repo私有仓库去管理。

多个.podspec文件也称specs,作为我们查找库时候的一个索引,为什么我们执行pod search AFNetworking命令时,返回结果如此之快。因为安装CocoaPods的时候,本地目录就已经有了一份master(公开)的specs,全球程序员们提交到CocoaPods的开源代码在这都有记录。

我们可以通过执行命令查看一下目录结构,结果一目了然。命令如下:

open ~/.cocoapods/repos/master

我们创建的私有specs仓库地址为http://私有库地址/EHILibraryiOS/EHILibrarySpecs.git。下面执行命令把Spec创建到本地。命令如下:

pod repo add EHILibrarySpecs http://私有库地址/EHILibraryiOS/EHILibrarySpecs.git

这时候EHILibrarySpecs就在本地目录下创建成功了,通过命令查看EHILibrarySpecs的目录结构,会发现里面的内容和git仓库上的保持一致。EHILibrarySpecsmaster在目录中同级。

open ~/.cocoapods/repos/EHILibrarySpecs

四、创建Pod代码库

有了仓库,我们就可以添加代码库啦。

4.1 使用pod创建库:

pod lib create EHIHiCarBluetooth
image.png

过程中终端会向我们提出一系列问题,大家自行选择即可。

4.2 添加文件,写好Demo

如图,添加文件:

image.png

工程目录如下:

image.png

Example中写好Demo,保证编译运行ok。

4.3 编辑*.podspec

务必保证填写的每一项都要是正确的,比如主页和链接都要能够访问。

编辑EHIHiCarBluetooth.podspec文件如下:

#
# Be sure to run `pod lib lint EHIHiCarBluetooth.podspec' to ensure this is a
# valid spec before submitting.
#
# Any lines starting with a # are optional, but their use is encouraged
# To learn more about a Podspec see https://guides.cocoapods.org/syntax/podspec.html
#

Pod::Spec.new do |s|
    s.name             = 'EHIHiCarBluetooth'
    s.version          = '0.1.0'
    s.summary          = '一句话描述'
    
    # This description is used to generate tags and improve search results.
    #   * Think: What does it do? Why did you write it? What is the focus?
    #   * Try to keep it short, snappy and to the point.
    #   * Write the description between the DESC delimiters below.
    #   * Finally, don't worry about the indent, CocoaPods strips it!
    
    s.description      = <<-DESC
    TODO: Add long description of the pod here.
    DESC
    
    s.homepage         = 'http://私有库地址/EHILibraryiOS/EHIHiCarBluetooth'
    # s.screenshots     = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
    s.license          = { :type => 'MIT', :file => 'LICENSE' }
    s.author           = { '用户名' => '邮箱地址' }
    s.source           = { :git => 'http://私有库地址/EHILibraryiOS/EHIHiCarBluetooth.git', :tag => s.version.to_s }
    # s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'
    
    s.ios.deployment_target = '8.0'
    
    s.source_files = 'EHIHiCarBluetooth/Classes/*'
    
    # s.resource_bundles = {
    #   'EHIHiCarBluetooth' => ['EHIHiCarBluetooth/Assets/*.png']
    # }
    
    # s.public_header_files = 'Pod/Classes/**/*.h'
    # s.frameworks = 'UIKit', 'MapKit'
    
    s.dependency 'YYKit'
    s.dependency 'BabyBluetooth', '~> 0.7.0'
end

4.4 验证*.podspec

验证本地库是否通过验证,终端输入如下命令:

pod lib lint --use-libraries --allow-warnings

--use-libraries表示使用了第三方,--allow-warnings表示忽略警告。

如果使用了私有库,命令如下(我的这个没有用到):

pod lib lint --sources=http://私有库地址/EHILibraryiOS/EHIHiCarBluetooth.git,https://github.com/CocoaPods/Specs.git --use-libraries --allow-warnings

4.5 提交代码

git add .

git commit -m 'create EHIHiCarBluetooth 0.1.0'

如果你还未创建远程仓库,你需要创建与之对应的远程仓库:

image.png

创建之后与本地仓库关联并推送,在终端执行如下命令:

git push --set-upstream http://私有库地址/EHILibraryiOS/EHIHiCarBluetooth.git master

提交完成之后进行打标签操作(这就作为该库的版本,版本号和上面.podspec文件配置中保持一致):

git tag -a 0.1.0 -m 'release version 0.1.0'

git push http://私有库地址/EHILibraryiOS/EHIHiCarBluetooth.git 0.1.0

4.6 推送*.podspec到远程

4.6.1 推送到私有库

首先将本地EHIHiCarBluetooth.podspec推送到远程私有EHILibrarySpecs仓库:

pod repo push EHILibrarySpecs EHIHiCarBluetooth.podspec --use-libraries --allow-warnings

--force一般用不着,需要强制推送的话可以在后面加上。

4.6.2 推送到公有库

顺便记录下公有库的上传吧。公有库的上传前面操作一样的,保证在Github上已经创建了库,.podspec里的地址和Github上对应,打好Tag并上传验证等。然后推送如下:

先使用邮箱注册命令:

pod trunk register 邮箱  '用户名'

命令成功后,会提示去邮箱验证。登录邮箱,打开邮箱里的链接进行验证。
回到终端,输入以下命令(如果提示验证过期,重新操作上一步骤):

pod trunk me

命令后终端界面如下即可:

image.png

上传.podspecCocoaPods/repo(注意在.podspec文件上级目录下操作):

pod trunk push xxx.podspec

4.7 验证远程是否通过

pod spec lint EHIHiCarBluetooth.podspec --allow-warnings --use-libraries

4.8 pod搜索

pod search EHIHiCarBluetooth

如果远程验证通过,但是搜索不到,是因为没有添加进pod search缓存文件,删掉缓存重建即可!命令如下:

# 切换到CocoaPods目录
cd ~/Library/Caches/CocoaPods/
# 查看该目录下有Pods和search_index.json两个文件
ls

# 删除缓存文件
rm search_index.json

# 重新搜索
pod search EHIHiCarBluetooth

五、使用

Podfile文件如下:

# CocoaPods官方spec仓库
source 'https://github.com/CocoaPods/Specs.git'
# 私有spec仓库
source 'http://私有库地址/EHILibraryiOS/EHILibrarySpecs.git'

platform :ios, '8.0'
target 'TextPodBluetooth' do

# 私有库
pod 'EHIHiCarBluetooth','~> 0.1.0'

end

六、参考

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

推荐阅读更多精彩内容