记录一下自己第一次创建CocoaPods库的经历,以及遇到的一些问题,废话不多,干货满满
1. 创建工程
打开终端,cd到你要创建文件的位置,如:Documents/work/pod
cd Documents/work/pod
pod lib create SYPodTest
第一次创建会问你几个问题
- 第一个是问你使用什么平台开发 [iOS还是macOS],根据需要选择即可,这里选择iOS。
- 第二个是问你使用什么开发语言 [Swift还是Objc],这里选择Objc。
- 第三个问是否创建一个demo应用包含在工程里,根据需要,如果需要demo示例,选择Yes,否则No。
- 第四个问是否需要测试Framework,这里选择None。
- 第五个问是否需要做界面调试,这里选择No。
- 最后一个问工程文件的前缀,根据需要,我这里使用SY前缀。
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.1
,1.0.0
等 - s.summary对项目简单扼要的描述,比如功能,作用等
-
s.description对项目详细全面的介绍,写在
<<-DESC
和DESC
中间,不用注意缩进 - 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
等,如果有第三方依赖,将注释去掉
3. 创建远程仓库
创建好后将本地代码提交到远程仓库
git add .
git commit -m "Initial Commit"
添加远程仓库
git remote add origin https://github.com/xxx/SYPodTest.git
git push -u origin master
到这里报错了按提示尝试
git pull origin master
还是有问题
报错原因是首次上传代码,本地分支和远程分支不一致,远程创建仓库的时候勾选了gitignore甚至可能还有License,导致不能合并,百度之,解决办法是,参考这里
git pull --rebase origin master
继续提交代码
git push -u origin master
pod验证
pod lib lint SYPodTest.podspec
到这里又报错了
Google之,还是StackOverflow好用,还有这里。这里插一句吐槽,论精准我只服Google,百度差评,搜半天,翻了好几个才找到答案的
解决办法是:
Xcode > Preferences > Locations
选择Command Line Tools继续刚才的操作,终于成功了
pod lib lint SYPodTest.podspec
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
这里又报错了
意思是你需要注册一个session,参考这里
pod trunk register 电子邮箱 '您的姓名' --description='description'
继续刚才报错的步骤,成功了
pod trunk push SYPodTest.podspec
5. pod search 检验是否可用
pod search SYPodTest
出现下面这个问题:
[!] Unable to find a pod with name, author, summary, or description matching `SYPodTest`
这主要是因为在本地索引里面没有, 解决办法
- pod setup (不行,实用方法二)
- pod repo update(不行,试用方法三)
- 前往这个路径下
~/Library/Caches/CocoaPods
删除search_index.json文件 , 或者使用终端命令删除:
rm ~/Library/Caches/CocoaPods/search_index.json
完成后,重新搜索
到这里,自己的CocoaPods仓库终于创建完成!