我们知道Cocoapods有一个远程存放spec文件的公开库,第一次使用Cocoapods都会有一个相对缓慢的下载过程,即把远程公开库中的spec文件下载到本地,为什么下载过程时间很长是因为这个spec文件保存了大量的通过Cocoapods管理的公开库的信息,这个文件下载到本地一般存放在/Users/brian/Library/Caches/CocoaPods文件夹下
1. 如果我们想要创建一个和Cocoapods公开索引库相同级别的远程私有索引库,我们先得有一个地方存储远程私有索引库,所以我们先在码云上创建一个私有的仓库用来存储私有索引库。
2. 通过命令pod repo add XMLYSpec https://gitee.com/brianbryant/XMLYSpec.git
添加该远程仓库到本地存储私有spec的私有仓库
2.1. 通过命令pod repo
,我们可以查看本地全部存储spec文件的仓库
3. 接下来我们通过命令pod lib create XMLYExtensions
生成框架的一个模板库
3.1. 替换生成的模板中的Example中如下图所示的ReplaceMe.swift文件为框架文件,并通过pod install
安装测试
3.2. 由于该项目是swift项目,我们需要通过创建文件.swift-version为框架源码指定兼容的swift版本。
// .swift-version包含的内容
echo "4.0" >> .swift-version
3.3. 创建源码私有库
3.4. 修改XMLYExtensions.podspec文件内容,这里会用到源码私有库的地址
3.5. 验证podspec文件
- 通过命令
pod lib lint
验证本地Extensions.podspec文件有没有错误 - 通过命令
pod spec lint
远程验证:一般这个时候我们还没有在远程仓库里创建发布版本(也就是打标签),所以.podspec中的s.source会验证失败(本地不会验证该行), 导致以下错误。
-> Extensions (0.1.0)
- ERROR | [iOS] unknown: Encountered an unknown error ([!] /usr/bin/git clone https://gitee.com/brianbryant/XMLYExtensions.git /var/folders/2f/d9rcp68x2pn18vfx6zb2jpgh0000gp/T/d20180507-10675-isi09a --template= --single-branch --depth 1 --branch 0.1.0
Cloning into '/var/folders/2f/d9rcp68x2pn18vfx6zb2jpgh0000gp/T/d20180507-10675-isi09a'...
warning: Could not find remote branch 0.1.0 to clone.
fatal: Remote branch 0.1.0 not found in upstream origin
) during validation.
Analyzed 1 podspec.
[!] The spec did not pass validation, due to 1 error.
4. 这个时候我们需要往远程仓库上传框架源码
git remote add origin https://gitee.com/brianbryant/XMLYExtensions.git
git add .
git commit -m "初始化框架模板"
git push origin master
4.1. 接下来给框架源码的第一个版本打标签
git tag 0.0.1// 保证版本号和.podspec文件中的版本号一致
git push --tags 或 git push origin 0.0.1
//删除指定tag
git tag -d 0.0.1
git push origin :0.0.1
4.2. 再次远程验证:pod spec lint
,会发现已经验证成功了
➜ XMLAExtensions git:(master) pod spec lint
-> XMLAExtensions (0.1.0)
Analyzed 1 podspec.
XMLAExtensions.podspec passed validation.
5. 然后执行命令:pod repo push FMSpec Extensions.podspec
把当前目录的.podspec文件push到本地的Cocoapods的私有索引分支XLMYSpec上,然后上传到远程私有索引仓库中XMLYSpec中
➜ XMLYExtensions git:(master) pod repo push XMLYSpec XMLYExtensions.podspec
Validating spec
-> XMLYExtensions (0.1.0)
Updating the `XMLYSpec' repo
Your configuration specifies to merge with the ref 'refs/heads/master'
from the remote, but no such ref was fetched.
Adding the spec to the `XMLYSpec' repo
- [Add] XMLYExtensions (0.1.0)
Pushing the `XMLYSpec' repo
5.1. 使用XCode打开XMLYExtensions模板中的Example,使用命令pod repo
查看本地全部私有存储spec的仓库
➜ XMLYExtensions git:(master) pod repo
master
- Type: git (master)
- URL: https://github.com/CocoaPods/Specs.git
- Path: /Users/brian/.cocoapods/repos/master
taobao-baichuansdk-alibcspecs
- Type: git (master)
- URL: http://repo.baichuan-ios.taobao.com/baichuanSDK/AliBCSpecs.git
- Path: /Users/brian/.cocoapods/repos/taobao-baichuansdk-alibcspecs
XMLYSpec
- Type: git (master)
- URL: https://gitee.com/brianbryant/XMLYSpec.git
- Path: /Users/brian/.cocoapods/repos/XMLYSpec
5.2. 在Example工程的Podfile文件中新增
# 官方Cocoapods公开spec文件路径
source 'https://github.com/CocoaPods/Specs.git'
# 自己的私有索引库路径
source 'https://gitee.com/brianbryant/XMLYSpec.git'
# 指定工程系统版本
platform :ios, '10.0'
use_frameworks!
target 'XMLYExtensions_Tests' do
pod 'XMLYExtensions'
end
5.3. 对Example工程执行pod install
命令
注意:
- 命令做事情的顺序应该是先把XMLYExtensions.podspec文件添加到本地私有存储spec的仓库XMLYSpec,然后把XMLYSpec中的XMLYExtensions.podspec文件push到远程私有仓库XMLYSpec.git中
相关源码:XMLYSpec、XMLYExtensions