没有尝试,就不知道是复杂还是简单,对程序员来说就怕复杂,能简单实现的就不能搞复杂了。这文章是也是第一次制作CocoaPods封装时写的,一边写文章,一边操作,每一步都是新手。内容多,有点复杂,但是尽量简化操作,多的是解释说明,最终是成功实现了!
更多内容可查看CocoaPods官网
一、创建自己的GitHub仓库
创建完成,可以查看仓库信息和仓库地址,可以拷贝下来,一会用到。
二、将仓库克隆本地
注:
要先cd 到指定目录路径,作为本地仓库存放地址。
如在桌面指定路径:cd /Users/您的电脑用户名/Desktop
执行主要的终端指令操作:git clone +仓库地址。
git clone https://github.com/cjq002/LYToolKit.git
三、创建.podspes文件
注:
要先cd 到上一步克隆创建的本地仓库文件夹路径,作为.podspes文件存放地址。
刚才添加的文件夹:cd /Users/您的电脑用户名/Desktop/LYToolKit
执行主要的终端指令操作:pod spec create +名称(和仓库名称一致)
pod spec create LYToolKit
生成的.podspec文件的内容很多,也有大量注释,主要配置几项就可以,有些可以默认,里面有举例子说明怎么填写。
s.version 版本号
s.summary 归纳总结说明
s.description 描述说明
s.homepage 主页链接
s.license License类型
s.author 作者
s.platform 支持版本
s.source 资源路径git和tag
s.source_files 存放资源文件路径
s.framework 需要用到的Frameworks,多个用逗号隔开
s.dependency 该项目所依赖的其他库,多个需要拷贝填写多个
s.name = "LYToolKit"
s.version = "0.0.1"
s.summary = "我的自定义库 LYToolKit."
s.description = <<-DESC
我的自定义库,目前是测试版,里面啥都没有!
DESC
s.homepage = "https://github.com/cjq002/LYToolKit"
s.license = "MIT"
s.author = { "cjq002" => "692771080@qq.com" }
s.platform = :ios, "8.0"
s.source = { :git => "https://github.com/cjq002/LYToolKit.git", :tag => "#{s.version}" }
s.source_files = "Classes", "Classes/**/*.{h,m}"
s.framework = "UIKit", "Foundation"
s.dependency 'AFNetworking', '~> 3.1.0'
s.dependency 'Masonry', '~> 1.0.2'
四、验证.podspec是否通过
执行主要的终端指令操作,如果失败,会返回错误原因,根据原因修改,直至验证成功。
pod lib lint
图上报错原因是由于s.source_files设置匹配不到文件。没有对应的Classes文件夹,或者Classes文件夹内没有任何文件。
解决方法:如下图,在LYToolKit目录文件夹内创建Classes文件夹,然后添加自己的主要文件。再此执行验证指令。
如果报错:
由于刚才填写 .podspec 文件填写 git 地址的时候没有填写指定tag,解决方法我们可以先执行忽略警告的命令:
pod lib lint --allow-warnings
五、将代码提交到GitHub
执行主要的终端指令操作,是否有需要提交的文件。
git add .
git commit -m "提交的描述说明"
git push origin master
add 添加到缓存区,commit推送修改到本地库,push到主分支数据。
注:按提示输入GitHub用户名和密码
六、标志Tag
执行主要的终端指令操作,注意版本号为标志。
git tag 0.0.1
git push --tags
不做标志,后面会报错:
Remote branch 0.0.1 not found in upstream origin
七、CocoaPods使用Trunk发布自己的Pods
1.注册Trunk(首次使用,没有注册过账号的)
执行主要的终端指令操作:pod trunk register 您的邮箱 '您的用户名' --description='描述'
pod trunk register 692771080@qq.com 'cjq002' --description='trunk register'
注意:上述操作会发出验证邮件,需要去邮箱验证后才能继续操作。
2.查看注册结果
执行主要的终端指令操作,完成后返回具体信息。
pod trunk me
3.执行数据上传
执行主要的终端指令操作:pod trunk push [NAME.podspec](也可省略提交对象)
pod trunk push LYToolKit.podspec
结果:
八、Trunk删除自己的Pods
执行主要的终端指令操作:pod trunk delete +库名称 +版本号,指令:pod trunk deprecate +库名称,按提示确认是否删除:y/n 或者yes/no
pod trunk delete LYToolKit 0.0.1
pod trunk deprecate LYToolKit
pod setup
删除后pod search就搜索不到了。CocoaPods会保留一个对象,但详情页打不开了;GitHub数据依然保留,里面的数据需自行处理。暂时没发现怎么修改库的名称……
九、完成
执行主要的终端指令操作:pod search +名称,查找自己添加的库。pod trunk push成功后可以在本地搜索pod search到自己的库的,远程的要等待CocoaPods审核。
搜索报错提示:
[!] Unable to find a pod with name, author, summary, or description matchingLYToolKit
解决方法:
方法1.更新CocoaPods,执行指令:pod setup;
方法2.Finder前往文件夹:~/Library/Caches/CocoaPods,删除search_index.json文件(后面会自动创建)。
需要等待CocoaPods的维护人员审核并将我们pull上去的修改合并到官方的Specs仓库中,审核时间大概一天,CocoaPods官方都会发邮件通知。