CocoaPods的安装使用和常见问题

最新推荐文章于 2017-04-10 11:07:00 发布

原创最新推荐文章于 2017-04-10 11:07:00 发布 · 956 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#CocoaPods #iOS

iOS环境配置专栏收录该内容

6 篇文章

订阅专栏

CocoaPods是一款用于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

如果出现
ERROR: While executing gem ... (Errno::EPERM) Operation not permitted - /usr/bin/update_rubygems

这个地方纠结了半天啊

则需要把路径改为`sudo gem install -n /usr/local/bin cocoapods`

接下来进行安装，执行：
$ pod setup

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

四、Cocoapods的使用

进入工程所在的目录cd Desktop/Test
输入pod init创建Podfile文件夹
查找需要的类库pod search AFNetworking
将查找到的版本名字复制到Podfile文件中
进行安装pod install

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

进入工程后import文件时倒入不了，要进行相关设置
这里写图片描述

ok!!!安装成功了

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 #. 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命令查看，已经改过来了

附：如何使用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上的镜像。