cocoapods创建远程私有库及相关踩坑

  最近因为项目需求变多且很多工具会在不同的项目中重复使用，因此需要把常用的工具或者封装的库进行剥离；于是就想要像其他的三方库一样使用cocoapods的方式进行管理。接下来就让我们一步步来实现它吧！
  以下的 Repository 为项目库的待位名称，操作的时候更换成自己的库名即可。

一.在GitHub上创建

新建库

填写库信息

二.创建本地私有库索引文件，并与远程私有索引库进行关联

 1.如何查看本地索引库：
  使用如下命令查看本地已经存在的索引：

pod repo  

查看索引

  正常情况下只会有一个 master 我涂鸦掉的就是自己添加的本地索引库。
 2.添加一个自己的索引并与远程库进行关联
  执行如下命令行为自己增加一个本地索引并关联到远程库

pod repo add RepositorySpec [GitHub上创建的索引库地址](https://xxx.git/)

  这一步完成后再使用 pod repo 命令即可看到自己创建的本地索引了。

三.创建

 在GitHub上创建一个项目私有库，运来存放真正需要pod安装的代码；创建步骤同第一步（命名去掉Spec即可）。
注意：

四.创建模板工程，并推送到远程代码库

 1.创建模板工程：
  新建一个项目存放文件夹并在终端cd到文件夹目录下：
  使用如下命令创建新的模板工程：

pod lib create Repository(库名)

  执行命令后会出现以下界面，如下图：

新建工程模板

 2.替换代码文件
  生成工程后Xcode 会自动将其打开，然后我们需要找到 ReplaceMe.m 文件，并将其在Finder中打开，然后将自己的代码放到这个位置，删除 ReplaceMe.m 文件，完成代码的替换。

更换自己的库代码

文件替换

 3.安装替换的代码文件
  在终端cd到项目的Example目录下，执行 pod install 工程会自动将你刚才替换的文件代码更新到pod文件夹相应的位置下，如下图：

更新pod代码

pod执行后的效果

 4.修改podspec文件配置
  打开工程中的Repository.podspec文件，对其中的内容进行修改；
 5.验证仓库并推送模板工程到远程仓库
  使用终端cd 到项目的根目录，执行如下命令验证:

pod lib lint
pod lib lint --allow-warnings (warning 验证不通过时使用此命令）

验证podspec

  使用git命令提交到远程仓库；（用SourceTree管理的直接使用SourceTree进行操作，主要目的是把项目推送到远端仓库，采用什么方式都可）

git status 
git add .
git commit -m'注释'
git remote add origin https://xxx/Repository.git 
(将本地库与远程代码仓库进行关联)
git push origin master  (提交到远程仓库)

五.设置Tag并推送到远程管理库

 1.使用如下命令打tag并推送：

git tag '0.1.0'
git push --tags

推送tag

 2.使用如下命令进行验证：（这一步不做的话在push的时候也会进行验证）

pod spec lint --allow-warnings (验证远程)

 3.将本地的私有索引库推送到远端库

pod repo push RepositorySpec Repository.podspec --allow-warnings

  成功后就可以在你GitHub的Tags中找到发布的版，如图：

成功推送的私有库版本tag

六.私有库的使用

划重点：打开podfile文件,在顶部source 添加一个索引 注意是不是库的地址，如图：

podfile添加索引库源地址

  添加完索引源地址之后再加上pod命令：

pod 'Repository'

  至此终端执行pod install即可安装使用。完美！

几个注意点及问题：

• 创建私有库的时候，建议不要选择使用 README 创建，因为创建模板项目的时候会自动创建一个 README 文件，在提交的时候会产生冲突，一般会使用模板里的。
• 当遇到如下错误时，一般是你的文件路径不对，验证会不通过；这里是路径是和Repository.podspec文件同级去取的。

 [iOS] file patterns: The `source_files` pattern did not match any file.

• 验证时可能会遇到各种问题通过不了，我也是走过了不少坑，如果有遇到问题的可以给我留言，助你渡劫。

• 使用码云创建私有库的需要把podspec文件中的源地址更换一下，如下图：

  
  
  更换源地址

• 当你的私有库需要依赖于另一个私有库的时候验证会报错，需要在验证的时候指定所有的索引源地址，比如我项目中当前引用了GitHub中的AFN以及自己的私有库，就需要在source中指定索引库来源，如下（多个索引库来源采取 “,”来分隔开）：

pod lib lint --sources= [cocoapods地址](https://github.com/CocoaPods/Specs.git),[自己的私有库索引地址](https://xxxSpec.git) --allow-warnings

• 当你的私有库中包含静态库时，需要采用如下命令(当然这些，命令是可以组合使用的)：

 pod lib lint --use-libraries

• 引入的三方库里面含有framework的时候 pod install 会报错，如下图：

framework问题

此时可以在podfile中加入如下代码解决（此问题也可采取将 use_frameworks!注释掉解决，前提是不需要 use_frameworks!）：

pre_install do |installer| Pod::Installer::Xcode::TargetValidator.send(:define_method, :verify_no_static_framework_transitive_dependencies) {}

• 在私有库中使用到其他三方库的时候导入的头文件在.h中会报错找不到，需要放到.m文件中才行；

• 使用pod repo push 将 .podsepc 文件推送到索引库时报错：
  [!] /usr/bin/git -C /Users/sunjuncheng/.cocoapods/repos/xxxSpec pull Your configuration specifies to merge with the ref 'refs/heads/master' from the remote, but no such ref was fetched.
  大概率是你的索引库中没有任何文件，在索引库中随便放一个文件即可（一般会选择初始化一个 README.md）。

• 如果是Swift库需要指定Swift版本:

s.swift_versions = '5'

暂且更新至此，后续有新的内容会继续补充。

参考内容：

• https://www.jianshu.com/p/283584683b0b
• https://blog.csdn.net/u012475191/article/details/89329594