iOS开发之Cocoapods的使用与私有pod的制作

0.168字数 3365阅读 3454

一、安装cocoaPods

第一步:升级ruby环境

sudo gem updte --system

若更新Ruby环境错误

sudo gem update -n /usr/local/bin --system

然后就可以进行cocoapods的安装了。

第二步:更换淘宝的RubyGems镜像代替官方版本,

1.移除官方的镜像

gem source --remove https://rubygems.org/

2.更换淘宝镜像

gem source -a https://ruby.taobao.org/

3.验证是否更换成功

gem sources -l

如果出现以下结果,说明更新成功

*** CURRENT SOURCES ***
https://ruby.taobao.org/

第三步:安装cocoapods

1.安装cocoapods

sudo gem install -n /usr/local/bin cocoapods

2.从cocoapods specs repository复制到~/.cocoapods目录下

pod setup

现在这个repo文件夹大概有750M,所以下载起来非常慢,如果你等的比较着急,想看一下当前下载的大小。

cd ~/.cocoapods(进入cocoapods文件夹)
du -sh *(查看当前文件夹大小)

至此cocoapods安装完成了。

二、使用cocoapods

1.进入工程对应的文件夹

cd YourApplication

2.创建一个podfile

pod init
或者使用
vim Podfile

它们之间的区别就是pod init生成的Podfile会默认帮我们生成一些代码,而vim PodfilePodfile是空的。

3.编写podfile

第一行:你的平台+你支持的版本

platform: ios, '8.0'

第二行:必须写上你所连接的Xcode target,这个一般就是你App的工程的名称

target 'MyApplication' do

最后一行:end

end

第三行-最后第二行:

pod 'podname'

那么如何搜索官方三方库呢?

pod search + '$podname'

如何从本地添加私有三方库呢?(如何创建私有三方库呢?)

//1.从本地文件夹添加
pod ’Alamofire’, :path => ‘~/Documents/Alamofire'

//2.从主分支添加
pod ‘Alamofire’, :git => ’https://github.com/Alamofire/Alamofire.git'

//3.从次分支添加
pod'Alamofire',:git=>'https://github.com/Alamofire/Alamofire.git',:branch=>'dev'

//4.用指定的tag
pod'Alamofire',:git=>'https://github.com/Alamofire/Alamofire.git',:tag=>'3.1.1'

//5.用指定的commit
pod'Alamofire',:git=>'https://github.com/Alamofire/Alamofire.git',:commit=>'0f506b1c45'

那么如何三方库的版本呢?

'> 0.1'   :高于0.1的版本
'>=0.1'   :0.1版本或者更高的版本
'<0.1'    :小于0.1的版本
'<=0.1'   :0.1版本或者更低的版本
'~> 0.1.2':版本0.1.2~版本0.2,不包括0.2
'~> 0.1'  :版本0.1~版本1.0,不包括版本1.0

4.执行pod install.

pod install 

初始化完成,然后打开YourApplication.xcworkspace就可以了。

5.pod update 和 pod install的区别

大部分人第一次初始化podfile的时候会用pod install,之后就一直用pod update

那么我们到底该怎么用他们呢,他们的之间的区别是什么呢?

pod install:每次如果下载新的pods的时候,都会把版本的信息写进podfile.lock中,podfile.lock会追踪这些版本,并且锁定这些版本。当你用这个命令的时候,他只会下载Podfile.lock中不存在的三方库。他也只会去下载Podfile.lock中记录的版本,而不会是检测一个更新的版本。如果没有Podfile.lock中没有指定版本,他会去搜索Podfile文件中对应的版本,如果不指定版本,默认为最新版本。

pod update:会直接去找最新的三方库,而不会去管Podfile.lock中的版本,他会一直下载最新版本,如果你指定了版本,他会下载你指定版本中最新的版本。如果使用 pod update,那么他会将你 Podfile中的所有三方库都更新成最新的版本。而且他会把Podfile.lock中的版本更改成对应的版本。

三、创建私有podspec

这个和我们平常的项目最大的区别就是有必须.podspecLICENSE这两个文件。

整体先说明一下创建一个私有的podspec包括如下那么几个步骤:

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

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

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

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

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

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

7.更新维护pod spec。

在这一系列的步骤中需要创建两个git仓库,分别是第一步和第二步(第二步不一定非要是git仓库,只要是可以获取到相关代码文件就可以,也可以是svn的,也可以说zip包,区别就是在podspec中的source项填写的内容不同),并且第一步只是在初次创建私有podspec时才需要,之后在创建其他的只需要从第二步开始就可以。本文只介绍在git环境下的操作,其他环境其他方式暂不说明。

1.创建私有Spec Repo

什么是Spec Repo?它是所有的Pods的一个索引,就是一个容器,所有公开的Pods都在这个里面,它实际是一个Git仓库remote端GitHub上,但是当你使用了Cocoapods后它会被clone到本地的~/.cocoapods/repos目录下,可以进入到这个目录看到master文件夹就是这个官方的Spec Repo了。

官方的Spec Repo目录
因此我们需要创建一个类似于master的私有Spec Repo,这里我们可以fork官方的Repo,也可以自己创建,个人建议不fork,因为你只是想添加自己的Pods,没有必要把现有的公开Podscopy一份。所以创建一个 Git仓库,这个仓库你可以创建私有的也可以创建公开的,不过既然私有的Spec Repo,还是创建私有的仓库吧,需要注意的就是如果项目中有其他同事共同开发的话,你还要给他这个Git仓库的权限。因为GitHub的私有仓库是收费的,我还不是GitHub的付费用户,所以我使用了其他Git服务,我使用的是cocoachina,当然还有其他的可供选择开源中国Bitbucket以及CSDN Code.

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

pod repo add [Private Repo Name] [GitHub HTTPS clone URL]
---------------------------------------------------------
pod repo add PrivateRepo https://git.oschina.net/wuhongxing/PrivateRepo.git

此时如果成功的话cd到~/.cocoapods/repos目录下就可以看到PrivateRepo这个目录了。至此第一步创建私有Spec Repo完成。

2.创建Pod项目工程文件

这个第二步没有什么好介绍的,如果是有现有的组件项目,并且在Git的版本管理下,那么这一步就算完成了,可以直接进行下一步了。

如果你的组件还在你冗余庞大的项目中,需要拆分出来或者需要自己从零开始创建一个组件库,那么我建议你使用Cocoapods提供的一个工具将第二步与第三步结合起来做。

现在来说一下这个工具,首先我们可以用pod lib create PrivateRepo,可以带上--template-url=URL参数(URL表示git仓库的地址),就拿我创建的podTestLibrary为例子具体讲一下这里是如何操作的,先cd到要创建项目的目录然后执行

pod lib create podTestLibrary

之后他会问我们五个问题:

第一个问题:Objective-C 或者 Swift

第二个问题:Making a Demo Application,如果选是就会在你的Xcode工程中新建一个工程。
(如果你想要一个demo或者你需要一个测试单元在你的工程中,你应该选是)

第三个问题:Choosing a Test Framework,你应该测试你的工程,确保别人可用
(如何选择:如果你不能决定,就选Specta/Epecta)

第四个问题:View-based Testing,会根据你选的测试自动生成一个

第五个问题: 你的前缀是什么。

以下是项目生成的目录结构及相关介绍。

$ tree PodTestLibrary -L 2
PodTestLibrary
├── Example                                  #demo APP
│   ├── PodTestLibrary
│   ├── PodTestLibrary.xcodeproj
│   ├── PodTestLibrary.xcworkspace
│   ├── Podfile                              #demo APP 的依赖描述文件
│   ├── Podfile.lock
│   ├── Pods                                  #demo APP 的依赖文件
│   └── Tests
├── LICENSE                               #开源协议 默认MIT
├── Pod                                       #组件的目录
│   ├── Assets                            #资源文件
│   └── Classes                              #类文件
├── PodTestLibrary.podspec           #第三步要创建的podspec文件
└── README.md                                
9 directories, 5 files

接下来就是向Pod文件夹中添加库文件和资源,并配置podspec文件,我把一个网络模块的共有组件放入Pod/Classes中,然后进入Example文件夹执行pod update命令,再打开项目工程可以看到,刚刚添加的组件已经在Pods子工程下Development Pods/PodTestLibrary中了,然后编辑demo工程,测试组件,我并没有使用提供的测试框架进行测试,这里就先不介绍了。

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

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

git add .
git commit -m "Initial Commit of Library"
#添加远端仓库
git remote add origin https://git.oschina.net/wuhongxing/PrivateRepo.git  
#推送到远端仓库
git push origin master  

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

git tag -m "first release" "0.1.0"
git push --tags     #推送tag到远端仓库

做完这些就可以开始编辑podspec文件了,它是一个Ruby的文件,把编辑器的格式改成Ruby就能看到语法高亮,下面我贴上我的podspec文件,并在后面以注释的形式说明每个字段的含义,没有涉及到的字段可以去官方文档查阅

Pod::Spec.new do |s|
  s.name             = "PodTestLibrary"    #名称
  s.version          = "0.1.0"             #版本号
  s.summary          = "Just Testing."     #简短介绍,下面是详细介绍
  s.description      = <<-DESC
                       Testing Private Podspec.
                       DESC
  s.homepage         = "https://git.oschina.net/wuhongxing/PrivateRepo.git"                           #主页,这里要填写可以访问到的地址,不然验证不通过
  # s.screenshots     = "www.example.com/screenshots_1", "www.example.com/screenshots_2"           #截图
  s.license          = 'MIT'              #开源协议
  s.author           = { "wtlucky" => "wtlucky@foxmail.com" }                   #作者信息
  s.source           = { :git => "https://git.oschina.net/wuhongxing/PrivateRepo.git", :tag => "0.1.0" }      #项目地址,这里不支持ssh的地址,验证不通过,只支持HTTP和HTTPS,最好使用HTTPS
  # s.social_media_url = 'https://twitter.com/<twitter_username>'                       #多媒体介绍地址
 
  s.platform     = :ios, '8.0'            #支持的平台及版本
  s.requires_arc = true                   #是否使用ARC,如果指定具体文件,则具体的问题使用ARC
 
  s.source_files = 'Pod/Classes/**/*'     #代码源文件地址,**/*表示Classes目录及其子目录下所有文件,如果有多个目录下则用逗号分开,如果需要在项目中分组显示,这里也要做相应的设置
  s.resource_bundles = {
    'PodTestLibrary' => ['Pod/Assets/*.png']
  }                                       #资源文件地址
  s.public_header_files = 'Pod/Classes/**/*.h'   #公开头文件地址
  s.frameworks = 'UIKit'                  #所需的framework,多个用逗号隔开
  s.dependency 'AFNetworking', '~> 2.3'   #依赖关系,该项目所依赖的其他库,如果有多个需要填写多个s.dependency
end

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

 pod lib lint

当你看到

-> PodTestLibrary (0.1.0)

PodTestLibrary passed validation.

时,说明验证通过了,不过这只是这个podspec文件是合格的,不一定说明这个Pod是可以用的,我们需要在本地做一下验证,这就是第四步的内容了,第四步在具体说明。

3.创建podspec文件

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

pod spec create PrivateRepo https://git.oschina.net/wuhongxing/PrivateRepo.git

编辑完成之后使用验证命令验证一下

pod lib lint

验证无误就可以进入下一步了。

4.本地测试podspec文件

我们可以创建一个新的项目,在这个项目的Podfile文件中直接指定刚才创建编辑好的podspec文件,看是否可用。 在Podfile中我们可以这样编辑,有两种方式

platform :ios, '7.0'
 
pod 'PodTestLibrary', :path => '~/code/Cocoapods/podTest/PodTestLibrary'      #指定路径
pod 'PodTestLibrary', :podspec => '~/code/Cocoapods/podTest/PodTestLibrary/PodTestLibrary.podspec'  #指定podspec文件

然后执行pod install命令安装依赖,打开项目工程,可以看到库文件都被加载到Pods子项目中了,不过它们并没有在Pods目录下,而是跟测试项目一样存在于Development Pods/PodTestLibrary中,这是因为我们是在本地测试,而没有把podspec文件添加到Spec Repo中的缘故。

在项目中编写代码,测试库文件无误后就可以开始下一步了,提交podspecSpec Repo中。

5.向Spec Repo提交podspec

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

pod repo push PrivateRepo PodTestLibrary.podspec  #前面是本地Repo名字 后面是podspec名字

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

.
├── LICENSE
├── PodTestLibrary
│   └── 0.1.0
│       └── PodTestLibrary.podspec
└── README.md

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

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

$ pod search PodTestLibrary
 
-> PodTestLibrary (0.1.0)
   Just Testing.
   pod 'PodTestLibrary', '~> 0.1.0'
   - Homepage: https://git.oschina.net/wuhongxing/PrivateRepo.git
   - Source:   https://git.oschina.net/wuhongxing/PrivateRepo.git
   - Versions: 0.1.0 [PodTestLibrary repo]

这里说的是添加到私有的Repo,如果要添加到Cocoapods的官方库了,可以使用trunk工具,具体可以查看官方文档

6.使用制作好的Pod

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

$ pod 'PodTestLibrary', '~> 0.1.0'

然后执行pod update,更新库依赖,然后打卡项目可以看到,我们自己的库文件已经出现在Pods子项目中的Pods子目录下了,而不再是Development Pods

7.更新维护podspec

最后再来说一下制作好的podspec文件后续的更新维护工作,比如如何添加新的版本,如何删除Pod

我已经制作好了PodTestLibrary0.1.0版本,现在我对他进行升级工作,这次我添加了更多的模块到PodTestLibrary之中,包括工具类,底层ModelUIKit扩展等,这里又尝试了一下subspec功能,给PodTestLibrary创建了多个子分支。

具体做法是先将源文件添加到Pod/Classes中,然后按照不同的模块对文件目录进行整理,因为我有四个模块,所以在Pod/Classes下有创建了四个子目录,完成之后继续编辑之前的PodTestLibrary.podspec,这次增加了subspec特性

Pod::Spec.new do |s|
  s.name             = "PodTestLibrary"
  s.version          = "1.0.0"
  s.summary          = "Just Testing."
  s.description      = <<-DESC
                       Testing Private Podspec.
 
                       * Markdown format.
                       * Don't worry about the indent, we strip it!
                       DESC
  s.homepage         = "https://git.oschina.net/wuhongxing/PrivateRepo.git"
  # s.screenshots     = "www.example.com/screenshots_1", "www.example.com/screenshots_2"
  s.license          = 'MIT'
  s.author           = { "wtlucky" => "wtlucky@foxmail.com" }
  s.source           = { :git => "https://git.oschina.net/wuhongxing/PrivateRepo.git", :tag => "1.0.0" }
  # s.social_media_url = 'https://twitter.com/<twitter_username>'
 
  s.platform     = :ios, '7.0'
  s.requires_arc = true
 
  #s.source_files = 'Pod/Classes/**/*'
  #s.resource_bundles = {
  #  'PodTestLibrary' => ['Pod/Assets/*.png']
  #}
  #s.public_header_files = 'Pod/Classes/**/*.h'
 
  s.subspec 'NetWorkEngine' do |networkEngine|
      networkEngine.source_files = 'Pod/Classes/NetworkEngine/**/*'
      networkEngine.public_header_files = 'Pod/Classes/NetworkEngine/**/*.h'
      networkEngine.dependency 'AFNetworking', '~> 2.3'
  end
 
  s.subspec 'DataModel' do |dataModel|
      dataModel.source_files = 'Pod/Classes/DataModel/**/*'
      dataModel.public_header_files = 'Pod/Classes/DataModel/**/*.h'
  end
 
  s.subspec 'CommonTools' do |commonTools|
      commonTools.source_files = 'Pod/Classes/CommonTools/**/*'
      commonTools.public_header_files = 'Pod/Classes/CommonTools/**/*.h'
      commonTools.dependency 'OpenUDID', '~> 1.0.0'
  end
 
  s.subspec 'UIKitAddition' do |ui|
      ui.source_files = 'Pod/Classes/UIKitAddition/**/*'
      ui.public_header_files = 'Pod/Classes/UIKitAddition/**/*.h'
      ui.resource = "Pod/Assets/MLSUIKitResource.bundle"
      ui.dependency 'PodTestLibrary/CommonTools'
  end
 
  s.frameworks = 'UIKit'
  #s.dependency 'AFNetworking', '~> 2.3'
  #s.dependency 'OpenUDID', '~> 1.0.0'
end

因为我们创建了subspec所以项目整体的依赖dependency,源文件source_files,头文件public_header_files,资源文件resource等都移动到了各自的subspec中,每个subspec之间也可以有相互的依赖关系,比如UIKitAddition就依赖于CommonTools

编辑完成之后,在测试项目里pod update一下,几个子项目都被加进项目工程了,写代码验证无误之后,就可以将这个工程push到远端仓库,并打上新的tag->1.0.0

最后再次使用pod lib lint验证编辑好的podsepc文件,没有自身的WARNING或者ERROR之后,就可以再次提交到Spec Repo中了,命令跟之前是一样的

$ pod repo push PodTestLibrary PodTestLibrary.podspec

之后再次到~/.cocoapods/repos/PrivateRepo目录下查看

.
├── LICENSE
├── PodTestLibrary
│   ├── 0.1.0
│   │   └── PodTestLibrary.podspec
│   └── 1.0.0
│       └── PodTestLibrary.podspec
└── README.md
 
3 directories, 4 files

已经有两个版本了,使用pod search查找得到的结果为

$ pod search PodTestLibrary
 
-> PodTestLibrary (1.0.0)
   Just Testing.
   pod 'PodTestLibrary', '~> 1.0.0'
   - Homepage: https://git.oschina.net/wuhongxing/PrivateRepo.git
   - Source:   https://git.oschina.net/wuhongxing/PrivateRepo.git
   - Versions: 1.0.0, 0.1.0 [WTSpecs repo]
   - Sub specs:
     - PodTestLibrary/NetWorkEngine (1.0.0)
     - PodTestLibrary/DataModel (1.0.0)
     - PodTestLibrary/CommonTools (1.0.0)
     - PodTestLibrary/UIKitAddition (1.0.0)

完成这些之后,在实际项目中我们就可以选择使用整个组件库或者是组件库的某一个部分了,对应的Podfile中添加的内容为

platform :ios, '7.0'
 
pod 'PodTestLibrary/NetWorkEngine', '1.0.0'  #使用某一个部分
pod 'PodTestLibrary/UIKitAddition', '1.0.0'
 
pod 'PodTestLibrary', '1.0.0'   #使用整个库

最后介绍一下如何删除一个私有Spec Repo,只需要执行一条命令即可

$ pod repo remove PodTestLibrary

这样这个Spec Repo就在本地删除了,我们还可以通过

$ pod repo add PodTestLibrary https://git.oschina.net/wuhongxing/PrivateRepo.git

再把它给加回来。

如果我们要删除私有Spec Repo下的某一个podspec怎么操作呢,此时无需借助Cocoapods,只需要cd到~/.cocoapods/repos/PodTestLibrary目录下,删掉库目录

cd ~/.cocoapods/repos/PodTestLibrary
rm -rf PodTestLibrary

然后在将Git的变动push到远端仓库即可

参考文章:
https://guides.cocoapods.org/
http://www.cocoachina.com/ios/20150228/11206.html

推荐阅读更多精彩内容