私有pod组件化实践一

最近刚换一个新公司,比较清闲些,就搜索了一些私有pod的制作资料,发现现有的一些文章大多数重在思想而忽略了实战细节,所以在这里把自己操作的整个流程写一下,一来算是对自己填坑的祭奠,二来希望给大家一些帮助吧!本文只介绍在git环境下的操作,其他环境其他方式暂不说明。

首先我们选择一个开源的git服务,例如Github、开源中国、Bitbucket以及CSDN Code等,平常用Github和开源中国比较多,因为GitHub的私有仓库是收费的,我还不是Github的付费用户,所以就选择开源中国了。


一、

1、设置忽略文件很重要。

mac上文件的 显示和隐藏的命令行如下:

defaults write com.apple.finder AppleShowAllFiles Yes && killall Finder //显示隐藏文件

defaults write com.apple.finder AppleShowAllFiles No && killall Finder //不显示隐藏文件

2、组件中忽略文件打开在最后添加上如下代码:

.idea/

CocoaPods

Pods

!Podfile

!Podfile.lock

保存退出!

3、本地私有库需要设置全局忽略

===============设置git全局忽略==========================

vim ~/.gitignore_global

复制下面的代码,保存退出:

#
## OS generated files
#
.DS_Store
.DS_Store?
.swp
._
.Spotlight-V100
.Trashes
Icon?
ehthumbs.db
Thumbs.db
#
####### packages
#
.7z.dmg
.gz.iso
.jar.rar
.tar.zip

vim ~/.gitconfig

[core] excludesfile = /Users/你的用户名/.gitignore_global

二、

1、创建私有podspec

整体先说明一下创建一个私有的podspec包括如下那么几个步骤:

a.创建并设置一个私有的Spec Repo。

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

c.创建Pod所对应的podspec文件。

d.本地测试配置好的podspec文件是否可用。

e.向私有的Spec Repo中提交podspec。

f.在个人项目中的Podfile中增加刚刚制作的好的Pod并使用。

g.更新维护pod spec。(什么是SpecRepo?它是所有的Pods的一个索引,就是一个容器,所有公开的Pods都在这个里面,它实际是一个Git仓库remote端在GitHub上,但是当你使用了Cocoapods后它会被clone到本地的~/.cocoapods/repos目录下,可以进入到这个目录看到master文件夹就是这个官方的SpecRepo了。)

首先我们在自己的git服务上创建一个私有的仓库:

创建完成之后在Terminal中执行如下命令:

pod repo add [Private Repo Name] [GitHub HTTPS clone URL]

pod repo add PrivateRepohttps://git.oschina.net/summermaimaiti/WTSpecs.git

此时如果成功的话cd到~/.cocoapods/repos目录下就可以看到PrivateRepo这个目录了。至此第一步创建私有Spec Repo完成


2、创建Pod项目工程文件

git服务上创建私有组件仓库:

如果有现有的组件项目,并且在Git的版本管理下,那么这一步就算完成了,可以直接进行下一步了。

如果你的组件还在你冗余庞大的项目中,需要拆分出来或者需要自己从零开始创建一个组件库,那么我建议你使用Cocoapods提供的一个工具将第二步与第三步结合起来做。

现在来说一下这个工具,首先我们可以用pod lib create PrivateRepo,可以带上--template-url=URL参数(URL表示git仓库的地址),就拿我创建的podTestLibrary为例子具体讲一下这里是如何操作的,先cd到要创建项目的目录然后执行:

pod lib create podTestLibrary

之后他会问我们五个问题:

第一个问题:Objective-C 或者 Swift

第二个问题:Making a Demo Application,如果选是就会在你的Xcode工程中新建一个工程。(如果你想要一个demo或者你需要一个测试单元在你的工程中,你应该选是)

第三个问题:Choosing a Test Framework,你应该测试你的工程,确保别人可用。(如何选择:如果你不能决定,就选Specta/Epecta)

第四个问题:View-based Testing,会根据你选的测试自动生成一个

第五个问题: 你的前缀是什么。

接下来就是向Pod文件夹中添加库文件和资源,并配置podspec文件,我把一个网络模块的共有组件放入Pod/Classes中,然后进入Example文件夹执行pod update命令,再打开项目工程可以看到,刚刚添加的组件已经在Pods子工程下DevelopmentPods/PodTestLibrary中了。

通过Cocoapods创建出来的目录本身就在本地的Git管理下,我们需要做的就是给它添加远端仓库,同样去GitHub或其他的Git服务提供商那里创建一个私有的仓库,拿到SSH地址,然后cd到PrivateRep0目录:

git add .

git commit -m "Initial Commit of Library"

添加远端仓库

git remote add originhttps://git.oschina.net/summermaimaiti/PrivateRepo.git

推送到远端仓库

git push origin master

在添加远端仓库前,先git pull origin master ,如果出现下面问题 refusing to merge unrelated histories? 可以用git pull origin master--allow-unrelated-histories解决,强制拉取,只是第一次用!如果再出现git相关的其他问题,请自行百度解决!

因为podspec文件中获取Git版本控制的项目还需要tag号,所以我们要打上一个tag:

git tag -m "first release" "0.1.0"

git push --tags    #推送tag到远端仓库

做完这些就可以开始编辑podspec文件了,它是一个Ruby的文件,把编辑器的格式改成Ruby就能看到语法高亮,下面我贴上我的podspec文件,并在后面以注释的形式说明每个字段的含义,没有涉及到的字段可以去官方文档查阅。


编辑完podspec文件后,需要验证一下这个文件是否可用,如果有任何WARNING或者ERROR都是不可以的,它就不能被添加到Spec Repo中,不过xcode的WARNING是可以存在的,验证需要执行一下命令:

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

当你看到

-> PodTestLibrary (0.1.0)

PodTestLibrary passed validation.

时,说明验证通过了,不过这只是这个podspec文件是合格的,不一定说明这个Pod是可以用的,我们需要在本地做一下验证,这就是第四步的内容了,第四步在具体说明。

3、向Spec Repo提交podspec

向Spec Repo提交podspec需要完成两点一个是podspec必须通过验证无误,在一个就是删掉无用的注释(这个不是必须的,为了规范还是删掉吧)。 向我们的私有Spec Repo提交podspec只需要一个命令:

pod repo push WTSpecs 你的模块名字.podspec --verbose --use-libraries --allow-warnings

如果出现类似私有WTSpecs not clearn 的问题,就重新创建一下WTSpecs ! 完成之后这个组件库就添加到我们的私有Spec Repo中了,可以进入到~/.cocoapods/repos/PrivateRepo目录下查看。

├── LICENSE

├── PodTestLibrary

│  └── 0.1.0

│  └── PodTestLibrary.podspec

└── README.md

再去看我们的Spec Repo远端仓库,也有了一次提交,这个podspec也已经被Push上去了。至此,我们的这个组件库就已经制作添加完成了,使用pod search命令就可以查到我们自己的库了!

查看我们创建的私有pod库:

$ pod search PodTestLibrary

提示:如果出现pod search找不到私有仓库的情况,可以先使用rm ~/Library/Caches/CocoaPods/search_index.json命令清除pods的索引再搜索。

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

推荐阅读更多精彩内容