iOS-cocoapods安装与使用以及常见错误

前言

CocoaPods是一个负责管理iOS项目中第三方开源代码的工具。

二、安装
由于网上的教程基本都大同小异，但细节之处还不是很完善，所以借机会在这里补充下：
注：要使用CocoaPods，那就要下载安装它，而下载安装CocoaPods需要Ruby环境

1.Ruby环境搭建

当前安装环境为Mac Pro 10.11.1。Mac OS本身自带Ruby，但还是更新一下保险，因为升级了系统之后,可能会出现一些意想不到的情况,最好还是更新一下Ruby。

查看下当前ruby版本：打开终端输入 ruby -v（确实安装了，不过iOS9使用https协议替换http协议,所以以前挂靠在淘宝下ruby的源的路径也要修改下，顺便更新下ruby）
```
CYdediannao:~ lcy$  ruby -v

ruby 2.0.0p645 (2015-04-13 revision 50299) [universal.x86_64-darwin15]
```
淘宝已经停止基于 HTTP 协议的镜像服务, 请在配置中使用 HTTPS 协议代替

CYdediannao:~ lcy$ gem sources - l

*** CURRENT SOURCES ***

http://ruby.taobao.org/

CYdediannao:~ lcy$ gem sources --add https://ruby.taobao.org/ --remove http://ruby.taobao.org/

https://ruby.taobao.org/ added to sources

http://ruby.taobao.org/ removed from sources

gem sources -l （用来检查使用替换镜像位置成功，然后升级ruby
```
CYdediannao:~ lcy$ sudo gem install rails
```
或者是
```
CYdediannao:~ lcy$ sudo gem update --system
```

2.下载安装CocoaPods

CYdediannao:~ lcy$ sudo gem install cocoapods

出现的错误###：原因是该文件夹没有修改的权限

CYdediannao:~ lcy$ sudo gem install cocoapods

Fetching: nap-1.0.0.gem (100%)

Successfully installed nap-1.0.0

Fetching: molinillo-0.4.0.gem (100%)

Successfully installed molinillo-0.4.0

Fetching: cocoapods-trunk-0.6.4.gem (100%)

Successfully installed cocoapods-trunk-0.6.4

Fetching: cocoapods-try-0.5.1.gem (100%)

Successfully installed cocoapods-try-0.5.1

Fetching: cocoapods-stats-0.6.2.gem (100%)

Successfully installed cocoapods-stats-0.6.2

Fetching: cocoapods-search-0.1.0.gem (100%)

Successfully installed cocoapods-search-0.1.0

Fetching: cocoapods-downloader-0.9.3.gem (100%)

Successfully installed cocoapods-downloader-0.9.3

Fetching: xcodeproj-0.28.2.gem (100%)

ERROR:  While executing gem ... (Errno::EPERM)

    Operation not permitted - /usr/bin/xcodeproj

10.11以上系统使用命令： sudo gem install -n /usr/local/bin cocoapods

CYdediannao:~ lcy$ sudo gem install -n /usr/local/bin cocoapods

Password:

Successfully installed xcodeproj-0.28.2

Fetching: cocoapods-core-0.39.0.gem (100%)

Successfully installed cocoapods-core-0.39.0

Fetching: cocoapods-0.39.0.gem (100%)

Successfully installed cocoapods-0.39.0

Parsing documentation for xcodeproj-0.28.2

Installing ri documentation for xcodeproj-0.28.2

Parsing documentation for cocoapods-core-0.39.0

Installing ri documentation for cocoapods-core-0.39.0

Parsing documentation for cocoapods-0.39.0

Installing ri documentation for cocoapods-0.39.0

3 gems installed

3.使用命令 pod search AFNetworking 查找某一个库，看cocoapods有没有安装好，搜索结果如下，已经安装好了cocoa pods

-> AFNetworking (2.6.0)

   A delightful iOS and OS X networking framework.

   pod 'AFNetworking', '~> 2.6.0'

   - Homepage: https://github.com/AFNetworking/AFNetworking

   - Source:   https://github.com/AFNetworking/AFNetworking.git

   - Versions: 2.6.0, 2.5.4, 2.5.3, 2.5.2, 2.5.1, 2.5.0, 2.4.1, 2.4.0, 2.3.1,

   2.3.0, 2.2.4, 2.2.3, 2.2.2, 2.2.1, 2.2.0, 2.1.0, 2.0.3, 2.0.2, 2.0.1, 2.0.0,

   2.0.0-RC3, 2.0.0-RC2, 2.0.0-RC1, 1.3.4, 1.3.3, 1.3.2, 1.3.1, 1.3.0, 1.2.1,

   1.2.0, 1.1.0, 1.0.1, 1.0, 1.0RC3, 1.0RC2, 1.0RC1, 0.10.1, 0.10.0, 0.9.2,

   0.9.1, 0.9.0, 0.7.0, 0.5.1 [master repo] - 2.6.0, 2.5.4, 2.5.3, 2.5.2, 2.5.1,

   2.5.0, 2.4.1, 2.4.0, 2.3.1, 2.3.0, 2.2.4, 2.2.3, 2.2.2, 2.2.1, 2.2.0, 2.1.0,

   2.0.3, 2.0.2, 2.0.1, 2.0.0, 2.0.0-RC3, 2.0.0-RC2, 2.0.0-RC1, 1.3.4, 1.3.3,

   1.3.2, 1.3.1, 1.3.0, 1.2.1, 1.2.0, 1.1.0, 1.0.1, 1.0, 1.0RC3, 1.0RC2, 1.0RC1,

   0.10.1, 0.10.0, 0.9.2, 0.9.1, 0.9.0, 0.7.0, 0.5.1 [master-1 repo]

   - Subspecs:

     - AFNetworking/Serialization (2.6.0)

     - AFNetworking/Security (2.6.0)

     - AFNetworking/Reachability (2.6.0)

     - AFNetworking/NSURLConnection (2.6.0)

     - AFNetworking/NSURLSession (2.6.0)

     - AFNetworking/UIKit (2.6.0)

-> AFNetworking+AutoRetry (0.0.5)

   Auto Retries for AFNetworking requests

   pod 'AFNetworking+AutoRetry', '~> 0.0.5'

   - Homepage: https://github.com/shaioz/AFNetworking-AutoRetry

   - Source:   https://github.com/shaioz/AFNetworking-AutoRetry.git

   - Versions: 0.0.5, 0.0.4, 0.0.3, 0.0.2, 0.0.1 [master repo] - 0.0.5, 0.0.4,

   0.0.3, 0.0.2, 0.0.1 [master-1 repo]

-> AFNetworking+Ext (1.2.1)

   AFNetworking的封装, 并提供一个 UIImageView+DYLoading  cache in fileSystem+memory

   pod 'AFNetworking+Ext', '~> 1.2.1'

   - Homepage: https://github.com/junhaiyang/AFNetworkingExt

   - Source:   https://github.com/junhaiyang/AFNetworkingExt.git

   - Versions: 1.2.1, 1.2, 1.1, 1.0, 0.5, 0.4, 0.3 [master repo] - 1.2.1, 1.2,

   1.1, 1.0, 0.5, 0.4, 0.3 [master-1 repo]

   - Subspecs:

     - AFNetworking+Ext/Base (1.2.1)

     - AFNetworking+Ext/AFCustomRequestOperation (1.2.1)

     - AFNetworking+Ext/AFDownloadRequestOperation (1.2.1)

     - AFNetworking+Ext/AFTextResponseSerializer (1.2.1)

     - AFNetworking+Ext/example (1.2.1)

     - AFNetworking+Ext/UIKit (1.2.1)

     - AFNetworking+Ext/UIKit/UIImageView+DYLoading (1.2.1)

##还有很大篇幅的结果，此处省略。。。##

4.cocoapods的使用

新建一个项目，名字podsTest

项目podsTest.png
打开项目所在的文件夹，在终端敲入 cd 将文件夹拖拽到终端或者用cd打开项目所在文件夹（注意：包含podsTest文件夹、podsTest.xcodeproj、podsTestTest、podsTestUITests的那个总目录）如图：

项目组织目录.png

进入到podsTest组织目录.png

建立Podfile（配置文件）
1.接着上一步，终端输入 vim Podfile

屏幕快照 2015-10-23 16.09.45.png

2.键盘输入 i，进入编辑模式

进入编辑模式.png

3.内容按这个格式输入
　platform :ios, '7.0'
　pod 'MBProgressHUD', '~> 0.9.1'
　pod 'ASIHTTPRequest', '~> 1.8.2'
　pod 'SDWebImage', '~> 3.7.3'

注意：　如果你不知道这些框架目前的版本是，可以使用命令pod search +框架名称查看相应的信息

查找结果.png

4.然后按Esc，并且输入 shift +“ ：”号进入vim命令模式，然后在冒号后边输入wq 按回车键，保存并且退出。
5.结果如下图：

编辑结果.png

6.发现podTest项目总目录中多一个Podfile文件

Podfile.png

7.激动人心的时刻到了：确定终端cd到项目总目录，然后输入 pod install，等待一会，框架安装好了如图所示，多出了3个文件夹/文件夹。

安装后的文件结构.png

注意：

现在打开项目不是点击 podTest.xodeproj了，而是点击 podsTest.xcworkspace

屏幕快照 2015-10-23 16.45.00.png

5.cocoaPods使用心得

最近使用CocoaPods来添加第三方类库，无论是执行pod install还是pod update都卡在了Analyzing dependencies不动原因在于当执行以上两个命令的时候会升级CocoaPods的spec仓库，加一个参数可以省略这一步，命令如下：
```
pod install --verbose --no-repo-update

pod update --verbose --no-repo-update
```
$ pod install只会按照Podfile的要求来请求类库，如果类库版本号有变化，那么将获取失败。但是 $ pod update会更新所有的类库，获取最新版本的类库。每次用$ pod update就行。
安装一个xcode插件管理工具，地址目前还不支持XCode7
在终端中执行
```
curl -fsSL https://raw.github.com/supermarin/Alcatraz/master/Scripts/install.sh | sh
```
安装完了打开xcode->window->package manger 搜cocoapods安装，方便操作。
工程在模拟器上编译报错，不支持i386，Cocoapods确实还不支持64位模拟器，解决办法：
其实就2条：
1.build active architecture only 在debug的时候设置成YES，不要在release的时候用模拟器
2.other linker flags 加一个 $(inherited)
用到svn,git多人协作的话，Pods/这个文件夹不要上传，例如：
.../Pods/Pods.xcodeproj ...Pods/Target Support Files/这些每次编译都会改动从而引起合并代码的时候冲突

心得内容来源

6.cocoaPods使用常见错误汇总：

pod install 时出现以下错误，错误原因是在vim Podfile 时，输入命令前面带有空格导致的，把空格去掉就好了

错误写法：

　platform :ios, '7.0'

　pod 'MBProgressHUD', '~> 0.9.1'

　pod 'ASIHTTPRequest', '~> 1.8.2'

　pod 'SDWebImage', '~> 3.7.3'

提示错误：

[!] Invalid `Podfile` file: undefined method `　pod' for #<Pod::Podfile:0x007ff3f9a45a48>. Updating CocoaPods might fix the issue.

正确写法：命令前面不留空格

platform :ios, '7.0'

pod 'MBProgressHUD', '~> 0.9.1'

pod 'ASIHTTPRequest', '~> 1.8.2'

pod 'SDWebImage', '~> 3.7.3'

7 使用CocoaPods来管理Objective-c的类库，非常方便。但是有一个小问题，当我在xcode输入import关键字的时候，没有自动联想补齐代码的功能，需要手工敲全了文件名，难以适应。

在stackoverflow上找到了解决办法:

1.Go to the Target > \”Build Settings\” tab and find the \”User Header Search Paths\” setting.

2.Set this to \”$(BUILT_PRODUCTS_DIR)\” and check the \”Recursive\” check box.

Now the built target will search the workspace’s shared build directory to locate the linkable header files.

简单说就是这么几步:

1.选择Target -> Build Settings 菜单，找到\”User Header Search Paths\”设置项

2.新增一个值$(BUILT_PRODUCTS_DIR)，并且选择\”Recursive\”，这样xcode就会在项目目录中递归搜索文件

自动补齐功能马上就好使了。

原文链接：http://www.jianshu.com/p/53f1679604ad