一直想制作一个pod库,然后写了一个demo
XXAlertTransition
,封装了几个present转场的动画,效果可点击XXAlertTransition github地址查看。这里讲的是如何制作公有库,制作过程就用XXAlertTransition
作为例子了,第一次制作,也遇到了一些问题,记录一下,代码提的比较散,后续需要优化。
制作pod公有库步骤
-
GitHub上创建一个仓库
XXAlertTransition
。
填上仓库名,直接点Create repository。
-
在本机
cd
到存放这个库的文件夹下,终端输入pod lib create XXAlertTransition
-
创建pod会问几个问题,我这里是用
Swift
写的代码,后续制作稍有不同,根据自己情况填写即可。
-
创建完毕之后,会自动创建一个
XXAlertTransition
文件夹,里面有pod的相关信息,并且自动打开此project。
-
将classes里面的
ReplaceMe.Swift
文件用自己pod的相关文件替代。(我把ReplaceMe.Swift
删掉,把之前写好的demoXXAlertTransition
封装好的几个类直接拖进来)
-
修改
XXAlertTransition.podspec
文件
傻了,homepage填错了(导致下面pod spec lint
找不到库报错,🐷,仔细呀)。应该是下面这样:
-
⚠️:如果是
Swift
库,这里最好还要加上s.swift_version = '5'。(我没有加,所以第9步我出错了,朋友们为了节省时间可以直接在这里就加上,同时记得检查自己的homepage,source信息呀。homepage、 source对应的是远端库的信息)
⚠️:如果制作的库有依赖项,记得需要填充
s.dependency
的内容
提交代码到远程仓库(就是制作的这个本地库提交和远程库关联)。
-
添加标签。必须要这一步,这个标签对应上面
XXAlertTransition.podspec
中的s.version
。 到时cocopods仓库也是通过版本关联起来的,这样比较清晰。
- lint检查仓库,终端执行
pod spec lint
。
-
由于开始第6步
s.homepage
、s.source
填错所以出现了以下错误。更正后正常。
-
由于开始第6步未填
s.swift_version
,所以报了以下错误,添加后正常。
-
在
XXAlertTransition.podspec
加入下面这个话:
s.swift_version = '5'
-
重新
pod spec lint
成功啦。(如果有依赖项需要用pod spec lint --use-libraries
,我制作的这个库没有依赖项请注意)
- 推送podspec到pod库,终端执行
pod trunk push XXAlertTransition.podspec
-
由于我是第一次推送,会出现以下问题:
-
解决:注册一个session。然后去邮箱验证一下。
pod trunk register shine9328@qq.com 'weimengxue' --description='A coder.'
-
验证完毕之后,会看到:
-
再重新
pod trunk push XXAlertTransition.podspec
就可以成功啦
- 这里看一下远程仓库自动创建的
README
-
未推送podspec到pod库时是这样的,描述中没有相关信息:
-
推送成功后:
- 迫不及待的
pod search XXAlertTransition
看能不能搜到我的库,好的,为啥没有!注意到上面的截图,
CocoaPods 1.10.0 is available.
,而我现在的版本:
更新cocopods版本和repos后,pod search XXAlertTransition
还是找不到这个库,我自己创建的demo中在Podfile
文件中引入此库,pod install
可以pod下来这个库,pod search
显示的并不及时。
⚠️: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