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

前言

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

2、安装
因为网上的教程基本都大同小异，但细节之处还不是很完善，因此借机会在这里补充下：
注：要使用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