一直想制作一个pod库,然后写了一个demo
XXAlertTransition
,封装了几个present转场的动画,效果可点击XXAlertTransition github地址查看。这里讲的是如何制作公有库,制作过程就用XXAlertTransition
作为例子了,第一次制作,也遇到了一些问题,记录一下,代码提的比较散,后续需要优化。
制作pod公有库步骤
-
GitHub上创建一个仓库
image.pngXXAlertTransition
。
填上仓库名,直接点Create repository。
-
在本机
image.pngcd
到存放这个库的文件夹下,终端输入pod lib create XXAlertTransition
-
创建pod会问几个问题,我这里是用
image.pngSwift
写的代码,后续制作稍有不同,根据自己情况填写即可。
-
创建完毕之后,会自动创建一个
image.pngXXAlertTransition
文件夹,里面有pod的相关信息,并且自动打开此project。
-
将classes里面的
image.pngReplaceMe.Swift
文件用自己pod的相关文件替代。(我把ReplaceMe.Swift
删掉,把之前写好的demoXXAlertTransition
封装好的几个类直接拖进来)
-
修改
注意此图有问题,看下面的图,不删是想让自己记住要仔细.pngXXAlertTransition.podspec
文件
傻了,homepage填错了(导致下面pod spec lint
找不到库报错,🐷,仔细呀)。应该是下面这样:
image.png
-
⚠️:如果是
homepage地址.pngSwift
库,这里最好还要加上s.swift_version = '5'。(我没有加,所以第9步我出错了,朋友们为了节省时间可以直接在这里就加上,同时记得检查自己的homepage,source信息呀。homepage、 source对应的是远端库的信息)
source地址.png -
⚠️:如果制作的库有依赖项,记得需要填充
s.dependency
的内容
-
提交代码到远程仓库(就是制作的这个本地库提交和远程库关联)。
-
添加标签。必须要这一步,这个标签对应上面
image.pngXXAlertTransition.podspec
中的s.version
。 到时cocopods仓库也是通过版本关联起来的,这样比较清晰。
image.png
- lint检查仓库,终端执行
pod spec lint
。
-
由于开始第6步
image.pngs.homepage
、s.source
填错所以出现了以下错误。更正后正常。
-
由于开始第6步未填
image.pngs.swift_version
,所以报了以下错误,添加后正常。
-
在
image.pngXXAlertTransition.podspec
加入下面这个话:
s.swift_version = '5'
-
重新
image.pngpod spec lint
成功啦。(如果有依赖项需要用pod spec lint --use-libraries
,我制作的这个库没有依赖项请注意)
- 推送podspec到pod库,终端执行
pod trunk push XXAlertTransition.podspec
-
由于我是第一次推送,会出现以下问题:
image.png -
解决:注册一个session。然后去邮箱验证一下。
image.png
pod trunk register shine9328@qq.com 'weimengxue' --description='A coder.'
-
验证完毕之后,会看到:
image.png -
再重新
image.pngpod trunk push XXAlertTransition.podspec
就可以成功啦
- 这里看一下远程仓库自动创建的
README
-
未推送podspec到pod库时是这样的,描述中没有相关信息:
image.png -
推送成功后:
image.png
- 迫不及待的
pod search XXAlertTransition
看能不能搜到我的库,好的,为啥没有!注意到上面的截图,
CocoaPods 1.10.0 is available.
,而我现在的版本:
image.png
更新cocopods版本和repos后,pod search XXAlertTransition
还是找不到这个库,我自己创建的demo中在Podfile
文件中引入此库,pod install
可以pod下来这个库,pod search
显示的并不及时。
image.png
⚠️:XXAlertTransition
,0.1.4
之后的才有效,之前的版本代码有问题。
制作pod公有库遇到的问题
-
pod lib lint
和pod spec lint
区别。
-
pod lib lint
lint的是本地的库 -
pod spec lint
lint的是远端的库
因为tag我修改过代码,把远端的tag取消过,所以pod spec lint
一直失败,而pod lib lint
是成功的。倒腾了半天,后直接提升了podspec版本号解决了。
-
注意制作的库,公开的访问级别设置对,普通的加上
public
,可以继承的类需要设置成open
。 我因为直接从demo中拖过来的代码,之前没有注意到导致pod完demo访问不到我的文件。 -
注意
pod spec lint
前最好pod lib lint
以下,以防有语法错误。pod spec lint
功能很强大,编译问题会有提示。 -
修改pod版本步骤(比如我之前提交的pod库有bug需要修改)
- 在本地先修改好,git提交到远端。因为有bug修复,这里把
podspec
号也提升一个小版本,注意修改s.version
- 对应
s.version
设置git tag
,并将tag提交到远端 pod spec lint
pod trunk push XXAlertTransition.podspec
- 用到的地方
pod update
即可以生效,pods库里面的版本也提升了。
参考:
我的制作库系列之: iOS制作一个pod私有库文档
我的制作库系列之: iOS 制作本地库Development Pods
cocoapods制作库的文档
cocoapods制作Private Pods文档
cocoapods制作公开Pods文档
https://juejin.cn/post/6844903810482061325
网友评论