美文网首页iOS进阶之路第三方
使用CocoaPods打造 --- 远程私有库

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

作者: _Joeyoung_ | 来源:发表于2018-04-20 19:28 被阅读106次

    上一次写了《使用 CocoaPods 打造 --- 第三方库》,我们可以通过该方式发布像 AFNetWorkingSDWebImage 等的第三方库,供广大开发者使用。该类型的库是公开的,面向大众的!
    如果我们项目需要组件化,但是又不想让源码库公布与众,那该怎么办呢?

    办法总比困难多,今天就带大家一步步实现自己的远程私有库~

    远程私有库原理

    先来看我的神图:

    重复的内容这里就不再阐述了,可以翻阅我的上篇文章 -> 戳这里

    原理分析:
    • 当我们执行 $ 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 私有库。

    解决方法:

    • 添加我们远程私有索引库的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 ~

    千里之行,始于足下。

    相关文章

      网友评论

        本文标题:使用CocoaPods打造 --- 远程私有库

        本文链接:https://www.haomeiwen.com/subject/ilxzkftx.html