iOS cocopods 创建私有依赖库

这里要说的就是 把自己 写的代码封装成 framework 然后 通过 pods 安装的方法 给 其他项目使用。

首先,有两个概念要搞清楚,一个是 代码库,一个是cocopods 版本管理库。

一、创建代码库

这个就是在保存自己代码的 地方,这个没什么可说的,在码云或者 GitHub 创建一个代码库就可以了。我是在码云上创建,这里证书 就选 ‘MIT License’就可以了。

iOS cocopods 创建私有依赖库_第1张图片
创建代码库

创建项目之后把 地址复制出来,然后把项目clone到本地。在终端输入:

git clone   url

进入到当前文件夹目录下,此时目录下除了一个 LICENSE文件 和一个 README.md文件,其他什么都没有。因为我要上传的是framework 文件,所以我没有创建xcode工程,而是在目录下创建一个文件夹‘Test’,然后把要用的framework 文件放进去。

创建podspec文件。这是很重要的一步,能否成功 这是关键。

在当前目录下,用终端:pod spec create 项目名

就会在目录下生成一个  项目名.podspec 文件。下一步就是编辑  podspec 文件:


iOS cocopods 创建私有依赖库_第2张图片
podspec文件

其中 

s.version,每次提交之前 要变更一次。

s.summary 项目简单描述,在pod search 的时候 会显示出来;

s.description 项目描述,随便写吧 目前还没发现有什么作用,必须写,且 长度必须比 summary 长度要长,不然验证无法通过。

s.homepage 就写项目那个 管理的地址就可以,比如我的  "https://gitee.com/limeidong/RomensSDK";

s.license 就这样 固定写;

s.author 自己生成 不用管;

s.source ,git 地址就写 刚才 项目那个 管理的地址,tag 就这么固定写,指向上边的 s.version;

s.platform ,项目平台 已经支持最低版本;

s.vendored_framework,这个就是 要用的 自己创建的 framework 地址,是相对路径,相对于 podspec文件地址。*.framework 表示所有framework文件;

s.requires_arc 支持arc;

s.frameworks 项目依赖的 系统库;

s.dependency 项目依赖的 第三方库;有几个就写几个吧,我的framework 文件中 依赖了这么多;

这个podspec 文件就算编辑完成了,保存以后 提交在 代码管理库就可以了。

在终端,依次执行:

git add .

git commit - m  " "

git push origin master

验证一下:

pod lib lint ,有时候会出现 ERROR,根据 指示修改podspec 文件就可以了,修改完成之后  继续验证 直到通过;有时候 会出现WARN,这个是在所难免的,可以避过,验证的时候 pod lib lint --allow-warnings,允许warn;成功的话 就会出现下边的界面:


iOS cocopods 创建私有依赖库_第3张图片
验证

继续执行终端命令:

git tag 0.0.1   (打标签,一定要和podspec中的s.version 保持一致);

git push --tags

至此  创建代码库的工作就算完成了。

二、创建版本管理库

还是在 码云上创建一个新的仓库,这次 证书不用选择,把地址拷贝出来,在终端执行:

pod repo add   版本管理库名 url; (这个只需要执行一次 后期可重复使用)

执行成功之后 在你本地 Finder中 


iOS cocopods 创建私有依赖库_第4张图片

你会发现 repos 文件夹下多了一个你刚才创建的 文件夹。cocopods 是隐藏文件,至于怎么找到隐藏文件  请自行搜索方法。

三、推送项目;

最后一步,把依赖库推送到 cocopods:

终端进入到 刚才的 代码库根目录下,执行命令:

 pod repo push 版本管理库名   xxx.podspec 

一般情况下只要刚才的验证没有问题  这里就不会再出现问题,如果出现warn,就在执行命令的时候  加上 --allow-warnings。

成功之后 在你本地Finder 目录下 cocopods 文件夹 中 就能看到 提交的版本记录:


iOS cocopods 创建私有依赖库_第5张图片
版本记录



现在新建项目测试一下自己的依赖库吧,如果 pod install的时候 提示找不到 ,就在 Podfile 文件中 加上代码库地址,pod 'xxxxx',:git=>'代码库 url'。pod install 之前可以先 pod update一下。

更新:后期自己的framework 有更新的是,还是先提交代码 然后 打 标签(tag),再 pod repo push 就可以了。

遇到坑:

1. 新建项目安装自己的依赖库 后 报错:


iOS cocopods 创建私有依赖库_第6张图片

这是 framework 依赖的一个第三方库,这里显示框架不支持。解决方案:在打包 自己的framework时,把


这个YES 设置为NO就可以了,上网查 说是 第三方库 会自动链接其他库 导致的。

2. framework 中某些本地.m文件显示不支持框架:


iOS cocopods 创建私有依赖库_第7张图片

这些文件 都是 framework 自己创建的 文件,这里显示不支持某个框架。解决方案,去这些文件中查看是否引用了系统的其他框架,比如我的:


iOS cocopods 创建私有依赖库_第8张图片

引用了 系统的 Accelerate 库,然后在自己项目中手动添加上 这个库,或者 在podspec 文件中添加上 都可以。

3. 本地 pod update 时报错 :

error: RPC failed; curl 18 transfer closed with outstanding read data remaining;fatal: The remote end hung up unexpectedly

fatal: early EOF

fatal: index-pack failed;

出现这个错误原因是 :整个项目比较复杂庞大,curl的postBuffer默认值太小的原因,重新在终端配置一下这个值就可以了。

解决方案:git config --global http.postBuffer 524288000,

524288000代表B,524288000B也就是500MB。这个值得大小,可以根据项目酌情设置。

也可以用如下命令查看是否配置成功:git config --list

结束语:这里可能还有很多细节没有注意到,欢迎大家补充;或者还有遇到其他问题,也可以联系我 一起解决。

你可能感兴趣的:(iOS cocopods 创建私有依赖库)