美文网首页
iOS cocopods 创建私有依赖库

iOS cocopods 创建私有依赖库

作者: 李美东 | 来源:发表于2017-12-08 16:09 被阅读0次

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

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

    一、创建代码库

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

    创建代码库

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

    git clone   url

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

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

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

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

    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;成功的话 就会出现下边的界面:

    验证

    继续执行终端命令:

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

    git push --tags

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

    二、创建版本管理库

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

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

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

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

    三、推送项目;

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

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

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

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

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

    版本记录

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

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

    遇到坑:

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

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

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

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

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

    引用了 系统的 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 创建私有依赖库

          本文链接:https://www.haomeiwen.com/subject/youeixtx.html