正文
创建版本库(repo)
首先,创建一个像master一样的存放版本描述文件的git仓库,因为是私人git仓库,我们选择oschina创建远程私有仓库(因为是免费的)或者也可以在GitHub上创建($7/month)。
下面以oschina为例
创建版本描述仓库
回到终端,将这个远程的私有版本仓库添加到本地,repo就是 repository 储存库的缩写。
$ pod repo add MyRepo https://git.oschina.net/baiyingqiu/MyRepo.git
查看在 Finder 目录~/.cocoapods/repos, 可以发现增加了一个 MyRepo 的储存库
创建代码库
回到oschina创建私人代码库
创建时添加MIT License和README
将仓库克隆到本地,添加你的代码文件、仓库名.podspec描述文件,还有.swift-version.
如下
.swift-version文件用来知道swift版本,用命令行创建
$echo"3.0"> .swift-version
.podspec文件是你这个代码库的pod描述文件,可以通过pod指令创建空白模板:
$ pod spec create KTVRoomThirdPart
或者强烈建议直接拷贝下面的模板进行修改
Pod::Spec.newdo|s|s.name ="KTVRoomThirdPart"# 项目名称s.version ="0.0.1"# 版本号 与 你仓库的 标签号 对应s.license ="MIT"# 开源证书s.summary ="私人pod代码"# 项目简介s.homepage ="https://git.oschina.net/baiyingqiu/KTVRoomThirdPart"# 仓库的主页s.source = {:git=>"https://git.oschina.net/baiyingqiu/KTVRoomThirdPart.git",:tag=>"#{s.version}"}#你的仓库地址,不能用SSH地址s.source_files ="KTVRoomThirdPart/*.{h,m}"# 你代码的位置, BYPhoneNumTF/*.{h,m} 表示 BYPhoneNumTF 文件夹下所有的.h和.m文件s.requires_arc =true# 是否启用ARCs.platform =:ios,"7.0"#平台及支持的最低版本# s.frameworks = "UIKit", "Foundation" #支持的框架# s.dependency = "AFNetworking" # 依赖库# Users.author = {"BY"=>"qiubaiyingios@163.com"}# 作者信息s.social_media_url ="http://qiubaiying.github.io"# 个人主页end
这里我要说一下一个坑,用oschina创建私人仓库时, 在验证时可能会找不到MIT LICENSE证书,将其中的
s.license ="MIT"修改为,指定文件s.license = { :type=>"MIT", :file=>"LICENSE"}
然后开始验证我们的仓库配置是否正确,并按照要求进行修改
$ pod lib lint
一般出现错误警告,需要添加--private或者--allow-warnings,就可以通过验证
$ pod lib lint --private --allow-warnings
验证成功后出现
->KTVRoomThirdPart(0.0.1)
KTVRoomThirdPartpassedvalidation.
将描述文件推送到版本库
将项目打上标签推到远程仓库,标签号 和 版本号对应 都是0.0.1
最后将我们的代码仓库的描述信息,push 到我们的版本仓库中
$ pod repo push KTVRoomRepo KTVRoomThirdPart.podspec --allow-warnings
这时会对远程仓库进行验证,成功的话就会在~/.cocoapods/repos/KTVRoomRepo中发现新增的仓库描述信息了
若是出现错误信息
[!] The repo`MyRepo`at`../.cocoapods/repos/KTVRoomRepo`isnotclean
更新下我们的版本库,
$ pod repo update MyRepo
再继续上传即可。
pod repo push MyRepo KTVRoomThirdPart.podspec的过程就是
验证KTVRoomThirdPart.podspec文件
拉取远程版本库MyRepo
添加KTVRoomThirdPart.podspec到版本库中
push 到远程
添加完成后我们就可以在pod中搜索
$ pod search KTVRoomThirdPart
-> KTVRoomThirdPart (0.0.1) Some categoryofthe framework and UIKit pod'KTVRoomThirdPart','~> 0.0.1'- Homepage: https://git.oschina.net/baiyingqiu/KTVRoomThirdPart- Source: https://git.oschina.net/baiyingqiu/KTVRoomThirdPart.git- Versions:0.0.1[MyRepo repo](END)
私人pod库的使用
使用私人pod库的需要在Podflie中添加这句话,指明你的版本库地址。
source‘https://git.oschina.net/baiyingqiu/MyRepo.git’
注意是版本库的地址,而不是代码库的地址,很多教程都把我搞晕了~
若有还使用了公有的pod库,需要把公有库地址也带上
source'https://github.com/CocoaPods/Specs.git'
最后的Podflie文件变成这个样子
source‘https://github.com/CocoaPods/Specs.git’source‘https://git.oschina.net/baiyingqiu/MyRepo.git’platform :ios,'8.0'target ‘MyPodTest’douse_frameworks!pod “BYPhoneNumTF”#公有库pod ‘KTVRoomThirdPart’#我们的私有库pod ‘BYAdditions’#这是我又添加到版本库中的另一个代码库end
测试:
$ pod install
加载完成可以看到代码已经整合到我们的项目中了
perfect!
回到Fender中~/.cocoapods/repos,会发现 repos 中增加了一个pod版本库。
执行pod install命令时
会拉取远程Podflie中source标记 版本库 到本地的 repos 文件夹中
在 版本库 中搜索我们pod ‘KTVRoomThirdPart’的KTVRoomThirdPart.podspec文件。
根据KTVRoomThirdPart.podspec文件中描述的源码地址下载并整合到项目中