iOS开发程序员征服iOS

CocoaPods 私有库配置

2017-03-27  本文已影响135人  Jabir_Zhang

前情提要

看了好多网上的CocoaPods私有库配置,看的是一知半解,写的都不是很详细,还是需要自己实际操作。实践是检验真理的唯一标准。在这里,我把最正确最详细的步骤展示给大家。因为私有库的配置对项目模块化具有很大的作用,具体有多大的好处和作用,可能会在文章的最后也可能后续文章会说到,现在开始我们的私有库配置,也是我将项目模块化的第一步。
官方文档 中文翻译

第一步 创建一个私有的仓库

也就是创建本地repo

首先在你的服务器上创建一个仓库。可以是在Github上或者是你自己的服务器如下

$ cd /opt/git
$ mkdir Specs.git
$ cd Specs.git
$ git init --bare

第二步 添加你的私有库到你的CocoaPods中

使用你服务器上的仓库的URL,添加你的仓库使用:

$ pod repo add Repo_Name SOURCE_URL

Repo_Name:你自己取得私有库的名字
SOURCE_URL:是你第一步创建私有库的URL地址

成功后,你可以额检查是否成功安装,通过

$ cd ~/.cocoapods/repos/REPO_NAME
$ pod repo lint .
验证成功如图

第三步 创建我们的私有库中的自定义Library

通过CocoaPods为我们提供的模板,可以自动创建一个项目,供我们创建自定义Lib

pod lib create MyLibrary

MyLibrary:是自定义Lib的名字,自取

可以使用自己的模板,因为这句命令其实是缩写,其完整应该是 pod lib create MyLibrary --template-url= https://github.com/cocoapods/pod-template,可以把=后面的URL替换成你自己的模板URL,不过我想几乎没人会用自己的模板吧(应该不会打脸吧,反正我用的是默认的)。

然后会问你一些问题来完成默认的配置。第一个问题是邮箱:

What is your email?
 > XXXX@163.com

然后接下来的一系列问题

XXXXXX$ pod lib create QGGImagePicker
Cloning `https://github.com/CocoaPods/pod-template.git` into `QGGImagePicker`.
Configuring QGGImagePicker template.
------------------------------
To get you started we need to ask a few questions, this should only take a minute.
If this is your first time we recommend running through with the guide: 
 - http://guides.cocoapods.org/making/using-pod-lib-create.html
 ( hold cmd and double click links to open in a browser. )
What language do you want to use?? [ ObjC / Swift ]
 > ObjC
Would you like to include a demo application with your library? [ Yes / No ]
 > Yes
Which testing frameworks will you use? [ Specta / Kiwi / None ]
 > Specta
Would you like to do view based testing? [ Yes / No ]
 > Yes
What is your class prefix?
 > QGG

第一个问题是你用的什么语言,不多说了。
第二个问题是问你要不要包含一个Demo,来测试你的Library。有了这个demo后,你可以用pod try MyLib获取到能测试你Library的Demo。
第三个问题是让你选择一个测试的framework,保证你的library的稳定性。官方推荐Specta。
第四个问题是问你是否要基于视图的测试。
第五个问题,让你所有的Class加上一个前缀。

直接回车会选择选项中带下划线也就是默认项。

然后将你的Lib代码放入到模板项目中,文件路径参照下图:

文件路径参照图

非常重要的一点

先声明我是这样操作的,网上并没有看到接下来的操作,都非常跳跃,说的很少。

我将项目复制出来,是打开项目,将里面的文件夹复制出来,如下图:

复制这些文件

!!!!注意:不是在最外层将整个项目文件夹复制出来,因为是用模板自动生成出来的,所以细心的同学会发现这个项目中有自动生成的.git、.gitignore隐藏文件!!!!

隐藏文件见此图

我一开始的时候直接在github上建了个Lib的Repository,然后直接check out 到本地,然后将模板自动生成项目到Lib的工作目录,发现根本没发现文件有修改,没东西上传到github。所以问题出在了通过模板自动生成的项目对应提交的git目录也指向了生成时的模板URL。我开始还费解怎么没法上传修改后的代码,搞了半天问题出在这,坑死爹了!!!

恩,发现问题后就感觉如履平地。然后按照我上面所说的复制出来文件到check out出来的目录,然后就能上传代码到git了,注意打个tag,原因看下面一段,

你会在项目里看到一个后缀名为.podspec的文件,这个文件很重要,这是Lib的Pod配置文件。打开,很多工具可以打开,我用的是Sublime Text。打开大致是这样的内容

Pod::Spec.new do |s|
  s.name             = 'MyLibrary'
  s.version          = '0.1.0'
  s.summary          = 'Test of MyLibrary.'
  s.description      = <<-DESC
TODO: Add long description of the pod here.
                       DESC

  s.homepage         = 'https://github.com/jiabibi888/MyLibrary'

  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'jiabibi888' => 'zhangjiabi9149@163.com' }
  s.source           = { :git => 'https://github.com/jiabibi888/MyLibrary.git', :tag => s.version.to_s }

  s.ios.deployment_target = '8.0'

  s.source_files = 'MyLibrary/Classes/**/*'
  
end

默认出来就是这样,配置文件基本已经没问题了,不用自己再参照官方语法写了。接下来解释为什么要打一个tag,你会看到第二个参数s.version = '0.1.0',这个版本你可以修改,是用来标注你Lib版本的。以tag=0.1.0为例,然后往下看 s.source = { :git => 'https://github.com/jiabibi888/MyLibrary.git', :tag => s.version.to_s },它会通过tag去取资源,所以你需要打一个tab,不然获取不到代码资源。

就像上面说的配置文件基本已经没问题,你只要注意看下s.homepage = 'https://github.com/jiabibi888/MyLibrary'和s.source = { :git => 'https://github.com/jiabibi888/MyLibrary.git', :tag => s.version.to_s }中的URL是否正确,即可。可用pod lib lint 和 pod spec lint来验证你的podspec文件是否正确。两个指令的不同点在于pod lib lint不用访问网路,而pod spec lint检查外部repo和相关标签。

下面是是用pod spec lint命令来验证的具体情况:

$ pod spec lint

 -> MyLibrary (0.1.0)

Analyzed 1 podspec.

MyLibrary.podspec passed validation.

好,到这一步,你的Lib创建已经成功。

第四步 添加你的Podspec到你的仓库

确定你已经给你的代码资源打上tag和版本,然后运行

$ pod repo push REPO_NAME SPEC_NAME.podspec

成功以后是这样的情况:

$ pod repo push TestSpec MyLibrary.podspec

Validating spec
 -> MyLibrary (0.1.0)

Updating the `TestSpec' repo

Already up-to-date.

Adding the spec to the `TestSpec' repo

 - [Add] MyLibrary (0.1.0)

Pushing the `TestSpec' repo

To https://github.com/XXXX/TestSpec.git
   a63caee..dd11098  master -> master

Congratulations!!!

自此,一个你自定义的Lib成功加入到了你的私有库中。

可以将私有库中的.podspec文件转成.json

$ pod ipc spec MyLibrary.podspec >> MyLibrary.podspec.json

支持CocoaPods公开库

https://github.com/CocoaPods/Specs.git 下fork一份

上一篇下一篇

猜你喜欢

热点阅读