• CocoaPods 详解之----更新篇


    CocoaPods 大概是 2011 年出现的开源组件管理工具(目前已支持 Objective-C 和 Swift),近年来普及率越来越高,几乎已是所有 Cocoa 开源项目的标配。另外,很多大点的团队会用 CocoaPods 拆分工程,实现项目插件化。

    博主曾在 2014 年写过 CocoaPods 详解 系列文章:CocoaPods详解之——使用篇CocoaPods详解之——进阶篇CocoaPods详解之——制作篇,简单介绍了从使用到亲手制作 CocoaPods 开源组件的过程。

    然而随着时间的推移,CocoaPods 有些使用方式也发生了变化,比如组件提交方式等。本文将从 Trunk 和私有仓库两个方面介绍自己对 CocoaPods 的新认识。

    一、Trunk 方式提交开源组件

    从 CocoaPods 0.33 版本开始,CocoaPods 将组件的提交从 Pull requests 变成了自动化的 Trunk 方式。Trunk 提交方式有以下步骤:

    1、向 Trunk 注册自己的电脑

    首次使用 Trunk 时,需要注册自己的电脑:

    1
    2
    
    # pod trunk register [E-mail] [User Name]
    $ pod trunk register foggry@foggry.com "foggry"

    执行命令以后,上述邮箱会收到一封验证邮件,按照邮件说明打开制定的链接,注册流程就完成了。

    注册流程完成后,可以使用命令:

    1
    
    $ pod trunk me

    可以检验注册结果,如果输出:

    1
    2
    3
    4
    5
    6
    
    - Name:     foggry
    - Email:    foggry@foggry.com
    - Since:    May 19th, 2014 16:03
    - Pods:     None
    - Sessions:
    - March 19th, 22:23 - July 25th, 22:26. IP: 10.1.1.1

    则说明注册成功。

    2、提交组件

    准备好 podspec 文件后,首先要检查其合法性:

    1
    2
    
    # Enter podspec path
    $ pod lib lint

    解决完错误和警告后,会显示以下内容:

    1
    2
    3
    
    -> FGMarqueeView (1.0.0)
    
    FGMarqueeView passed validation.

    这就说明验证可以提交了。

    执行提交命令:

    1
    
    $ pod trunk push WZMarqueeView.podspec

    如果顺利的话,会输出以下内容:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    
    Updating spec repo `master`
    
    Validating podspec
    -> WZMarqueeView (2.0.0)
    
    Updating spec repo `master`
    
    - Data URL: https://raw.githubusercontent.com/CocoaPods/Specs/1f2d70d978843a29cbe17b2476ffed8204eea6ef/Specs/WZMarqueeView/2.0.0/WZMarqueeView.podspec.json
    - Log messages:
    - March 21st, 00:49: Push for `WZMarqueeView 2.0.0' initiated.
    - March 21st, 00:49: Push for `WZMarqueeView 2.0.0' has been pushed (2.327208585 s).

    仅需要这一条命令,开源组件就被推送到 CocoaPods 主仓库中了。可以执行以下命令验证下:

    1
    
    $ pod search WZMarqueeView

    输出为:

    1
    2
    3
    4
    5
    6
    
    -> WZMarqueeView (2.0.0)
    A marquee view used on iOS.
    pod 'WZMarqueeView', '~> 2.0.0'
    - Homepage: https://github.com/wangzz/WZMarqueeView
    - Source:   https://github.com/wangzz/WZMarqueeView.git
    - Versions: 2.0.0, 1.0.0 [master repo]

    说明组件 WZMarqueeView 已经成功从 1.0.0 升级成了 2.0.0 版本。

    3、其它说明

    • 权限声明

    在执行下述命令时:

    1
    
    $ pod trunk push WZMarqueeView.podspec

    提示了以下错误:

    1
    2
    3
    4
    5
    6
    
    Updating spec repo `master`
    
    Validating podspec
    -> WZMarqueeView (2.0.0)
    
    [!] You are not allowed to push new versions for this pod.
    

    原来,Trunk 要求只有组件所有者和开发者才能更新已有组件,而上例的组件 WZMarqueeView 是 2014 年通过 Pull requests 方式上传到 CocoaPods 主仓库的,并没有声明过所有权。

    随后,到 CocoaPods 指定的网页:Claim your Pod上填写对应信息后,按照提示执行命令:

    1
    
    $ pod trunk info WZMarqueeView

    看到执行结果:

    1
    2
    3
    4
    5
    
    WZMarqueeView
    - Versions:
    - 1.0.0 (2014-05-19 22:03:59 UTC)
    - Owners:
    - foggry <foggry@foggry.com>

    组件的所有权已经变成了本人,此时再去执行 trunk push 命令时就正常了。

    • 为组件添加其它所有者

    一个组件可以通过以下命令,添加多个所有者(以邮箱为标识):

    1
    2
    
    # pod trunk add-owner [Module Name] [Owner E-mail]
    $ pod trunk add-owner WZMarqueeView kyle@cocoapods.org

    执行成功后,kyle@cocoapods.org 也变成了 WZMarqueeView 的所有者。

    • Pull requests 和 Trunk 对比

    对于开发者来说,Pull requests 的操作过程十分繁琐,需要开源组件制作者先 fork 一份主仓库,然后将组件提交到 fork 后的仓库,再 Pull requests 给 CocoaPods 主仓库的维护者;

    对 CocoaPods 主仓库的维护者来说,需要手工一个个处理主仓库的合并操作,通常第二天甚至需要更长时间 requests 才能被处理;

    而 Trunk 方式,开发者只需要一条命令就能将组件上传到主仓库,并且 Trunk 方式是自动化的,几乎不再需要主仓库的维护者做任何工作,实时性更好。

    另外,Trunk 增加了组件所有者的概念,非所有者无法提交组件的更新,这在一定程度上提高了 CocoaPods 的安全性。

    二、创建私有 CocoaPods 仓库

    目前所有支持 CocoaPods 的开源组件,都存储在 Github 上公共的 CocoaPods Specs 仓库中,这种方式有以下缺点:

    官方仓库过大,里面的绝大多数组件都不是我们需要的,你一定忘不了首次执行 pod install 操作时那无尽的等待;

    不能实现私有化,作为一个相当好用的组件管理工具,很多团队都使用 CocoaPods 实现庞大项目的组件化,都放在公共仓库肯定不行。

    这时就需要创建一个和 CocoaPods Specs 类似的私有组件存储仓库。私有仓库可以存放在自家公司的 Git 服务器上,也可以放在各大支持私有仓库的 Git 平台上,下面以支持免费私有仓库的 coding.net为例说明 CocoaPods 私有仓库的创建过程。

    1、创建coding.net私有仓库

    按照 coding.net 官网提示创建一个私有仓库即可。

    2、本地初始化组件仓库

    执行以下命令:

    1
    2
    
    # pod repo add [Private Repo Name] [GitHub HTTPS clone URL]
    $ pod repo add FGSpecs https://git.coding.net/foogry/FGSpecs.git

    3、向仓库中添加组件

    将事先准备好的组件添加到仓库中,组件可以存放在本地,也可以放在自家或网上的代码托管平台。执行以下命令:

    1
    2
    
    # pod repo push [Private Repo Name] [Private podspec Path]
    $ pod repo push FGSpecs ~/Desktop/FGMarqueeView.podspec

    执行成功以后,会有以下输出:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    
    Validating spec
    
    -> FGMarqueeView (0.1.0)
    
    Updating the `FGSpecs' repo
    
    Already up-to-date.
    
    Adding the spec to the `FGSpecs' repo
    
    - [Fix] FGMarqueeView (0.1.0)
    
    Pushing the `FGSpecs' repo
    
    To git@git.coding.net:foogry/FGSpecs.git
    e2ad499..31a1a8e  master -> master

    至此,本地和代码托管平台上的私有仓库 FGSpecs 中就都已经添加了私有组件 FGMarqueeView。

    4、使用私有仓库中的组件

    Podfile 文件中默认情况下已经隐式使用 source 声明了 CocoaPods 的官方仓库。但使用私有组件,需要使用 source 关键字鲜显式声明组件所在仓库:

    1
    2
    3
    4
    5
    6
    7
    8
    
    # Private Specs
    source 'https://git.coding.net/foogry/FGSpecs.git'
    
    # Public Specs
    source 'https://github.com/CocoaPods/Specs.git'
    
    pod 'FGMarqueeView', '~> 0.1.0'
    pod 'SBJson', '~> 4.0.0'

    其中,SBJson 组件是官方仓库的,FGMarqueeView 组件属于我们刚创建的私有仓库。

    需要注意的是:

    • 官方仓库的显式声明

    尽管官方仓库会被隐式声明,如果同时使用了官方仓库和私有仓库,就需要同时声明二者。

    • 仓库声明顺序性

    先声明的仓库具有优先权。当先后引用的两个仓库中都包含同一个组件时,会使用先引用仓库中的,哪怕后引用的仓库中版本号更高。

    5、直接使用私有组件

    如果不想创建私有仓库,也可以在 Podfile 里直接引用私有组件(组件可以是本地的,也可以是托管在自家公司服务器或网上的代码托管平台上的),引用的同时还可以制定具体的 commit、branch 或者 tag,比如:

    1
    
    $ pod 'FGMarqueeView', :git => 'https://git.coding.net/foogry/FGMarqueeView.git', :commit => 'b4dc0ffee'

    这种方式引用的组件在执行完 pod install 以后,会被添加在 Development Pods 目录下,而通过私有仓库或共有仓库方式引用的组件则会被添加在 Pods 目录下。

    三、cocoapods 版本管理

    cocoapods 升级新版本后可能会遇到坑,因此就有了降级的需求。

    • 查看当前版本
    1
    
    sudo gem list cocoapods
    • 卸载当前版本
    1
    
    sudo gem uninstall cocoapods
    • 安装指定版本
    1
    
    sudo gem install cocoapods -v 0.39.0

    四、参考文档

    转自:http://foggry.com/blog/2016/03/23/cocoapods-xiang-jie-zhi-geng-xin-pian/

  • 相关阅读:
    Android开源项目发现---TextView,Button篇(持续更新)
    Android 性能分析案例
    Android如何正确的保存文件
    注意android裁图的Intent action
    UI设计师的 Android 备忘录
    添加Fragment注意事项
    在 ActionBar 添加刷新按钮
    显示 SQLite 日志
    MySQL数据库的自动备份与数据库被破坏后的恢复(2)
    MySQL数据库的自动备份与数据库被破坏后的恢复1
  • 原文地址:https://www.cnblogs.com/feiyu-mdm/p/6568168.html
Copyright © 2020-2023  润新知