最近因为项目需求变多且很多工具会在不同的项目中重复使用,因此需要把常用的工具或者封装的库进行剥离;于是就想要像其他的三方库一样使用cocoapods的方式进行管理。接下来就让我们一步步来实现它吧!
以下的 Repository 为项目库的待位名称,操作的时候更换成自己的库名即可。
一.在GitHub上创建 项 目 索 引 私 有 库 \color{red}{项目索引私有库} 项目索引私有库
二.创建本地私有库索引文件,并与远程私有索引库进行关联
1.如何查看本地索引库:
使用如下命令查看本地已经存在的索引:
pod repo
正常情况下只会有一个 master 我涂鸦掉的就是自己添加的本地索引库。
2.添加一个自己的索引并与远程库进行关联
执行如下命令行为自己增加一个本地索引并关联到远程库
pod repo add RepositorySpec [GitHub上创建的索引库地址](https://xxx.git/)
这一步完成后再使用 pod repo 命令即可看到自己创建的本地索引了。
三.创建 项 目 私 有 库 \color{red}{项目私有库} 项目私有库
在GitHub上创建一个项目私有库,运来存放真正需要pod安装的代码;创建步骤同第一步(命名去掉Spec即可)。
注意:
这
个
库
是
真
正
的
代
码
库
,
第
一
步
创
建
的
是
索
引
库
,
是
为
项
目
库
做
索
引
的
\color{red}{这个库是真正的代码库,第一步创建的是索引库,是为项目库做索引的}
这个库是真正的代码库,第一步创建的是索引库,是为项目库做索引的
四.创建模板工程,并推送到远程代码库
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 添加一个索引
G
i
t
H
u
b
上
的
私
有
索
引
库
地
址
\color{red}{GitHub上的私有索引库地址}
GitHub上的私有索引库地址 注意是
索
引
库
地
址
\color{red}{索引库地址}
索引库地址不是库的地址,如图:
添加完索引源地址之后再加上pod命令:
pod 'Repository'
至此终端执行pod install即可安装使用。完美!
####几个注意点:
- 创建私有库的时候,建议不要选择使用 README 创建,因为创建模板项目的时候回自动创建一个 README 文件,一般会使用模板里的。
- 当遇到如下错误时,一般是你的文件路径不对,验证会不通过;这里是路径是和***Repository.podspec***文件同级去取的。
[iOS] file patterns: The `source_files` pattern did not match any file.
- 验证时可能会遇到各种问题通过不了,我也是走过了不少坑,如果有遇到问题的可以给我留言,助你渡劫。
好了暂且更新至此,后续有新的内容会继续补充。
参考内容:
- https://www.jianshu.com/p/283584683b0b
- https://blog.csdn.net/u012475191/article/details/89329594