一步一步创建自己的CocoaPods库(一)

记录一下自己第一次创建CocoaPods库的经历,以及遇到的一些问题,废话不多,干货满满

1. 创建工程

打开终端,cd到你要创建文件的位置,如:Documents/work/pod

cd Documents/work/pod
pod lib create SYPodTest
pod创建过程.png

第一次创建会问你几个问题

  • 第一个是问你使用什么平台开发 [iOS还是macOS],根据需要选择即可,这里选择iOS。
  • 第二个是问你使用什么开发语言 [Swift还是Objc],这里选择Objc。
  • 第三个问是否创建一个demo应用包含在工程里,根据需要,如果需要demo示例,选择Yes,否则No。
  • 第四个问是否需要测试Framework,这里选择None。
  • 第五个问是否需要做界面调试,这里选择No。
  • 最后一个问工程文件的前缀,根据需要,我这里使用SY前缀。

创建完成后会在pod文件夹生成一个项目,里面包含了Demo和配置文件:
image.png

2. 编辑配置文件

  • podspec文件,即Pod Specification(Pod描述文件),描述指定版本的pod库信息,包括:pod库源码地址、文件列表、配置信息、描述信息等。具体可参考官方文档
  • README项目描述文件,这个文件可以使用Markdown语法,主要展示在GitHub工程上的首页。README文件对于使用这个pod库的人来说,有和没有这个文件,区别是很明显的
  • LICENSE要想是Spec仓库接收,就必须包含一个license。pod lib create 自动创建使用的是 MIT license。可以根据需要可以使用不同的License。

这里主要修改podspec文件

  • s.name 项目名称,这里是SYPodTest
  • s.version版本号,0.0.11.0.0
  • s.summary对项目简单扼要的描述,比如功能,作用等
  • s.description对项目详细全面的介绍,写在<<-DESCDESC中间,不用注意缩进
  • s.homepage项目主页地址
  • s.license License类型和名称
  • s.author作者及联系邮箱
  • s.source源码地址
  • s.ios.deployment_target目标版本号
  • s.source_files代码路径
  • s.resource_bundles资源文件如图片等的路径,如果有将注释去掉
  • s.public_header_files公共头文件路径
  • s.frameworks依赖的Framework
  • s.dependency依赖的第三方库,如AFNetworking等,如果有第三方依赖,将注释去掉
    image.png

3. 创建远程仓库

image.png

创建好后将本地代码提交到远程仓库

git add .
git commit -m "Initial Commit"

添加远程仓库

git remote add origin https://github.com/xxx/SYPodTest.git
git push -u origin master

到这里报错了
image.png

按提示尝试

git pull origin master

还是有问题

image.png

报错原因是首次上传代码,本地分支和远程分支不一致,远程创建仓库的时候勾选了gitignore甚至可能还有License,导致不能合并,百度之,解决办法是,参考这里

git pull --rebase origin master

继续提交代码

git push -u origin master

pod验证

pod lib lint SYPodTest.podspec

到这里又报错了

image.png

Google之,还是StackOverflow好用,还有这里。这里插一句吐槽,论精准我只服Google,百度差评,搜半天,翻了好几个才找到答案的
解决办法是:Xcode > Preferences > Locations选择Command Line Tools
image.png

继续刚才的操作,终于成功了

pod lib lint SYPodTest.podspec
image.png

4. 提交Pod

1. 打Tag

git tag 0.1.0

提交到远程仓库

git push origin --tag

2. 验证

pod spec lint SYPodTest.podspec

 -> SYPodTest (0.1.0)

Analyzed 1 podspec.

SYPodTest.podspec passed validation.

3. 提交pod到Specs仓库

pod trunk push SYPodTest.podspec

这里又报错了

image.png

意思是你需要注册一个session,参考这里

pod trunk register 电子邮箱 '您的姓名' --description='description'

继续刚才报错的步骤,成功了

pod trunk push SYPodTest.podspec
image.png

5. pod search 检验是否可用

pod search SYPodTest

出现下面这个问题:

[!] Unable to find a pod with name, author, summary, or description matching `SYPodTest`

这主要是因为在本地索引里面没有, 解决办法

  1. pod setup (不行,实用方法二)
  2. pod repo update(不行,试用方法三)
  3. 前往这个路径下~/Library/Caches/CocoaPods删除search_index.json文件 , 或者使用终端命令删除:
rm ~/Library/Caches/CocoaPods/search_index.json

完成后,重新搜索
到这里,自己的CocoaPods仓库终于创建完成!

参考文章

https://www.jianshu.com/p/41611b14942b

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容