title: Cocoapods创建私有podspec
date: 2018-10-31 16:06:36
categories: iOS
tags: Pod
创建一个私有的podspec包括如下那么几个步骤:
- 创建并设置一个私有的Spec Repo。
- 创建Pod的所需要的项目工程文件,并且有可访问的项目版本控制地址。
- 创建Pod所对应的podspec文件。
- 本地测试配置好的podspec文件是否可用。
- 向私有的Spec Repo中提交podspec。
- 在个人项目中的Podfile中增加刚刚制作的好的Pod并使用。
- 更新维护podspec。
创建私有Spec Repo
先来说第一步,什么是Spec Repo?它是所有的Pods的一个索引,就是一个容器,所有公开的Pods都在这个里面,它实际是一个Git仓库remote端在GitHub上,但是当你使用了Cocoapods后它会被clone到本地的~/.cocoapods/repos目录下,可以进入到这个目录看到master文件夹就是这个官方的Spec Repo了。这个master目录的结构是这个样子的
├── Specs
└── [SPEC_NAME]
└── [VERSION]
└── [SPEC_NAME].podspec
复制代码
因此我们需要创建一个类似于master的私有Spec Repo,可以fork官方的Repo
创建完成之后在Terminal中执行如下命令
# pod repo add [Private Repo Name] [GitHub HTTPS clone URL]
$ pod repo add NewRepo http://github.com/newrepo/NewRepo.git
复制代码
此时如果成功的话进入到~/.cocoapods/repos目录下就可以看到NewRepo这个目录了。至此第一步创建私有Spec Repo完成。
PS:如果有其他合作人员共同使用这个私有Spec Repo的话在他有对应Git仓库的权限的前提下执行相同的命令添加这个Spec Repo即可。
创建Pod项目工程文件
创建新的组件项目,可以使用Using Pod Lib Create
来创建项目
$ pod lib create PodDemoLibrary
复制代码
之后四个问题,
- 是否需要一个例子工程;
- 选择一个测试框架;
- 是否基于View测试;
- 类的前缀;
具体介绍可以去看官方文档,我这里选择的是1.yes;2.Specta/Expecta;3.yes;4.HZ。 问完这4个问题他会自动执行pod install命令创建项目并生成依赖。
$ tree PodDemoLibrary -L 2
PodDemoLibrary
├── Example #demo APP
│ ├── PodDemoLibrary
│ ├── PodDemoLibrary.xcodeproj
│ ├── PodDemoLibrary.xcworkspace
│ ├── Podfile #demo APP 的依赖描述文件
│ ├── Podfile.lock
│ ├── Pods #demo APP 的依赖文件
│ └── Tests
├── LICENSE #开源协议 默认MIT
├── Pod #组件的目录
│ ├── Assets #资源文件
│ └── Classes #类文件
├── PodDemoLibrary.podspec #第三步要创建的podspec文件
└── README.md #markdown格式的README
9 directories, 5 files
复制代码
以上是项目生成的目录结构及相关介绍。
接下来就是向Pod文件夹中添加库文件和资源,并配置podspec文件,我把一个网络模块的组件放入Pod/Classes中,然后进入Example文件夹执行pod update命令,再打开项目工程可以看到,刚刚添加的组件已经在Pods子工程下Development Pods/PodDemoLibrary中了,然后编辑demo工程,测试组件。
注:这里需要注意的是每当你向Pod中添加了新的文件或者以后更新了podspec的版本都需要重新执行一遍pod update命令。 测试无误后需要将该项目添加并推送到远端仓库,并编辑podspec文件。
通过Cocoapods创建出来的目录本身就在本地的Git管理下,我们需要做的就是给它添加远端仓库,同样去GitHub或其他的Git服务提供商那里创建一个私有的仓库,拿到SSH地址,然后cd到PodDemoLibrary目录
$ git add .
$ git commit -m "Initial Commit of Library"
$ git remote add origin <git ssh url> #添加远端仓库
$ git push origin master #提交到远端仓库
复制代码
因为podspec文件中获取Git版本控制的项目还需要tag号,所以我们要打上一个tag,
$ git tag '0.1.0'
$ git push --tags #推送tag到远端仓库
复制代码
做完这些就可以开始编辑podspec文件了,它是一个Ruby的文件,把编辑器的格式改成Ruby就能看到语法高亮,下面我贴上我的podspec文件,并在后面以注释的形式说明每个字段的含义,没有涉及到的字段可以去官方文档查阅
Pod::Spec.new do |s|
s.name = "PodDemoLibrary" #名称
s.version = "0.1.0" #版本号
s.summary = "Just Testing." #简短介绍,下面是详细介绍
s.description = <<-DESC
Testing Private Podspec.
* Markdown format.
* Don't worry about the indent, we strip it!
DESC
s.homepage = "<git project url>" #主页,这里要填写可以访问到的地址,不然验证不通过
# s.screenshots = "www.example.com/screenshots_1", "www.example.com/screenshots_2" #截图
s.license = 'MIT' #开源协议
s.author = { "abc" => "abc@gmail.com" } #作者信息
s.source = { :git => "https://github.com/PodDemoLibrary/PodDemoLibrary.git", :tag => "0.1.0" } #项目地址,这里不支持ssh的地址,验证不通过,只支持HTTP和HTTPS,最好使用HTTPS
# s.social_media_url = 'https://twitter.com/<twitter_username>' #多媒体介绍地址
s.platform = :ios, '8.0' #支持的平台及版本
s.requires_arc = true #是否使用ARC,如果指定具体文件,则具体的问题使用ARC
s.source_files = 'Pod/Classes/**/*' #代码源文件地址,**/*表示Classes目录及其子目录下所有文件,如果有多个目录下则用逗号分开,如果需要在项目中分组显示,这里也要做相应的设置
s.resource_bundles = {
'PodDemoLibrary' => ['Pod/Assets/*.png']
} #资源文件地址
s.public_header_files = 'Pod/Classes/**/*.h' #公开头文件地址
s.frameworks = 'UIKit' #所需的framework,多个用逗号隔开
s.dependency 'AFNetworking', '~> 3.1' #依赖关系,该项目所依赖的其他库,如果有多个需要填写多个s.dependency
end</twitter_username>
复制代码
编辑完podspec文件后,需要验证一下这个文件是否可用,如果有任何WARNING或者ERROR都是不可以的,它就不能被添加到Spec Repo中,不过xcode的WARNING是可以存在的,验证需要执行一下命令
$ pod lib lint
复制代码
当你看到
-> PodDemoLibrary (0.1.0)
PodDemoLibrary passed validation.
复制代码
时,说明验证通过了,不过这只是这个podspec文件是合格的,不一定说明这个Pod是可以用的,我们需要在本地做一下验证,这就是第四步的内容了,第四步在具体说明。
创建podspec文件
如果从第二步过来,已经有了现成的项目,那么就需要给这个项目创建一个podspec文件,创建它需要执行Cocoapods的另外一个命令,官方文档在这里
$ pod spec create PodDemoLibrary git@github.com:abc/PodDemoLibrary.git
复制代码
执行完之后,就创建了一个podspec文件,他其中会包含很多内容,可以按照我之前介绍的进行编辑,没用的删掉。编辑完成之后使用验证命令验证一下
$ pod lib lint
复制代码
验证无误就可以进入下一步了。
本地测试podspec文件
我们可以创建一个新的项目,在这个项目的Podfile文件中直接指定刚才创建编辑好的podspec文件,看是否可用。 在Podfile中我们可以这样编辑,有两种方式
platform :ios, '7.0'
pod 'PodDemoLibrary', :path => '~/code/Cocoapods/podTest/PodDemoLibrary' #指定路径
pod 'PodDemoLibrary', :podspec => '~/code/Cocoapods/podTest/PodDemoLibrary/PodDemoLibrary.podspec' #指定podspec文件
复制代码
然后执行pod install命令安装依赖,打开项目工程,可以看到库文件都被加载到Pods子项目中了,不过它们并没有在Pods目录下,而是跟测试项目一样存在于Development Pods/PodDemoLibrary中,这是因为我们是在本地测试,而没有把podspec文件添加到Spec Repo中的缘故。
在项目中编写代码,测试库文件无误后就可以开始下一步了,提交podspec到Spec Repo中。
向Spec Repo提交podspec
向Spec Repo提交podspec需要完成两点一个是podspec必须通过验证无误,在一个就是删掉无用的注释(这个不是必须的,为了规范还是删掉吧)。
向我们的私有Spec Repo提交podspec只需要一个命令
$ pod repo push NewRepo PodDemoLibrary.podspec #前面是本地Repo名字 后面是podspec名字
复制代码
完成之后这个组件库就添加到我们的私有Spec Repo中了,可以进入到~/.cocoapods/repos/NewRepo目录下查看
.
├── LICENSE
├── PodDemoLibrary
│ └── 0.1.0
│ └── PodDemoLibrary.podspec
└── README.md
复制代码
再去看我们的Spec Repo远端仓库,也有了一次提交,这个podspec也已经被Push上去了。
至此,我们的这个组件库就已经制作添加完成了,使用pod search命令就可以查到我们自己的库了
$ pod search PodDemoLibrary
-> PodDemoLibrary (0.1.0)
Just Testing.
pod 'PodDemoLibrary', '~> 0.1.0'
- Homepage: https://github.com/abc/PodDemoLibrary
- Source: https://github.com/abc/PodDemoLibrary.git
- Versions: 0.1.0 [NewRepo repo]
复制代码
这里说的是添加到私有的Repo,如果要添加到Cocoapods的官方库了,可以使用trunk工具,具体可以查看官方文档。
使用制作好的Pod
在完成这一系列步骤之后,我们就可以在正式项目中使用这个私有的Pod了只需要在项目的Podfile里增加以下代码即可
#指出Pod源地址,否则只会在官方地址中寻找
source 'https://github.com/CocoaPods/Specs.git'
source 'https://github.com/newRepo/NewRepo.git'
$ pod 'PodDemoLibrary', '~> 0.1.0'
复制代码
然后执行pod update,更新库依赖,然后打开项目可以看到,我们自己的库文件已经出现在Pods子项目中的Pods子目录下了,而不再是Development Pods。
更新维护podspec
最后再来说一下制作好的podspec文件后续的更新维护工作,比如如何添加新的版本,如何删除Pod。
我已经制作好了PodDemoLibrary的0.1.0版本,现在我对他进行升级工作,这次我添加了更多的模块到PodDemoLibrary之中,包括工具类,底层Model及UIKit扩展等,这里又尝试了一下subspec功能,给PodDemoLibrary创建了多个子分支。
具体做法是先将源文件添加到Pod/Classes中,然后按照不同的模块对文件目录进行整理,因为我有四个模块,所以在Pod/Classes下有创建了四个子目录,完成之后继续编辑之前的PodDemoLibrary.podspec,这次增加了subspec特性
Pod::Spec.new do |s|
s.name = "PodDemoLibrary"
s.version = "1.0.0"
s.summary = "Just Testing."
s.description = <<-DESC
Testing Private Podspec.
* Markdown format.
* Don't worry about the indent, we strip it!
DESC
s.homepage = "https://github.com/PodDemoLibrary/PodDemoLibrary"
# s.screenshots = "www.example.com/screenshots_1", "www.example.com/screenshots_2"
s.license = 'MIT'
s.author = { "abc" => "abc@gmail.com" }
s.source = { :git => "https://github.com/PodDemoLibrary/PodDemoLibrary.git", :tag => "1.0.0" }
# s.social_media_url = 'https://twitter.com/<twitter_username>'
s.platform = :ios, '8.0'
s.requires_arc = true
#s.source_files = 'Pod/Classes/**/*'
#s.resource_bundles = {
# 'PodDemoLibrary' => ['Pod/Assets/*.png']
#}
#s.public_header_files = 'Pod/Classes/**/*.h'
s.subspec 'NetWorkEngine' do |networkEngine|
networkEngine.source_files = 'Pod/Classes/NetworkEngine/**/*'
networkEngine.public_header_files = 'Pod/Classes/NetworkEngine/**/*.h'
networkEngine.dependency 'AFNetworking', '~> 3.1'
end
s.subspec 'DataModel' do |dataModel|
dataModel.source_files = 'Pod/Classes/DataModel/**/*'
dataModel.public_header_files = 'Pod/Classes/DataModel/**/*.h'
end
s.subspec 'CommonTools' do |commonTools|
commonTools.source_files = 'Pod/Classes/CommonTools/**/*'
commonTools.public_header_files = 'Pod/Classes/CommonTools/**/*.h'
commonTools.dependency 'OpenUDID', '~> 1.0.0'
end
s.subspec 'UIKitAddition' do |ui|
ui.source_files = 'Pod/Classes/UIKitAddition/**/*'
ui.public_header_files = 'Pod/Classes/UIKitAddition/**/*.h'
ui.resource = "Pod/Assets/MLSUIKitResource.bundle"
ui.dependency 'PodDemoLibrary/CommonTools'
end
s.frameworks = 'UIKit'
#s.dependency 'AFNetworking', '~> 3.1'
#s.dependency 'OpenUDID', '~> 1.0.0'
end</twitter_username>
复制代码
因为我们创建了subspec所以项目整体的依赖dependency,源文件source_files,头文件public_header_files,资源文件resource等都移动到了各自的subspec中,每个subspec之间也可以有相互的依赖关系,比如UIKitAddition就依赖于CommonTools。
编辑完成之后,在测试项目里pod update一下,几个子项目都被加进项目工程了,写代码验证无误之后,就可以将这个工程push到远端仓库,并打上新的tag->1.0.0。
最后再次使用pod lib lint验证编辑好的podsepc文件,没有自身的WARNING或者ERROR之后,就可以再次提交到Spec Repo中
$ pod repo push NewRepo PodDemoLibrary.podspec
复制代码
之后再次到~/.cocoapods/repos/NewRepo目录下查看
.
├── LICENSE
├── PodDemoLibrary
│ ├── 0.1.0
│ │ └── PodDemoLibrary.podspec
│ └── 1.0.0
│ └── PodDemoLibrary.podspec
└── README.md
复制代码
已经有两个版本了,使用pod search可以看到记录
完成这些之后,在实际项目中我们就可以选择使用整个组件库或者是组件库的某一个部分了,对应的Podfile中添加的内容为
platform :ios, '8.0'
pod 'PodDemoLibrary/NetWorkEngine', '1.0.0' #使用某一个部分
pod 'PodDemoLibrary/UIKitAddition', '1.0.0'
pod 'PodDemoLibrary', '1.0.0' #使用整个库
复制代码
最后介绍一下如何删除一个私有Spec Repo,只需要执行一条命令即可
$ pod repo remove NewRepo
复制代码
这样这个Spec Repo就在本地删除了,我们还可以通过
$ pod repo add NewRepo git@github.com:abc/NewRepo.git
复制代码
再把它给加回来。
如果我们要删除私有Spec Repo下的某一个podspec怎么操作呢,此时无需借助Cocoapods,只需要cd到~/.cocoapods/repos/NewRepo目录下,删掉库目录
$ rm -Rf PodDemoLibrary
复制代码
然后在将Git的变动push到远端仓库即可
$ git add --all .
$ git ci -m "remove unuseful pods"
$ git push origin master
复制代码
参考资料