iOS 创建自己的Cocoapods公共、私有库

1、git服务器创建一个项目。

2、Clone项目到本地，到本地后是一个空目录，还没有工程。

image.png

3、创建一个工程。

1.打开终端，切换到该目录

cd /Users/lmy/Desktop/XesAppMultimedia

2、创建工程模板

pod lib create XesAppMultimedia

3、配置相关选择。

选择平台

What platform do you want to use?? [ iOS / macOS ]
iOS

选择语言

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

是否自动生成demo，选择Yes，方便以后测试

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

是否集成测试框架

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

UI 测试

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

指定类前缀

What is your class prefix?
XesApp

image.png

4、执行完之后，自动打开项目。

image.png

4、编写podspec文件。

1、 目录下文件介绍

• podspec这个文件主要是用来描述项目名称、pod的版本号、介绍、首页（homepage)、作者信息、git源等，具体的可以参看官方Podspec Syntax Reference

• README使用过GitHub的都会知道README文件的重要性，这个文件可以使用Markdown语法，主要展示在GitHub工程上的首页。README文件对于使用这个pod库的人来说，有和没有这个文件，区别是很明显的，此外这还有助于创建一个高质量的 CocoaPods Quality Index ；

• LICENSE要想是Spec仓库接收，就必须包含一个license。命令pod lib create 自动创建使用的是 MIT license；

2、如果用第3步的命令创建工程模板，那么工程的目录下已经自动生成了.podspec（XesAppMultimedia.podspec）。如果是已有的工程或者库文件目录，也可以利用Pod命令自己制作.podspec文件，命令如下：

pod spec cretae <组件库名>

PS注意：自动生成的podspec文件只是模板，需要结合工程的库文件、资源目录、远程代码仓库（第1步创建的远程代码仓库）修改补充podspec文件。

image.png

5、验证.podspec文件的格式是否正确

1、cd 到 *.podspec 文件所在的目录下,用到的一些命令

pod lib lint
解说：本地验证pod能否通过验证，如果失败使用下面命令：pod lib lint --verbose查看失败原因， 或使用pod lib lint --allow-warnings忽略警告错误

pod spec lint
解说：本地和远程验证pod能否通过验证，需要更新提交podspec到远程specs仓库，参考第7步，一般本地验证通过即可提交到远程specs仓库

pod lib lint --verbose
解说：加--verbose可以显示详细的检测过程，出错时会显示详细的错误信息

pod lib lint --verbose --allow-warnings
解说： 允许警告，用来解决由于代码中存在警告导致不能通过校验的问题

有时候会提示一个错误：

image.png

没有写简介，把简介填写一下，就可以验证通过。

有时候会提示一个错误：

992921-20170419163104056-63847022.png

到这个提示错误信息的时候，使用如下指令：

pod lib lint 文件名称.podspec --use-libraries --allow-warnings

相应的执行上传指令的时候，也需要加上参数：

pod repo push GofSpecs GofKit.podspec --use-libraries --allow-warnings

pod lib lint --sources=[https://git.xxx.com/XesAppMediator...]
解说： 私有库依赖需要添加specs源来验证

引用当前私有库的podFile中指定source为私有库地址

source http://[privateLibName]/cocoaspecs.git'
source 'https://github.com/CocoaPods/Specs.git'

pod lib lint --help
解说：查看所有可选参数，可选参数可以加多个

6.提交工程代码

提交工程代码到远程代码仓库，可以利用git或者svn进行代码版本管理，提交代码到GitHub等， 初始化提交命令如下：

//初始化git版本管理仓库，模板代码已经初始化过此步骤可以忽略（有.git文件夹）
git init

//添加到暂存区
git add .

Sourcetree可视化

//提交到本地仓库
git commit -a -m '提交信息'
示例：git commit -a -m '添加pod组件库'

//打标签，注意此标签可能在podspec中用到，用于区分版本
git tag 1.0.0

//本地仓库与远程仓库关联（已关联过的，可以忽略）
git remote add origin

//拉取和合并本地与远程仓库
git pull origin master --allow-unrelated-histories

//本地仓库代码推送到远程
git push --set-upstream origin master

此时如果你报错，查看报错信息中如果有：“pre-receive hook declined”
说明存在权限问题，没有master分支的代码提交权限。分配权限后，就可以push成功。

//推送标签
git push --tags

7.提交podspec文件

1. 开源库提交

podspec文件到Cocopods官方仓库，首先在cocopods官方仓库中注册账号，命令如下：

pod trunk me
//（检查是否注册trunk）

pod trunk register 邮箱 注册名字 --verbose
//（注册命令）

注册完成之后会给你的邮箱发个邮件,进入邮箱邮件里面有个链接,需要点击确认一下.之后开始提交，切换到有.podspec文件的组件工程根目录执行命令

pod trunk push 组件库名.podspec
pod trunk push 组件库名.podspec --allow-warnings

2. 私有库提交

私有仓库需要先添加到本地仓库，再push到远程仓库。
电脑查看目录：~/.cocoapods/repos/

• 添加到本地仓库, [email protected]/.git为远程specs库的地址，成功之后目录（~/.cocoapods/repos）除了master之外，新增了一个文件夹（组件库名）

  pod repo add specs仓库名 specs远程仓库地址
  //示例：pod repo add XesAppMultimedia https://####.com/ /XesAppMultimedia_ spec.git

• 查看是否添加成功

  pod repo list

• push到远程specs仓库

  pod repo push 本地spec库名 本地.podsepc文件
  //示例：pod repo push XesAppMultimedia XesAppMultimedia.podspec

• 如果.podspec文件存在警告时不能成功push。

解决：Pod repo push 本地spec库名 本地.podsepc文件 --allow-warnings
示例：pod repo push XesAppMultimedia XesAppMultimedia.podspec --allow-warnings

• 如果已经添加过得，可以不用再添加。

• 如果添加报错：

  
  
  

  image.png

删除文件夹， 重新pod repo add， 重新pod repo push

pod repo add XesAppMultimedia https://####.com/ /XesAppMultimedia_ spec.git

pod repo push specs远程仓库地址 组件库名.podspec
//示例：pod repo push https://##.com/#/XesAppMultimedia_ specs.git XesAppMultimedia.podspec

8、 检查仓库是否发布成功

pod搜索验证：

pod search 组件库名

如果报错，搜索不到，建议更新下pod：

pod update

之后仍然搜索不到，那么进入CocoaPods缓存目录，删除缓存索引文件search_index.json：

cd ~/Library/Caches/CocoaPods
ls
rm -f search_index.json

9、 pod库文件引入

如果是开源库（公有的），修改podfile文件：

如果是私有仓库，建议在podfile文件开头添加source源：

最后执行命令进行安装：

pod install