Cocoapods静态库制作笔记

创建一个私有的podspec包括如下那么几个步骤:

1、创建并设置一个私有的Spec Repo。

Spec Repo?他是所有的Pods的一个索引,就是一个容器,所有公开的Pods都在这个里面,他实际是一个Git仓库remote端在GitHub上,但是当你使用了Cocoapods后他会被clone到本地的~/.cocoapods/repos目录下,可以进入到这个目录看到master文件夹就是这个官方的Spec Repo了。我们需要创建一个类似于master的私有Spec Repo,这里我们可以fork官方的Repo,也可以自己创建,因为你只是想添加自己的Pods,没有必要把现有的公开Pods都copy一份。所以创建一个Git仓库,这个仓库你可以创建私有的也可以创建公开的,不过既然私有的Spec Repo,还是创建私有的仓库吧,需要注意的就是如果项目中有其他同事共同开发的话,你还要给他这个Git仓库的权限。因为GitHub的私有仓库是收费的,我还不是GitHub的付费用户,所以我使用了其他Git服务,我使用的是CODING,当然还有其他的可供选择开源中国、Bitbucket以及CSDN。

创建完成之后在Terminal中执行如下命令:

$pod repo add SunbeamSpecs https://github.com/sunbeamChen/SunbeamSpecs.git

如果成功的话进入到~/.cocoapods/repos目录下就可以看到SunbeamSpecs这个目录了。

2、创建Pod的所需要的项目工程文件,并且有可访问的项目版本控制地址。

如果你的组件还在你冗余庞大的项目中,需要拆分出来或者需要自己从零开始创建一个组件库,那么我建议你使用Cocoapods提供的一个工具来做。现在来说一下这个工具,拿我创建的SunbeamLib为例具体讲一下这里是如何操作的,先cd到要创建项目的目录然后执行如下命令:

$pod lib create SunbeamLib

之后他会问你四个问题,1.是否需要一个例子工程;2.选择一个测试框架;3.是否基于View测试;4.类的前缀;4个问题的具体介绍可以去看官方文档,我这里选择的是1.yes;2.Specta/Expecta;3.yes;4.PTL。 问完这4个问题他会自动执行pod install命令创建项目并生成依赖。

3、创建Pod所对应的podspec文件。

如果从第二步过来,已经有了现成的项目,那么就需要给这个项目创建一个podspec文件,创建它需要执行Cocoapods的另外一个命令:

$pod spec create SunbeamLib [email protected]:sunbeamChen/SunbeamLib.git

=====================以上如果是用cocoapods命令生成的项目则忽略

这里需要注意的是每当你向Pod中添加了新的文件或者以后更新了podspec的版本都需要重新执行一遍pod update命令。

测试无误后需要将该项目添加并推送到远端仓库,并编辑podspec文件。

通过Cocoapods创建出来的目录本身就在本地的Git管理下,我们需要做的就是给它添加远端仓库,同样去GitHub或其他的Git服务提供商那里创建一个私有的仓库,拿到SSH地址,然后cd到PodTestLibrary目录执行如下命令:

$git add .

$git commit -s -m"Initial Commit of SunbeamLib"

$git remote add origin [email protected]:sunbeamChen/SunbeamLib.git      #添加远端仓库,如果第二次提交代码时,不需要执行该步骤

$git push origin master       #提交到远端仓库

因为podspec文件中获取Git版本控制的项目还需要tag号,所以我们要打上一个tag,执行如下命令:

$git tag -m"first release"0.1.0

$git push --tags       #推送tag到远端仓库

做完这些就可以开始编辑podspec文件了:

#

# Be sure to run `pod lib lint SunbeamLib.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= 'SunbeamLib'

s.version= '0.1.0'

s.summary= 'SunbeamLib Test.'

# 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= <<-DESC

TODO: Add long description of the pod here.

DESC

s.homepage= 'https://github.com/sunbeamChen/SunbeamLib'

# s.screenshots= 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'

s.license= { :type => 'MIT', :file => 'LICENSE' }

s.author= { 'chenxun' => '[email protected]' }

s.source= { :git => 'https://github.com/sunbeamChen/SunbeamLib.git', :tag => s.version.to_s }

# s.social_media_url = 'https://twitter.com/'

s.ios.deployment_target = '7.0'

s.requires_arc = true

s.source_files = 'SunbeamLib/Classes/**/*'

#s.resource_bundles = {

#'SunbeamLib' => ['SunbeamLib/Assets/*.png']

#}

s.public_header_files = 'SunbeamLib/Classes/**/*.h'

s.frameworks = 'UIKit', 'MapKit'

s.dependency 'AFNetworking', '~> 2.3'

end

4、本地测试配置好的podspec文件是否可用。

编辑完podspec文件后,需要验证一下这个文件是否可用,如果有任何WARNING或者ERROR都是不可以的,它就不能被添加到Spec Repo中,不过xcode的WARNING是可以存在的,验证需要执行一下命令:

$pod lib lint

-> SunbeamLib(0.1.0)

SunbeamLib passed validation.

当你看到如上打印时,说明验证通过了,不过这只是这个podspec文件是合格的,不一定说明这个Pod是可以用的,我们需要在本地做一下验证,进入Example程序,执行pod install命令安装依赖,在项目中编写代码,测试库文件无误后就可以开始下一步了。

5、向私有的Spec Repo中提交podspec。

向Spec Repo提交podspec需要完成两点一个是podspec必须通过验证无误,在一个就是删掉无用的注释(这个不是必须的,为了规范还是删掉吧)。 向我们的私有Spec Repo提交podspec只需要一个命令:

$pod repo push SunbeamSpecs SunbeamLib.podspec       #前面是本地Repo名字 后面是podspec名字

完成之后这个组件库就添加到我们的私有Spec Repo中了,可以进入到~/.cocoapods/repos/SunbeamSpecs目录下查看

再去看我们的Spec Repo远端仓库,也有了一次提交,这个podspec也已经被Push上去了。

至此,我们的这个组件库就已经制作添加完成了,使用pod search命令就可以查到我们自己的库了。

6、在个人项目中的Podfile中增加刚刚制作的好的Pod并使用。

在完成这一系列步骤之后,我们就可以在正式项目中使用这个私有的Pod了只需要在项目的Podfile里增加以下一行代码即可:

$pod'PodTestLibrary','~> 0.1.0'

7、更新维护podspec。

参考:http://blog.wtlucky.com/blog/2015/02/26/create-private-podspec/

你可能感兴趣的:(Cocoapods静态库制作笔记)