索引库 repo
索引文件(.podspec文件)
1.搭建私有库之前必须要先创建索引库
1）首先检查当前电脑的索引库
pod repo
2）在gitlab上创建一个新的库，这个库用来保存私有库的podspec文件，所以我们一般起名字最好是 xxxSpec用以区分这个库的作用。
3) 创建本地索引库，然后将其于刚才创建的远程索引库相关联，注意！！！此时的远程索引库是空的！空的！空的！但是必须得有master分支，所以你可以添加一个readme文件。
两种方式：01-https方式；02-ssh方式（ssh方式需提前配置SSH）
pod repo add 本地索引库名称 远程索引库的git地址
例如：pod repo add PinnetSpec http://code.pinnettech.cn/pinnet/IESP880/IOS/PinnetSpec.git
4) 检查是否安装成功
cd 到新建索引库
cd ~/.cocoapods/repos/PinnetSpec
验证索引文件仓库
pod repo lint .
删除本地repo
pod repo remove [索引库名称]
更新本地的Pod 索引库的缓存信息
pod repo update --verbose
2.创建本地私有库（组件库）
1）创建本地私有库
cd到将要创建的本地私有库文件夹下执行
pod lib create [组件库名称]
这里的组件库名称一定要与远程仓库创建的名称一致
例如: pod lib create PinnetHeaderSegment
报错[!] /usr/bin/git clone https://github.com/CocoaPods/pod-template.git xxx
Cloning into 'xxx'...
fatal: unable to access 'https://github.com/CocoaPods/pod-template.git/': error:02FFF036:system library:func(4095):Connection reset by peer
或者
fatal: unable to access 'https://github.com/CocoaPods/pod-template.git/': SSL certificate problem: unable to get local issuer certificate
去除代理
git config --global http.proxy
git config --global --unset http.proxy
2）参照下图进行参数配置
3）配置完成后会自动打开一个HeaderSegmentView-Example项目，层级如下图
4）将Classes文件夹下面的ReplaceMe.m文件删除掉，替换成组件库的代码
5）安装pod库
cd到Example文件夹下执行
pod install
等待一段时间
6）修改xxx.podspec配置文件
Ps：
（A）s.homepage需要修改为远程私有库首页地址, 不是私有索引库的地址！！！
（B）s.source 需要修改为远程私有库的git地址(选择使用HTTPS地址)！！！
（C）s.version 私有库版本号一般改为1.0.0
3.上传本地私有库
1）在gitlab上创建远程私有库。注意！！！这个库是存远程私有库代码的，不要跟远程索引库混淆啦！！！
git remote add origin 远程仓库地址 ##未关联地址时，需要添加关联远程仓库地址
2）将本地私有库推送到远程私有库
cd到本地私有库文件夹PinnetHeaderSegment下执行
①构建本地git代码库
git init
git status ##查看上次提交后是否对文件再做了修改（红色文件表示没有更新到缓存中）
②将红色文件更新到缓存中
git add 文件名 ##上传单个文件
git add . ##上传所有文件
git status ##更新成功文件变成绿色
③进行文件提交
git commit -m ‘提交信息’
④先拉取远程代码
git pull origin master
或者git branch --set-upstream-to=origin/master master
报错“fatal: refusing to merge unrelated histories”（即，不知道彼此的存在，并已不匹配的项目提交历史）可执行git pull origin master --allow-unrelated-histories
之后上面的命令可能会进入vi模式，按提示输入更新信息后，按【ESC】键跳到命令模式，按下冒号按键，然后再按下【wq】，即可保存退出vi的编辑状态，
报错fatal: couldn't find remote ref master
这个仓库还没有文件，空的，直接push本地修改就可以了，不需要pull了
报错 fatal: 'origin' does not appear to be a git repository
fatal: Could not read from remote repository.
重新cd文件夹位置
git remote add origin 远程仓库地址 #关联远程仓库地址
⑤提交本地缓存到远程代码库
提交修改前，再次确认不修改后，修改spec文件中的tag值后，再之后push
git push -u origin master
推送版本到master分支(-f强制推送,覆盖掉之前的所有文件)
git push origin master -f
4.进行本地校验
初始命令
pod lib lint --verbose --allow-warnings
如果依赖了其他的第三方库
pod lib lint --verbose --allow-warnings --sources="cocoapods库地址,私有库远程地址"
如果其他第三方私有库又依赖了其他的库，需增加--use-libraries
pod lib lint --verbose --use-libraries --allow-warnings --sources="cocoapods库地址,私有库远程地址"
显示xxx passed validation.表示校验通过
Ps：
--verbose：有些非语法错误是不会给出错误原因的，这个时候可以使用其来查看详细的验证过程来帮助定位错误。
--allow-warnings：表示允许警告。
--use-libraries：表示使用静态库或者是framework，这里主要是解决当我们依赖一些framework库后校验提示找不到库的时候用到。
--sources=‘master,privateSpecs'：指定源，比如你的私有pod同时依赖了公有库和私有库，你必须指定源才行，因为默认只会去在公有源中查找对应的依赖
报错[!] xxx did not pass validation, due to 1 error.
需要解决Example工程中的所有报错后重新提交
ERROR | [iOS] unknown: Encountered an unknown error (CDN: trunk URL couldn't be downloaded: https://cdn.cocoapods.org/all_pods_versions_a_1_5.txt Response: SSL peer certificate or SSH remote key was not OK) during validation.
执行pod repo remove trunk 删除下面的repo源
trunk
- Type: CDN
- URL: https://cdn.cocoapods.org/
- Path: /Users/xxx/.cocoapods/repos/trunk
报错ERROR | [iOS] unknown: Encountered an unknown error (Unable to find a specification for `PinnetBase` depended upon by `PinnetHeaderSegment`
或报错
[!] Couldn't determine repo type for URL: `https://xxx/`: SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed (unable to get local issuer certificate)
或报错[!]Found multiple specifications for ‘xxx’
未引用github第三方库执行
pod lib lint --verbose --use-libraries --allow-warnings --sources='http://code.pinnettech.cn/pinnet/IESP880/IOS/PinnetSpec.git'
有引用github第三方库执行
pod lib lint --verbose --use-libraries --allow-warnings --sources='https://github.com/CocoaPods/Specs.git,http://code.pinnettech.cn/pinnet/IESP880/IOS/PinnetSpec.git'
5.打Tag
tag必须与spec文件里面写的版本号要一致，要一致，要一致！！！后期版本修改了任何东西都需要重新打tag
git tag 版本号（要跟spec文件里面写的版本号一致）
git push origin --tags
6.远程校验
1）tag打上去之后，进行远程校验，其实和本地校验一样，本地如何校验通过的，远程只需要把lib字段改成spec就可以了，例如我的
pod spec lint --verbose --allow-warnings
如果依赖了其他的第三方库
pod spec lint --verbose --allow-warnings --sources="cocoapods库地址,私有库远程地址"
如果其他第三方私有库又依赖了其他的库，需增加--use-libraries
pod spec lint --verbose --use-libraries --allow-warnings --sources="cocoapods库地址,私有库远程地址"
未引用github第三方库执行
pod spec lint --verbose --use-libraries --allow-warnings --sources='http://code.pinnettech.cn/pinnet/IESP880/IOS/PinnetSpec.git'
有引用github第三方库执行
pod spec lint --verbose --use-libraries --allow-warnings --sources='https://github.com/CocoaPods/Specs.git,http://code.pinnettech.cn/pinnet/IESP880/IOS/PinnetSpec.git'
报错- ERROR | [iOS] unknown: Encountered an unknown error ([!] /usr/bin/git clone http://code.pinnettech.cn/pinnet/IESP880/IOS/PinnetSearchBar.git /var/folders/sn/56pkr11n0vv91b5q37mjgxf80000gn/T/d20221021-1427-1o5usog --template= --single-branch --depth 1 --branch 1.0.0
Cloning into '/var/folders/sn/56pkr11n0vv91b5q37mjgxf80000gn/T/d20221021-1427-1o5usog'...
warning: Could not find remote branch 1.0.0 to clone.
fatal: Remote branch 1.0.0 not found in upstream origin
警告：找不到要克隆的远程分支1.0.0。
致命：在上游源中找不到远程分支1.0.0
gitlab上查看组件库tag
先去打tag
7.提交podspec文件到最开始创建的私有索引库PinnetSpec
1）所有验证通过之后，要将spec文件推送到最开始创建的远程索引库当中
如果报错
[!] Unable to find the `PinnetSpec` repo. If it has not yet been cloned, add it via `pod repo add`.
1、添加源地址
pod repo add PinnetSpec http://code.pinnettech.cn/pinnet/IESP880/IOS/PinnetSpec.git
2、将spec推送到远程
pod repo push [索引库名称] [组件库名称].podspec
pod repo push PinnetSpec PinnetBase.podspec --allow-warnings --use-libraries --verbose
报错[!] Couldn't determine repo type for URL: `https://cdn.cocoapods.org/`: SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed (unable to get local issuer certificate)
先切外网执行一遍，再切内网执行一遍
报错The xx.podspec specification does not validate.
命令添加后缀--allow-warnings --use-libraries --verbose
2）最后推送上去之后，在本地的索引库中的样子如下图
3）这个时候验证一下你的私有库
先更新一下pod库，不然找不到你刚上传的私有库
pod repo update --
pod search 私有库名称
使用私有库
在Example文件夹的Podfile文件里
1、添加source源路径
source 'https://github.com/CocoaPods/Specs.git'
source 'http://code.pinnettech.cn/pinnet/IESP880/IOS/PinnetSpec.git'
2、pod ‘PinnetBase’
更新远程私有库（组件库）
1、修改xxx/xxx/Classes文件夹下对应的库文件
2、更新测试工程的pod库文件
pod update --no-repo-update
3、更新xxx.podspec文件的配置信息，版本号tag一定要改
4、提交代码到远程仓库
git push orgin master
5、更新tag标签
git tag x.x.x
git push --tags
6、验证私有库
pod lib lint --private
pod spec lint
7.更新远程和本地的私有索引库
pod repo push [索引库名称] [组件库名称].podspec
私有库图片资源处理
· 把自己的图片资源直接复制到桌面xxKit/xxKit/Assets 文件夹内（ Assets 是专门用来存放组件图片资源 ）
· cd到桌面组件xxKit的Example目录下
cd xxx/Example
pod install