一步一步创建自己的CocoaPods库(一)
2018-03-01 本文已影响0人
StevenYung
记录一下自己第一次创建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前缀。
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.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等，如果有第三方依赖，将注释去掉
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`
这主要是因为在本地索引里面没有, 解决办法
- pod setup (不行,实用方法二)
- pod repo update(不行,试用方法三)
- 前往这个路径下
~/Library/Caches/CocoaPods删除search_index.json文件 , 或者使用终端命令删除:
rm ~/Library/Caches/CocoaPods/search_index.json
完成后，重新搜索
到这里，自己的CocoaPods仓库终于创建完成！
