使用CocoaPods打造 --- 远程私有库

上一次写了 《使用 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/'

  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 ~

千里之行，始于足下。