创建自己的本地私有pod（实践）

序

下面描述到的操作，我全部都一一实践过，可以保证是没有问题的。如果有读者已经完成了部分操作，可以根据需要选择步骤阅读或者查看“遇到的问题”栏。写了好长时间，如果对你有帮助，还望给点个赞，非要捐助的我也没意见~~~

为什么要这么干

开发过程中我们会有许多公用的组件，比如多个工程会同时引用一段代码。记得多年之前，我曾经打过静态包，还制作过framework来满足我的需求，但是都太不方便了。尤其是多人合作开发的时候，弊端很大。把公用库交给cocoapods来管理，是我觉得目前最方便的解决方案了。伙伴们只要简单几句命令行就可以完成库的安装和更新，真乃团队协作利器。

操作过程中如果遇到命令不明的情况，建议多去官网搜索，里面提供的内容都是最全最准的。Command-line Reference

准备工作

1、准备一个git远程仓库，存放我们自己的specs。

specs可以理解为我们查找库时候的一个索引，为什么我们执行pod search AFNetworking命令时，返回结果如此之快。因为安装cocospod的时候，本地目录就已经有了一份master（公开）的specs，全球程序员们提交到cocospod的开源代码在这都有记录。
我们可以通过执行命令1查看下目录结构，结果一目了然。

命令1

open ~/.cocoapods/repos/master

2、一个git远程仓库，存放我们自己的公共组件代码。

其实这个也可以是别的（比如svn），不过我只尝试过git。git远程仓库我用的是偏爱的coding，免费、好使。

创建私有Spec

准备工作的第一步已经完成了，我创建的私有specs仓库地址为https://coding.net/zanyfly/ZYSpecs.git。下面执行命令2把Spec创建到本地。

命令2

pod repo add ZYSpecs https://coding.net/zanyfly/ZYSpecs.git

这时候ZYSpecs就在本地目录下创建成功了，通过命令查看ZYSpecs的目录结构，会发现里面的内容和git仓库上的保持一致。

open ~/.cocoapods/repos/ZYSpecs

创建个人pod

这一步的主要目的是为我们的公用代码创建podspec文件，这个文件会要求我们配置很多必要的信息。如果你的公用库代码已经是一套成型的组织，那么可以考虑直接新建一个podspec。我的做法是利用命令3创建一个完整的pod，也就是从头开始，好处是可以选择生成Example工程和测试框架，方便调试以及帮助他人学习使用。

1、创建podspec

命令3

pod lib create ZYLib

过程中终端会向我们提出一系列问题，包括开发语言是OC还是Swift（Objective-C or Swift
），demo程序（Making a Demo Application），是否包含测试框架（Choosing a Test Framework），界面测试等（View-based Testing）。选项问题都很简单，我选择了包含demo程序，没有测试框架，大家可以根据自己的实际需要进行选择。</br>
2、编辑podspec
操作成功后，可以看到ZYLIB.podspec文件就已经创建好了，而且其中包含一个Example目录。大体的结构图（摘自官网）

$ tree ZYLIB -L 2

  ZYLIB
  ├── _Pods.xcproject
  ├── Example
  │   ├── ZYLIB
  │   ├── ZYLIB.xcodeproj
  │   ├── ZYLIB.xcworkspace
  │   ├── Podfile
  │   ├── Podfile.lock
  │   ├── Pods
  │   └── Tests
  ├── LICENSE
  ├── ZYLIB.podspec
  ├── Pod
  │   ├── Assets
  │   └── Classes
  │     └── RemoveMe.[Objective-C/m]
  └── README.md

用编辑器打开podspec，把里面的资料都填写一下，下面是我写的（#注释的部分都被我删掉了）。特别指出：务必保证填写的每一项都要是正确的，比如主页和链接都要能够访问。

Pod::Spec.new do |s|
  s.name             = 'ZY_LIB'
  s.version          = '0.1.0'
  s.summary          = 'This is my pod lib'


  s.description      = <<-DESC
TODO: Add long description of the pod here.
                       DESC

  s.homepage         = 'https://git.coding.net/ivanzeng/ZY_LIB.git'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'zengyuan' => 'zanyfly@126.com' }
  s.source           = { :git => 'https://git.coding.net/ivanzeng/ZY_LIB.git', :tag => s.version.to_s }
  s.social_media_url = 'http://www.jianshu.com/users/f8e79006b5c6/latest_articles'

  s.ios.deployment_target = '7.0'

  s.source_files = 'ZY_LIB/Classes/**/*'

  s.public_header_files = 'ZY_LIB/Classes/**/*.h'
  s.dependency 'AFNetworking', '~> 2.0'
end

提示: s.public_header_files是要公开的头文件，s.dependency表示依赖库，我的库HTTP通信部分用了AFNetworking，没有的话可以直接注释掉。</br>
3、测试podspec
我首先是打开Example，在工程里直接尝试调用库文件，保证编译过程中没有错误，没有警告，运行过程中可以正常使用。
最后打开命令行，cd到podspec所在的当前目录，执行命令4进行检验。

命令4

pod lib lint

幸运的话，我们可以看到passed validation.的提示。如果提示验证失败，不要着急，仔细阅读它描述的错误信息，基本上google一下就能找出解决方案。</br>
备注：要是实在是解决不了警告也没关系，在后面追加 --allow-warnings

4、提交ZY_LIB代码
这时候ZY_LIB验证通过，确定没问题了，那么把代码push到我们公用库远程仓库上去，否则其他的同事或者合作者就没法用了。基本操作就是add、commit、push，最后重点说明一个事情，push结束以后千万不能忘记打tag！！！而且tag值一定要和s.version保持一致！！！

$ git tag -m "ZYLib say hi to you" 0.1.0
$ git push --tags  

这些操作全都结束以后，可以通过log日志的方式，来确保我们没有遗漏操作。</br>
5、push podspec
执行命令5，这时候本地的repos目录就有ZYSPECS了，和~/.cocoapods下的master是同级。
命令5

pod repo push ZYSPECS ZYLIB.podspec。

提交时候，会再进行一次验证，如果遇到警告不通过的问题，可以考虑 pod repo push ZYSPECS ZYLIB.podspec --allow-warnings。
</br>
6、搜索公用库，执行命令6
命令6

pod search ZYLib

查询到结果，说明已经安装成功。

使用公用库

使用方式和其他的开源库一样，修改podfile，增加库标记。不同的是，需要在头部增加

source 'https://github.com/CocoaPods/Specs.git'
source 'https://git.coding.net/ivanzeng/ZYSpecs.git'

否则可能会出现无法正确安装的情况。其他同事或者小伙伴，在自己的电脑执行一下命名进行安装，

pod repo add ZYSpecs https://git.coding.net/ivanzeng/ZYSpecs.git

如果是更新就换成 repo update。

写作参考

遇到的问题

1.demo下无法import到库头文件
解决办法：我遇到过一次，如果发生了，手动打开pod工程 - Build Phases - Headers - Public,把我们需要的头文件加进去。

2.pod lib lint执行报错
记得修改下summary，别用初始的。看看source和homepage是否正确，public_header_files是否正确引用。还要记住代码文件不能有警告，有警告也无法编译成功。

3、 pod lib lint执行报错

  - ERROR | [iOS] xcodebuild: Returned an unsuccessful exit code. You can use `--verbose` for more information.
    - ERROR | xcodebuild:  ....
    -  error: include of non-modular header inside framework module '' [-Werror,-Wnon-modular-include-in-framework-module]
...

原因就是我的库的某个头文件中直接import了第三方库（我对它有依赖）的头文件，我采用了前向声明的方式解决。

4、pod lib lint验证成功了，但是在接下来的pod repo push报错
而且报的是就是podspec无法通过验证，解决方法，重新提交一个tag并push。在执行pod repo push，验证通过。

5、pod search可以成功的搜索到我们的库，但是在项目中执行pod install报错
Unable to find a specification for **

在podfile 文件中

source 'https://github.com/CocoaPods/Specs.git'
source 'https://git.coding.net/ivanzeng/ZYSpecs.git'

6、在pod中引入第三方库报错
比如在自己的pod中引入sharesdk，lint时报错

The 'Pods-Your Example' target has transitive dependencies that include static binaries:

这是因为sharesdk以framework形式出现，导致lint在执行的时候因为静态库无法通过验证。可以在lint命令后面增加

--use-libraries

参考
https://www.jianshu.com/p/d6a592d6fced