创建私有Spec Repo
创建一个 Git仓库,这个仓库你可以创建私有的也可以创建公开的,不过既然私有的Spec Repo,还是创建私有的仓库吧,需要注意的就是如果项目中有其他同事共同开发的话,你还要给他这个Git仓库的权限。因为GitHub的私有仓库是收费的,我还不是GitHub的付费用户,所以我使用了其他Git服务,我使用的是公司的git服务器,当然还有其他的可供选择CODING、开源中国、Bitbucket以及CSDN
创建完成之后在Terminal中执行如下命令
pod repo add WTYNetworking http://git.webtrn.cn/CoderTian/WTYNetworking.git
创建Pod项目工程文件
切换到要创建项目的目录然后执行
pod lib create WTYNetworking
之后会有几个问题
What language do you want to use?? [ Swift / ObjC ]
> ObjC
Would you like to include a demo application with your library? [ Yes / No ]
> Yes
Which testing frameworks will you use? [ Specta / Kiwi / None ]
> Specta
Would you like to do view based testing? [ Yes / No ]
> No
What is your class prefix?
> WTY
问完这4个问题他会自动执行pod install命令创建项目并生成依赖。
如图所示就是私有库项目的目录,红框就是开发的私有库
因为私有库是针对AFNetworking封装,需要在Podfile里面添加AFNetworking
测试无误后需要将该项目添加并推送到远端仓库,并编辑podspec文件。
通过Cocoapods创建出来的目录本身就在本地的Git管理下,我们需要做的就是给它添加远端仓库,同样去GitHub或其他的Git服务提供商那里创建一个私有的仓库,拿到SSH地址,然后cd到项目目录,提交打tag
git add -A && git commit -m "1.0.0版本"
git remote add origin http://git.webtrn.cn/CoderTian/WTYNetworking.git
git push origin master
git tag '1.0.0'
git push --tags
做完这些就可以开始编辑podspec文件了,它是一个Ruby的文件,把编辑器的格式改成Ruby就能看到语法高亮,下面我贴上我的podspec文件,并在后面以注释的形式说明每个字段的含义,没有涉及到的字段可以去官方文档查阅
Pod::Spec.new do |s|
s.name = 'WTYNetworking'
s.version = '1.0.0'
s.summary = '私有网络请求库.'
s.description = <<-DESC
用于项目中的两种网络请求库
DESC
s.homepage = 'http://git.webtrn.cn/CoderTian/WTYNetworking'
s.license = { :type => 'MIT', :file => 'LICENSE' }
s.author = { 'CoderTian' => '[email protected]' }
s.source = { :git => 'http://git.webtrn.cn/CoderTian/WTYNetworking.git', :tag => s.version.to_s }
s.ios.deployment_target = '8.0'
s.subspec 'DDBNetworking' do |ddbNetworking|
ddbNetworking.source_files = 'WTYNetworking/Classes/DDBNetworking/**/*'
ddbNetworking.public_header_files = 'WTYNetworking/Classes/DDBNetworking/**/*.h'
ddbNetworking.dependency 'AFNetworking', '~> 3.1.0'
end
# s.frameworks = 'UIKit', 'MapKit'
end
编辑完podspec文件后,需要验证一下这个文件是否可用,如果有任何WARNING或者ERROR都是不可以的,它就不能被添加到Spec Repo中,不过xcode的WARNING是可以存在的,验证需要执行一下命令
pod lib lint
当你看到
-> WTYNetworking (0.1.0)
WTYNetworking passed validation.
时,说明验证通过了,不过这只是这个podspec文件是合格的,不一定说明这个Pod是可以用的,我们需要在本地做一下验证,这就是第四步的内容了,第四步在具体说明。
向Spec Repo提交podspec
向Spec Repo提交podspec需要完成两点一个是podspec必须通过验证无误,在一个就是删掉无用的注释(这个不是必须的,为了规范还是删掉吧)。 向我们的私有Spec Repo提交podspec只需要一个命令
pod repo push WTYNetworking WTYNetworking.podspec #前面是本地Repo名字 后面是podspec名字
完成之后这个组件库就添加到我们的私有Spec Repo中了,可以进入到~/.cocoapods/repos/WTYNetworking目录下查看
再去看我们的Spec Repo远端仓库,也有了一次提交,这个podspec也已经被Push上去了。
使用制作好的Pod
在完成这一系列步骤之后,我们就可以在正式项目中使用这个私有的Pod了只需要在项目的Podfile里增加以下一行代码即可
source 'http://git.webtrn.cn/CoderTian/WTYNetWorking.git' #私有库
source 'https://github.com/CocoaPods/Specs.git' #官方库
platform :ios, '8.0'
target 'TestTest' do
pod 'WTYNetworking'
end
然后执行pod update,更新库依赖,然后打开项目可以看到,我们自己的库文件已经出现在Pods子项目中的Pods子目录下了