CocoaPods管理本地库

CocoaPods 是一个ruby工具. Mac下优秀的第三方包管理工具,帮助管理和集成,自动更新网络上的第三方类库.方便了配置.大概原理是将所有依赖库都放到另一个名为pods项目中.然后让主项目依赖pods项目.

CocoaPods本地的存储路径

本地一个名为 .cocoapods的文件 下载到本地的第三方库的文件路径


repos路径.png
  • repos 就是pod搜索的目录(基于本地), master的来源:(https://github.com/CocoaPods/Specs)
CocoaPods管理本地库_第1张图片
屏幕快照 specs路径.png
  • specs,现在pod能找到第三方库的目录.然后就可以根据里面所写的内容完成下载.

个人或公司在开发过程中,会积累很多可以复用的代码包,有些我们不想开源,又想像开源库一样在CocoaPods中管理它们,那么通过私有仓库来管理就很必要。

CocoaPods默认只能管理基于git管理的代码,如果要使用svn或者mercurial管理代码,则需要安装一些插件(cocoapods-repo-svn).我们通过git上的插件把私有代码通过svn下载到本地的私有仓库.这样委托pod来管理.

1.在git上的设置私有代码库

以下方法都是基于git来操作。
1.创建代码仓库

将自己写的代码推送到git服务器。如果代码可以开源的话,可以用github来托管。参考我们所开源的代码

2.给稳定的代码打上版本tag,一般以版本号作为tag名

$ git tag -a

将tag推送到git服务器

$ git push --tags

这里一般是类似1.0.2的版本号。版本号的规范参考这里

3.创建spec文件

在shell中运行:

$ pod spec create

会在当前目录创建.podspec文件,创建的文件是个完整的配置模板,根据字面意思以及注释,大体上都能弄明白。不清楚的地方可以到https://guides.cocoapods.org/making/specs-and-specs-repo.html看看,github上也有很多开源代码可以参考。

4.验证spec文件有效性

spec文件修改完成后,运行

pod spec lint .podspec

根据输出提示修改你的spec文件或者代码,直到能pass.

5.创建spec repository(spec 仓库)

除了上面创建的代码仓库,还需要创建一个spec仓库,存放spec,目录结构应该遵照以下的规范:

[plain] view plaincopy

├── Specs
    └── [SPEC_NAME]
        └── [VERSION]
            └── [SPEC_NAME].podspec

例:

├─Specs
    ├──QueryKit/
    ├── 0.8.0
    │  └── QueryKit.podspec
    ├── 0.8.1
    │  └── QueryKit.podspec
    ├── 0.8.2
    │  └── QueryKit.podspec
    └── 0.8.3
    └── QueryKit.podspec
    URITemplate
    ├── 1.0.0
    │  └── URITemplate.podspec
    └── 1.0.1
    └── URITemplate.podspec

这里的版本号要和代码仓库里的tag一一对应。

将其推送到git服务器,参考我们开源的代码

6.添加私有repo到CocoaPods中

$ pod repo add REPO_NAME SOURCE_URL

7.验证私有repo安装无误:

$ cd ~/.cocoapods/repos/REPO_NAME
$ pod repo lint .

后面如果还要往REPO_NAME里添加新包,只需运行下面命令:

$ pod repo push REPO_NAME SPEC_NAME.podspec

如要删除私有repo:

$ pod repo remove [name]

8.添加包到工程的Podfile中如下:

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


platform :ios, "7.0"


target "XXX" do
pod 'DLSlideView','~>0.8.1'
end
  1. That's it!

接下来测试运行:

到工程目录下运行

$ pod update

依赖包更新完毕后,打开workspace文件,点击Go!

一些坑:

很容易把spec repository和代码repository弄混,我一开始就在这里挂起了好久。代码repository是代码仓库,我们把包代码上传到这个仓库。

spec repository是配置仓库,所有的配置按照包名、版本号分门别类的存放在这个仓库。这个仓库只用来存放spec文件,不存放代码。

spec repository可以放在本地,不用git服务器,但是貌似必须用git init初始化这个目录。

详细的一些东西可以看这里

1到8步都只需在本机执行一次,团队里的其他人只需更新Podfile就可以直接使用私有仓库了。

2.使用cocoapods-repo-svn管理svn上的代码

1.安装**cocoapods-repo-svn **
gem install cocoapods-repo-svn

2.安装 cocoapods-repo-svn 后,添加自己的Spec源,并验证是否成功(检查 ~/.cocoapods/repos 里面有没有XXXSpecs)

cocoapods-repo-svn Commands

Add
$ pod repo-svn add my-svn-repo http://svn-repo-url

Update
$ pod repo-svn update my-svn-repo

Remove
$ pod repo-svn remove my-svn-repo

把svn上的内容下载到本地,通过pod来管理

添加成功.png

有时候没权限的时候, 可以先用svn下载到本地再执行添加命令

svn checkout http://your SVN Address

项目管理:CocoaPods建立私有仓库
http://www.cocoachina.com/ios/20150508/11785.html

CocoaPods 英文说明
https://guides.cocoapods.org

git安装和使用就看这篇文章
http://www.liaoxuefeng.com/wiki/0013739516305929606dd18361248578c67b8067c8c017b000

cocoapods的使用安装就看这篇文章
http://code4app.com/article/cocoapods-install-usage

你可能感兴趣的:(CocoaPods管理本地库)