如何发布自己的开源框架到CocoaPods

在开发过程中，经常会使用到第三框架，我们通过一个pod install命令，很方便的就将第三方框架加到我们自己的项目中。 如果我们也想将自己写的组件或库开源出去，让别人也可以通过pod install命令安装自己的框架该怎么做呢？下面，我就教大家一步一步的将自己的pods发布到CocoaPods 中。如果你现在对CocoaPods还不太了解，推荐你看一看这篇文章：用CocoaPods做iOS程序的依赖管理 创建自己项目的Podspec描述文件 下面我会通过一个名为HUPhotoBrowser的项目来讲解一下整个过程。项目发布到github后，需要打上tag。之后我们在工程根目录中初始化一个Podspec文件： pod spec create HUPhotoBrowser 该命令将在本目录产生一个名为HUPhotoBrowser.podspec文件。用编辑器打开该文件，里面已经有非常丰富的说明文档。下面介绍如何声明第三方库的代码目录和资源目录，还有该第三方库所依赖ios核心框架和第三方库。这是我的podspec文件： Pod::Spec.new do |s|   s.name         = "HUPhotoBrowser"   s.version      = "0.0.2"   s.summary      = "photo browser for ios."   s.homepage     = "https://github.com/hujewelz/HUPhotoBrowser"   s.license      = "MIT"   s.author             = { "Jewelz Hu" => "[email protected]" }   s.platform     = :ios, "7.0"   s.source       = { :git => "https://github.com/hujewelz/HUPhotoBrowser.git", :tag => "0.0.2" }   s.source_files  = "HUPhotoBrowser", "HUPhotoBrowser/**/*.{h,m}"    s.framework  = "UIKit"   # s.frameworks = "SomeFramework", "AnotherFramework" s.name是我们库的名称，s.version是库原代码版本号，s.summary是对我们库的一个简单的介绍，s.homepage声明库的主页，s.license是所采用的授权版本，s.author是库的作者。s.platform是我们库所支持的软件平台，这在我们最后提交进行编译 时有用。s.source声明原代码的地址。我这里是托管在github上,所以这里将地址copy过来就行了。 对于很多第三方库而言，在发布的时候都会打上一个tag，如版本0.0.1就会打上一个名为0.0.1的tag,你也可以选择一个最新的commit来作为该库0.0.1版的代码, 那么最终source就是这样了： {:git => "https://github.com/hujewelz/HUPhotoBrowser.git", :commit => '65584b0e0b08e01f83e66d487180c164b5182409'} 我这里还是使用的tag，所以我这里就是这样的： { :git => "https://github.com/hujewelz/HUPhotoBrowser.git", :tag => "0.0.2" } 以后我们的库有新版本时，我们可以修改相应的version和source。 s.source_files声明了我们库的源代码的位置，所以这个地方不能填错了。先看一下我的目录结构： 所以工程根目录下的HUPhotoBrowse文件夹才是库的原代码目录。 s.source_files  = "HUPhotoBrowser", "HUPhotoBrowser/**/*.{h,m}" 目录的层级关系一定要跟代码库的保持一致。这里前一部分可以不用的，因为我这里后一部分的HUPhotoBrowser/**与前面是一致的，这个指定的目录下的文件都会进行编译。如果该目录下还有一些资源文件（如图片等），这些文件并不需要进行编译。可以使用s.resourcs声明。*.{h,m}是一个类似正则表达式的字符串，表示匹配所有以.h和.m为扩展名的文件。 s.framework声明了所依赖的核心库，我这里只用到了UIKit,所以是这样的： s.framework  = "UIKit" 如果你的项目中依赖多个库，可以使用 s.frameworks = "SomeFramework", "AnotherFramework" 当然，我们开发的库中也可能还依赖第三方库，例如JSONKit，那么，就可以做如下声明: s.dependency "JSONKit", "~> 1.4" 如果有多个需要填写多个s.dependency。 编辑完podspec文件后，需要验证一下这个文件是否可用，如果有任何WARNING或者ERROR都是不可以的，它就不能被添加到Spec Repo中，不过xcode的WARNING是可以存在的，验证需要执行命令： pod spec lint PodName.podspec 当看到HUPhotoBrowser passed validation.时，说明验证通过了。 编辑好podspec文件后就可以将该podspec文件保存到本机的~/.cocoapods/repos/master/Specs目录中仅供自己使用，也可以将其提交到CocoaPods/Specs代码库中。下面我们先将其保存到本机中： 下面可以看一下是否可以通过搜索找到该库: 同样在需要依赖于HUPhotoBrowser这个库的项目，可以将下列添加到项目的Podfile文件中 pod 'HUPhotoBrowser', '~0.0.2' 保存文件，并用pod install安装HUPhotoBrowser库。 通过以上步骤创建Pod库还只能供自己使用，下面会继续讲解如何将其提交到CocoaPods/Specs代码库中，让其他人也可以通过pod install安装我们的开源库。 CocoaPods Trunk发布自己的Pods 在cocoapods使用了trunk之后，CocoaPods 需要0.33以上版本，用 pod --version查看版本，如果版本低，需要更新。 注册Trunk $ pod trunk register [email protected] 'Orta Therox' --description='macbook air' 大家在注册时需要替换成自己的邮箱和用户名，一切顺利的话就会受到一份邮件，点击邮件中的链接后验证一下： pod trunk me 当然，如果你的pod是由多人维护的，你也可以添加其他维护者: $ pod trunk add-owner ARAnalytics [email protected] 上面的工作完成之后，我们就可以开始 trunk push了。 Trunk push pod trunk push 命令会首先验证你本地的podspec文件(是否有错误)，之后会上传spec文件到trunk，最后会将你上传的podspec文件转换为需要的json文件。在工程根目录(包含有.podspec)下执行命令： pod trunk push 如果在trunk push过程中报错了，仔细查看一下错误信息。我当初就是使用了podspec文件中描述的版本所没有的API，之后修改podspec文件中s.platform = :ios, "7.0"就可以了。 如果你能看的上面的结果说明上传成功了。我们也可以在本地的~/.cocoapods/repos/master/Specs目录下看到转换之后的json文件, 至此我们整个制作自己的开源库的过程就完成了，以后有新版本只需要修改工程根目录下的podspec文件就行了，然后重新执行pod trunk push命令。 最后 最后对这个过程做个总结： 1.开源库发布之后，需要打上tag 2.进入到项目根目录下，创建podspec文件 pod spec create PodName 3.编辑podspec文件中的相关信息，有两个比较重要的地方s.source和s.source_files,可以验证是否有误： pod spec lint PodName.podspec 4.注册pod trunk $ pod trunk register [email protected] 'Orta Therox' --description='macbook air' 5.发布到pod trunk pod trunk push [NAME.podspec] 该命令在包含有.podspec文件的目录下执行 6.更新pod库 pod setup 如果pod trunk push成功后无法pod search到自己的库，可执行该命令。 最后的最后 哈哈。好吧，我承认其实我是来打广告的。例子中的HUPhotoBrowser是我开源的一个图片浏览器的库，使用起来非常简单，一行代码就以实现图片浏览功能，支持本地和网络图片。