CocoaPods 支持导入自己的开源库（一）

原创精选来自我的博客文章

前提

有cocoapods的基本环境（安装过cocoapods）

github上有相应的开源代码库，或者新建一个代码库
clone到本地来操作

//clone到本地
$ git clone https://github.com/honeycao/CocoaPodDemo.git
//后续操作都是基于在项目目录下执行
$ cd CocoaPodDemo

创建podspec文件

为了让自己的开源库支持cocoapods导入，关键就是podspec文件

//下面2个命令功能是一样的，都是在当前目录创建一个 cocoapodDemo.podspec 文件
$ pod spec create cocoapodDemo
$ pod spec create cocoapodDemo.podspec

podspec文件书写

在书写podspec文件之前，我们的开源代码库需要有一个规范的目录结构（一般包括源码 + demo），也是为了方便后面源码路径的选择

开源代码库目录结构

.
├── cocoapodDemo（主文件夹）
    ├── cocoapodDemo（源码）
        ├── xxx.bundle
        ├── xxx.h/m
    ├── cocoapodDemoExample（demo示例）
    ├── cocoapodDemoExample.xcodeproj
    ├── cocoapod.podspec
    ├── README.md

podspec文件简单模板
注意：在书写的时候最好不要用文本编辑器打开，容易造成标点符号中英文混用的错误，最好用vim或者sublime打开。

Pod::Spec.new do |s|

  s.name         = "CocoaPodDemo"
  s.version      = "1.0.0"
  s.summary      = "summary"
  s.description  = "description"
  s.homepage     = "https://github.com/honeycao/CocoaPodDemo"
  #s.screenshots  = "www.example.com/screenshots_1.gif", "www.example.com/screenshots_2.gif"

  s.license      = "MIT"
  s.author       = { "author" => "[email protected]" }
  s.platform     = :ios, "7.0"

  s.source       = { :git => "http://github.com/honeycao/cocoapod.git", :tag => "#{s.version}" }
  s.source_files  = "CocoaPodDemo/*.{h,m}"
  s.resources = "CocoaPodDemo/CocoaPodDemo.bundle"

  s.requires_arc = true
  # s.dependency "ACAletController", "~> 1.0.0"

end

s.version：版本号，每次更新必定修改的内容
s.author：作者以及邮箱
s.platform：平台以及最低版本限制
s.source：源代码的一个路径，这里指向的github上对应的某一个版本，而版本号就是和该文件版本相关联，所以这里要确保github上存在这个版本号，也就是验证之前的打标签
s.source_files：资源文件路径
s.dependency：依赖库，有时候代码会依赖于其他第三方，需要在这里配置

验证 podspec 文件

打标签

podspec中定义的版本号，在开源库中如果没有对应的标签，那么我们在验证之前就需要打个标签

$ git tag 1.0.0     #给当前工作副本节点当上 1.0.0 标签
$ git push --tags   #推送所有标签到远端

注册

对于一个新的开源库第一次添加cocoapods支持，是需要进行注册的，而且会有邮件进行确认

// 邮箱 以及 名称 进行注册
$ pod trunk register [email protected] 'author'

//注册成功后可以查看个人信息
$ pod trunk me

验证

直接验证
```
$ pod spec lint
```
忽略警告（有时候有无法避免的警告，可以忽略警告）
```
$ pod spec lint --allow-warnings
```
显示错误（如果验证出错，可以采用这个命令显示出更清晰的错误信息）
```
$ pod spec lint --verbose
```

验证通过显示结果

 -> CocoaPodDemo (1.0.0)

Analyzed 1 podspec.

CocoaPodDemo.podspec passed validation.

推送 podspec 文件到cocoapods

推送的过程会再次验证一遍，所以有时候有会出现验证不通过的情况

$ pod trunk push CocoaPodDemo.podspec

如果在验证的时候添加了忽略警告命令，那么在推送的时候也必须加上，不然前面的警告会再次出现导致验证又通不过。

$ pod trunk push CocoaPodDemo.podspec --allow-warnings

成功之后显示

trunk_push_success

更新 podspec 文件

由于我们的开源库版本更新，所以我们的podspec文件也必须更新，至于更新步骤就是重复上面步骤

修改podspec文件中s.version对应的版本号
验证
给我们开源库打上标签（tag 和 s.version是一致的）
推送

搜索库

一般推送成功之后，我们并不能直接搜索到我们的库，具体怎么做，需要分为两种情况

首次推送成功：需先删除本地缓存再进行搜索

$ rm ~/Library/Caches/CocoaPods/search_index.json
$ pod search CocoaPodDemo

podspec文件更新至推送成功：删除本地缓存进行搜索查看到的也只是旧版本，这时候只需更新pod即可搜索到最新版本的库
```
$ pod repo update
$ pod search CocoaPodDemo
```

错误集中处理

1、验证过程中出现根据路径找不到匹配文件等如下情况

- ERROR | [iOS] file patterns: The `resources` pattern did not match any file.
- - ERROR | [iOS] file patterns: The `source_files` pattern did not match any file.

我们可以到 podspec 验证路径下去手动修改

podspec 本地验证路径：~/Library/Caches/CocoaPods/Pods/External
在该路径下可以找到我们验证的代码库，进入子目录下修改文件路径，或者如果是资源文件不存在，也可以直接添加进去即可
再次执行验证应该就没有这个问题了