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