自建 cocoapods 库，这一篇就够了

通过查找两天了的资料，和一步一坑的实践。鬼知道我有多少次想砸电脑。

不过最终还是实现了自建 cocoapods 库。话不多说，以下是全部过程：

---

一、新建远端库

选择一个平台，GitHub 也好，GitLab 也罢。提醒一下：GitHub 上的私有库是收费的。

我这里选择的是GitLab：

添加远端库

！！！重点：这里我们添加两个远端库！！！

一个是私有仓库的索引库，存放.podspec 文件的。

另一个则是自己要建立的组件库。

索引库

组件库

使用 GitLab 的要进入Setting ——> Repository ——> Protected Branches 里面取消保护。

设置

取消保护

到此，第一步准备工作就算完成了，很简单。

二、创建两个本地库与对应的远端库相关联

2.1 直接将索引库clone 至 ~/.cocoapods/repos文件夹。

pod repo add zzmRepo https://git.lug.ustc.edu.cn/Taurus_zzm/zzmrepo.git

成功后前往~/.cocoapods/repos文件夹下，就可以看到 zzmRepo 库了。（提醒：这里的名字要和远端库相同，否则后面还会有坑等着你）

2.2 在桌面新建一个文件夹，使用终端打开到此文件夹下。

（这里是我爬了好久的坑，网上很多人没有重点说，我以为直接在上一步的文件夹中执行，其实不然）

然后执行 pod lib create zzmUtils

这是 Cocoapods 提供的一个工具，以此来开始 Pod 的创建。详细可点击这里。

稍等片刻，终端会询问你问题如下：

示例

2.3 Pod 库建好了之后就要向其中添加库和资源以及代码文件

建好的 pod 库下面的文件

向 zzmUtils ——> Pod ——>Classes 文件夹下添加资源文件。比如我就添加了 zzmConstant.h ,同时删除了 ReplaceMe.m 文件。

之后使用终端 cd 到上图中的 Example 文件夹

执行pod update

不出意外会执行成功（毕竟这一步我还没错过）

然后再打开 Example 文件夹中的项目，会发现Development Pods/zzmUtils 文件夹下有了该文件。

文件目录

2.4 最重要的一步：修改.podspec 文件

亲身体验，这一步错会导致后面各种奇葩的错误出现。

修改 .podspec 文件

真的确认无误后开始下一步。

三、远端库和本地库的关联

3.1终端 cd 到本地的 Pod 库下，我的是 zzmUtils。

git add .

git commit -m 'first commit'

git remote add origin https://git.lug.ustc.edu.cn/Taurus_zzm/zzmutils.git

git pull

git push origin master

注意：关联的链接也是组件库的链接。

如果出现 ! [rejected]    master -> master (non-fast-forward)则使用

git push -f origin maser

rejected

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

git tag 0.1.0

 git push --tags

3.2 上面的都成功后我们就要开始验证这个podspec文件是否可用。

很多地方使用的是 pod lib lint，也有人用的是 pod spec lint。区别如下：

pod lib lint是只从本地验证你的pod能否通过验证。

pod spec lint是从本地和远程验证你的pod能否通过验证。

所以我建议采用后者。

强烈建议  pod spec lint --allow-warnings

因为这样可以忽略一些警告。

如果前面的 podspec 文件修改正确，后面的链接也都对的上的话，

不出意外会得到 ***passed validation。

通过验证

3.3 最后一步

 将通过验证的 podspec文件 上传到索引库，发布当前版本：

pod repo push zzmRepo zzmUtils.podspec

前面是 索引库 的名称，后面是文件名称。由于之前我们已经关联了 `zzmRepo` 这个仓库的地址，所以这里push之后会直接push到我们的git仓库之中。

忽略警告

至此大功告成！先不急着庆祝，验证一下这个库能不能用：

pod search ****

出现下图这样的结果，就算真的成功了！

 pod search结果

四、去项目中引用 pod

需要在前面加上 source：索引库的链接，再执行 pod install。就可以看见 Pods 下有了。

大功告成

参考链接：

http://blog.wtlucky.com/blog/2015/02/26/create-private-podspec/

https://www.cnblogs.com/tufeibo/p/5654268.html

https://www.e-learn.cn/content/qita/2645296

https://www.jianshu.com/p/9f7ecaf8667f