制作自己的CocoaPods封装

2017-08-28 本文已影响116人 CarrySniper

没有尝试，就不知道是复杂还是简单，对程序员来说就怕复杂，能简单实现的就不能搞复杂了。这文章是也是第一次制作CocoaPods封装时写的，一边写文章，一边操作，每一步都是新手。内容多，有点复杂，但是尽量简化操作，多的是解释说明，最终是成功实现了！

更多内容可查看CocoaPods官网

一、创建自己的GitHub仓库

CCEA7654-3EAD-4BB8-A08E-61C1BE473F3E.png

创建完成，可以查看仓库信息和仓库地址，可以拷贝下来，一会用到。

EF1F069E-871D-481C-AA9A-BF77198006E7.png

二、将仓库克隆本地

注：
要先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

94F42881-FF47-44ED-9624-B25C377988BE.png

生成的.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

41EDE447-A914-4E47-A1A6-2FC3C2BBFF90.png

图上报错原因是由于s.source_files设置匹配不到文件。没有对应的Classes文件夹，或者Classes文件夹内没有任何文件。
解决方法：如下图，在LYToolKit目录文件夹内创建Classes文件夹，然后添加自己的主要文件。再此执行验证指令。

766E29A0-04CA-4DC4-BDBB-7DFD185A9B66.png

7144F31F-B030-437A-B353-5C2CDC323674.png

如果报错：

image.png

由于刚才填写 .podspec 文件填写 git 地址的时候没有填写指定tag，解决方法我们可以先执行忽略警告的命令：

pod lib lint --allow-warnings

五、将代码提交到GitHub

执行主要的终端指令操作，是否有需要提交的文件。

git add .
git commit -m "提交的描述说明"

git push origin master

add 添加到缓存区，commit推送修改到本地库，push到主分支数据。
注：按提示输入GitHub用户名和密码

F04A29D8-7E0C-4680-B3B7-C87BE9DDA678.png

六、标志Tag

执行主要的终端指令操作，注意版本号为标志。

git tag 0.0.1
git push --tags

不做标志，后面会报错：
Remote branch 0.0.1 not found in upstream origin

3DD8652E-C638-40C5-B078-058C76F02BDB.png

七、CocoaPods使用Trunk发布自己的Pods

1.注册Trunk（首次使用，没有注册过账号的）

执行主要的终端指令操作：pod trunk register 您的邮箱 '您的用户名' --description='描述'

pod trunk register 692771080@qq.com 'cjq002' --description='trunk register'

注意：上述操作会发出验证邮件，需要去邮箱验证后才能继续操作。

2.查看注册结果

执行主要的终端指令操作，完成后返回具体信息。

pod trunk me

6CDB50A9-A3AB-4667-AAE8-CF6D02736F99.png

3.执行数据上传

执行主要的终端指令操作：pod trunk push [NAME.podspec]（也可省略提交对象）

pod trunk push LYToolKit.podspec

结果：

596B9ED0-A61D-4571-9213-AC66C78C759B.png

八、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 matching LYToolKit
解决方法：
方法1.更新CocoaPods，执行指令：pod setup;
方法2.Finder前往文件夹：~/Library/Caches/CocoaPods，删除search_index.json文件（后面会自动创建）。

需要等待CocoaPods的维护人员审核并将我们pull上去的修改合并到官方的Specs仓库中，审核时间大概一天，CocoaPods官方都会发邮件通知。