最近因为项目需求变多且很多工具会在不同的项目中重复使用,因此需要把常用的工具或者封装的库进行剥离;于是就想要像其他的三方库一样使用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文件夹相应的位置下,如下图:
4.修改podspec文件配置
打开工程中的Repository.podspec文件,对其中的内容进行修改;
5.验证仓库并推送模板工程到远程仓库
使用终端cd 到项目的根目录,执行如下命令验证:
pod lib lint
pod lib lint --allow-warnings (warning 验证不通过时使用此命令)
使用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
2.使用如下命令进行验证:(这一步不做的话在push的时候也会进行验证)
pod spec lint --allow-warnings (验证远程)
3.将本地的私有索引库推送到远端库
pod repo push RepositorySpec Repository.podspec --allow-warnings
成功后就可以在你GitHub的Tags中找到发布的版,如图:
六.私有库的使用
划重点:打开podfile文件,在顶部source 添加一个索引 注意是不是库的地址,如图:
添加完索引源地址之后再加上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 会报错,如下图:
此时可以在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'
暂且更新至此,后续有新的内容会继续补充。
参考内容: