Cocoapods

来源:互联网 发布:h3c msr5660软件版本 编辑:程序博客网 时间:2024/05/15 02:54


之前学过cocoa pods 依赖,但是这几天项目管理的时候还是有很多的问题,所以稍微整理了一下,重新再加深学一遍

Cocoa pods的安装和使用介绍
1.使用ruby的gem来安装和升级gem
sudo gem install cocoapods
pod setup

如果gem 版本过低,则需要更新一下,sudo gem update  --system

如果没有翻墙,需要调换ruby 的软件源 
gem sources —remove https://rubygems.org/
gem sources -a https://ruby.taobao.org/
gem sources -l

然后可以使用pod setup  来建立cocoa pods   第一次安装的时候会下载相关的第三方库文件,时间会比较长,会下载到~/.cocoapods目录下 

可以进入查看
https://github.com/CocoaPods/Specs

使用 CocoaPods

使用时需要新建一个名为 Podfile 的文件,以如下格式,将依赖的库名字依次列在文件中即可

12345
platform :iospod 'JSONKit',       '~> 1.4'pod 'Reachability',  '~> 3.0.0'pod 'ASIHTTPRequest'pod 'RegexKitLite'

关于 Podfile.lock


当你执行pod install之后,除了 Podfile 外,CocoaPods 还会生成一个名为Podfile.lock的文件,Podfile.lock 应该加入到版本控制里面,不应该把这个文件加入到.gitignore中。因为Podfile.lock会锁定当前各依赖库的版本,之后如果多次执行pod install 不会更改版本,要pod update才会改Podfile.lock了。这样多人协作的时候,可以防止第三方库升级时造成大家各自的第三方库版本不一致。
详细的内容可以直接在github上搜索 cocoa pods的项目,有相关的详细介绍

至于pod其他的相关信息可以查看 
  • 《如何编写一个 CocoaPods 的 spec 文件》
  • 《Cocoapods 入门》。


我们建立起来cocoa pods之后,会在~/.cocoapods/repo/master里面生成大量的库,但是这些库并不一定都能被我们使用,也不一定都是最新的,所以我们需要自己去制作一些项目配置

如果想自己写一个供给cocoapods 使用的spec文件,这个文件可以在podsearch 中搜索到
可以看上边的
《如何编写一个 CocoaPods 的 spec 文件》
此处不在做赘述

可以直接https://guides.cocoapods.org/using/using-cocoapods.html,去查看官方cocoa pods 的详细描述 



下边两篇是  在网上找的一些比较好的博客,放在一起,便于以后查阅
此篇博文与pod.lock  结合起来学习更全面
pod install --no-repo-update
直接使用pod install 会卡住,可以用上边的那个

CocoaPods的安装使用和常见问题
字数2158 阅读9158 评论8 喜欢29
本文多引自《iOS开发进阶》(唐巧 著),加上广大网友技术博客的帮助,我对自己在安装使用CocoaPods的过程和遇到的问题进行了一个总结,感谢他们!希望这篇文章能帮助有需要的人,尤其是刚开始使用CocoaPods的朋友。
一、什么是CocoaPods

CocoaPods是iOS项目的依赖管理工具,该项目源码在Github上管理。开发iOS项目不可避免地要使用第三方开源库,CocoaPods的出现使得我们可以节省设置和第三方开源库的时间。
在使用CocoaPods之前,开发项目需要用到第三方开源库的时候,我们需要
1.把开源库的源代码复制到项目中
2.添加一些依赖框架和动态库
3.设置-ObjC,-fno-objc-arc等参数
4.管理他们的更新
在使用CocoaPods后,我们只需要把用到的开源库放到一个名为Podfile的文件中,然后执行pod install.Cocoapods就会自动将这些第三方开源库的源码下载下来,并且为我们的工程设置好响应的系统依赖和编译参数。

二、CocoaPods的原理

CocoaPods的原理是将所有的依赖库都放到另一个名为Pods的项目中,然后让主项目依赖Pods项目,这样,源码管理工作都从主项目移到了Pods项目中。Pods项目最终会编译成一个名为libPods.a的文件,主项目只需要依赖这个.a文件即可。

三、CocoaPods的安装

CocoaPods可以方便地通过Mac自带的RubyGems安装。
打开Terminal,然后键入以下命令:
$ sudo gem install cocoapods

执行完这句如果报告以下错误:
ERROR: Could not find a valid gem 'cocoapods' (>= 0), here is why:
Unable to download data from https://rubygems.org/ - Errno::ETIMEDOUT: Operation timed out - connect(2) (https://rubygems.org/latest_specs.4.8.gz)
ERROR: Possible alternatives: cocoapods

这是因为ruby的软件源rubygems.org因为使用亚马逊的云服务,被我天朝屏蔽了,需要更新一下ruby的源,过程如下:
$ gem sources -l (查看当前ruby的源)
$ gem sources --remove https://rubygems.org/
$ gem sources -a https://ruby.taobao.org/
$ gem sources -l

如果gem太老,可以尝试用如下命令升级gem
$ sudo gem update --system
升级成功后会提示: RubyGems system software updated

然后重新执行安装下载命令
$ sudo gem install cocoapods
这时候应该没什么问题了

接下来进行安装,执行:
$ pod setup

在这里会出现错误‘
bogon:~ chenhanqing$ pod setup
Setting up CocoaPods master repo
[!] /usr/bin/git clonehttps://github.com/CocoaPods/Specs.git master --depth=1

Cloning into 'master'...
fatal: unable to access 'https://github.com/CocoaPods/Specs.git/': Could not resolve host:github.com


此时采用pod search AFNetworking
即可解决问题

Terminal会停留在 Setting up CocoaPods master repo 这个状态一段时间,是因为要进行下载安装,而且目录比较大,需要耐心等待一下.如果想加快速度,可使用cocoapods的镜像索引.(文章末尾附使用镜像索引的方法)
安装成功后,你会看到:
01.png
01.png
四、Cocoapods的使用

进入工程所在的目录(工程根目录)
执行命令 touch Podfile
这句是说新建一个名为Podfile的文件(不能写成别的名字,也可以自己在工程根目录里面直接新建)

然后对改文件进行编辑,执行命令 open -e Podfile
第一次执行这个命令,会有一个空白文件打开,可以先放在一边,
Podfile文件的格式应该如下:
platform :ios, '7.0'
pod 'AMap2DMap', '~> 2.5.0'
pod 'AFNetworking', '~> 2.5.3'
pod 'SDWebImage', '~> 3.7.2'

需要注意的几点:platform那一行,ios三个字母都要小写,而且与前面的冒号之间不能有间隔,后面的版本号也可以不写,但是有些开源库对版本是有要求的,比如要在6.0以上才能运行,遇到这样的开源库就需要写上版本号。

platform下面就是Cocoapods需要集成的开源库,根据你的需要确定集成那些库。

举个例子:
我要集成AFNetworking这个库类,需要在Cocoapods里面先搜索是否有需要的库,可以在Terminal中输入:
pod search AFNetworking
回车之后就可以看到和你搜索的关键字相关的一些库类,如图:

02.png
02.png

其中第一个就是我们需要的,把pod ‘AFNetworking’, ‘~>2.5.3’
那一行复制到我们的Podfile文件中,保存修改。
然后在Terminal中执行 :
pod install

这样,AFNetworking就已经下载完成并且设置好了编译参数和依赖,以后使用的时候切记如下两点:
1.从此以后需要使用Cocoapods生成的 .xcworkspace文件来打开工程,而不是使用以前的.xcodeproj文件
2.每次更改了Podfile文件,都需要重新执行一次pod update命令

ps:当执行pod install之后,除了Podfile,还会生成一个名为Podfile.lock的文件,它会锁定当前各依赖库的版本,之后即使多次执行pod install也不会更改版本,只有执行pod update才会改变Podfile.lock.在多人协作的时候,这样可以防止第三方库升级时候造成大家各自的第三方库版本不一致。所以在提交版本的时候不能把它落下,也不要添加到.gitignore中.

五、常见问题

1.
[!] Invalid 
Podfile file: undefined local variable or method `en_US' for #<Pod::Podfile:0x00000102a5d8b0>. Updating CocoaPods might fix the issue.

原因:单引号格式,可能是手动输入导致
解决办法:系统偏好设置-键盘-文本-将“使用智能引号和破折号”一项取消勾选-再将podfile里面的单(双)引号修改一下

2.ArgumentError - invalid byte sequence in US-ASCII
原因:字符集错误
解决办法:
使用locale命令查看当前的字符集,如果都是zh,需要执行以下命令:
export LC_ALL=en_US.UTF-8
export LANG=en_US.UTF-8
然后再使用locale命令查看,已经改过来了

  1. [!] The YMTea [Debug] target overrides the OTHER_LDFLAGS build setting defined in `Pods/Target Support Files/Pods/Pods.debug.xcconfig'. This can lead to problems with the CocoaPods installation
    • Use the $(inherited) flag, or
    • Remove the build settings from the target.

[!] The YMTea [Release] target overrides the OTHER_LDFLAGS build setting defined in `Pods/Target Support Files/Pods/Pods.release.xcconfig'. This can lead to problems with the CocoaPods installation

- Use the `$(inherited)` flag, or- Remove the build settings from the target.

原因:我是在已有项目中集成Cocoapods的时候遇到这个问题,原因是项目 Target 中做了一些设置,CocoaPods 也做了默认的设置,如果两个设置结果不一致,就会造成问题。
解决方法:我想要使用 CocoaPods 中的设置,分别在我的项目中定义
PODS_ROOT 和 Other Linker Flags的地方(build settings),把他们的值用$(inherited)替换掉,进入终端,执行 pod update
警告没了,回到 Xcode,build通过。
网上还流行另外一种简单粗暴的方法:点击项目文件 project.xcodeproj,右键
显示包内容,用文本编辑器打开project.pbxproj,删除OTHER_LDFLAGS的地方,保存(这种我没试过)

4.
[!] Oh no, an error occurred.

It appears to have originated from your Podfile at line 2.

Search for existing GitHub issues similar to yours:
https://github.com/CocoaPods/CocoaPods/search?q=%2FUsers%2Fxiao6%2FMusic%2FGI06%E5%AE%9E%E8%AE%AD%E8%8A%B8%E8%8C%97%E8%8C%B6%E5%8F%B6%2FYMTea%2FPodfile%3A2%3A+syntax+error%2C+unexpected+%27%3A%27%2C+expecting+end-of-input%0Aplatform+%3A+ios%2C+%277.0%27%0A++++++++++%5E&type=Issues

If none exists, create a ticket, with the template displayed above, on:
https://github.com/CocoaPods/CocoaPods/issues/new

Be sure to first read the contributing guide for details on how to properly submit a ticket:
https://github.com/CocoaPods/CocoaPods/blob/master/CONTRIBUTING.md

Don't forget to anonymize any private data!

原因:这个问题比较蛋疼,弄了好久,仔细看发现就是因为Podfile文件里面 platform 那一行 冒号和ios之间多了一个空格。。。。其实这个错误在报错的时候ruby已经给出了,只是一开始没有好好看:

03.png
03.png
附:如何使用CocoaPods的镜像索引:
所有项目的Podspec文件都托管在https://github.com/CocoaPods/Specs,
第一次执行pod setup时,CocoaPods会将这些podspec索引文件更新到本地的~/.cocoapods目录下,
这个索引文件比较大,所以第一次更新时非常慢.
友好人士在国内的服务器建立了Cocoapods索引库的镜像,
所以执行索引跟新操作时候会快很多.具体操作方法如下:
$ pod repo remove master
$ pod repo add master https://gitcafe.com/akuandev/Specs.git
$ pod repo update
这是使用gitcafe上的镜像,将以上代码中的 https://gitcafe.com/akuandev/Specs.git 
替换成 http://git.oschina.net/akuandev/Specs.git 即可使用oschina上的镜像。


1、pod install

根据Podfile文件指定的内容,安装依赖库,如果有Podfile.lock文件而且对应的Podfile文件未被修改,则会根据Podfile.lock文件指定的版本安装。
每次更新了Podfile文件时,都需要重新执行该命令,以便重新安装Pods依赖库。

2、pod update

若果Podfile中指定的依赖库版本不是写死的,当对应的依赖库有了更新,无论有没有Podfile.lock文件都会去获取Podfile文件描述的允许获取到的最新依赖库版


一、Podfile.lock文件

上文讲过,在开始使用CocoaPods,执行完pod install之后,会生成一个Podfile.lock文件。这个文件看起来跟我们关系不大,实际上绝对不应该忽略它。

该文件用于保存已经安装的Pods依赖库的版本,通过CocoaPods安装了SBJson、AFNetworking、Reachability三个POds依赖库以后对应的Podfile.lock文件内容为:
PODS:  - AFNetworking (2.3.1):    - AFNetworking/NSURLConnection    - AFNetworking/NSURLSession    - AFNetworking/Reachability    - AFNetworking/Security    - AFNetworking/Serialization    - AFNetworking/UIKit  - AFNetworking/NSURLConnection (2.3.1):    - AFNetworking/Reachability    - AFNetworking/Security    - AFNetworking/Serialization  - AFNetworking/NSURLSession (2.3.1):    - AFNetworking/Reachability    - AFNetworking/Security    - AFNetworking/Serialization  - AFNetworking/Reachability (2.3.1)  - AFNetworking/Security (2.3.1)  - AFNetworking/Serialization (2.3.1)  - AFNetworking/UIKit (2.3.1):    - AFNetworking/NSURLConnection    - AFNetworking/NSURLSession  - FXReachability (1.1.1)  - GCJSONKit (1.5.0)DEPENDENCIES:  - AFNetworking (~> 2.3.1)  - FXReachability (~> 1.1.1)  - GCJSONKit (~> 1.5.0)SPEC CHECKSUMS:  AFNetworking: 6d7b76aa5d04c8c37daad3eef4b7e3f2a7620da3  FXReachability: 34c68085c9a12c7fe4f791bdb54e99f14d90b5ae  GCJSONKit: 2e66dba7183b1557f01bcbb3021746073c6fa523COCOAPODS: 0.33.1
Podfile.lock文件最大得用处在于多人开发。对于没有在Podfile中指定Pods依赖库版本的写法,如下:
pod JSONKIT

该句话用于获取当前SBJson这个Pods依赖库的最新版本。
当团队中的某个人执行完pod install命令后,生成的Podfile.lock文件就记录下了当时最新Pods依赖库的版本,这时团队中的其它人check下来这份包含Podfile.lock文件的工程以后,再去执行pod install命令时,获取下来的Pods依赖库的版本就和最开始用户获取到的版本一致。如果没有Podfile.lock文件,后续所有用户执行pod install命令都会获取最新版本的SBJson,这就有可能造成同一个团队使用的依赖库版本不一致,这对团队协作来说绝对是个灾难!
在这种情况下,如果团队想使用当前最新版本的JSONKIT依赖库,有两种方案:
  • 更改Podfile,使其指向最新版本的JSONKIT依赖库;
  • 执行pod update命令;
鉴于Podfile.lock文件对团队协作如此重要,我们需要将它添加到版本管理中。

二、Podfile文件

对于普通用户来说,使用CocoaPods我们打交道最多的就是Podfile文件。CocoaPods是用ruby实现的,因此Podfile文件的语法就是ruby的语法。接着从以下几个方面来介绍Podfile:

1、Podfile文件存放位置

这是在上篇文章中,遗留的一个问题。通常情况下我们都推荐Podfile文件都放在工程根目录,如下图所示:


事实上Podfile文件可以放在任意一个目录下,需要做的是在Podfile中指定工程的路径,和原来相比,Podfile文件就在最开始的位置增加了一行,具体内容如下:

xcodeproj "/Users/admin/Documents/CocoaPodsFirst/CocoaPodsFirst.xcodeproj" 

platform :ios
pod 'FXReachability', '~> 1.1.1'
pod 'GCJSONKit', '~> 1.5.0'

platform :ios ,'7.0'
pod 'AFNetworking', '~> 2.3.1'

指定路径使用的是xcodeproj关键字。此后,进入Podfile文件所在路径,执行pod install命令就会和之前一样下载这些Pods依赖库,而且生成的相关文件都放在了Podfile所在目录下面,如下图:


和之前一样,我们仍然需要使用这里生成的workspace文件打开工程。

2、Podfile和target

Podfile本质上是用来描述Xcode工程中的targets用的。如果我们不显式指定Podfile对应的target,CocoaPods会创建一个名称为default的隐式target,会和我们工程中的第一个target相对应。换句话说,如果在Podfile中没有指定target,那么只有工程里的第一个target能够使用Podfile中描述的Pods依赖库。
如果想在一个Podfile中同时描述project中的多个target,根据需求的不同,可以有不同的实现方式。为了说明问题,在原来的工程中再创建一个名称为CocoaPodsSecondExample的target,现在的project中包含的target有:

①多个target中使用相同的Pods依赖库
比如,名称为CocoaPodsTest的target和Second的target都需要使用Reachability、SBJson、AFNetworking三个Pods依赖库,可以使用link_with关键字来实现,将Podfile写成如下方式:

link_with 'CocoaPodsFirstExample','CocoaPodsSecondExample' 

platform :ios
pod 'FXReachability', '~> 1.1.1'
pod 'GCJSONKit', '~> 1.5.0'

platform :ios ,'7.0'
pod 'AFNetworking', '~> 2.3.1'

这种写法就实现了CocoaPodsFirstExample和CocoaPodsSecondExample两个target共用相同的Pods依赖库。
②不同的target使用完全不同的Pods依赖库
CocoaPodsFirstExample这个target使用的是Reachability、SBJson、AFNetworking三个依赖库,但CocoaPodsSecondExample这个target只需要使用OpenUDID这一个依赖库,这时可以使用target关键字,Podfile的描述方式如下:(注意target后面的:不能有空格)

target :'CocoaPodsFirstExample' do
platform :ios
pod 'FXReachability', '~> 1.1.1'
pod 'GCJSONKit', '~> 1.5.0'

platform :ios ,'7.0'
pod 'AFNetworking', '~> 2.3.1'
end

target :'CocoaPodsSecondExample' do
platform :ios
pod 'OpenUDID', '~> 1.0.0'
end
其中,do/end作为开始和结束标识符。

3、使用Podfile管理Pods依赖库版本

再引入依赖库时,需要显示或隐式注明引用的依赖库版本,具体写法和表示含义如下:
pod 'AFNetworking'      //不显式指定依赖库版本,表示每次都获取最新版本  pod 'AFNetworking', '2.0'     //只使用2.0版本  pod 'AFNetworking', '> 2.0'     //使用高于2.0的版本  pod 'AFNetworking', '>= 2.0'     //使用大于或等于2.0的版本  pod 'AFNetworking', '< 2.0'     //使用小于2.0的版本  pod 'AFNetworking', '<= 2.0'     //使用小于或等于2.0的版本  pod 'AFNetworking', '~> 0.1.2'     //使用大于等于0.1.2但小于0.2的版本  pod 'AFNetworking', '~>0.1'     //使用大于等于0.1但小于1.0的版本  pod 'AFNetworking', '~>0'     //高于0的版本,写这个限制和什么都不写是一个效果,都表示使用最新版本

三、CocoaPods常用命令

1、pod install

根据Podfile文件指定的内容,安装依赖库,如果有Podfile.lock文件而且对应的Podfile文件未被修改,则会根据Podfile.lock文件指定的版本安装。
每次更新了Podfile文件时,都需要重新执行该命令,以便重新安装Pods依赖库。

2、pod update

若果Podfile中指定的依赖库版本不是写死的,当对应的依赖库有了更新,无论有没有Podfile.lock文件都会去获取Podfile文件描述的允许获取到的最新依赖库版本。

3、pod search

命令格式为:$ pod search OpenUDID  
后面的OpenUDID为参数。从命令的名称不难看出,该命令是用来按名称搜索可用的Pods依赖库,执行结果如下:
-> OpenUDID (1.0.0)     Open source initiative for a universal and persistent UDID solution for iOS.     pod 'OpenUDID', '~> 1.0.0'     - Homepage: http://OpenUDID.org     - Source:   https://github.com/ylechelle/OpenUDID.git     - Versions: 1.0.0 [master repo]  


pod 'OpenUDID''~> 1.0.0'
不难看出,这是我们需要添加到Podfile文件中的。
有了这条命令,就可以方便、迅速地找到需要的Pods依赖库。

4、pod setup

命令格式为:$ pod setup 
执行完了以后会打印:
Setting up CocoaPods master repo  Updating 7cd4668..f3d3ced    Fast-forward  


接下来还会打印很多更新信息。这条命令用于跟新本地电脑上的保存的Pods依赖库tree。由于每天有很多人会创建或者更新Pods依赖库,这条命令执行的时候会相当慢,还请耐心等待。我们需要经常执行这条命令,否则有新的Pods依赖库的时候执行pod search命令是搜不出来的。

转载自:http://blog.csdn.net/wzzvictory/article/details/19178709
参照文档:http://guides.cocoapods.org/using/index.html


0 0