说明
这里说的完全是从实用的角度出发的,首先是能用,但是不做原因的追究。这个会在以后的文章中研究学习,这个非常符合我本人的学习路线——先看效果再探究其原因。关于自制Cocoapod库网上有人已经写了很多文章,我并不是在效仿,我只是在写我自己的心得体会而已。以下说的全都是顺序的步骤。
github工程
很简单,你是你的源代码所在的工程。这还用说吗?还是说一说吧,免得被忽略了,我知道你潜意识里是知道的,所以这里提的并不多。
创建XXX.podspec文件
这个文件的专业名词叫啥玩意,我没去研究,但是从使用的角度来讲,它就是个配置文件。如何创建呢?很简单,先cd到你的github目录下,然后执行pod spec create [项目名字]命令,它就会在当前目录下生成一个[项目名字].podspec文件。
如何配置XXX.podspec文件
这里面其实没啥玩意,大部分都是注释,或者可以说成是备选项,在这里只说说关键的部分。下面我准备结合图片来说明。
-
s.name:就是这个库的名字,就是下图这个。
-
s.version:就是这个库的版本号,也就是下面这个。
-
s.summary:这个用来说明该库的介绍,是下面这个。
- s.description:这个我还不清楚是干啥的,不过这个是必填的。你需要在<<-DESC,DESC之间填入描述性文字。
- s.homepage:这个就是你的项目的github地址。
- s.license:许可证,这个是必须的,一般来说正规点的都是用一个文件型的许可证,好像还是需要申请的。但是如果你想自己申请,其实可以不用费劲,直接把许可证赋值为MIT,于是变成了s.license = "MIT"。
- s.author:作者,没错了,就是你啦,那么如何证明你是你呢?你需要提供你的昵称和邮箱。举个例子{ "非主流程序员" => "13207533103@163.com" },哈哈这个其实就是我啦。
- s.platform:就是对于iOS系统版本的兼容性,这里应该填的是兼容的最低iOS版本号,我填的值是s.platform = :ios, "10.0"。
- s.source:源代码所在地址,我填的值是{ :git => "https://github.com/AbnormalProgrammer/BackForward.git", :tag => "#{s.version}" }。由于s.version是前面设定好的,所以在这里直接使用就好了。
- s.source_files:这个是你写的代码的实质所在,一般来说你是要在github目录中建立一个单独的文件夹,并在里面放入你的源代码文件。这个直接使用它自带的默认值就行,即"Classes", "Classes/*/.{h,m}"。这个好像是说,这个文件夹叫做Classes,后面的应该该文件夹中.h和.m文件,里面的都是通配符。
验证XXX.podspec文件的正确性
输入pod lib lint StromanBackForward.podspec --allow-warnings命令即可。如果出现了错误自然就通不过嘛,但是如果是警告那种,并且还是针对于语言本身没有错,但是pod不认账的那种警告,如果遇到这种情况通不过,那就有点太冤了,于是要添加--allow-warnings免得麻烦。
提交代码
你需要把github下面的源代码准备好,主要有供别人学习你的这个玩意如何使用的demo,源代码所在文件夹以及说明性的readme.md即可。在提交以后,你需要在本次提交上面打tag,然后需要把这个tag推送到远程对应分支上面,把tag推送到远端这个事情一定要做,不然pod会认为你是在新分支上面发布。另外,这个tag最好跟版本号是一样的,这样github上面tag就代表了你的库的版本号。
在pod中添加你的库
pod其实也是一个库,pod一开始是没有你的库的,所以你需要在pod库中把你的库添加进去。使用的命令是pod repo add StromanBackForward https://github.com/AbnormalProgrammer/BackForward master,不过在这里我用的是我自己的仓库。这个也是只有在新建立pod库的时候才需要做。
把你的库推送到pod中去
这个没啥好解释的,这就跟你创建了一个github仓库,然后再把自己的代码推送到远程分支上一样。所用的命令就是pod repo push StromanBackForward StromanBackForward.podspec --allow-warnings,这里面有需要--allow-warnings,否则会因为警告导致失败。
这一步成功以后,你就可以通过pod search命令找到你的库了。但是此时你并不能像正常的库一样去pod install或者pod update。
这一步需要访问你的私账仓库,而现在一般使用token作为密码,假如你忘了你已经在使用token作为密码,而仍然尝试使用原来的密码的话,就会出现账户名密码不匹配的错误。值得注意的是这里输入的应该是账户名,而不是账号。
拥有trunk账号。
在这一步Cocoapods需要访问你的私人仓库,现在都是用token作为密码的,有的时候可能导致访问失败,原因是账户名和密码不匹配,可能是因为你忘记了已经使用了token作为密码导致的。
这个trunk具体应该怎么翻译?我也不知道,不过从实用角度叫它像是一个上传代码接口。pod的用法是要使用库随便用,只要你知道方法,但是你要上传自己的库就必须要有一个账户。首先是要sudo gem install cocoapods一下,如果你遇到/usr/bin写权限失败的话就换成sudo gem install -n /usr/local/bin cocoapods命令,如果是由于网络原因导致的失败,那你还是翻墙吧。如果你没有trunk账户,则需要注册一个,实例就是pod trunk register [邮箱] [昵称],然后Cocoapod就会向你注册的邮箱发送一封激活邮件,激活以后就可以使用pod trunk me命令,开启你注册的这个账户。
通过trunk推送库
可以通过pod trunk push [xxx.podspec的路径] --allow-warnings把库推送到pod repo中去,这里面也要使用--allow-warnings来避免因为警告导致失败。这一步成功以后,恭喜你的你的库就可以像AFNetWorking之类的库一样通过pod安装了。
为什么在别的电脑上搜不到自己的库?
因为pod在本地维持了一个库的缓存,你在本地提交的库就已经被缓存到本地了。但是你在别的电脑去搜索的话, 人家的缓存里面是没有你的库的,所以会出现Unable to find a pod with name, author, summary, or description matching XXX的提示。所以你只需要更新一下这台电脑上的pod缓存即可,方法是先rm -rf ~/Library/Caches/Cocoapods删除本地pod缓存,然后再搜索,pod会自动建立新的缓存,成功以后你就能在这台电脑上搜索到你自己的库了。如果发现你刚刚更新的pod没有被search出来,那就执行
pod repo update
,然后再次search就可以看到了。