【cocoaods】组件化

关于创建私有Cocoapods仓库和组件化项目的资料网上已经很多了,这里我们就不再讲解。这里主要是对根据各方面资料的操作的大体流程进行记录以及重点标记一些需要注意的细节。


开始正文,这里我们将组件化项目分为两步:

  • 1.生成对应的.podspec配置文件;
  • 2.将.podspec配置文件push到Cocoapods私有仓库中;
1.创建pods工程 配置.podspec文件

cocoapods官方建议我们使用pods工程项目创建.podspec配置文件,因为这样可以让我们在Demo中检测.podspec文件和涉及到的class(依赖库代码文件)的代码功能是否正常。

  • 创建名字为MyLibary的pods工程项目
    pod lib create MyLibary
    中间会要求做一些命令选择,如:是否创建Demo工程等,具体见官方手册这里我们没有选择Demo工程,生成的pods工程目录如下:
【cocoaods】组件化_第1张图片
pods.png

这里每次在Class中引入或更新了代码后,如果引入了Demo工程,要在Demo工程中使用的话,需要先cd到Demo工程中,进行pod update pod install操作。

对应的文件夹目录如下:

【cocoaods】组件化_第2张图片
文件夹目录.png
  • 修改.podspec配置文件
    使用了上一步创建pods工程,.podspec文件就自动生成了,这一点跟网上大多数直接创建.podspec文件略有不同,请注意。
    首先我们打开.podspec文件:
【cocoaods】组件化_第3张图片
podspec.png

.podspec文件使用的Ruby语言,具体的参数含义请查看官方手册,这大部分参数已经自动配置好了,但是仍然需要特别小心。红色标注的部分代表了重点注意,其中s.homepage和s.source代码了cocoapods获取依赖库代码文件的路径,必填
将下方创建的代码托管仓库的gitHub地址填入s.homepages.source,如图所示:

【cocoaods】组件化_第4张图片
�修改配置文件.png

在自己公司的git上创建一个依赖库代码文件托管的仓库,.podspec会根据s.source找到这个仓库,来拉去依赖库。为了方便,这里我们选择在gitHub上建仓库讲解。但是你不能这么做,除非你想公开公司的代码文件。

  • 创建名字为Components的代码托管仓库;
【cocoaods】组件化_第5张图片
�代码托管.png
  • 拉取仓库到本地;
    # git clone [仓库地址]
【cocoaods】组件化_第6张图片
克隆仓库.png
  • 制作完成后将需要托管的代码文件拷贝到到git托管仓库中
【cocoaods】组件化_第7张图片
git托管库.png
  • �推送托管库:
    cd到git托管库中
    • 打版本号
      # set the new version to 0.1.0
      # set the new tag to 0.1.0
    • 验证.podspec配置文件是否正确:必须验证通过
      # pod lib lint
      以上两步也可在pods项目中进行。
    • 本地托管git库上传到gitHub仓库
      # git add -A && git commit -m "Release 0.1.0"
      # git tag '0.1.0'
      # git push --tags
      # git push origin master
    • 验证是否可以根据配置文件正确拉去依赖库
      # pod spec lint
      验证都通过,即表示我们的依赖库已经制作完成,接下来只要把配置文件放到我们自制的spec库中即可。
2.将.podspec文件push到私有spec库中

接下来我们需要在自己服务器上建立类似Cocoapos官方的私有spec库,然后给小组成员分配管理权限。私有库的建立这里不再讲述,我建立的私有库名字叫做souFunsepec:

  • 根据souFunsepec仓库初始化本地spec依赖库
    # pod repo add [Private Repo Name] [git HTTPS clone URL]
    # pod repo add souFunsepec http://192.168.73.186:3500/userName/souFunSepec.git
  • 向spec仓库中添加.podspec配置文件
    cd到.podspec文件所在目录
    # pod repo push [Private Repo Name] [Private podspec Path]
    # pod repo push souFunsepec ./MyLibary.podspec
    推送成功我们可以到souFunsepec目录下查看
    # cd ~/.cocoapods

这里我们使用pod search命令是搜索不到私有库的,因为pod search是在cocopods官方的本地specs库下进行搜索。可以使用下面的方法在podfile中直接使用。

私有仓库的使用

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

【cocoaods】组件化_第8张图片
私有仓库使用.png

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

需要注意的是:

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

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

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

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

文中引用了Cocoapods官方的一些介绍以及王中周的cocopods更新篇中的一些步骤,开始使用中被坑了无限次,本文是在实际操作中结合以上参考文章中较容易迷糊的地方给出了操作步骤,有不全的地方,可以移步参考文章。

你可能感兴趣的:(【cocoaods】组件化)