使用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 <email> <name>

pod trunk register cui.keyi@outlook.com '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" => "cuidawangvip@163.com" }
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 <podName> <tag>

pod trunk delete CCPhotoBrowser 0.0.1

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

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

人已赞赏
iOS文章

iOS xib设置UIView的边框、圆角

2020-2-7 21:09:05

iOS文章

iOS 让正在滑动的scrollView停止滚动(不是禁止,而是暂时停止滚动)

2020-2-7 23:09:20

个人中心
购物车
优惠劵
今日签到
有新私信 私信列表
搜索