使用Cocoapods创建私有podspec

释放双眼,带上耳机,听听看~!

整体说明一下创建私有podspec的步骤:

1,创建一个远程的git库用于存储代码,将新建的git库clone到本地,添加需要导入pod库中的代码。

2,创建并设置一个私有的Spec Repo。

3,在本地git库文件夹中创建pod所对应的podspec文件。

4,本地测试配置好的podspec文件是否可用。

5,向私有的spec repo中提交podspec。

6,在项目中的Podfile中增加刚刚制作好的Pod并使用。

7,后续更新维护podspec。

一,创建私有的Spec Repo

什么是 Spec Repo ? 它是所有的 Pods 的一个索引,就是一个容器,所有公开的 Pods 都在这个里面,它实际是一个 Git 仓库 remote 端在 GitHUb 上,但是当你使用了 CocoaPods 后它会被 clone 到本地的 ~/.cocoapods/repos 目录下。第一步先创建远端的 GitHub,并clone到本地:

    git clone git@github.com:Cuidawang/CKYTool.git
image

创建之后在 Terminal 中执行如下命令:

 # pod repo add [Private Repo Name] [GitHub HTTPS clone URL]
$ pod repo add CKYTool git@github.com:Cuidawang/CKYTool.git

此时如果成功的话,进入 ~/.cocoapods/repos 目录下就可以看见 CKYTool 这个目录了。到这第一步就完成了。

PS: 如果有其他合作人员共同使用这个私有Spec Repo的话在他有对应Git仓库的权限的前提下执行相同的命令添加这个Spec Repo即可。

二,添加需要的代码文件到CKYTool目录下

比如我选取了一个文件管理和一个分类的文件进行测试,将这两个文件添加到 CKYTool 中,

image

三,创建项目的podspec文件

使用终端命令cd到CKYTool文件下执行命令:

    pod spec create CKYTool

这时候本地会生成一个 CKYTool.podspec 文件,使用 sublime 打开 CKYTool.podspec 文件,删除不必要的注释,最后的文件形式如下:

Pod::Spec.new do |s|
s.name         = "CKYTool"                            #名称
s.version      = "0.0.1"                              #版本号
s.summary      = "CKYTool."    #简短介绍
s.description  = <<-DESC
对这个pod文件进行描述,这的描述要比summary的长。
DESC
s.homepage     = "https://github.com/Cuidawang/CKYTool"   #主页
s.license      = "MIT"                                    #开源协议
s.author       = { "Cuikeyi" => "https://github.com/Cuidawang/CKYTool" }
s.platform     = :ios, "8.0"
s.source       = { :git => "https://github.com/Cuidawang/CKYTool.git", :tag => "#{s.version}" }
s.header_dir   = "CKYTools"                           #Pod安装之后的文件名
s.requires_arc = true
s.subspec 'XHCCategories' do |ss|
ss.header_dir   = 'XHCCategories'
ss.subspec 'NSDate' do |sss|
sss.source_files = "XHCTools/XHCCategories/NSDate/**/*.{h,m}",
sss.header_dir = 'NSDate'
end
ss.subspec 'NSString' do |sss|
sss.source_files = "XHCTools/XHCCategories/NSString/**/*.{h,m}",
sss.header_dir = 'NSString'
end
ss.subspec 'NSDate' do |sss|
sss.source_files = "XHCTools/XHCCategories/NSDate/**/*.{h,m}",
sss.header_dir = 'NSDate'
end
ss.subspec 'UIButton' do |sss|
sss.source_files = "XHCTools/XHCCategories/UIButton/**/*.{h,m}",
sss.header_dir = 'UIButton'
end
ss.subspec 'UIColor' do |sss|
sss.source_files = "XHCTools/XHCCategories/UIColor/**/*.{h,m}",
sss.header_dir = 'UIColor'
end
ss.subspec 'UIImage' do |sss|
sss.source_files = "XHCTools/XHCCategories/UIImage/**/*.{h,m}",
sss.header_dir = 'UIImage'
end
ss.subspec 'UIView' do |sss|
sss.source_files = "XHCTools/XHCCategories/UIView/**/*.{h,m}",
sss.header_dir = 'UIView'
end
end
s.subspec 'XHCFileManager' do |ss|
ss.source_files = "XHCTools/XHCFileManager/**/*.{h,m}",
ss.header_dir   = 'XHCFileManager'
end
end

文件中的字段说明参考:http://guides.cocoapods.org/syntax/podspec.html

编辑完 podspec 文件后,需要验证一下这个文件是否可用,如果有任何的 Warning 或者 Error 都是不可以的,它就不能被添加到 Spec Repo 中,不过 xcode 的 Warning 是可以存在的,验证需要执行一个命令

pod lib lint

当如下图时,表示验证通过了

image

Tips:

1,去除Xcode的警告,可以通过命令屏蔽警告:

    pod lib lint --allow-warnings

2,如果出现Error但是提示信息不足,可以添加 –verbose 以获取更多的错误信息

    pod lib lint --verbose

四,提交文件到github,打tag,上传podspec

1,提交文件到github

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

2,提交tag

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

3,上传podspec

pod repo push CKYTool CKYTool.podspec  #前面是本地Repo名字 后面是podspec名字

至此,我们的这个组件库就已经制作添加完成了,使用 pod search CKYTool 就可以找到这个库了。

Tips:

1,提交文件的顺序不能改变,一定要先提交tag标签,之后再上传podspec。否则会上传podspec失败。

2,对于 .podspec 文件,一定要放在文件的最外层,不然就报错。

五,使用制作好的Pod

在完成这一系列步骤后,我们就可以在正式的项目中使用这个私有的Pod了只需要在Podfile文件中添加:

platform :ios, "8.0"
# source 是pod去哪下载地址,写多个source会从上到下一次去加载
source 'https://github.com/Cuidawang/CKYTool.git'
source 'https://github.com/CocoaPods/Specs.git'
target "XXXX" do
pod 'CKYTool'
end

然后执行 pod update ,更新依赖库,就可以看见自己的库文件出现在 Pods 子目录中,而不是 Development Pods 中。

Tips:

1,引用使用文件的时候,引用方式为 #import <NSString/NSString+URLEncoding.h>, 就可以找到文件的路径了。

2,也可以在Target -> Build Settings -> User Header Search Paths 中点击加号,添加 $(PODS_ROOT) ,后边设置成recursive,此时可以通过 #import “NSString+URLEncoding.h” 引入头文件。

六,关于Pod的升级

当前的版本是0.0.1,如果我们增加了一些代码文件,更新了一些代码,此时要发布0.0.2版本,需要怎么做呢?

1,修改代码文件,更新代码完毕之后,并更新 CKYTool.podspec 文件,修改s.version = ‘0.0.2’,都修改完成之后,通过 pod lib lint 验证 podspec 文件是否有效,如果有效,进行下一步。

2,验证通过之后,提交自己的代码到git,然后打tag 0.0.2,(一定要打tag和s.verisonxiang相对应),然后提交tag。

3,提交完tag之后,接着上传podspec, pod repo push CKYTool CKYTool.podspec。此时 pod search CKYTool 就会发现0.0.2版本了。

七,删除和添加 Spec Repo

1, 删除一个私有的 Spec Repo:

pod repo remove CKYTool

2,添加

pod repo add CKYTool git@github.com:Cuidawang/CKYTool.git

如果我们要删除私有Spec Repo下的某一个podspec怎么操作呢,此时无需借助Cocoapods,只需要cd到~/.cocoapods/repos/WTSpecs目录下,删掉库目录

八,参考资料

http://blog.wtlucky.com/blog/2015/02/26/create-private-podspec/

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