上一篇文章记录了我利用cocoapods创建基于SVN的私有库的全部过程，今天我再记录一下基于git创建的过程。

整体先说明一下创建一个私有的podspec包括如下那么几个步骤：

1. 创建并设置一个私有的Spec Repo。
2. 创建Pod的所需要的项目工程文件，并且有可访问的项目版本控制地址。
3. 创建Pod所对应的podspec文件。
4. 本地测试配置好的podspec文件是否可用。
5. 向私有的Spec Repo中提交podspec。
6. 在个人项目中的Podfile中增加刚刚制作的好的Pod并使用。
7. 更新维护podspec。

在这一系列的步骤中需要创建两个Git仓库，分别是第一步和第二步（第二步不一定非要是Git仓库，只要是可以获取到相关代码文件就可以，也可以是SVN的，也可以说zip包，区别就是在podspec中的source项填写的内容不同），并且第一步只是在初次创建私有podspec时才需要，之后在创建其他的只需要从第二步开始就可以。

创建私有Spec Repo

什么是Spec Repo？他是所有的Pods的一个索引，就是一个容器，所有公开的Pods都在这个里面，他实际是一个Git仓库，remote端在GitHub上，当我们使用Cocoapods后它会被clone到本地的~/.cocoapods/repos目录下，可以进入到这个目录看到master文件夹就是这个官方的Spec Repo了。这个master目录的结构是这个样子的

因此我们需要创建一个类似于master的私有Spec Repo 。同理这个私有Spec Repo我们也要有一个远程端。那么我们需要创建一个 Git仓库，这个仓库你可以创建私有的也可以创建公开的。如果是私有的话，项目中其他同事，你要给他这个Git仓库的权限。

https://git.oschina.net（选择右上角的+号，创建项目）

创建完成之后在Terminal中执行如下命令

命令格式# pod repo add [Private Repo Name] [GitHub HTTPS clone URL]

$ pod repo add yooweiTest https://git.oschina.net/yoowei/yooweiTest

详情

$ defaults write com.apple.finder AppleShowAllFiles -boolean true ; killall Finder

$ pod repo add yoowei https://git.oschina.net/yoowei/yooweiTest

Cloning spec repo `yooweiTest` from `https://git.oschina.net/yoowei/yooweiTest`

Username for 'https://git.oschina.net': yoowei

Password for 'https://yoowei@git.oschina.net':

输入账号码云的账号密码后，进入到~/.cocoapods/repos目录下就可以看到yoowei这个目录了。至此第一步创建私有Spec Repo完成。

PS：如果有其他合作人员共同使用这个私有Spec Repo的话在他有对应Git仓库的权限的前提下执行相同的命令添加这个Spec Repo即可。

检查是否安装成功：
$ cd ~/.cocoapods/repos/yooweiTest

$ pod repo lint .

注意第二个命令后面的 "."不能省。

创建Pod项目工程文件

这个第二步没有什么好介绍的，如果是有现有的组件项目，并且在Git的版本管理下，那么这一步就算完成了，可以直接进行下一步了。如果没有的话，可以使用Cocoapods提供的一个工具将第二步与第三步结合起来做。

现在来说一下这个工具，相关的文档介绍是Using Pod Lib Create 就拿我创建的yooweiTestLibrary为例子具体讲一下这里是如何操作的，先cd到要创建项目的目录然后执行

接下来就是向yooweiTestLibrary组件文件夹中添加库文件和资源，并配置podspec文件，我测试的时候把一个UIAlertView分类放入yooweiTestLibrary/Classes中，然后进入Example文件夹执行pod update命令，再打开项目工程可以看到，刚刚添加的组件已经在Pods子工程下Development Pods/yooweiTestLibrary中了。之所以是Development Pods/PodTestLibrary中，这是因为我们是在本地测试，而没有把podspec文件添加到Spec Repo中的缘故。

注：这里需要注意的是每当你向yooweiTestLibrary中添加了新的文件或者以后更新了podspec的版本都需要重新执行一遍pod update命令。

通过Cocoapods创建出来的目录本身就在本地的Git管理下，我们需要做的就是给它添加远端仓库，同样去GitHub或其他的Git服务提供商那里创建一个私有的仓库，拿到SSH地址(这一步需要配置 SSH)

使用SSH方式加密连接过程如下（码云的相关方式）：

$ ssh-keygen

Generating public/private rsa key pair.

Enter file in which to save the key (/Users/galahad/.ssh/id_rsa): //直接回车，千万不要输入

/Users/galahad/.ssh/id_rsa already exists.

Overwrite (y/n)? y

Enter passphrase (empty for no passphrase): //输入密码，待会会用到

Enter same passphrase again:

Your identification has been saved in /Users/galahad/.ssh/id_rsa.

Your public key has been saved in /Users/galahad/.ssh/id_rsa.pub.

The key fingerprint is:

省略......

The key's randomart image is:

省略......

$ cat ~/.ssh/id_rsa.pub        // 查看

省略......拿到以后在开源中国码云上面添加公钥

$ ssh -T git@git.oschina.net   //连接（添加成功以后，这里进项连接）

Enter passphrase for key '/Users/galahad/.ssh/id_rsa':  //输入刚才的那个密码

Welcome to Git@OSC, yoowei!

一切OK

然后cd到yooweiTestLibrary项目目录

将本地仓库关联到git远程仓库的详细步骤

$ cd /Users/galahad/Desktop/yooweiTesting/yooweiTestLibrary

$ git add .

$ git commit -s -m "Initial Commit of Library"

$ git remote add origin git@git.oschina.net:yoowei/yooweiTestLibrary.git

$ git push -u origin master    //报错

Enter passphrase for key '/Users/galahad/.ssh/id_rsa':             //输入密码

To git.oschina.net:yoowei/yooweiTestLibrary.git

! [rejected]        master -> master (fetch first)

error: failed to push some refs to 'git@git.oschina.net:yoowei/yooweiTestLibrary.git'

hint: Updates were rejected because the remote contains work that you do

hint: not have locally. This is usually caused by another repository pushing

hint: to the same ref. You may want to first integrate the remote changes

hint: (e.g., 'git pull ...') before pushing again.

hint: See the 'Note about fast-forwards' in 'git push --help' for details.

$ git fetch

Enter passphrase for key '/Users/galahad/.ssh/id_rsa':

From git.oschina.net:yoowei/yooweiTestLibrary

* [new branch]      master     -> origin/master

$ git branch

* master

$ git push --force origin master    //直接强推，成功

Enter passphrase for key '/Users/galahad/.ssh/id_rsa':

Counting objects: 324, done.

Delta compression using up to 4 threads.

Compressing objects: 100% (313/313), done.

Writing objects: 100% (324/324), 186.04 KiB | 0 bytes/s, done.

Total 324 (delta 74), reused 0 (delta 0)

remote: Resolving deltas: 100% (74/74), done.

To git.oschina.net:yoowei/yooweiTestLibrary.git

+ 66361fb...e9cc24c master -> master (forced update)

本地仓库添加东西以后，测试

$ git status

$ git add .

$ git commit -m" 初始化"

$ git push

fatal: The current branch master has no upstream branch.

To push the current branch and set the remote as upstream, use

git push --set-upstream origin master

$ git push --set-upstream origin master

Enter passphrase for key '/Users/galahad/.ssh/id_rsa':

Counting objects: 7, done.

Delta compression using up to 4 threads.

Compressing objects: 100% (7/7), done.

Writing objects: 100% (7/7), 17.74 KiB | 0 bytes/s, done.

Total 7 (delta 1), reused 0 (delta 0)

To git.oschina.net:yoowei/yooweiTestLibrary.git

f2bf993..f2d3210  master -> master

Branch master set up to track remote branch master from origin.

本地仓库添加图片后（再次测试就OK了）

$ git status

$ git add .

$ git commit -m"添加图片"

$ git push

Enter passphrase for key '/Users/galahad/.ssh/id_rsa':

Counting objects: 5, done.

Delta compression using up to 4 threads.

Compressing objects: 100% (5/5), done.

Writing objects: 100% (5/5), 6.71 KiB | 0 bytes/s, done.

Total 5 (delta 1), reused 0 (delta 0)

To git.oschina.net:yoowei/yooweiTestLibrary.git

f2d3210..a54adeb  master -> master

因为podspec文件中获取Git版本控制的项目还需要tag号，

所以我们要打上一个tag，

$ git tag -m "first release" 0.1.0

推送tags到远程仓库

$ git push --tags

$ git tag

0.1.0

接下来就开始编辑podspec文件了，它是一个Ruby的文件.

也可参考：http://www.cnblogs.com/richard-youth/p/6272932.html

编辑完podspec文件后，需要验证一下这个文件是否可用

以前测试的时候遇到过的错误：

1、-> yooweiTestLibrary (0.1.0)

- WARN  | summary: The summary is not meaningful.

- WARN  | url: There was a problem validating the URL https://github.com/<GITHUB_USERNAME>/yooweiTestLibrary.

- ERROR | [iOS] unknown: Encountered an unknown error ([!] /usr/bin/git clone https://github.com/<GITHUB_USERNAME>/yooweiTestLibrary.git /var/folders/rg/gmjp61bx0x95t4tjx2hh_3sr0000gn/T/d20170119-91250-1w5v7us --template= --single-branch --depth 1 --branch 0.1.0

Cloning into '/var/folders/rg/gmjp61bx0x95t4tjx2hh_3sr0000gn/T/d20170119-91250-1w5v7us'...

fatal: unable to access 'https://github.com/<GITHUB_USERNAME>/yooweiTestLibrary.git/': The requested URL returned error: 400

红色的需要修改。

2、

-> yooweiTestLibrary (0.1.0)

- ERROR | [iOS] file patterns: The `resource_bundles` pattern for `yooweiTestLibrary` did not match any file.

原因是：

s.resource_bundles = {

'yooweiTestLibrary' => ['yooweiTestLibrary/Assets/*.png']

}

找不到任何文件，所以报错，解决方式要么弄几张图片，要么先删掉。

当你看到

yooweiTestLibrary.podspec passed validation.

时，说明验证通过了，不过这只是这个podspec文件是合格的，不一定说明这个yooweiTestLibrary是可以用的，我们需要在本地做一下验证，这就是第四步的内容了，第四步在具体说明。

创建podspec文件

如果从第二步过来，如果已经有了现成的项目，那么就给这个项目创建一个podspec文件。编辑完成之后使用验证命令验证一下。

具体操作参考：http://www.cnblogs.com/richard-youth/p/4704413.html

本地测试podspec文件

我们可以创建一个新的项目，在这个项目的Podfile文件中直接指定刚才创建编辑好的podspec文件，看是否可用。 在Podfile中我们可以这样编辑，有两种方式

其中yooweiTestLibrary.podspec的路径为/Users/galahad/Desktop/yooweiTesting/yooweiTestLibrary/yooweiTestLibrary.podspec

# 指定路径的方式，注意到yooweiTestLibrary.podspec上一层文件夹就可以了

#pod 'yooweiTestLibrary', :path => '~/Desktop/yooweiTesting/yooweiTestLibrary'

# 指定podspec文件（要具体到yooweiTestLibrary.podspec）

pod 'yooweiTestLibrary', :podspec => '~/Desktop/yooweiTesting/yooweiTestLibrary/yooweiTestLibrary.podspec'

然后执行pod install命令安装依赖，打开项目工程，可以看到库文件都被加载到Pods子项目中了。

中间测试过程中遇到部分错误，通过修改.Podspec文件就可以解决。

在项目中编写代码，测试库文件无误后就可以开始下一步了，提交podspec到Spec Repo中。

向Spec Repo提交podspec

向Spec Repo提交podspec需要完成两点一个是podspec必须通过验证无误，再一个就是删掉无用的注释（规范，但不必须）。 向我们的私有Spec Repo提交podspec只需要一个命令

pod repo push [本地Spec Repo名称][podspec文件路径]

$ pod repo push yooweiTest ~/Desktop/yooweiTesting/yooweiTestLibrary/yooweiTestLibrary.podspec

完成之后这个组件库就添加到我们的私有Spec Repo中了，可以进入到~/.cocoapods/repos/yooweiTest目录下查看

可能会出现的问题是：

Validating spec

Cloning spec repo `-1` from ``

[!] Unable to add a source with url `` named `-1`.

You can try adding it manually in `~/.cocoapods/repos` or via `pod repo add`.

网上资料说，是装了多个Xcode导致路径变了，

解决：

$ sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer

注意这个路径可以通过终端拉文件得到：/Applications/Xcode.app/Contents/Developer

$ pod update --no-repo-update

$ pod install --verbose --no-repo-update

真是蛋疼，所有的方法用尽了还是(以后有机会再重新试试？)

[!] Unable to add a source with url `` named `-1`.

You can try adding it manually in `~/.cocoapods/repos` or via `pod repo add`.

那我就真手动了，前往~/.cocoapods/repos文件夹找到yoowei文件夹

其组成方式是

specName  ——   版本version ——  specName.podspec

$ cd /Users/galahad/.cocoapods/repos/yooweiTest

$ tree -L 3

.

├── LICENSE

├── README.md

└── yooweiTestLibrary

└── 0.1.0

└── yooweiTestLibrary.podspec

2 directories, 3 files

然后

$ pod search yooweiTestLibrary

[!] Unable to find a pod with name, author, summary, or description matching `yooweiTestLibrary`

$ rm ~/Library/Caches/CocoaPods/search_index.json

$ pod search yooweiTestLibrary

Creating search index for spec repo 'master'.. Done!

Creating search index for spec repo 'net:443'.. Done!

Creating search index for spec repo 'yoowei'.. Done!

-> yooweiTestLibrary (0.1.0)

测试yooweiTest

pod 'yooweiTestLibrary', '~> 0.1.0'

- Homepage: https://git.oschina.net

- Source:   https://git.oschina.net/yoowei/yooweiLibrary.git

- Versions: 0.1.0 [yoowei repo]

这里说的是添加到私有的Repo，如果要添加到Cocoapods的官方库了，可以使用trunk工具。

可以参考：http://www.cnblogs.com/richard-youth/p/4704413.html

使用制作好的yooweiTestLibrary

我们在正式项目中使用这个私有的yooweiTestLibrary，在项目的Podfile里增加以下一行代码

pod 'yooweiTestLibrary', '~> 0.1.0'

$ pod install

之后发现不正常现象

Analyzing dependencies

[!] Unable to find a specification for `yooweiTestLibrary (~> 0.1.0)`

原因：

如果你不指定来源的话,pod install只会在master下搜索有没有,而我们的yooweiTestLibrary.podspec文件在yoowei下面,当然找不到了!

解决方式

在podfile文件最上方添加

source 'https://git.oschina.net/yoowei/yooweiTest'  #我们自己的私有spec仓库的地址

source 'https://github.com/CocoaPods/Specs.git'    #官方仓库的地址

默认情况下,如果你不添加source的话,系统会默认使用 https://github.com/CocoaPods/Specs.git 官方源,但是当你添加了source后,系统就不再自动搜索官方源,所以这两句都必须添加!!!!!

怎么查看本地有几个repo

$ pod repo

master

- Type: git (master)

- URL:  https://github.com/CocoaPods/Specs.git

- Path: /Users/galahad/.cocoapods/repos/master

net:443

fatal: Not a git repository (or any of the parent directories): .git

- Type: local

- URL:

- Path: /Users/galahad/.cocoapods/repos/net:443

yooweiTest

- Type: git (master)

- URL:  https://git.oschina.net/yoowei/yooweiTest

- Path: /Users/galahad/.cocoapods/repos/yooweiTest

3 repos

怎么删除repos

├── LICENSE

├── yooweiTestLibrary
│   ├── 0.1.0 │   
│   └──yooweiTestLibrary.podspec 
│   └── 0.2.0 │   
│   └──yooweiTestLibrary.podspec 

── README.md  3 directories, 4 files

source 'https://github.com/CocoaPods/Specs.git'  # 官方库

platform :ios, '7.0'

pod 'yooweiTestLibrary/NetWorkEngine', '1.0.0' #使用某一个部分 

pod 'yooweiTestLibrary/UIKitAddition', '1.0.0'  

pod 'yooweiTestLibrary', '1.0.0' #使用整个库

$ pod repo remove yooweiTest

$ pod repo add yoowei git@git.oschina.net:yoowei/yooweiTestLibrary.git

参考文章：

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