这里要说的就是 把自己 写的代码封装成 framework 然后 通过 pods 安装的方法 给 其他项目使用。
首先,有两个概念要搞清楚,一个是 代码库,一个是cocopods 版本管理库。
一、创建代码库
这个就是在保存自己代码的 地方,这个没什么可说的,在码云或者 GitHub 创建一个代码库就可以了。我是在码云上创建,这里证书 就选 ‘MIT License’就可以了。
创建项目之后把 地址复制出来,然后把项目clone到本地。在终端输入:
git clone url
进入到当前文件夹目录下,此时目录下除了一个 LICENSE文件 和一个 README.md文件,其他什么都没有。因为我要上传的是framework 文件,所以我没有创建xcode工程,而是在目录下创建一个文件夹‘Test’,然后把要用的framework 文件放进去。
创建podspec文件。这是很重要的一步,能否成功 这是关键。
在当前目录下,用终端:pod spec create 项目名
就会在目录下生成一个 项目名.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