使用CocoaPods创建私有库

最近在研究使用CocoaPods创建私有库，因为公司要使用组件化，然后打算用cocoapods来管理各个组件，那就废话少说吧，直接把步骤跟大家分享下，有不对的地方希望大家多多指教，感激不尽！

主要的参考链接有以下几个: www.jianshu.com/p/107cc74847ab

                                               blog.csdn.net/yanyanforest/article/details/53406855

                                               www.jianshu.com/p/7a82e977281c

                                               www.jianshu.com/p/ddc2490bff9f

                                               www.jianshu.com/p/c6c227c0c221

                                               含有一些常见的错误

                                               www.cocoachina.com/ios/20150930/13471.html

                                               添加资源文件

                                               添加资源文件

主要是以下四个步骤：

一、创建Spec Repo管理我们创建的所有pod spec （repo1）

二、创建准备制作成podspec的项目 （repo2）

三、创建并提交MyLib pod库的pod spec文件到私有仓库

四、pod做成功了

五、常见错误

---

过程如下：

一、创建Spec Repo管理我们创建的所有pod spec

注意：查看本地的cocoapods文件目录路径：~/.cocoapods/repos，这是一个隐藏文件，可以通过终端命令来(显示 \隐藏)隐藏文件：

显示隐藏文件：$ defaults write com.apple.finder AppleShowAllFiles -boolean true ; killall Finder

隐藏文件：$ defaults write com.apple.finder AppleShowAllFiles -boolean false ; killall Finder

以上是我本地repos的目录：master是官方的目录，FXSpecs是我们自己的私有库目录。

1、首先在gitlab上建立一个FXSpecs项目（管理所有的pod spec文件）

2.终端执行一下命令clone远程的FXSpecs：

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

$ pod repo add FXSpecs http://zhoubin2017@git.xxx.com:88/xxx/FXSpecs.git

此时查看你的本地~/.cocoapods/repos路径就会发现FXSpecs文件已经存在了

二、创建准备制作成podspec的项目

1.在GitLab上创建FXLoginRegist项目（repo2）

2.cd进入到要创建项目的目录，然后终端执行以下命令创建工程：

#pod lib create [项目名]

$pod lib create FXLoginRegist

接着在控制台就会输出以下几个问题让你来回答：

2.1选择使用语言

What language do you want to use?? [ Swift / ObjC ]

> ObjC

2.2问你是否需要创建一个Demo项目，我选的是Yes

Would you like to include a demo application with your library? [ Yes / No ]

> Yes

2.3让你是否选择一个测试框架，选 None

Which testing frameworks will you use? [ Specta / Kiwi / None ]

> None

2.4是否基于View测试，选Yes

Would you like to do view based testing? [ Yes / No ]

> yes

2.5类的前缀

What is your class prefix?

> FXL

完成以上的问题后控制台会输出以下信息 ，然后自动打开所创建的项目

在以下截图的目录下添加你的实现代码，里面自带一个ReplaceMe.m文件，直接删除它就好了，添加你自己的.h.m实现文件 ，如下图：

3.修改Podfile文件，打开工程目录下Example目录的Podfile文件，修改如下：

修改之后在Example目录下执行pod update安装依赖

4.提交本地的FXLoginRegist到远程仓库（repo2）

在终端执行以下命令：

至此，本地的FXLoginRegist已经提交至远程仓库了，如下图：

三、创建并提交MyLib pod库的pod spec文件到私有仓库

1.配置pod spec文件信息，打开FXLoginRegist目录下的FXLoginRegist.podspec文件，如下图：

2.编辑好了之后，要验证下podspec文件

2.1执行以下命令：pod lib lint

成功后终端会输出以下信息：-> FXLoginRegist (0.1.0)

                                                FXLoginRegist passed validation.

3.测试pod spec文件，cd Example工程目录，执行pod update

4.向Spec Repo提交pod spec，也就是把FXLoginRegist.podspec提交到远程仓库（repo1），终端执行：

成功后会在控制台输出如下信息，我遇见额的几个问题和解决办法会在文章底部给大家写上仅供参考：

至此，~/.cocoapods/repos/FXSpecs目录下就已经存在了我们创建的pod spec文件了，可以在cocoapods上面查询到

四、pod做成功了

这是我们既可以把制作好的podspec集成到项目中啦，在podfile中药配置如下信息，然后pod install就成功啦

五、常见错误

1.pod lib lint时候常见的错误 

1）错误： [!] ExtensionSample did not pass validation, due to 1 warning (but you can use `--allow-warnings` to ignore it).

[!] The validator for Swift projects uses Swift 3.0 by default, if you are using a different version of swift you can use a `.swift-version` file to set the version for your Pod. For example to use Swift 2.3, run:

`echo "2.3" > .swift-version`.

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

      解决办法：终端输入命令echo "2.3" > .swift-version 解决

2）错误：[!] TestLib did not pass validation, due to 1 warning (but you can use `--allow-warnings` to ignore it) and all results apply only to public specs, but you can use `--private` to ignore them if linting the specification for a private pod.

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

bogon:TestLib sunjinshuai$

      解决办法：pod lib lint --allow-warnings

3）错误：ERROR | [iOS] unknown: Encountered an unknown error (An unexpected version directory `Assets` was encountered for the `/Users/zzz/.cocoapods/repos/aaa/xxx` Pod in the `xxx` repository.

     解决办法：找到上边提示的路径，然后删除xxx文件就好了

4）错误：ERROR | [iOS] Encountered an unknown error (The 'Pods' target has transitive dependencies that include static binaries: (/private/var/folders/xx/xxx/T/CocoaPods/Lint/Pods/BPushSDK/LibBPush/libBPush.a)) during validation.

      解决办法：这个错误是因为依赖库（s.dependency）包含了.a静态库造成的。虽然这并不影响Pod的使用，但是验证是无法通过的。可以通过 --use-libraries 来让验证通过。

2.pod repo push FXSpecs TestLib.podspec常见错误

1）错误：Validating spec

-> TestLib (0.1.0)

- WARN | source: Git SSH URLs will NOT work for people behind firewalls configured to only allow HTTP, therefore HTTPS is preferred.

[!] The repo `FXSpecs` at `../.cocoapods/repos/FXSpecs` is not clean

      解决办法：1.cd到repo目录

                         2.git status（有时候是因为有内容没有commit，如果提示那就commit一下）

                         3.git clean -f （清除多余的隐藏文件之类的）

                         4.push就成功了，希望对你有帮助