一、安装

1.网上教程有太多，先来一个CocoaPods的安装与使用（一）［http://www.jianshu.com/p/13cb4937108a］

注意：安装之前先确认电脑上之前是否安装过pod，执行命令pod —version

安装简要步骤：

1.查看镜像

$ gem sources -l

2.若是ruby的https://rubygems.org/则需要换成淘宝的，如本来就已经是淘宝的（https://ruby.taobao.org/），就不用换了

更改的方式为：

a.$ gem source -rhttps://rubygems.org/

b.$ gem source -ahttps://ruby.taobao.org/

3.查看是否替换成功:

$ gem sources -l

4、安装cocopods

$sudo gem install cocoapods（步骤有点慢，不要急）

2. 如果安装过，实用当前pod 执行install 或者update老是失败，但其他人install和update能成功，可能是本地pod做过不干净的操作，

被损坏，可以卸载本地pod，重新安装，卸载重装的教程也很清楚：cocopods卸载、安装、重装等问题解决［http://blog.csdn.net/qtds8810/article/details/50510910］（重装解决90%问题）

卸载关键步骤：

二.简单的pod file文件

先是最简单的例子，针对测试的简单工程

target : test do 

pod'OCMock','~> 2.0.1'

end

再到复杂一点的，

source'https://github.com/CocoaPods/Specs.git'//可以不要                                             

platform:ios,‘6.0’//可以不要inhibit_all_warnings!//可以不要

xcodeproj'MyProject'//路径对的话，可以不要

pod'ObjectiveSugar','~> 0.5'

target : test  do//target必须要

pod'OCMock','~> 2.0.1'

end

---

pod install 或者 pod update 失败了跟第三方库有没有关系？

测试：

1.向pod仓库中提交了一个自己的podspec文件，podspec文件中指向gitHub上一些项目文件，故意在文件中写了一些编译不过的语法，首先实用pod spec lint 命令去检验podspec文件的有效性时，在debug信息中发现输出了Xcode的编译信息，提示了语法的warnning，但还是通过了。

2.将这个自己的第三方库引入到测试工程的podfile中，再执行pod update 操作时任然成功了。

结论：pod install 和pod update 失败与第三方库的文件无关

三、podSpec文件的结构

1.先从简单的例子来看清文件的结构

图1

例. AFNetWorking.podSpec文件

图2

s.name：名称，pod search 搜索的关键词

s.version：版本

s.summary：简介，pod search 搜索的关键词

s.homepage：主页地址，例如Github地址

s.license：许可证

s.author：作者

s.social_media_url：社交网址

s.platform：平台

s.source：Git仓库地址，例如在Github地址后边加上 .git 就是Git仓库地址，常见写法如下

s.source_files：需要包含的源文件，常见的写法如下

s.resources：需要包含的图片等资源文件

s.dependency：依赖库，不能依赖未发布的库

s.dependency：依赖库，如有多个可以这样写

s.requires_arc：是否要求ARC

s.source_files 常见写法

[

      "Directory1/*”,

      "Directory1/Directory2/*.{h,m}”,

      "Directory1/**/*.h”

]

“*” 表示匹配所有文件

“*.{h,m}” 表示匹配所有以.h和.m结尾的文件

“**” 表示匹配所有子目录

s.source 常见写法

s.source = { :git=>"https://github.com/xiaofei86/LPPushService.git", :commit=>"68defea"}

s.source = { :git=>"https://github.com/xiaofei86/LPPushService.git", :tag=>1.0.0}

s.source = { :git=>"https://github.com/xiaofei86/LPPushService.git", :tag=>s.version }

commit => "68defea" 表示将这个Pod版本与Git仓库中某个commit绑定

tag => 1.0.0 表示将这个Pod版本与Git仓库中某个版本的comit绑定

tag => s.version 表示将这个Pod版本与Git仓库中相同版本的commit绑定

四、pod使用过程中常见报错

检测podSpec文件错误

1.语法错误

如果是因为语法错误，验证失败后会给出错误的准确定位

[!] Invalid `LPPushService.podspec`file: no . floating literal anymore;put0beforedot  s.version= “1.0.0”                        ^LPPushService.podspec:5: syntaxerror, unexpected tFLOAT, expecting '('  s.version= “1.0.0”                          ^

标记“^”的地方即为有语法错误的地方。

2.依赖错误

但是，有些非语法错误是不会给出错误原因的。这个时候可以使用“--verbose”来查看详细的验证过程来帮助定位错误。

pod spec lint LPPushService.podspec--verbose

如下错误通过 --verbose 就可以找到原因。

-> LPPushService (1.0.0)    - ERROR | [iOS] Encountered an unknown error (The'Pods'target has transitivedependenciesthatincludestaticbinaries: (/private/var/folders/jz/b_m3k7ln47524cm__h3__mk00000gn/T/CocoaPods/Lint/Pods/BPushSDK/LibBPush/libBPush.a)) during validation.

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

podspeclintLPPushService.podspec--verbose--use-libraries

这种情况下使用 --use-libraries 虽然不会出现错误（error），但是有时候会带来一些警告（waring），警告同样是无法通过验证的。这时可以用 --allow-warnings 来允许警告。

podspeclintLPPushService.podspec--verbose--use-libraries--allow-warnings

安装错误

如果在其他项目 pod install 的过程中，出现包含“undefined method `end_with?' for nil”字样的报错。进入“~/.cocoapods/repos”目录，删除“master”，并将 master-1 改为 master 即可。

如果出现如下错误，而你的验证可以通过，那么一般更新下版本号就可以解决。

[!] Unabletofinda specificationfor'LPPushService'.

五、制作自己的pod库

1.在github上创建自己的项目库

图3 图4 图5

2.自己的代码库创建成功后，克隆到本地，添加自己的文件到本地代码仓库，然后向远程仓库push代码

1.  git clonehttps://github.com/13554175559/TestPodSpec.git2.  cd TestPodSpec3.  git add a.file4.  git commit -am “add files”5.  git push6.  git tag 0.0.17.  git push origin 0.0.1

3.然后就可以创建库所对应的podSpec文件了

打开terminal在自己的库的根目录下执行 

pod spec create TestPodSpec

然后就可以编辑产生的TestPodSpec.podspec 文件了，编辑时参考上面的－》三、podSpec文件的结构

4.验证pod spec文件的有效性

在terminal中进入库的根目录，执行

 pod spec lint TestPodSpec.podspec —allow-warnings

中间如果验证失败的话，需要根据error信息提示来改正。

5.验证通过了就可以准备发布了

先注册发布帐号  ，

pod trunk register［邮箱XXXXXX@163.com］“名字”

注册完了去邮箱瞅一眼，激活一下

发布：

pod trunk push TestPodSpec.podspec --allow-warnings

会看到如下提示

🎉congratulations ……..

然后在本地 pod search 就可以找到之前提交的库了，如果要在别人的电脑上也能搜到的话，需要等pod审核