Podspec 制作
Podspec创建
1 | $ pod lib create MyTest |
创建名为MyTest的工程,执行此命令后,pod会向其远程服务器下拉工程文件模板及相关依赖。
下拉后,按照提示填入相应的字段即可。
例如 平台类型
、 语言
、 Demo
、 测试框架
、 界面测试
、 类前缀
等,可按实际情况填写。
在创建工程前,最好先cd到指定目录下,避免找不到工程文件。
Podspec修改
工程创建完成后,文件结构可如下所示:
_Pods.xcodeproj
Example
LICENSE
MyTest
MyTest.podspec
README.md
其中 Example
是刚才创建的demo工程,我们可以在这里面写自己的demo。里面用Pod管理的第三方,可以随意pod。
MyTest
下需要存放源代码,也就是需要把自己的pod库源代码存放在里面。注意目录结构,后面会用得到。
MyTest.podspec
这个我们需要做修改,打开 Example
里的demo工程,就可以通过Xcode看到这个podspec文件了。按照该文件的要求,进行修改。其中 s.source_files
需要重点注意,路径别修改错了。例如我的 s.source_files = 'MyTest\*.{h,m}'
,根目录:MyTest目录->所有的.h和.m文件。如果这个路径写错了,后面验证Podspec的时候,肯定不通过。
补充Demo
打开Demo工程,可在里面书写自己的类使用实例。
注意:若更改了原有 MyTest
下的目录结构及文件,有可能造成Demo工程运行不起来的情况,此时只需在终端执行 pod install
(注意pod执行路径),然后关闭工程,重新打开这个Demo即可。我估计是文件路径有变动,但是Demo工程读取的还是旧的文件路径。
Podspec验证
1 | $ pod lib lint |
正常情况下,验证是通过的 MyTest passed validation.
如果验证出错,需根据错误提示进行处理。
代码上传
添加远程git仓库地址
以上操作后,我们需要将我们的代码上传到远程仓库。
若是新建仓库,个人建议建立一个空的仓库,即使是README.md也不需要。然后在整个工程的根目录下,执行操作
1 | $ git remote add origin xxx.xxx.git |
也就是把远程仓库地址添加到工程里,这样我们就可以进行代码的提交。
若是已有仓库,或者是仓库有文件。个人建议先将此仓库克隆下来,然后把我们用pod创建的工程整个拖进去,这样我们就可以进行代码提交了。
添加tag
1 | $ git add -A && git commit -m "Release 0.1.0" |
需要注意的是,这个tag需要与podspec里的version号一致,否则在提交podspec到pod远程仓库的时候会出错。
代码提交
1 | $ git push origin master |
至此,所有的文件都应该是上传到远程代码仓库了,我们可以查看自己的远程仓库,看是否有提交记录。
Podspec提交公有仓库
公有仓库说明
此处的公有仓库,指的是cocoapods官方的仓库。用于存放用户提交的podspec文件,以便于所有用户使用pod拉取第三方代码。
注册设备
在向cocoapods远程仓库提交自己的podspec,需要进行设备注册(认证)。
1 | $ pod trunk register xxx@xxx.com 'my name' --description='my macbook air' |
然后查看自己的邮件,复制邮件中的链接,用浏览器打开即可。(此操作可能出现失败,需良好的网络环境)
提交.podspec
1 | $ pod trunk push MyTest.podspec |
注意命令执行的目录,需要项目根目录执行。
正常情况下,会提示你提交成功,然后就可以用pod搜索自己的库了。例如 $ pod search MyTest
,就可以搜索到我刚才提交的MyTest的pod资源了。
如果搜索不到,可能需要删除索引文件了。
1 | $ rm ~/Library/Caches/CocoaPods/search_index.json |
然后再次执行 pod search
。
Podspec提交私有仓库
私有仓库说明
此处的私有仓库,指的是个人或者公司使用而不让其他人使用的仓库。与公有仓库类似,用于存放用户提交的podspec文件,以便于私有用户使用pod拉取自己的代码。
私有仓库创建
此创建与普通git仓库创建类似,最好使用README.md初始化,顺便补充README.md文件信息。
私有仓库本地安装
1 | $ pod repo add MyRepo xxx.xxx.git |
在本地安装一个名叫 MyRepo
的私有仓库, xxx.xxx.git
为私有仓库地址。
查看本地私有仓库
1 | $ cd ~/.cocoapods/repos |
可查看此文件夹下,除了官方的master仓库,还会有自己刚刚安装的MyRepo私有仓库。我们也可以顺带看看官方的仓库里到底都有什么。
提交.podspec
1 | $ pod repo push MyRepo MyTest.podspec |
向私有库 MyRepo
提交 MyTest.podspec
文件。
需要注意的是,在提交 .podspec
前,同样需要修改 .podspec
文件,验证、打tag,源码提交。但私有库的验证,需要加上 --private
。完整的验证为: $ pod lib lint --private
。
私有库引用
只需要在编辑Podfile文件的时候,指定source源即可。
1 | source ‘xxx.xxx.com/MyRepo.git’ |
顺便补充官方的source源1
source ‘https://github.com/CocoaPods/Specs.git’
信息补充
关于私有仓库:
私有仓库只是用来存放私有的podspec,不存放代码。可为外网git,也可为内网git。总而言之,只是podspec的仓库。
关于代码仓库:
代码仓库用来存放自己的源代码的git,可为外网git,也可为内网git。总而言之,只是代码的仓库。
一个私有库,可以存放n多个podspec文件,管理着n多个私有pod。
私有仓库可以随意删除,但不会影响到代码仓库。私有仓库不要加入代码,因为加了也没有任何作用。
私有库与公有库基本一样,只是一个是官方的git,一个是自己的git。私有库需安装,podspec验证需加上说明,使用的时候需引入。