最近刚换一个新公司,比较清闲些,就搜索了一些私有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的索引再搜索。