使用CocoaPods创建自己的公开库

一、简介

CocoaPods是 iOS 的依赖管理工具，很优雅的将一些常用的三方库或私有库与主工程分隔开，pod是使用 git 进行项目管理的，所以能好的控制版本，使用 pod 可以集成 git 上的开源项目，也可以集成本地的项目，也是组件化中必不可少的一项重要的工具。同时通过创建一个Xcode的workspace来将这些三方库和我们的工程连接起来，供我们开发使用。使用CocoaPods的目的是让我们能自动化的、集中的、直观的管理第三方开源库。

二、Cocoapods的安装和使用

1、安装

使用 Terminal，输入指令：

sudo gem install cocoapods

如果报错：(没有权限)

ERROR:  While executing gem ... (Errno::EPERM)
    Operation not permitted - /usr/bin/xcodeproj

使用以下指令安装：

sudo gem install -n /usr/local/bin cocoapods

执行完以上指令，pod应该已经正常安装你的电脑上了，如果依然失败，请留言给我。

2、使用

pod 是通过Podfile文件进行安装管理的，在工程的目录下，使用终端执行指令vi Podfile创建Podfile文件，文件内容如下：

#Uncomment this line to define a global platform for your project
# 支持的最低版本
platform :ios, "8.0" 
# 是否使用framework的形式集成
#use_frameworks!
#下载三方库的地址，下面的地址就是公开pod库的默认地址，如果还有私有库，还需要将私有库的地址也写上。
source 'https://github.com/CocoaPods/Specs.git'

# Demo为工程的名字
target "Demo" do
    pod 'SDWebImage', '~> 3.0'
end

配置好Podfile文件之后，执行指令pod install，pod就会自动安装了，安装之后打开工程，需要打开.xcworkspace文件了。

三、发布自己的pod到CocoaPods

平常我们都是使用pod去安装别人封装好的库，那么自己怎么发布自己的 pod 库到 CocoaPods 呢？主要分为如果几个步骤：

• 注册 trunk
• 创建 podspec 文件
• 验证 podspec 文件
• 提交自己的代码到 git，添加 tag
• 通过 trunk 推送 podspec文件

1、注册trunk

pod trunk register

pod trunk register [email protected] 'cuikeyi'

注册成功之后会收到一份确认邮件，去邮箱确认一下邮件，然后执行指令

pod trunk me

成功之后如下图：

image

2、创建 podspec 文件

本文以上一篇文章 图片浏览器 PhotoBrowser 为例，比如我这次的名字叫做CCPhotoBrowser,那么执行指令创建 spec 文件：

pod spec create CCPhotoBrowser

会生成一个 CCPhotoBrowser.podspec 文件，这个文件需要我们简单的修改，修改完的信息如下。

Pod::Spec.new do |s|
  s.name         = "CCPhotoBrowser"
  s.version      = "0.0.1"
  s.summary      = "CCPhotoBrowser."
  s.description  = <<-DESC
                    发布pod到CocoaPods的演示例子，demo。
                   DESC

  s.homepage     = "https://github.com/cky113999742/CCPhotoBrowser"
  s.license      = "MIT"
  s.author       = { "Cuikeyi" => "[email protected]" }
  s.platform     = :ios, '8.0'
  s.source       = { :git => "https://github.com/cky113999742/CCPhotoBrowser.git", :tag => "#{s.version}" }
  s.header_dir    = 'CCPhotoBrowser'
  s.source_files  = 'KYPhotoBrowser/PhotoBrowser/**/*.{h,m}'
  s.framework  = 'UIKit'
  s.requires_arc = true
  s.dependency 'YYWebImage'

end

文件的目录如下：

image

3、验证 podspec 文件

运行指令：

pod lib lint

这个指令是验证 podspec 文件的格式是否正确，如果有报错，就按照报错的提示去修改这个文件，如果有不知道怎么解决的问题，可以留言。

pod lib lint --verbose

上边这个指令可以打出详细的信息，方便更直接的定位文件的问题所在。如果验证没有错误，就算验证成功了，警告什么的可以忽略，无伤大雅，可以使用如下指令忽略警告：

pod lib lint --allow-warnings

如果验证通过了，就进行下一步骤。

4、提交代码，添加tag

提交代码：

git  add .
git commit -m "first commit"
git pull origin master
git push origin master

提交tag

git  tag -m "release 0.0.1" 0.0.1
git  push --tags

5、推送 podspec文件

执行指令：

pod trunk push CCPhotoBrowser.podspec --allow-warnings

上传成功显示如下图：

image

看见这个是不是很兴奋，此刻是不是很激动，想立刻去看看自己的库到底能不能找到吧。
执行指令：

pod search CCPhotoBrowser

你会发现，纳尼，怎么找不到？？？

▶ pod search CCPhotoBrowser
[!] Unable to find a pod with name, author, summary, or description matching `CCPhotoBrowser`

此时别慌，你需要执行以下几个指令试一试，如果你的朋友也搜不到你提交的pod，执行下面的指令就能解决问题了。
1、更新本地的 repo 空间

pod repo update

2、如果执行完这个还是找不到，删除本地缓存，执行：

rm ~/Library/Caches/CocoaPods/search_index.json

此时就能找到自己刚刚发布的pod库啦，如果还是没有找到，请留言吧。到此发布自己的 pod 到 cocoaPods 就算是告一段落了，但是还没有结束，如果有一天，你不想发布这个 pod 了，你突然想删掉上传到cocoaPods了，你只需要执行以下的指令就可以了：
pod trunk delete

pod trunk delete CCPhotoBrowser 0.0.1

0.0.1为你发布到 cocoaPods 上的版本，这个版本号和自己的 tag 有关系。
好了，亲爱的读者们，欢乐的时光总是这么短暂，又到了和大家说再见的时间了，文章到这里就彻底结束了，如果有什么问题的话，可以留言告知。

使用Cocoapods创建私有podspec
图片浏览器 PhotoBrowser