CocoaPods创建公有和私有Pod库方法总结

Github地址 zhangxiaomeng1 (ZXM) · GitHub

正文目录

一. 创建公有Pod库

1、注册CocoaPods账户信息

2、创建共享库文件并上传到公有仓库

3、编辑.podspec文件

4、打tag, 发布一个release版本

5、发布自己的库描述文件podspec给cocoapods

6、关于查找和使用新创建的库

7、更新维护podspec


二. 创建私有Pod库,整体思路:

1.创建一个私有spec repo 管理所有私有spec文件;

2.创建Pod所需要的项目工程文件,并且有可访问的项目版本控制地址;

3.创建Pod所对应的podspec文件;

4.验证podspec文件是否可用;

5.向私有的spec repo里添加podspec文件;

6.新建个项目测试自己的私有库;

7.更新podspec,建不同的版本;


一. 创建公有Pod库

1. 创建一个工程 ,打开终端,切换到你要创建的位置的目录,

cd /Users/zhangxiaomeng/Desktop/Repertory/OC/MyPods/XMLineChartView

pod lib create XMLineChartView

当被问及创建Swift还是OC项目,按自己要求回答,我选择ObjC;

当被问及是否创建一个demo应用包含在工程里,根据需要,如果需要写一个demo示例,就选择Yes,否则选择NO,我这里选择Yes;

当被问及是否需要使用测试Framwork,选择NO;

当被问及是否需要做接界面调试,我这里选择NO;

还有一个就是工程文件的前缀,我这里是自己的名字的缩写,这个随意写;

2.填写podspec信息,这个文件主要是用来描述pod的版本号,首页(homepage),作者信心等,具体的可以参看官方offical reference page

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

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

其实通过pod lib lint这个命令,Cocoapods已经帮我们创建了一个模板我们只需要在里面根据需要你进行配置即可.没有用到的注释(#开头的)可以删除掉,看起来舒服一些.


接下来,我们做一个远程验证

pod lib lint XMLineChartView.podspec --allow-warnings

只要见到passed validation就是成功通过了验证.

通过以上步骤,我们只是创建了一个合格的空的工程,并没有实现任何功能,接下来我们就需要把自己要实现的功能代码方进去.

找到工程中ReplaceMe文件,替换就可以.

如果你在创建工程时候创建了一个包含demo的工程,那么你可以先切换到工程的Example文件目录下面使用命令:

pod install

成功以后你就可以在demo文件中使用你的功能文件了.如果不能导入,那么可以commond + B编译一下再导入使用

3.我们还没有在GitHub上面创建相关的仓库,因此可以先进入GitHub账户创建仓库

4. 提交自己的pod

Step 1: 接下来就需要把自己的工程推送到Github:

 git add .

 git commit -m “Initial Commit"

 git remote add origin https://github.com//YourPodName.git // replacewith your github.com username

  git push -u origin master

//添加版本号

$ git tag -m "first release" "0.1.0"

$ git push --tags

Step 2 :验证

终端切换到LPodTest.podspec文件所在的目录下面,运行命令

pod lib lint --allow-warnings

如果出错:

[!] QXMFatherHomeTbaListMoreVC_Category did not pass validation, due to 2 errors.

You can use the `--no-clean` option to inspect any issue.

解决:

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


5. 提交pod 到Specs仓库

在这里有个pod trunk工具需要实现(只需要配置一次即可)。trunk工具是为了认证用户信息(包括设备)而存在的,只有注册认证通过了,才能够发布公开库。

注册trunk:

$ pod trunk register 邮箱 '名称' --description='描述'

替换自己的邮箱名称和描述

注册成功后提示:

[!] Please verify the session by clicking the link in the verification email that has been sent to13162255392@163.com

需要我们接受认证邮件并点击附带链接确认。当我们完成注册后,以后不需要此步骤。最后使用trunk工具,发布公开库。

$ pod trunk push XMLineChartView.podspec --allow-warnings


Updating spec repo `master`

--------------------------------------------------------------------------------

 🎉  Congrats

 🚀  XMLineChartView (1.1.3) successfully published

 📅  March 25th, 18:55

 🌎  https://cocoapods.org/pods/XMLineChartView

 👍  Tell your friends!

如果出错:

[!] The spec did not pass validation, due to 2 errors.

解决

pod trunk push --allow-warnings --use-libraries


6. pod search 检验是否可用大多情况下会出现这个问题:

[!] Unable to find a podwithname, author, summary,ordescriptionmatching `LPodTest

这主要是因为在本地索引里面没有, 解决办法

pod setup (不行,实用方法二)

pod repo update(不行,试用方法三)

前往这个路径下~/Library/Caches/CocoaPods删除search_index.json文件 , 或者使用终端命令删除:

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

然后重新搜索.




打包类库

需要使用一个cocoapods的插件cocoapods-packager来完成类库的打包。当然也可以手动编译打包,但是过程会相当繁琐。

安装打包插件

终端执行以下命令

sudo gem install cocoapods-packager

打包

命令很简单,执行

pod package BZLib.podspec --library --force

其中--library指定打包成.a文件,如果不带上将会打包成.framework文件。--force是指强制覆盖。最终的目录结构如下

修改spec文件

#s.source_files = 'ABTestFrameWork/Classes/**/*'

  s.vendored_frameworks ='ABTestFrameWork-1.0.5/ios/ABTestFrameWork.framework'

(.a是s.vendored_libraries,.framework是s.vendored_frameworks。)

最后执行 pod trunk push --allow-warnings --use-libraries




二.创建私有库

1、如果想利用pod安装私有库,那么就得创建和cocoapods官方一样的结构,我们想来看看cocoapods官方的结构,cocoapods所有公共库文件都存放在CocoaPods spec远端文件地址,如果在电脑上安装了cocoapods它会从这个地址clone一份到本地,每次pod update 都会更新这个本地仓库,首先先创建一个私有的库 ,由于github的私有仓库是收费的,这里用coding码市创建私有仓库,如果和其他人协同开发,只要把该仓库的权限添加给他就行。

在coding码市在创建2个仓库,一个仓库存放spec文件, 一个存源代码,

创建完远端的spec XMSpec,在终端执行

pod repo add XMSpec https://git.coding.net/n34/XMSpec.gi

然后执行

open ~/.cocoapods/repos 

会开看到在repos中创建了一个私有的仓库,master是cocoapods官方的


2.创建工程和编辑spec文件

cd /Users/zhangxiaomeng/Desktop/Repertory/OC/MyPods/XSPrivate/XSCategorys

pod lib create XSCategorys

3、上传到coding和打tag


4、验证.podspec文件

pod lib lint XSCategorys.podspec --allow-warnings


报错有可能 


5、向私有的库里添加podspec文件

pod repo push XMSpec XSCategorys.podspec


6.验证一下结果;

pod search XSCategory


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

解决办法:

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


7、新建一个项目进行验证

xcode新建项目 在podfile中添加

pod 'XSCategorys', '~> 0.0.2'

如果提示'unable to find a specification for'

需要在podfile文件中添加源地址

source 'https://github.com/CocoaPods/Specs.git'

source 'https://git.coding.net/n34/XMSpec.git'

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

推荐阅读更多精彩内容