如何利用CocoaPods创建私有库

创建私有库

1、git服务器创建一个项目

2、clone项目到本地(git clone https://github.com/XXX.git)

3、创建工程

1、切换到该目录下

2、创建工程模版
pod lib create RKLAPPPrivatePrivateLibraries

3、配置相关的选择
选择平台:
What platform do you want to use?? [ iOS / macOS ]
>iOS
选择语言:
What language do you want to use?? [ Swift / ObjC ]
 >ObjC
是否自动生成demo,选择Yes,方便以后测试:
Would you like to include a demo application with your library? [ Yes / No ]
>Yes
是否集成测试的框架:
Which testing frameworks will you use? [ Specta / Kiwi / None ]
>None
UI测试:
Would you like to do view based testing? [ Yes / No ]
 >No
指定类的前缀:
What is your class prefix?
>RKLAPP

4、执行完以后,cd到工程目录下执行pod install

5、打开 RKLAPPPrivatePrivateLibraries.xcworkspace工程文件


4、编写podspec文件

1、目录下文件介绍

podspec该文件主要是用来描述项目名称、pod版本号、介绍、首页、作者信息、git源等等

README.md使用过GitHub的都会知道README的重要性,这个文件可以使用Markdown语法,主要展示在GitHub工程上的首页,README文件对于使用pod库的人来说有和没有这个文件,区别很明显的,此外有助于创建一个高质量的CocoaPods Quality Index

LICENSE要想是Spec仓库接收,就必须包含一个LICENSE。命令pod lib create 自动创建使用的是 MIT license

2、如果用第3步的命令创建工程模版,那么工程的目录下已经自动生成了.podspec(RKLAPPPrivatePrivateLibraries.podspec)。如果是已有的工程或者库文件目录,也可以利用pod命令自己制作.podspec文件,命令如下:

pod spec create "组件库名"

3、自动生成的podspec文件只是模版,需要结合工程的库文件、资源目录、远程代码仓库(第一步创建的远程代码仓库)修改补充podspec文件。

Pod::Spec.new do |s|
s.name            = 'RKLAPPPrivatePrivateLibraries'
s.version          = '0.1.0'           \color{red}{版本号}
s.summary          = 'A short description of RKLAPPPrivatePrivateLibraries.'   \color{red}{简介,写一些简单的介绍}
# 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  \color{red}{详细介绍该库的功能}
TODO: Add long description of the pod here.
                         DESC
s.homepage        = 'https://github.com/RKLAppPrivateLibraries/RKLAPPPrivatePrivateLibraries'  \color{red}{主页}
 # s.screenshots    = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
s.license          = { :type => 'MIT', :file => 'LICENSE' }
s.author          = { 'RKLAppPrivateLibraries' => '277944936@qq.com' }
s.source          = { :git =>
'https://github.com/RKLAppPrivateLibraries/RKLAPPPrivatePrivateLibraries.git', :tag => s.version.to_s }  \color{red}{git源}
# s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'
s.ios.deployment_target = '8.0'
s.source_files = 'RKLAPPPrivatePrivateLibraries/Classes/**/*'

# s.resource_bundles = {
#  'RKLAPPPrivatePrivateLibraries' => ['RKLAPPPrivatePrivateLibraries/Assets/*.png'] # }
# s.public_header_files = 'Pod/Classes/**/*.h'
# s.frameworks = 'UIKit', 'MapKit'
# s.dependency 'AFNetworking', '~> 2.3'  \color{red}{依赖的文件}

5、验证.podspec文件的格式是否正确

1、cd到xxx.podspec文件所在的目录下,用到一些命令

pod lib lint
解说:本地验证pod能否通过验证,如果失败使用下面命令: pod lib lint --verbose查看原因,或者使用pod lib lint --allow-warnings忽略警告错误

pod spec lint
解说:本地和远程验证pod能否通过验证,需要更新提交podspec到远程specs仓库,参考第7步,一般本地验证通过即可提交到远程specs仓库

pod lib lint --verbose
解说:加--verbose可以显示详细的检测过程,出错时会显示详细的错误信息

pod lib lint --verbose --allow-warnings
解说: 允许警告,用来解决由于代码中存在警告导致不能通过校验的问题

常见错误:

解决方案:设置Command Line Tools

6、提交工程代码

提交工程代码到远程代码仓库,可以利用git或者svn进行代码版本管理,提交代码到GitHub等, 初始化提交命令如下:

//初始化git版本管理仓库,模板代码已经初始化过此步骤可以忽略(有.git文件夹)
git init

//添加到暂存区
git add .

//提交到本地仓库
git commit -a -m '提交信息'
示例:git commit -a -m '添加pod组件库'

//打标签,注意此标签可能在podspec中用到,用于区分版本
git tag 1.0.0

//本地仓库与远程仓库关联(已关联过的,可以忽略)
git remote add origin

//拉取和合并本地与远程仓库
git pull origin master --allow-unrelated-histories

//本地仓库代码推送到远程
git push --set-upstream origin master

此时如果你报错,查看报错信息中如果有:“pre-receive hook declined”
说明存在权限问题,没有master分支的代码提交权限。分配权限后,就可以push成功。

//推送标签
git push --tags

7.提交podspec文件

1. 开源库提交
podspec文件到Cocopods官方仓库,首先在cocopods官方仓库中注册账号,命令如下:

pod trunk me      //(检查是否注册trunk)

pod trunk register 邮箱 注册名字 --verbose
//(注册命令)

注册完成之后会给你的邮箱发个邮件,进入邮箱邮件里面有个链接,需要点击确认一下.之后开始提交,切换到有.podspec文件的组件工程根目录执行命令

pod trunk push 组件库名.podspec
pod trunk push 组件库名.podspec --allow-warning

2、私有库提交

私有仓库需要先添加到本地仓库,再push到远程仓库。
电脑查看目录:~/.cocoapods/repos/

1、添加到本地仓库, git@git.xxxx/.git为远程specs库的地址,成功之后目录(~/.cocoapods/repos)新增了一个文件夹(组件库名)
pod repo add specs仓库名 specs远程仓库地址 //示例:pod repo add RKLAPPPrivatePrivateLibraries https://XXX/klrepo.git

2、查看是否添加成功
pod repo list

3、push到远程specs仓库
pod repo push 本地spec库名 本地.podsepc文件    //示例:pod repo push RKLAPPPrivatePrivateLibraries RKLAPPPrivatePrivateLibraries.podspec

4、如果.podspec文件存在警告时不能成功push。
解决:Pod repo push 本地spec库名 本地.podsepc文件 --allow-warnings

8、 检查仓库是否发布成功

pod搜索验证:

pod search 组件库名

如果报错,搜索不到,建议更新下pod:

pod update

之后仍然搜索不到,那么进入CocoaPods缓存目录,删除缓存索引文件search_index.json:

cd ~/Library/Caches/CocoaPods
ls
rm -f search_index.json

9、使用

如果是开源库(公有的),修改podfile文件:

如果是私有仓库,建议在podfile文件开头添加source源:


最后执行命令进行安装:

pod install

参考:https://www.jianshu.com/p/c04f1d8b5b61

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

推荐阅读更多精彩内容