上一次写了《使用 CocoaPods 打造 --- 第三方库》,我们可以通过该方式发布像
AFNetWorking
、SDWebImage
等的第三方库,供广大开发者使用。该类型的库是公开的,面向大众的!
如果我们项目需要组件化,但是又不想让源码库公布与众,那该怎么办呢?
办法总比困难多,今天就带大家一步步实现自己的远程私有库~
远程私有库原理
先来看我的神图:重复的内容这里就不再阐述了,可以翻阅我的上篇文章 -> 戳这里。
原理分析:
- 当我们执行
$ pod repo add 索引库名 索引库地址
指令之后,会将我们的远程私有索引库克隆到本地; - 图中紫色线路是我们上传
.podspec
索引文件的正确路径。当我们执行$ pod repo push 索引库名 .podsepc文件
指令时,pod会将我们的.podsepc
文件保存在本地索引库中,然后自动帮我们把该.podsepc
文件推送到我们的远程私有索引库中。
打造远程私有库:
(1):新建远程私有源码仓库和私有索引库。
a). 创建远程私有源码库。
仓库一定要是私有的,这里可以使用公司内网的Git、GitHub私有库(收费)、coding等代码托管平台。
此处我使用的是coding。
b). 创建远程私有索引库。
该仓库用来存放我们的.podSpec文件
(2):将远程私有索引库克隆到我们本地。
克隆远程私有索引库到本地:
// QYSpec :远程索引仓库名称
// https://git.coding.net... 远程索引仓库地址
$ pod repo add QYSpec https://git.coding.net/Joeyoung_/QYSpec.git
此时,我们的 CocoaPods
本地索引库就会多出一个我们刚才添加的仓库。
(3):使用 CocoaPods自动创建模板库存放我们的源码。
自动创建模板库可以 -> 戳这里查看。此处不是本文重点,不再阐述。
a). 创建模板库:
$ pod lib create QYBaseComponent
创建过程中的一些配置可以根据自己需要更改,我的如下:
b). 将我们的私有库源码放在
Classes
文件夹下:此处我的源码使用的是项目中的一些分类,只是为了演示使用。
c). 根据我们上面创建的远程私有源码库,修改我们的
.podSpec
文件。
#
# Be sure to run `pod lib lint QYBaseComponent.podspec' to ensure this is a
# valid spec before submitting.
#
# Any lines starting with a # are optional, but their use is encouraged
# To learn more about a Podspec see http://guides.cocoapods.org/syntax/podspec.html
#
Pod::Spec.new do |s|
s.name = 'QYBaseComponent'
s.version = '0.1.0'
s.summary = '基础组件'
# This description is used to generate tags and improve search results.
# * Think: What does it do? Why did you write it? What is the focus?
# * Try to keep it short, snappy and to the point.
# * Write the description between the DESC delimiters below.
# * Finally, don't worry about the indent, CocoaPods strips it!
s.description = "描述部分一定要比摘要部分长长长长。。。。"
s.homepage = 'https://coding.net/u/Joeyoung_/p/QYBaseComponent'
# s.screenshots = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
s.license = { :type => 'MIT', :file => 'LICENSE' }
s.author = { '你的姓名' => '你的邮箱' }
s.source = { :git => 'https://git.coding.net/Joeyoung_/QYBaseComponent.git', :tag => s.version.to_s }
# s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'
s.ios.deployment_target = '8.0'
s.source_files = 'QYBaseComponent/Classes/**/*'
# s.resource_bundles = {
# 'QYBaseComponent' => ['QYBaseComponent/Assets/*.png']
# }
# s.public_header_files = 'Pod/Classes/**/*.h'
# s.frameworks = 'UIKit', 'MapKit'
# s.dependency 'AFNetworking', '~> 2.3'
end
d). 使用Git上传我们的代码到远程私有源码库。
(此处一定要记得打上 tag
,否则后面的工作无法进行。)
(4):文件校验。
a). 先本地校验 .podspec 文件。
$ pod lib lint
此处表明本地验证通过
b). 远程校验 .podspec 文件。
$ pod spec lint
此处表明本地验证通过
(5):上传 .podSpec文件。
上传.podSpec文件。
// QYSpec :远程索引仓库库的名称
// QYBaseComponent.podspec : 我们的.podSpec文件
$ pod repo push QYSpec QYBaseComponent.podspec
此时已经上传成功了
上面的指令会先把
.podspec
文件添加到我们本地的索引库当中。
然后自动帮我们推送到了远端私有索引仓库。
此时我们的远程私有库就创建完成了。
安装私有库到项目中:
a). 搜索我们的私有库:
$ pod search QYBaseComponent
b). 将私有库复制到我们的Podfile文件中:
platform :ios, '8.0'
target 'TestDemo' do
use_frameworks!
pod 'QYBaseComponent', '~> 0.1.0'
end
c). 安装我们的Podfile
$ pod install
此时报错了,未能找到我们的
QYBaseComponent
私有库。
- 因为我们
Podfile
文件默认是根据 CocoaPods 官方索引库的URL下载源码的 https://github.com/CocoaPods/Specs.git; - 而我们的私有库是放在 https://git.coding.net/Joeyoung_/QYSpec.git 这里的。
解决方法:
- 添加我们远程私有索引库的URL到
Podfile
文件中; - 添加 CocoaPods 官方索引库的URL到
Podfile
文件中。(如果不添加,则所有资源会去我们的远程私有索引库中找,导致那些放在官方索引库中的资源会找不到。)
// 查询我们本地索引库信息
$ pod repo
将我们需要的索引库URL复制到
Podfile
文件中:
# master
source 'https://github.com/CocoaPods/Specs.git'
# QYSpec
source 'https://git.coding.net/Joeyoung_/QYSpec.git'
platform :ios, '8.0'
target 'TestDemo' do
use_frameworks!
pod 'QYBaseComponent', '~> 0.1.0'
end
从新执行 pod install
命令:
此时已经安装成功了。
d). 通过 .xcworkspace
打开工程。
看到我们的私有库已经成功安装到项目中了,just do it ~
千里之行,始于足下。
网友评论